FORGE Batch Application Generator

Transcription

1 FORGE Batch Application Generator For 8 Series Mobile Computers: 8000 / 8300 / 8400 / 8500 DOC Version 2.22

2 Copyright 2008~2010 CIPHERLAB CO., LTD. All rights reserved The software contains proprietary information of CIPHERLAB CO., LTD.; it is provided under a license agreement containing restrictions on use and disclosure and is also protected by copyright law. Reverse engineering of the software is prohibited. Due to continued product development this information may change without notice. The information and intellectual property contained herein is confidential between CIPHERLAB and the client and remains the exclusive property of CIPHERLAB CO., LTD. If you find any problems in the documentation, please report them to us in writing. CIPHERLAB does not warrant that this document is error-free. No part of this publication may be reproduced, stored in a retrieval system, or transmitted in any form or by any means, electronic, mechanical, photocopying, recording or otherwise without the prior written permission of CIPHERLAB CO., LTD. For product consultancy and technical support, please contact your local sales representative. Also, you may visit our web site for more information. The CipherLab logo is a registered trademark of CIPHERLAB CO., LTD. Microsoft, Windows, and the Windows logo are registered trademarks of Microsoft Corporation in the United States and/or other countries. Bluetooth is a trademark of Bluetooth SIG, Inc., U.S.A. Other product names mentioned in this manual may be trademarks or registered trademarks of their respective companies and are hereby acknowledged. The editorial use of these names is for identification as well as to the benefit of the owners, with no intention of infringement. CIPHERLAB CO., LTD. Website:

3 RELEASE NOTES Version Date Notes 2.22 Nov. 01, 2010 Modified: Introduction Getting Started, add Using FTP Server to Transfer Files Modified: Introduction Menu Bar, add FTP Communication Settings, WLAN Communication Settings and FTP File Settings Modified: Counter Modified: 7.3 Mobile Link update screenshots Modified: View Link Status 8000/8300 supports Auto Upload Modified: Change Data File Settings update Auto File Name Modified: Appendix II change Negative Barcode to Enable by default 2.21 Sep. 13, 2010 Modified: Getting Started, Upload Data describe icons indicating support of auto upload Modified: DBF File Location (8400 Only) Modified: 3.8 Action When the Format of Record Is Wrong New: 7 Utilities Modified: 7.4 SD DBF Converter (8400 Only) Modified: Appendix I~IV add more GS1 DataBar symbologies 2.20 Apr. 02, 2010 Modified: Introduction Getting Started, Menu Bar, Toolbar and Menu Tree Modified: Installing FORGE Application Generator DATA_READ utility also synchronizes date/time on every host connection. Modified: Getting Started (1) add Upload Application Template (2) Download Lookup Files (file path changed to \AG\DBF for lookup files) Modified: Menu Bar (1) DBF Converter (file path changed to \AG\DBF for lookup files) (2) DATA_READ utility also synchronizes date/time on every host connection. Modified: Field Data Decimal Places Modified: Enable MSQI Modified: Trim Space When Lookup Data Can Be Uploaded Modified: Download Method AG8400 (file path changed to \AG\DBF for lookup files) Modified: 5.2 Function Key Setting update screenshot, etc. Modified: Upload.AGX change 6-digit password to 5-digit Modified: Appendix IV 2D Scan Engine update 2.19 Nov. 19, 2009 New: support D Modified: Upload & Download Settings Buzzer Volume changed to LARGE_VOL Modified: Appendix IV Chinese 25, Matrix 25, Picklist Mode, 1D Inverse, 2D Inverse, UPU FICS Postal and USPS 4CB/One Code/ Intelligent Mail

4 2.18 June. 25, 2009 Modified: section DBF File Location and section DAT File Location features are added. Modified: section add DBF Converter, download and upload information 2.17 May. 07, 2009 Modified: Convert to 8300 and other 8400 supported features are added Jan. 19, 2009 Modified: 8400 supported features are added Nov. 26, 2008 Applied new GUI screen shots and modified the relative contents July 30, 2008 Modified: sections 6.3 add Use Large Font for Data Browsing for AG8000 and AG8300 Modified: Appendix II~III support replacement of EAN-128 field separator for all scan engines 2.13 Jun. 26, 2008 Modified: section 1.6 Record add remove from lookup and save & remove options Modified: section 3.11 Action When the Input Data Has No Match add remove from lookup and save & remove options Modified: section RFID Reader Automatically enabled after initialization (checkbox removed from UI) New: Long Range Laser option available for Nov. 06, 2007 Modified: section RFID Reader RFID tags in proximity will be read automatically by 8300/8500 when RFID reader is enabled 2.11 Oct. 18, 2007 Modified: Features 2.10 Sep. 19, 2007 New Word template applied 2.07 June 20, 2006 Company name changed to CIPHERLAB CO., LTD. since April 2006 Modified: section 5.3 Barcode & Parameters 2.06 Apr. 14, 2006 Modified: section Font_12x12 not supported Modified: sections 5.1 & Modified: sections 6.2, 6.4 & Apr. 10, 2006 AG for CPT-8500 is included

5 CONTENTS RELEASE NOTES INTRODUCTION... 1 Intended Purpose... 2 Features... 2 Installing FORGE Application Generator... 3 Getting Started... 4 Download AG Runtime... 4 Design Application Template... 5 Download Application Template... 6 Download Lookup Files... 6 Collect & Edit Data... 6 Upload Data... 7 Upload Application Template... 8 Localization... 8 Using FTP Server to Transfer Files... 9 FTP Communication Settings...10 WLAN Communication Settings...11 WLAN Security Settings...12 FTP File Settings...14 Menu Bar...16 Preference...18 AGX Template Conversion...19 Recent File List...21 Language...21 Toolbar...22 Menu Tree...22 FORM Select a Form Properties Esc Next Record Enable MSQI Font Size Lookup (File) Date & Time Stamp Branch Reset Current Form Data Type Nil Text Letter...31

6 FORGE Batch Application Generator User Guide Alphameric Integer Real Auto (+/-) Extension Pass down Boolean Lookup Fixed Data Prompt Pause Counter Prompt Input Type Minimum Length Maximum Length Input via Barcode/RFID Reader Input via Keypad Variables Lookup (Field) Variables More Field Data Barcode Input...42 MENU To Select a Menu Properties Menu Caption ESC Font Size Data Save Caption Save Selected Item Pass Down Save Collected Data for Each Form to Separate Data Files Item Name Next Reset Current Menu...48 LOOKUP To Select a Lookup File Field Property Number of Fields Fixed Length Delimiter DBF File Location (8400 Only) Lookup Data...52

7 FORGE Batch Application Generator User Guide Only Read Data Once Lookup Data Can Be Uploaded Trim Space When Lookup Data Can Be Uploaded Action When the Input Data Has No Match Continue Show Warning Message Insert to Lookup File Show Warning Message & Insert Clear the Screen Show Warning & Clear Screen Offset (Max) Length Key Field Action When the Format of Record Is Wrong Stop the Download Process Truncate / Reformat the Record Skip the Record Reset Current Lookup File...58 SYMBOLOGY Reader Settings Code ID Reset Barcode & Parameters...60 SETTINGS Initial Setting Data Manipulation Keypad & LCD Notification Reader Option Upload Method Download Method Baud Rate & Modem Speed Reset Settings Function Key Setting Security Setting Security Checking Upload.AGX...70 STARTUP Application Start From Prompt Font Size Data Field Properties Number of Delimiter Browse data font size DAT File Location Redefine Prompts & Messages Import Prompts & Messages...73

8 FORGE Batch Application Generator User Guide 6.6 Reset Prompts & Messages to Default...73 AG UTILITIES Download Utilities AG Load DLookup ProgLoad Upload Utilities Data_Read AGX_Read Mobile Link Prerequisites Menu Bar & Toolbar View Link Status View Received Files View Device Information Change Connection Settings Change Data File Settings SD DBF Converter (8400 Only) Program Simulation SCAN ENGINE SETTINGS Symbologies Supported RFID Tags Supported CCD/LASER SCAN ENGINE Reader Settings Table Symbology Settings Table LR/ELR LASER SCAN ENGINE Reader Settings Table Symbology Settings Table D SCAN ENGINE Reader Settings Table Symbology Settings Table D Symbologies D Symbologies...133

9 INTRODUCTION FORGE Application Generator for 8000/8300/8400/8500 Series Mobile Computers, featuring easy-to-use and quick-to-apply, is designed for the users to develop custom templates for the use with AG runtime preloaded on the mobile computers. Users are then able to define their own data collection templates on any desktop computer without spending time writing any program code. FORGE Application Generator is used to develop applications for many purposes, such as Receiving in Retail Price Check Product labeling & Tracking Shelf Product Replenishment Mobile Point of Sale (POS) Mobile Inventory Management Order Picking & Staging Work-In-Process Tracking Material Flow Control Transportation & Distribution Warehousing Asset Management FORGE Application Generator presents itself as a miniature image of the mobile computer. It simulates the program s running sequences on the actual mobile computer, and therefore, allows you to design a new application on screen in minutes. After having configured and saved your template, download the application template file and lookup file(s) to the mobile computer. When running the AG runtime on the mobile computer, data collection can commence immediately by making use of the template downloaded. This manual serves to provide comprehensive understanding of FORGE Application Generator for 8000/8300/8400/8500 Series Mobile Computers, and helps define custom template for a specific application. We recommend that you read the document thoroughly before use and keep it at hand for quick reference. Thank you for choosing CipherLab products! 1

10 FORGE Batch Application Generator User Guide INTENDED PURPOSE Data collection mainly consists of three elements: input (scanning or key-in), data processing, and output (or updating database). FORGE Application Generator for 8000/8300/8400/8500 Series Mobile Computers is specifically designed to deal with the sequences of data processing inside the mobile computers. You may use the Batch AG program and runtime with any wireless mobile computer if wireless connectivity is not desired. In particular, when you use a Bluetooth mobile computer, say 8062 or 8330, you will be able to use Bluetooth SPP for download and upload by selecting RS-232/IrDA/USB VCOM. FEATURES Definition of program flow Editing of screens and data Managing barcode reader and RFID reader Font size options and program localization Simple program simulation for debugging Password-protected user settings to prevent unauthorized user intervention Hot key selection for tasks or user settings menus Definition of system initial settings for a quick start Easy cloning by downloading the template file Integrated interface for downloading lookup files and uploading data FTP client configuration for wireless mobile computers, as well as for 8400 used with Ethernet Cradle 2

11 Introduction INSTALLING FORGE APPLICATION GENERATOR Install FORGE Application Generator for 8000/8300/8400/8500 Series Mobile Computers from the Product CD. If you did not change to install to a different folder, it will install the application to the default directory C:\CipherLab\Forge\Batch\. Shortcuts to the AG program is created and placed in Start All Programs CipherLab Forge Batch Application Generator. Shortcuts to the AG utilities are created and placed in Start All Programs CipherLab Forge Batch Utilities. Refer to AG Utilities. Shortcut Name of Utility Program Name Usage AG_Load AG_Load.exe To download the current application template to the mobile computer. Data_Read Data_Read.exe To receive data via Data_Read utility. It also synchronizes date/time on every host connection. DBF_Converter DBF_Converter.exe To convert text file into DBF file. DLookup DLookup.exe To download associated lookup file(s) to the mobile computer MobileLink MobileLink.exe To receive data from the mobile computer via Mobile Link utility. Prog_Load ProgLoad.exe To download the AG runtime or font file (.SHX) to the mobile computer. Simulator Simulator.exe To launch the simulator. AGX_Read AGX_Read.exe To upload the current application template from the mobile computer. 3

12 FORGE Batch Application Generator User Guide GETTING STARTED 1) Run the 8 Series Batch AG program on your computer. The work area appears as shown below, and each element is described in the following sections. Menu Bar Toolbar Menu Tree DOWNLOAD AG RUNTIME 2) Click Transfer Send Program to download the AG runtime program (U8*.SHX) to the mobile computer. Refer to Localization for downloading font file. On the mobile computer, press [7] + [9] + [Power] simultaneously to enter System Menu Load Program. Note: Make sure the download settings on the mobile computer and PC side are matching. 4

13 Introduction DESIGN APPLICATION TEMPLATE 3) Click File New or File Open to work on a new or existing application template. An application template is composed of six tabs; each is a property page for custom configurations. From the tree list on the left pane, click new or the latest application template. to start your configuration for a Warning: On the Settings tab, you must select the correct barcode reader in the initial setting page even though no modification is made to its settings. Otherwise, it will indicate "wrong reader type" after downloading the template file to the mobile computer and cause the reader to fail! Property Pages Startup Settings Symbology Menu Lookup Form You may configure program sequences and customize user interface on the mobile computer. You may configure system settings so that they will take effect when initialization is done on the mobile computer. You may configure symbologies and barcode parameters. Menus are used to provide multi-level options, which may be placed under the main menu, e.g. 1. Collect Data Menu 1 (Menu 2) Form 1. Data of forms may make reference to one or up to 3 lookup files. You need to specify the data format of a lookup file. Forms are used to show information and allow for data input, which may be placed under a user menu, e.g. 1. Collect Data (Menu 1) Form 1. 4) Upon completion, click File Save or File Save As to save the current editing template to file (.AGX). You may run program simulation and verify whether these program sequences meet your requirements. Refer to 7.5 Program Simulation. Note: For initial downloading of the application template, you must manually configure the download settings on the mobile computer. Then, the upload and download interface settings on the mobile computer will be overwritten by the settings of the application template after downloading. 5

14 FORGE Batch Application Generator User Guide DOWNLOAD APPLICATION TEMPLATE 5) Establish a proper connection between your mobile computer and the host. 6) Click Transfer Send Application to download the template file (*.AGX) to the mobile computer. On the mobile computer, select 3. Utilities 6. Load Application to download the template file. After downloading, the main menu is displayed. Warning: In the application template file, the upload and download interface settings for the mobile computer and PC side must match. Note: SD Card option is provided for 8400 to download template file (.AGX) from the card. The default import directory is \AG\IMPORT for template file, which will be created on SD card automatically. When using AG program version or later to create and download a template file, it may be configured to allow uploading the template file from the mobile computer at a later time. Refer to Upload Application Template and Upload.AGX. DOWNLOAD LOOKUP FILES 7) If any lookup file is specified in use in the template file, you must download the lookup file(s). Refer to section 1.4 Lookup (File) and 3 Lookup. Click Transfer Send Lookup to download up to three lookup files for use. Alternatively, you may use the DLookup.exe utility to download text files for reference purpose. On the mobile computer, select 3. Utilities 8. Load Lookup File to download the associated lookup file(s). After downloading, the main menu is displayed. Note: SD Card option is provided for 8400 to download lookup files from the card. The default import directory is \AG\DBF for lookup files, which will be created on SD card automatically. Refer to 7.4 SD DBF Converter (8400 Only). Before you download the lookup files, you must use the DBF converter tool to convert text files (.TXT) to DBF format (.DB0). It will automatically copy these files to the import directory \AG\DBF on either SD card or SRAM. COLLECT & EDIT DATA 8) On the mobile computer, select 1. Collect Data to start with the data collection task. 9) On the mobile computer, select the following submenus if you want to edit the collected data 3. Utilities 2. Browse Data 3. Utilities 3. Delete Data (Refer to section Data Manipulation.) 6

15 Introduction UPLOAD DATA 10) Click Transfer Receive File via Direct-Link or Transfer Receive File via Net to receive the collected data (.txt) from the mobile computer. On the mobile computer, select 2. Upload Data to send the collected data back to the host. Data file(s) Lookup file(s), if any in use All (one by one) All (append), that is, all-in-one Refer to section Record and Lookup Data Can Be Uploaded. If no lookup files are defined on both the Form and Lookup property pages, you may receive data from the mobile computer via the Data Read utility. Note: (1) Batch AG supports automatically uploading data to a host computer when the upload interface is properly configured. Once the mobile computer is seated in the cradle or connected via the RS-232 or USB Virtual COM cable, there will be a running dot or hourglass icon displayed on the upper-right corner of the screen, indicating the mobile computer is ready for auto upload. Refer to Data_Read. (2) SD Card option is provided for 8400 to upload DAT files and DBF files to SD card. The files will be saved to the default directory \AG\EXPORT, which will be created on SD card automatically. 7

16 FORGE Batch Application Generator User Guide UPLOAD APPLICATION TEMPLATE When using AG program version or later to create and download a template file, it may be configured to allow uploading the template file from the mobile computer at a later time. Refer to Upload.AGX. 1) Establish a proper connection between your mobile computer and the host. 2) Click Transfer Receive Application to upload the template file (*.AGX) from the mobile computer. On the mobile computer, stay in the main menu or select 3. Utilities to upload the template file. Warning: The upload interface settings for the mobile computer must match the setting of AGX_Read.exe on PC side, either Cradle-IR or RS-232/IrDA/USB VCOM. LOCALIZATION If you want to customize the entire application to your local language, you must translate the text of the user interface into your own language, as well as re-define menus and messages for the runtime. 1) Click Transfer Send Program to download the desired font file (.SHX) to the mobile computer. On the mobile computer, press [7] + [9] + [Power] simultaneously to enter System Menu Load Program. 2) Save the original language file (.lng) of the AG program as a new file - translate the text of the user interface from English to another language. 3) Click Language from the Menu Bar and select this new.lng file for the current language. 4) Re-define the template prompts and messages on the Startup property page of the application template. For 8000/8300, apply large font on the Form and Menu property pages for double-byte languages such as Japanese, Chinese, etc., so that their contents will be displayed properly on the actual screen. However, the rest of prompts and messages can only be displayed in alphanumeric characters in the current system. 5) Click Transfer Send Application to download the template file (.AGX) to the mobile computer. 6) Turn on the mobile computer to run the AG runtime program (U8*.SHX). Select 3. Utilities 6. Load Application to download the template file. 8

17 Introduction USING FTP SERVER TO TRANSFER FILES When using AG program version or later to create and download a template, it may be configured to allow transferring files with an FTP server wirelessly or via Ethernet Cradle. The FTP client configuration is provided for the mobile computer to log in to a FTP server for the following tasks: Update the script file Upload or download lookup files (version control with downloads) Upload data files 9

18 FORGE Batch Application Generator User Guide FTP COMMUNICATION SETTINGS Server IP or Name Specify the IP address or name of the FTP server. Port Specify the remote port number. By default, TCP port 21 is used on the server for the control connection. User Name Specify the user name for logging onto FTP server. Password Specify the password for logging onto FTP server. FTP Communication Interface Options WLAN Ethernet Cradle 10

19 Introduction WLAN COMMUNICATION SETTINGS Enable DHCP By default, DHCP server is enabled and all the settings can be obtained from it. If DHCP server is disabled, you must provide the following information Subnet Mask Gateway DNS Server Terminal IP SSID This refers to Service Set ID or Identifier, which serves to uniquely identify a group of wireless network devices used in a given Service Set. For example, you need to specify the same SSID here as is used for access points so that the mobile computer can associate to the access points. SSID can be made up of 32 characters maximum. Security Authentication and encryption help provide data protection on the b/g network. Refer to WLAN Security Settings. 11

20 FORGE Batch Application Generator User Guide WLAN SECURITY SETTINGS Authentication Two types of network authentication methods are supported: Open System and Shared Key. Setting Open System Shared Key Remark Using Open authentication, any wireless station can request authentication. The station that needs to authenticate with another wireless station sends an authentication management frame that contains the identity of the sending station. The receiving station or AP will grant any request for authentication. Open authentication allows any device network access. If no encryption is enabled on the network, any device that knows the SSID of the access point can gain access to the network. Using Shared Key authentication, each wireless station is assumed to have received a secret shared key over a secure channel that is independent from the b/g wireless network communications channel. Shared key authentication requires that the client configure a static WEP key. The client access will be granted only if it passed a challenge based authentication. Note: For Shared Key authentication, the active WEP key is used for authentication. 12

21 Introduction EAP Select the check box to enable authentication using Extensible Authentication Protocol (EAP). It requires user name and password so that the mobile computer can identify itself when associating to Cisco access points. Setting Identity Password Remark Specify a user name. (32 characters maximum) Specify a password. (32 characters maximum) WEP Key Select the check box to implement Wired Equivalent Privacy or Wireless Encryption Protocol (WEP) for data encryption. Setting Key Length Key 1 ~ 4 Active Remark Encryption type can be 64 bits (5 bytes) or 128 bits (13 bytes). Using 64-bit encryption, the password phrase can be 5 characters long. From the Grid Control, select up to 5 characters (ASCII codes) for the WEP key. For 128-bit encryption, the password phrase can be 13 characters long. From the Grid Control, select up to 13 characters (ASCII codes) for the WEP key. Key index number. Up to four WEP keys can be configured. Only one key (the active one) can be used at a time. Note: You must use the same settings as configured for other devices on your wireless network, e.g. access points. WPA-PSK/WPA2-PSK Passphrase WPA-PSK is supported to enhance security over wireless networks, and this Pre-Shared key mode requires a passphrase to access the network. The passphrase must be 8 to 63 characters (ASCII codes). It is used to generate a WEP key automatically. For 8400, it also supports WPA2-PSK! 13

22 FORGE Batch Application Generator User Guide FTP FILE SETTINGS Download Script File Decide whether to download any update to the script file FTP.dat, if there is any, from FTP server. Create Script File Decide whether to create the script file FTP.dat and save the related settings with it on your computer. The file name FTP.dat is reserved for the script file. The file name must be uppercase while the file extension must be lowercase. 14

23 Introduction Data File Settings Decide which data files are to be uploaded to FTP server. Instead of using the default file name DATAF1~DATAF10, you may change it if necessary. The maximum length of a full-path file name is 255 characters. If file path is not specified, the data file will be uploaded to the root directory on FTP server. Lookup File Settings Decide whether to download or upload any lookup files. When Download is enabled for a lookup file, Upload is enabled automatically by default. Cancel the check box of Upload if necessary. When Download is enabled for a lookup file, you may apply version control if necessary. Uploads will be saved to the root directory on FTP server, with the file names DBF1.txt~DBF3.txt. Downloads will be saved to SRAM or SD in DBF format, depending on the Lookup settings. 15

24 FORGE Batch Application Generator User Guide MENU BAR The Menu Bar contains a number of menus that specify which task you want the system to perform. Each menu contains a list of commands and sometimes sub-menus. For the provided tools, refer to AG Utilities. Menu Command Action File New To create a new application template. Open Save To open an existing application template. File path needs to be specified. To save the current editing template. Save As To save the current editing template to a new file. Preference To configure the software settings. Refer to Preference. Convert to 8xxx To convert the AGX Template for another model of 8 Series product line. Refer to AGX Template Conversion. Recent File List Exit To quick launch the recently opened template file. Refer to Recent File List. To close the Application Generator. Transfer Send Program Send Application Receive Application Send Lookup To download the AG runtime or font file (.SHX) to the mobile computer. To download the current application template to the mobile computer. To upload the current application template from the mobile computer. You must provide the matching password. Refer to Upload Application Template and Upload.AGX. To download associated lookup file(s) to the mobile computer. Receive File via Direct-Link To receive data via Data_Read utility. It also synchronizes date/time on every host connection. 16

25 Introduction Receive File via Net To receive data from the mobile computer via Mobile Link utility. FTP Settings Communication To specify IP address of FTP server, remote port number, user name/password for logging onto FTP server. Refer to FTP Communication Settings. WLAN Settings Communications To specify wireless networking settings for 8071, 8330/8370, or Refer to WLAN Communication Settings. Tools FTP File Settings Simulator To specify uploads and downloads. Refer to FTP File Settings. To launch the simulator. Language DBF Converter To convert text file into DBF file, for use with SD card on To select a preferred language for the program GUI. Refer to Language. Help About Forge AG To show information about the Application Generator. 17

26 FORGE Batch Application Generator User Guide PREFERENCE Click File Preference and you may configure preferred features for launching the program. Auto pre-load the last editing file You may select the check box so that the last editing file will be loaded upon running the AG program (ForgeAG.exe). Always on top You may select the check box so that the AG program (ForgeAG.exe) and the utilities always remain on top of all other windows on the desktop. 18

27 Introduction AGX TEMPLATE CONVERSION Click File Convert to 8xxx and you may convert the current template for another model of 8 Series product line. The following items will be changed during the converting process: Upload/Download interface will be changed. Prompts & Messages will be changed. Conversion of Upload/Download Interface Conversion between Devices Upload Interface Download Interface Original Target Original Target Original Target Cradle IR Direct-RS232 Cradle IR Direct-RS Direct-RS232 Cradle IR Direct-RS232 Cradle IR Keyboard Wedge 8400 Cradle IR RS232 Cradle IR RS232 Keyboard Wedge USB HID Cradle IR RS232 Cradle IR RS232 IrDA IrDA Bluetooth SPP 19

28 FORGE Batch Application Generator User Guide Conversion of Prompts & Messages on Startup Page The Interface prompts of upload port and download port will be reset to the defaults of the target device. For 8500 series, if you click Convert to 8400, the prompt F8:Edit F9:Del will be changed to 8400 s F8:Edit Del:Del. If you convert the 8300 AGX template to the 8000 AGX template, the prompts which are considered too long will be truncated automatically. Note: For prompts on Form page and Menu Caption/Item Name on Menu page, long strings will be truncated while converting the template from 8300 to

29 Introduction RECENT FILE LIST If you ever saved a template, it will be displayed in the File Menu as well. Up to 4 recent template files are listed for quick access. Click File and choose any of the four files to open the template for editing. It will then be placed on top of the list. LANGUAGE If there is any language file (*.lng) saved in the language folder where the AG program is saved, language options will become available. Click Language and you may select a preferred language for the GUI of the program. Refer to Localization. 21

30 FORGE Batch Application Generator User Guide TOOLBAR The toolbar offers most of the functions provided in the Menu Bar. Click the Icon on the toolbar for a quick launch. Icons Command Description New To create a new application template. Open Save To open an existing application template. File path needs to be specified. To save the current editing template. Send Application Send Lookup To download the current application template to the mobile computer. To download associated lookup file(s) to the mobile computer. Get File via Direct-Link About To receive data from the mobile computer. To show information about the Application Generator. Exit To close the Application Generator. MENU TREE In the work area, a menu tree is displayed on the left pane for navigation. Click "+" to expand the tree or "-" to collapse it. Click an existing item from the tree list. Its contents will be displayed on the right pane. 22

31 FORM Chapter 1 A form is a data collection template with input prompts. Data will be kept as a transaction record after the user completes all the input fields (lines) of a form. Then, it can be saved in a transaction file, added to its lookup database, or directly output to a printer, etc. Each form allows at most eight input fields (8 lines). Ten different forms can be defined. The attributes on this property page are explained in detail as follows

32 FORGE Batch Application Generator User Guide IN THIS CHAPTER 1.1 Select a Form Properties Font Size Lookup (File) Date & Time Stamp Branch Reset Current Form Data Type Prompt Input Type Minimum Length Maximum Length Variables More SELECT A FORM Select a form to start with. Usually "Form 1". Form 1 ~ PROPERTIES ESC Select a form or menu that will be displayed when you press the [ESC] key on the mobile computer. For settings of user menus, refer to the Menu property page. Main Menu Form 1 ~ 10 Menu 1 ~ 10 Note: Normally, the [ESC] key is used to return to a previous form or menu NEXT Select a form or menu that will be displayed when the last input field of the current form has been completed. For settings of user menus, refer to the Menu property page. Main Menu Form 1 ~ 10 Menu 1 ~ 10 This function is invoked by sending the key value of [Enter] when you finish with the last input field. And, the setting of section 1.10 Input Type decides the way to produce the key value of [Enter]. 24

33 Chapter 1 Form Input Source of the last line Operation Reader Auto ENTER for barcode input must be configured as "Scan + ENTER". Refer to section 1.14 More. Keypad Both RFID All Press the [Enter] key on the 8000/8300/8400/8500 Series mobile computer. See the two options above. Press the [Enter] key on the 8300/8500 Series mobile computer. See all the options above RECORD Select which action to take as soon as the input fields of a form have been completed. Options Save Update lookup Save & update Pass down Output record Output screen Save & output record Save & output screen Remove from lookup Action... To save the record to a sequential data file. To update the lookup file associated with the form. To save the record to a sequential data file, and update the lookup file. To pass down data to the next form or menu without saving. To output the record directly to a printer through COM port instead of saving it to a file. Similar to "output record". To output what is displayed on the screen, such as the prompts and data collected. To save the record to a sequential data file and output it directly to a printer through COM port. To save the record to a sequential data file and output what is displayed on the screen. To remove the record from the lookup file. Save & remove To save the record to a sequential data file and remove it from the lookup file. Note: Instead of saving all the collected data to a data file, you may select to save the collected data for each form to separate data files on the Menu property page. Based on the selected option of Record and section Lookup Data Can Be Uploaded, you can upload data file(s) or lookup file(s), or both files ("All, one by one"), or even merge them to a new file ("All, append"). Note: The uploaded file is a sequential file. 25

34 FORGE Batch Application Generator User Guide Data file: This is available only when you have selected "save", "Save & update", "Save & output record", "Save & output screen", or Save & remove for Record. Lookup file: This is available only when you have specified a lookup file in use and allowed it to be uploaded. On the mobile computer, select 2. Upload Data after you have completed the data collection task and establish a proper connection with the host. Warning: If you have selected "output record" or "output screen" for Record, 2. Upload Data on the mobile computer will become unavailable ENABLE MSQI When the Multiple Scan Quantity Incrementing (MSQI) function is enabled, the form is set to be processed again and again until you press the [ESC] key on the mobile computer. Data will be saved to a data file. Line 1 is set to text for data type. If a lookup file is specified in use, the lookup field will be automatically set to the key field. Line 2 is set to MSQI for data type. By default, the initial value is 0 ; you may specify a value instead. If a lookup file is specified in use, the initial value depends on the lookup field you select. If a lookup file is specified in use, you may specify to import more information (line #3~) from the lookup file and display it on the mobile computer. 26

35 Chapter 1 Form The process designed in Form 01, as shown above, will repeat as long as you are scanning barcodes. When you keep scanning the same barcode, it will accumulate the value for Qty field by one for each scanning. When you scan a different barcode, it starts all over again with accumulating the quantity of this new item. Data for the previous item will be saved as a transaction record! Below is the process flow explaining how MSQI function works. 1) Scan a barcode for an item. (line #1) 2) The lookup value will be displayed as the initial value. (line #2) (If no lookup file is specified in use, the pre-defined initial value will be displayed.) 3) Scan the barcode again, and it will accumulate the value by 1. 4) You may keep scanning barcodes for different items. Repeat step 2 and step 3. Data for the previous item will be saved automatically. Take the scanning in step 3 for example, data for the quantity field saved with this transaction record is the value displayed on the screen, say 3 for this case. 5) Press [ESC] to end the scanning task. You are required to input a track number. Enter a number if necessary; otherwise, click [Enter] to skip it. 27

36 FORGE Batch Application Generator User Guide Note: Alternatively, if you have a large number of the same item, you may manually input the quantity, say 30. It will override the previous scanning of this item. Press [ESC]. Data for the quantity field saved with this transaction record is FONT SIZE Large font (8x16) must be applied for double-byte languages, such as Chinese, Japanese, etc. On the Form and Menu property pages, font size needs to be changed accordingly. Refer to Localization and 2.3 Font Size. Mobile Computer Small (Font 6x8) Large (Font 8x16) 8000 Series 16 characters by 8 lines (default) 12 characters by 8 lines 8300 Series 20 characters by 8 lines (default) 15 characters by 8 lines 8400 Series N/A 20 characters by 8 lines 8500 Series N/A 20 characters by 8 lines Note: This setting is not available for 8400/8500 Series because it must use large font. 1.4 LOOKUP (FILE) A lookup file is a database. Select whether or not a lookup file is associated with the form. If a lookup file is used, its data format must be defined on the Lookup property page. On this property page, the following settings must be configured: section 1.8 Data Type section 1.4 Lookup (File) section Lookup (Field) Note: The associated lookup file(s) must be downloaded to the mobile computer. 28

37 Chapter 1 Form 1.5 DATE & TIME STAMP It may be helpful in analyzing data when the date and time information is joined in each record. Stamp Position You can select whether or not to enable the stamp function and include the date/time information, either to the beginning or to the end of a record. By default, date/time information is separated into two fields by inserting a character, (comma). Date & Time Format Select the format of the Date and Time stamps. To stop the use of either stamp, clear all the associated settings. 29

38 FORGE Batch Application Generator User Guide 1.6 BRANCH Normally, a form is to be followed by either another form or menu. This feature is provided when a form is designed to lead to more than one other form. Also, it allows the linking to another form, which may jump over a number of forms or menus. Up to four branches are provided through the use of function keys. Take the following illustration for example. Note: Data cannot be passed down through branches. 1.7 RESET CURRENT FORM Press this button to reset current form to default. 30

39 Chapter 1 Form 1.8 DATA TYPE Specify the data type line by line to address your application requirements. The associated settings for each data type are marked in the table below. Data Type Prompt Input Source Length Lookup Properties on-screen saved in record Min / Max Field More... nil text letter alphanumeric integer real auto (+/-) extension pass down boolean lookup User-definable fixed data prompt pause counter NIL No data input is allowed. This is the default setting. There will be single line spacing on the mobile computer screen TEXT ASCII character any character is acceptable. For example, $1a2b3c=-*/ LETTER Alphabetic character any letter is acceptable, capital or small (Aa ~ Zz). 31

40 FORGE Batch Application Generator User Guide ALPHAMERIC Any alphabet or number is acceptable. For example, ABC123xyz INTEGER Whole number - any number is acceptable, such as -2, -1, 0, 1, REAL Read number any number with a decimal representation is acceptable, rational or irrational. For example, 4.56 When integer or real is selected along with lookup field specified, the lookup value will be first displayed in the input field on the mobile computer screen. Then, data input is allowed. Lookup (field) Field 1 ~ 8 +Field 1 ~ 8 If you select "Save & Update" for Record... The input value will overwrite the lookup value. No arithmetic operations are performed. It will automatically add the input value to the lookup value. - Field 1 ~ 8 It will automatically subtract the input value to the lookup value. 32

41 Chapter 1 Form AUTO (+/-) This is similar to data type integer, except that the lookup value is displayed before the input field. There may be an arithmetic sign (+, -) in front of the input field, which depends on the setting of the lookup field. 33

42 FORGE Batch Application Generator User Guide EXTENSION No data input is allowed. The line needs to be reserved as an "extension" of the previous line so that the whole input data can be displayed on the mobile computer screen. Note: The number of extension lines depends on the maximum length of your data and the screen size of the mobile computer. Take the following for example If the screen of the mobile computer allows 20 characters per line for small font, Now the prompt string ("Description:" in line 2) takes 13 characters, and the data length is 15 characters at most. This makes the total length 28 characters at most, which is longer than one line. As a result, the data type of line 3 needs to be set "extension" if you want to display the input data in full PASS DOWN No data input is allowed. Data of this line may be imported from a previous form, of which the setting of Record is specified as "pass down". When one line is not enough for displaying the inherited contents, set its following line(s) to be an "extension". Or, it may be imported from a menu, of which the setting of Data is specified as "pass down". Note: This data type is used to combine a number of forms so that they can be saved as one record. 34

43 Chapter 1 Form BOOLEAN Only one of these sets of values are acceptable - "0 or 1", "Y or N" and "T or F". If you input a value other than the above ones, a message will be displayed on the mobile computer to indicate "Data type is wrong!" LOOKUP No data input is allowed. When data of a previous input field is found matching with the "key field" of a lookup file, data of this input field will be imported from its associated lookup field. By default, the imported data will not be saved in the transaction record. In section 1.14 More as shown below, you may select Save field data. Note: The lookup value is imported for reference. No change is allowed FIXED DATA No data input is allowed. The prompt string will be saved as part of the transaction record PROMPT No data input is allowed. The prompt string will not be saved. 35

44 FORGE Batch Application Generator User Guide PAUSE No data input is allowed. The prompt string will not be saved. However, it will be highlighted constantly on the mobile computer to catch your attention COUNTER No data input is allowed. Instead of being displayed on the screen only, now it can be saved with the input data. Normally, the record count starts from (7 digits for 8000/8300/8400, but only 5 digits for 8500). However, when a menu appears before the form starts, and you have configured to save the menu caption, the last digit of record count with the field will change from 0 to 1. You may find the record count in other places: Along with the main menu, the record count will be displayed on the bottom of the screen (next to date and time) on the mobile computer. By default, it is set to display the record count upon completion of data input. Refer to Data Manipulation for Entry Options When the field is set to show counter, the current record count will be displayed in seven digits, starting from However, the counter displayed in the main menu is slightly different, as explained below. Record Count Range: 0000 ~ 9999 Record Count Range: ~ Record Count Range: >0000 ~ >9999 (= ~ ) 8300 When the field is set to show counter, the current record count will be displayed in seven digits, starting from The counter displayed in the main menu is as shown below. 36

45 Chapter 1 Form 8400 When the field is set to show counter, the current record count will be displayed in seven digits, starting from The counter displayed in the main menu is as shown below When the field is set to show counter, the current record count will be displayed in five digits, starting from However, the counter displayed in the main menu is seven digits, as shown below. 37

46 FORGE Batch Application Generator User Guide 1.9 PROMPT Specify a prompt string for a specific input field, if necessary. Note: Unless data type of a line is "fixed data", a prompt string will not be saved in a transaction record INPUT TYPE Specify from which source data can be collected. Reader Keypad Both RFID All (only applicable to 8300, 8500 Series) (only applicable to 8300, 8500 Series) Upon completion of one input field, it is necessary to press the [Enter] key on the mobile computer. Then, it will move either to the next input field, or to the next form or menu. When the input source is specified to "reader" only, you need to enable "Auto ENTER" for barcode input settings in section 1.14 More. Note: When "RFID" is selected, you may still press the [ESC] or [Enter] key to cancel or confirm a task. The rest keys on the keypad are disabled MINIMUM LENGTH Specify the minimum length of an input field. If the input data is shorter than specified, it will be considered unacceptable. A warning message will be displayed to indicate "Data is too short!" 38

47 Chapter 1 Form 1.12 MAXIMUM LENGTH Specify the maximum length of an input field. The value can be 80 at most in 8000/8300 and 160 at most in 8400/8500. You can facilitate data input by showing input marks on the screen. In section 1.14 More, select Show input mark. The number of input marks equals to the maximum length specified here. If the input data is longer than specified, it will be considered unacceptable INPUT VIA BARCODE/RFID READER For data input from the barcode or RFID reader, a warning message will be displayed when data is too long INPUT VIA KEYPAD For data input from the keypad, it will be allowed even though data has become longer than the screen can display. Take the scenario below for example. The screen of the mobile computer allows 20 characters per line for small font. Each prompt string takes 12 characters. Line Input from Keypad Screen Reading Transaction Record # ABCDE E E #3, A A A #5, LEMONADE LEMOE LEMOE #7, ORANGE_JUICE ORANGE_JUICE ORANGE_JUICE 39

48 FORGE Batch Application Generator User Guide 1.13 VARIABLES If there is no lookup file in use, this feature will be Variables. Refer to section 1.4 Lookup (File) LOOKUP (FIELD) If a lookup file is in use, you need to specify the corresponding lookup field line by line. For each lookup file, there will be a key field. Normally, the "key field" is Field #1. When an input field makes reference to the key field and its input data is found matching, data for its following input fields will be imported from each corresponding lookup fields. For those data types other than integer, real, and auto (+/-), see left below. For data types integer, real, and auto (+/-), see right below. When an arithmetic sign (+, -) is prefixed to the lookup field, the input data will be added or subtracted from the lookup value. Lookup Field for data type other than integer, real, auto (+/-) Lookup Field for data type: integer, real, auto (+/-) VARIABLES If there is no lookup file in use, it will provide variables, which can be accessed by different forms. For example, Select set v1 for input field #1 of form 1, and its input data will be saved in the first character array. Select get v1 for input field #3 of form 2, and the previous input data will be imported. Select get&set v1 for input field #3 of form 2, the previous input data will be imported and then updated. 40

49 Chapter 1 Form 1.14 MORE Specify field properties if necessary FIELD DATA Fixed Data Length Select the check box. The data length will be fixed to the value specified here. If the input data is longer, it will be truncated and saved to transaction record. When browsing data, the truncated data will be displayed on the screen. If the input data is shorter, "Space" or "0" will be added in front of or to the end of the data based on either "Left" or "Right" alignment. Below are some examples. Fixed data length Alignment Input data Transaction record 4 Left aligned / space Right aligned / space Left aligned / Right aligned /

50 FORGE Batch Application Generator User Guide Initial Value or Text Select the check box. An initial value or text, up to 9 characters, specified here will be shown in the input field. It is to be replaced by input data. For example, it can be used to prompt an initial value for quantity. Add Prefix Code Select the check box to prefix a code to the input data. Click the editing box next to it, and select one or more codes from the Grid Control (ASCII codes). For example, a dollar sign ("$") can be added to the front of the data input for price. Add Suffix Code Select the check box to suffix a code to the input data. Click the editing box next to it, and select one or more codes from the Grid Control (ASCII codes). Instead of using delimiters in section 6.3 Data Field Properties, you may use prefix and/or suffix codes to separate each entry of input data. Note: You may use prefix/suffix code to wrap the input data. Show Input Mark Select the check box to show input marks, such as underline (_) or asterisk (*), which is to be replaced by input data. The number of input marks shown on the screen equals to the maximum length of data specified in section 1.12 Maximum Length. Decimal Places A decimal place is the position of a digit to the right of a decimal point. When the data type is real, you may need to specify its decimal places. By default, it is set variable to accept all real numbers. For example, 4 is selected for decimal places, however, there are only 2 decimal places in the input number, say "8.12". To follow this rule, the system will save the input data as "8.1200". If you try to input a number " " via the keypad, it will not allow the input of the fifth decimal digit. Only "8.1234" is considered acceptable and saved to file. If the barcode " " is scanned via the barcode reader, a warning message Incorrect decimal input will be displayed on the mobile computer, and the system will automatically clear the input data and wait for new entry BARCODE INPUT Read Partial Barcode By default, it will return the whole barcode that has been decoded. When the check box is selected, it will return partial barcode according to the settings of the start position and maximum length. Below are some examples. Start position Max. length Barcode scanned Transaction record

51 Chapter 1 Form Check Leading Code The leading code refers to the digit in the start position of a barcode. Select the check box to verify the barcode input. When the leading code is not matching, the barcode will be rejected. Below are some examples. Leading code Barcode scanned Transaction record (Error: code not matching) Read partial code + Check leading code: Start position Max. length Leading Code Barcode scanned Transaction record (Error) Check Digit Verification The check digit refers to the digit in the end of a barcode, as a one-digit derived checksum digit. Select the check box to verify the barcode input. You may apply different modulus 10 or 11 check digit as provided in the drop-down menu. When the check digit is not matching, the barcode will be rejected. Auto ENTER Normally, it is necessary to press the [Enter] key on the mobile computer upon completion of one input field. Then, it will move either to the next input field, or to the next form/menu specified. This function will automatically add a carriage return in front of or to the end of the barcode input. For barcode scanning, it proves to be timesaving when Scan+ENTER is enabled. For a typical application of continuous scanning, it is efficient by making use of ENTER+Scan. 43

52 FORGE Batch Application Generator User Guide 44

53 MENU Chapter 2 A menu is a list of selection items. Up to ten different menus can be defined. Below are the settings for each field of a menu IN THIS CHAPTER 2.1 To Select a Menu Properties Font Size Data Save Collected Data for Each Form to Separate Data Files Item Name Next Reset Current Menu

54 FORGE Batch Application Generator User Guide 2.1 TO SELECT A MENU Select a menu to start with. Usually "Menu 1". Menu 1 ~ PROPERTIES MENU CAPTION Select the check box and specify a caption for the current menu if necessary ESC Select a form or menu that will be displayed when you press the [ESC] key on the mobile computer. Main Menu Form 1 ~ 10 Menu 1 ~ 10 Note: Normally, the [ESC] key is used to return to a previous form or menu. 2.3 FONT SIZE Large font (8x16) must be applied for double-byte languages, such as Chinese, Japanese, etc. On the Form and Menu property pages, font size needs to be changed accordingly. Refer to Localization and 1.3 Font Size. 46

55 Chapter 2 Menu 2.4 DATA Specify how to proceed when a menu item has been selected SAVE CAPTION Save the menu caption to the transaction record if this menu is running SAVE SELECTED ITEM Save the selected menu item to the transaction record if this menu applies PASS DOWN If you have selected to save any of the above items, decide whether or not to pass it to the next menu or form. (No menu caption or item saved to the transaction record.) Save caption & pass down Save selected item & pass down Save both & pass down Note: The selected option(s) will be passed down to an associated form or menu. 2.5 SAVE COLLECTED DATA FOR EACH FORM TO SEPARATE DATA FILES When a menu leads to more than one form, you may select the check box to save the data collected from each form to individual files. The check box of "Pass down" for Data will automatically be selected. That is, the menu caption or selected item name will be saved together with separate forms if you have selected the check box for each. 47

56 FORGE Batch Application Generator User Guide 2.6 ITEM NAME Specify a name for each menu item. It allows up to ten menu items. For example, you may specify "1. Goods In" or "Goods In" (see below) in the first field of Item Name. Caption Item Name Note: Whether you have included Item No. in the name field, you can press [1] on the mobile computer to enter the "Goods In" menu. 2.7 NEXT Select a form or menu that will be displayed when a menu item has been selected. Main Menu Form 1 ~ 10 Menu 1 ~ 10 This function can be invoked by performing one of the following actions on the mobile computer - Press the shortcut key (Item No.) of a menu item, e.g. press [2] to select the second menu item. The form or menu you specified here will be displayed then. Press the [Up/Down] arrow keys to select a menu item, and then press [Enter]. 2.8 RESET CURRENT MENU Click this button to load the default settings. Note: The current settings for all menus will be cleared. 48

57 LOOKUP Chapter 3 A lookup file is a database file created for information reference. Up to three lookup files can be defined. If settings on this property page are specified improperly, it may go wrong when an input field makes reference to its corresponding lookup field. The following settings must be configured: section 1.4 Lookup (File) section Lookup (Data Type) section Lookup (Field) If the default settings remain unchanged for the following items in the AG template file that has been downloaded to your mobile computer, 3. Utilities 8. Load Lookup File will be unavailable. section 1.4 Lookup (File) section 3 Lookup

58 FORGE Batch Application Generator User Guide IN THIS CHAPTER 3.1 To Select a Lookup File Field Property Lookup Data Action When the Input Data Has No Match Offset (Max) Length Key Field Action When the Format of Record Is Wrong Reset Current Lookup File TO SELECT A LOOKUP FILE Select a lookup file you want to define its settings. Up to 3 different lookup files can be specified. Usually start with the "1st Lookup File". 3.2 FIELD PROPERTY Specify the data field settings of the database (lookup file) NUMBER OF FIELDS It must at least cover the referred fields of the database (lookup file). Refer to section Lookup (Field) FIXED LENGTH This is the default setting. Proceed to define related settings - Number of fields Offset Length DELIMITER You may use a delimiter (ASCII code) to separate the data fields. Proceed to define related settings - Number of fields Max. Length If the maximum length of each field is set improperly, you will receive a warning message during downloading. You may fail to download the lookup file, depending on the action specified when the data format is wrong. Refer to the settings of section 3.8 Action When the Format of Record Is Wrong. 50

59 Chapter 3 Lookup DBF FILE LOCATION (8400 ONLY) You may specify where to store the DBF files on the mobile computer. The options are as follows: SRAM SD Card Normally, the lookup files are stored in SRAM. The original lookup files (.TXT) will be automatically saved to DBF format when being downloaded to the mobile computer. SD Card option is provided for 8400, allowing files either to be saved to SD card or to SRAM via the card. You must have the lookup files (.TXT) saved to DBF format first. Refer to 7.4 SD DBF Converter (8400 Only). DBF File Location SRAM Download Method (1) Download to 8400 directly (2) Download to 8400 via SD card: Use DBF Converter to copy files to SD card first. SD Use DBF Converter to copy files to SD card. Note: It takes less time to download lookup files to SRAM via SD card than download to SRAM directly. 51

60 FORGE Batch Application Generator User Guide 3.3 LOOKUP DATA ONLY READ DATA ONCE Normally, it will compare data of an input field and the key field of the lookup file it refers to for as many times as required. Select the check box to compare data for one time only. Data found matching again Data is accepted for the initial match only. When data is found matching again (i.e. data already exist), the record will be rejected. It will clear the screen automatically by default. For 8000/8300/8400, it can be set to show a warning message before clearing the screen. If so, press any key on the mobile computer to clear the screen. No data found matching If this function is enabled, Insert to lookup file will be automatically set in 3.4 Action When the Input Data Has No Match. When no data is found matching (i.e. new data), the record will be inserted to the lookup file. The action can be changed to Show Warning Message & Insert to show a warning message before inserting the record to the lookup file LOOKUP DATA CAN BE UPLOADED This is the default setting. The lookup data can be uploaded from the mobile computer to your computer. On the mobile computer, select 2. Upload Data after you have completed the data collection task and establish a proper connection with the host. Refer to section Record TRIM SPACE WHEN LOOKUP DATA CAN BE UPLOADED When lookup data can be uploaded and a delimiter is used to separate the data fields, you may select the check box to trim space while uploading the lookup file from the mobile computer. 52

61 Chapter 3 Lookup 3.4 ACTION WHEN THE INPUT DATA HAS NO MATCH Choose the appropriate action to take when the input data does not match that of the key field CONTINUE The program will allow data input to proceed without showing any message. Data can only be saved in a data file if you have selected "Save", "Save & update", "Save & output record", "Save & output screen" or Save & remove in section Record SHOW WARNING MESSAGE The program will suspend and a warning message "Data not found!" is displayed on the mobile computer. You will need to clear the input data manually (that is, 9990, in the example below) INSERT TO LOOKUP FILE The program will allow data input to proceed without showing any message. Data will be inserted to the target lookup file if you have selected "Update lookup", "Save & update", Remove from lookup, or Save & remove in section Record SHOW WARNING MESSAGE & INSERT The program will suspend and a warning message "Data not found!" is displayed on the mobile computer. Then, it will resume to data input. Data will be inserted to the target lookup file if you have selected "Update lookup", "Save & update", Remove from lookup, or Save & remove in section Record CLEAR THE SCREEN The program will automatically clear the input data and wait for new entry. 53

62 FORGE Batch Application Generator User Guide SHOW WARNING & CLEAR SCREEN The program will suspend and a warning message "Data not found!" is displayed on the mobile computer. Then, it will automatically clear the input data and wait for new entry. 54

63 Chapter 3 Lookup 3.5 OFFSET This applies to Fixed Length. Specify the start position for each referred data field. 3.6 (MAX) LENGTH When the field property is set Fixed Length, specify the length for each referred data field. The value can be 255 at most. When the field property is set Delimiter, specify the maximum length for each referred data field. The value can be 255 at most. Note: If a delimiter is used to separate data fields, any improper value would cause wrong data format. 3.7 KEY FIELD The import of data depends on the key field. Select your key field so that an index file can be created for the database (lookup file). When a form makes reference to a lookup file, there must be one input field associated with the key field of the database (lookup file). When its input data is found matching with that of the key field, data of other input fields, if referring to a lookup field, will be imported accordingly. If no matching, see section 3.4 Action When the Input Data Has No Match. Note: If offset and length of each field are specified improperly, it may go wrong with data import. 55

64 FORGE Batch Application Generator User Guide 3.8 ACTION WHEN THE FORMAT OF RECORD IS WRONG Depending on whether data fields of the lookup file are separated by fixed length or delimiter, options are provided for handling wrong data format when you download the lookup file to the mobile computer STOP THE DOWNLOAD PROCESS When wrong data format is encountered, a warning message will be displayed on the mobile computer to indicate which line is found format mismatching. The downloading process is stopped then. You will need to correct the data format, for example, remove an empty record (line) at the end of a file. Then, download the lookup file again. Fixed Length Conditions Record length in source file is greater than that specified in.agx Record length in source file is less than that specified in.agx Action Stop download Stop download Delimiter Conditions Number of fields in source file is greater than that specified in.agx Number of fields in source file is less than that specified in.agx Field length in source file is greater than that specified in.agx Field length in source file is less than that specified in.agx Action Stop download Stop download Stop download Allow download Note Note: That specific field will be padded with additional space. 56

65 Chapter 3 Lookup TRUNCATE / REFORMAT THE RECORD When wrong data format is encountered, a warning message will be displayed on the mobile computer to indicate the mismatching part has been fixed, being automatically truncated or reformatted during downloading. For example, the additional fields of a record will be left out. However, you may need to reload the lookup file after the data format has been corrected. Fixed Length Conditions Record length in source file is greater than that specified in.agx Record length in source file is less than that specified in.agx Action Truncate Reformat Note Note: Each field of that specific record will be padded with additional space. Delimiter Conditions Number of fields in source file is greater than that specified in.agx Number of fields in source file is less than that specified in.agx Field length in source file is greater than that specified in.agx Field length in source file is less than that specified in.agx Action Truncate Reformat Note1 Truncate Allow download Note2 Note: (1) It will append additional fields by adding delimiter and space. (2) That specific field will be padded with additional space. 57

66 FORGE Batch Application Generator User Guide SKIP THE RECORD When wrong data format is encountered, a warning message will be displayed on the mobile computer to indicate the mismatching part has been discarded. You may need to reload the lookup file after the data format has been corrected. Fixed Length Conditions Record length in source file is greater than that specified in.agx Record length in source file is less than that specified in.agx Action Skip Skip Delimiter Conditions Number of fields in source file is greater than that specified in.agx Number of fields in source file is less than that specified in.agx Field length in source file is greater than that specified in.agx Field length in source file is less than that specified in.agx Action Skip Skip Skip Allow download Note Note: That specific field will be padded with additional space. 3.9 RESET CURRENT LOOKUP FILE Click this button to load the default settings. Note: The settings for the current lookup file will be cleared. 58

67 SYMBOLOGY Chapter 4 According to the requirements of a specific application, you may enable or disable any of the barcode symbologies and configure the associated parameters. Supported barcodes depend on the scan engine integrated on the mobile computer IN THIS CHAPTER 4.1 Reader Settings Code ID Reset Barcode & Parameters READER SETTINGS Refer to the following appendices for information on barcode reader settings Appendix II - CCD/Laser Scan Engine for details. Appendix III - LR/ELR Laser Scan Engine for details. Appendix IV - 2D Scan Engine for details. 59

68 FORGE Batch Application Generator User Guide 4.2 CODE ID If this function is enabled, specify Code ID for a listed barcode. The Code ID will be prefixed to the decoding result of a barcode. Click the editing box next to the barcode, and select one code from the Grid Control (ASCII codes). Alternatively, you may select Set 1 ~ 5. Note: Code ID settings for GS1 Databar-14/Expanded, GS1 Databar Limited, and GS1-128 are provided in section 4.4 Barcode & Parameters. 4.3 RESET Click [Reset] to load the default settings. This applies to the following - section 4.1 Reader Settings section 4.4 Barcode & Parameters Note: The current settings will be cleared. 4.4 BARCODE & PARAMETERS Refer to the following appendices for information on symbology settings Appendix II - CCD/Laser Scan Engine for details. Appendix III - LR/ELR Laser Scan Engine for details. Appendix IV - 2D Scan Engine for details. 60

69 SETTINGS Chapter 5 On this property page, basic settings for the application program can be changed IN THIS CHAPTER 5.1 Initial Setting Function Key Setting Security Setting INITIAL SETTING Settings Default Value Remarks Data Deletion Manual Entry Options Show count Stay on the LCD for 600 ms Key Click Tone 2 Backlight Warning Beep Good Read Beep Vibrator Duration Turn off Two beeps One beep Off Buzzer Volume LARGE_VOL Only for

70 FORGE Batch Application Generator User Guide Bluetooth SPP is not available on the mobile Reader Option CCD/Laser Upload Method Cradle-IR Note Download Method Cradle-IR Note computer unless selected for downloading to 8061, Baud Rate & Modem Speed bps Note: For 8400, the default upload/download port is RS DATA MANIPULATION Data Deletion By default, you need to select 3. Utilities 3. Delete Data and manually delete a file. You may select to automatically delete data file(s) or lookup file(s) once it has been uploaded to the host. If so, the file will not be available any more when you select the following submenus - 2. Upload Data 3. Utilities 2. Browse Data If you don t want to delete any data file(s) or lookup file(s), please select Always keep. The data file(s) and lookup file(s) will always be kept in the mobile computer. Entry Options You may specify whether or not to display more information, either the record count (Show count) or the record preview (Show record), before proceeding to the next entry. By default, the record count will be displayed on the mobile computer screen for 600 milliseconds as soon as an entry is completed. Refer to Counter. When selecting "Show count" or "Show record", you will need to specify how long it will be displayed on the screen. Time-out is specified in the range of 1~99, in units of 100 milliseconds KEYPAD & LCD Key Click By default, "Tone 2" is used for the key click. You may select a desired tone or mute it. Backlight By default, the backlight for the LCD and the keypad of the mobile computer is turned off. When the backlight is turned on, you may specify a period of idle time so that it can be automatically turned off. Such time-out is specified in the range of 1~9, in units of 10 seconds. The default time-out is 20 seconds NOTIFICATION Warning Beep You may specify whether or not to have a warning beep when a specific event takes place. By default, it will produce two beeps to warn you of a specific event. 62

71 Chapter 5 Settings Good Read Beep You may specify whether or not to have a beep when decoding of a barcode is done successfully. By default, it will produce one beep to inform you of a successful reading. Vibration Duration This is available in 8300/8400/8500 program only. You may specify whether or not to turn on the vibrator to warn you of a specific event. By default, the vibrator is turned off. You may turn it on for a preset period of time. Buzzer Volume This is available in 8400 program only. You may change the buzzer volume READER OPTION Refer to Appendix I - Scan Engine Settings for information on barcode reader and RFID reader. Reader Type (for barcode scan engine) Select a reader type that matches the hardware configuration of your mobile computer. The associated barcode parameters will be displayed accordingly. If there is a More button next to the barcode symbology listed, advanced settings are available. Note: In order to initialize the barcode reader, you must select the correct reader type when you first configure a template. Otherwise, a message will be displayed on the mobile computer to indicate "Wrong reader type!" after you download the template file. Set RFID The RFID reader is automatically enabled after initialization. Advanced settings are provided as shown below. RFID tags in proximity will be read automatically by 8300/8500 when RFID reader is enabled. You may limit the 1.10 Input Type options in Form to prevent from misreading RFID data. 63

72 FORGE Batch Application Generator User Guide Read UID By default, the RFID reader is set to read UID (Unique Identification). Read Data Select the check box so that RFID data can be read. If only partial data is required, specify the start position and maximum length. User Delimiter Select the check box and specify a delimiter to separate UID from data UPLOAD METHOD Select a communication interface used on the mobile computer to upload data file(s) or lookup file(s) to your computer. Refer to Data_Read for auto upload settings. Upload Interface AG8000 AG8300 Remarks Normally, the interface options on the mobile computer are Cradle-IR IrDA Modem Ethernet Cradle However, if you download Batch AG runtime to 8061, Bluetooth SPP must be selected for initial settings, and it will replace Modem above; otherwise, this option will become unavailable on the mobile computer 3. Utilities 1. Settings 1. Upload Port 3. Utilities 1. Settings 2. Download Port Normally, the interface options on the mobile computer are Direct RS-232 Cradle-IR IrDA Keyboard Wedge Note Ethernet Cradle Modem However, if you download Batch AG runtime to 8360, Serial-SPP (=Bluetooth SPP) must be selected for initial settings, and it will replace Modem above; otherwise, this option will become unavailable on the mobile computer 3. Utilities 1. Program Settings 1. Upload Interface 3. Utilities 1. Program Settings 2. Download Interface Note: Keyboard Wedge option is provided with the 8300 Series mobile computers, and therefore, the settings are available in AG8300 program only. 64

73 Chapter 5 Settings Upload Interface AG8400 AG8500 Remarks Because the 8400 Series comes with Bluetooth integrated, the interface options on the mobile computer are RS232 Bluetooth SPP USB VOM Modem Ethernet Cradle USB HID SD Card Note Because the 8500 Series comes with Bluetooth integrated, the interface options on the mobile computer are Cradle-IR IrDA Modem Ethernet Cradle Bluetooth SPP Note: SD Card option is provided for 8400 to upload DAT files and DBF files to SD card. The files will be saved to the default working directory \AG\EXPORT, which will be created on SD card automatically DOWNLOAD METHOD Select a communication interface used on the mobile computer to download the application template or lookup file(s) from your computer. Download Interface AG8000 Remarks Normally, the interface options on the mobile computer are Cradle-IR IrDA Modem However, if you download Batch AG runtime to 8061, Bluetooth SPP must be selected for initial settings, and it will replace Modem above; otherwise, this option will become unavailable on the mobile computer 3. Utilities 1. Settings 1. Upload Port 3. Utilities 1. Settings 2. Download Port 65

74 FORGE Batch Application Generator User Guide Download Port AG8300 AG8400 AG8500 Remarks Normally, the interface options on the mobile computer are Direct RS-232 Cradle-IR IrDA Modem However, if you download Batch AG runtime to 8360, Bluetooth SPP must be selected for initial settings, and it will replace Modem above; otherwise, this option will become unavailable on the mobile computer 3. Utilities 1. Program Settings 1. Upload Interface 3. Utilities 1. Program Settings 2. Download Interface Because the 8400 Series comes with Bluetooth integrated, the interface options on the mobile computer are RS232 Bluetooth SPP USB VOM Modem SD Card Because the 8500 Series comes with Bluetooth integrated, the interface options on the mobile computer are Cradle-IR IrDA Modem Bluetooth SPP Note: SD Card option is provided for 8400 to download template file (.AGX) and lookup files from SD card. The default working directories are \AG\IMPORT for template file and \AG\DBF for lookup files, which will be created on SD card automatically. It allows setting different download interface for each file type. Before you download the lookup files, you must use the DBF converter tool to convert text files (.TXT) to DBF format (.DB0). It will automatically copy these files to the import directory \AG\DBF on either SD card or SRAM. 66

75 Chapter 5 Settings BAUD RATE & MODEM SPEED Baud Rate By default, the baud rate setting is bps for communications via any interface other than Modem. Modem Speed Only when Modem is selected for upload or download interface, this option will become available. For 8000/8300/8500, it depends on the IR control board of the modem cradle, which is set to bps by default. If you select any value other than bps, you need to adjust the DIP switch of the control board accordingly. For 8400, the modem cradle is capable of detecting baud rate. Note: For the 8000/8300 Series, the version of IR control board on the modem cradle must be greater than SV RESET SETTINGS Click this button to load the default settings. This applies to the following - section 5.1 Initial Setting section 5.2 Function Key Setting section 5.3 Security Setting Note: The current settings will be cleared. 67

76 FORGE Batch Application Generator User Guide 5.2 FUNCTION KEY SETTING You may enable the function keys and define the mapping. That is, specify which task will be invoked when you press a key combination. By default, no function keys have been defined. Note: For 8400, key combination FN+9 on 29-key requires pressing the orange modifier key and the - key. 68

77 Chapter 5 Settings 5.3 SECURITY SETTING SECURITY CHECKING For security concerns, you may specify a password and select the check box of one or more tasks that need security checking. By default, no password is required for any task. If any task is selected and provided with a password, you will not be allowed to enter a submenu on the mobile computer without the password. A password can be up to 10 alphanumeric characters. Note: The password is case-sensitive. Security Options Settings Edit Data Delete Data Set Date/Time Load Application Load Lookup File Key Click Barcode Good Read Upload Port Remarks 3. Utilities 1. Program Settings 3. Utilities 2. Browse Data 3. Utilities 3. Delete Data 3. Utilities 5. Set Date/Time 3. Utilities 6. Load Application 3. Utilities 8. Load Lookup File 3. Utilities 1. Program Settings 8. Buzzer 1. Key Click 3. Utilities 1. Program Settings 8. Buzzer 2. Barcode Read 3. Utilities 1. Program Settings 1. Upload Interface 69

78 FORGE Batch Application Generator User Guide Download Application Port Baud Rate Backlight Data Deletion Entry Options Warning Beep Download Lookup Port 3. Utilities 1. Program Settings 2. DL Program Interface 3. Utilities 1. Program Settings 4. Transmission speed 3. Utilities 1. Program Settings 5. Backlight 3. Utilities 1. Program Settings 6. Set Data Delete 3. Utilities 1. Program Settings 7. Entry Options 3. Utilities 1. Program Settings 8. Buzzer 3. Warning Beep 3. Utilities 1. Program Settings 3. DL Lookup Interface Note: For 8400, it allows setting different download interface for template file (.AGX) and lookup files separately UPLOAD.AGX When using AG program version or later to create and download a template file, it may be configured to allow uploading the template file from the mobile computer at a later time. Refer to Upload Application Template. Select the check box to allow uploading.agx file. You are required to specify a password. A password can be up to 5 alphanumeric characters. Note: The password is case-sensitive. 70

79 STARTUP Chapter 6 On this property page, startup settings for the application program can be customized. Use large font for all prompts is NOT available in AG8500 and AG IN THIS CHAPTER 6.1 Application Start From Prompt Font Size Data Field Properties Redefine Prompts & Messages Import Prompts & Messages Reset Prompts & Messages to Default APPLICATION START FROM Decide where the application program starts as soon as 1. Collect data is selected on the mobile computer. Form 1 Menu 1 71

80 FORGE Batch Application Generator User Guide 6.2 PROMPT FONT SIZE You may select to use large font for all prompts. These two options are available in AG8000 and AG8300 programs only because small font (6x8) is applied by default. Large font (8x16) must be applied for double-byte languages, such as Chinese, Japanese, etc. In that case, select the check box first so that all the prompts and messages will use large font. Refer to section 6.4 Redefine Prompts & Messages. On the Form and Menu property pages, font size needs to be changed accordingly. Refer to Localization. Note: These settings are not available for 8400 and 8500 Series because it must use large font. 6.3 DATA FIELD PROPERTIES NUMBER OF DELIMITER The input data will be saved as transaction records. Specify the delimiters used to separate data fields, either in ASCII code or text. It allows using up to two different delimiters. Type the ASCII code for a delimiter and its corresponding character will be shown automatically, and vice versa BROWSE DATA FONT SIZE You may select to use large font for data browsing. These two options are available in AG8000 and AG8300 programs only because small font (6x8) is applied by default. Large font (8x16) must be applied for double-byte languages, such as Chinese, Japanese, etc. In that case, select the check box first so that all the prompts and messages will use large font. Refer to section 6.4 Redefine Prompts & Messages. On the Form and Menu property pages, font size needs to be changed accordingly. Refer to Localization. Note: These settings are not available for 8400 and 8500 Series because it must use large font DAT FILE LOCATION You may specify the location to store the DAT files. The options are as follows: SRAM SD Card 72

81 Chapter 6 Settings 6.4 REDEFINE PROMPTS & MESSAGES For non-english environment, all the prompts and messages need to be re-defined in your local language. In addition, the appropriate font file has to be downloaded to the mobile computer so that it can display the prompts and messages correctly. Refer to Localization. 6.5 IMPORT PROMPTS & MESSAGES If the prompts and messages have already been re-defined with an existing template file, simply import the template file. 6.6 RESET PROMPTS & MESSAGES TO DEFAULT Click this button to load the default prompts and messages settings. Note: The current settings will be cleared. 73

82 FORGE Batch Application Generator User Guide 74

83 AG UTILITIES Chapter 7 These AG utilities are available in the Tools menu inside the 8 Series Batch AG program, or can be accessed via Start All Programs CipherLab Forge Batch Utilities. Shortcut Name of Utility Program Name Usage AG_Load AG_Load.exe To download the current application template to the mobile computer. DLookup DLookup.exe To download associated lookup file(s) to the mobile computer Prog_Load ProgLoad.exe To download the AG runtime or font file (.SHX) to the mobile computer. Data_Read Data_Read.exe To receive data via Data_Read utility. It also synchronizes date/time on every host connection. AGX_Read AGX_Read.exe To upload the current application template from the mobile computer. MobileLink MobileLink.exe To receive data from the mobile computer via Mobile Link utility. DBF_Converter DBF_Converter.exe To convert text file into DBF file. Simulator Simulator.exe To launch the simulator. IN THIS CHAPTER 7.1 Download Utilities Upload Utilities Mobile Link SD DBF Converter Program Simulation

84 FORGE Batch Application Generator User Guide 7.1 DOWNLOAD UTILITIES AG LOAD Without the need to run the Batch or WLAN Application Generator programs, you can use AG_Load.exe to download a template file to your mobile computer. Alternatively, you may use command lines in your own code

85 Chapter 7 Startup Run AG_Load.exe 1. In the File Type box, select the file type of the target AG template file. File Type Description The AGX format is used by the template file of Forge AG program (Batch) for 8000/8300/8400/8500 Series Mobile Computers. The ATX format is used by the template file of Batch AG program AG711*.exe for 711 Mobile Computer. The ATF format is used by the template file of WLAN AG programs for 8000/8300/8400/8500 Series Mobile computers. 2. In the File name box, type the file path where the AG template file is located. Otherwise, click Browse to locate the AG template file you want to download. Click Open in the dialog box as shown below. 77

86 FORGE Batch Application Generator User Guide 3. In the Download via box, select the download interface. Download via Description RS-232/IrDA/USB VCOM is available on 711/8000/8300/8400/8500 Series Mobile Computers. Proceed to configure COM port (1~255) and baud rate settings. Cradle-IR interface is available on 711/8000/8300/8500 Series Mobile Computers. Cradles or IR-Transceivers are required. Proceed to configure COM port (1~255) and baud rate settings. Modem interface is available on 8000/8300/8400/8500 Series Mobile Computers. Modem Cradles are required. Proceed to configure modem if necessary. Note: Mobile Link is provided for mobile computers to establish a connection with the host via Ethernet Cradles. However, it only allows uploading data currently. 4. Click OK to start the download process. 78

87 Chapter 7 Startup Run Command Line You can use the command line to download the AG template file as well. At the command line prompt, use the following command line arguments: AG_Load <File name>,<com port>,<baud rate>,<download via>,<file type> For example, AG_Load SAMPLE.AGX,1,1,1,1 //COM 1, bps, RS-232/IrDA, AGX file If command line arguments are not given, you may select the appropriate parameters from the dialog box that pops up. Each argument is explained in the table below. Argument File name COM port Baud rate Description Max length: 256 bytes Range: 1 ~ 255 (It is set to 1 by default in the utility program.) Range: 1 ~ 5 (It is set to 1 by default in the utility program.) 1: bps 2: bps 3: bps 4: bps 5: 9600 bps Download via Range: 1 ~ 3 (It is set to 1 by default in the utility program.) 1: 2: 3: RS-232 or IrDA Cradle-IR Modem File type Range: 1 ~ 3 (It is set to 1 by default in the utility program.) 1: 2: 3: AGX file ATX file ATF file 79

88 FORGE Batch Application Generator User Guide DLOOKUP Without the need to run the Batch Application Generator programs, you can use DLookup.exe to download a lookup file to your mobile computer. Alternatively, you may use command lines in your own code Note: (1) For 8400, USB Virtual COM shares the interface option of RS-232/IrDA. (2) Cradle-IR is not supported on

89 Chapter 7 Startup Run DLookup.exe 1. In the File name box, type the file path where the lookup file is located. Otherwise, click Browse to locate the lookup file you want to download. Click Open in the dialog box as shown below. 2. In the Download via box, select the download interface. Download via Description RS-232 or IrDA interface is available on 711/8000/8300/8400/8500 Series Mobile Computers. Proceed to configure COM port (1~255) and baud rate settings. Cradle-IR interface is available on 711/8000/8300/8500 Series Mobile Computers. Cradles or IR-Transceivers are required. Proceed to configure COM port (1~255) and baud rate settings. Modem interface is available on 8000/8300/8400/8500 Series Mobile Computers. Modem Cradles are required. Proceed to configure modem if necessary. 81

90 FORGE Batch Application Generator User Guide Note: Mobile Link is provided for mobile computers to establish a connection with the host via Ethernet Cradles. However, it only allows uploading data currently. 3. Click OK to start the download process. 82

91 Chapter 7 Startup Run Command Line You can use the command line to download the lookup file as well. At the command line prompt, use the following command line arguments: DLookup <File name>,<download via>,<com port>,<baud rate>,<show message box> For example, DLookup DEMO_LOOKUP.TXT,1,1,1,0 // RS-232/IrDA, COM 1, bps, No message box If command line arguments are not given, you may select the appropriate parameters from the dialog box that pops up. Each argument is explained in the table below. Argument File name Download via Description Max length: 256 bytes Range: 1 ~ 3 (It is set to 1 by default in the utility program.) 1: 2: 3: RS-232 or IrDA Cradle-IR Modem COM port Baud rate Range: 1 ~ 255 (It is set to 1 by default in the utility program.) Range: 1 ~ 5 (It is set to 1 by default in the utility program.) 1: bps 2: bps 3: bps 4: bps 5: 9600 bps Show message box Range: 0 ~ 1 (It is set to 1 by default in the utility program.) 0: 1: Disable Enable 83

92 FORGE Batch Application Generator User Guide PROGLOAD Without the need to run the Batch or WLAN Application Generator programs, you can use ProgLoad.exe to download a program (*.SHX, *.SYN or *.BIN) to your mobile computer Note: (1) For 8400, USB Virtual COM shares the interface option of RS-232/IrDA. (2) Cradle-IR is not supported on

93 Chapter 7 Startup Run ProgLoad.exe 1. In the Comm type box, select the download interface. Comm Type RS-232/IrDA Cradle-IR TCP/IP Description Connection via direct RS-232 cable, IrDA port, or Bluetooth SPP Connection via cradle Connection over networks 2. In the File type box, type the file path where the program file is located. Otherwise, click Browse to locate the program file you want to download. Click Open in the dialog box as shown below. File Type.SHX file.syn file.bin file Description 3. Click OK to start the download process. Any C program, such as AG Runtime, BASIC Runtime, font file, etc. Any BASIC program after BASIC Runtime has been installed first. Any C program Use PC utility SHX2Bin.exe to convert the program (.shx.bin). Note: Mobile Link is provided for mobile computers to establish a connection with the host via Ethernet Cradles. However, it only allows uploading data currently. 85

94 FORGE Batch Application Generator User Guide 7.2 UPLOAD UTILITIES DATA_READ Without the need to run the Batch Application Generator program, you can use Data_Read.exe to receive the data file(s) uploaded from your mobile computer. Alternatively, you may use command lines in your own code. However, if you want to upload data files over the network via Ethernet Cradles, use Mobile Link instead. It supports automatically uploading data to a host computer when the upload interface is properly configured Cradle-IR, RS-232 or USB VCOM. Once the mobile computer is seated in the cradle or connected via the RS-232 or USB Virtual COM cable, there will be a running dot or hourglass icon displayed on the upper-right corner of the screen, indicating the mobile computer is ready for auto upload. Please make sure the interface on the mobile computer is matching! Auto Upload Support Interface Required Cradle-IR Cradle-IR RS-232 RS-232 USB VCOM Cradle-IR

95 Chapter 7 Startup Run Data_Read.exe 1. In the Directory box under File Properties, type the file path where the data file will be saved to. Otherwise, click Browse to select which directory the data file is saved to. Type the file name and click Save in the dialog box as shown below. 2. If you want to save another data file to the same directory as specified above, simply type the file name here. 87

96 FORGE Batch Application Generator User Guide 3. In the Save mode box under File Properties, select the appropriate file mode and configure related settings. You may click the [Data Convert] button to configure settings for converting the received data into an Excel file. Save Mode Description Overwrite: If the file name you give is the same as of an existing file, the uploaded data will overwrite the original data. Otherwise, it will create a new file. Append: If the file name you give is the same as of an existing file, the uploaded data will be appended to the original data. Otherwise, it will create a new file. 88

97 Chapter 7 Startup Save Mode Description Keyboard emulation: Data is emulated as typed text and sent to the active window. In the Inter-character delay box under Communication Parameters, type or select a value that matches the computer response time of the keyboard interface. Such delay time is inserted between every character being transmitted. The longer the delay time is, the slower the transmission speed will be. Auto file name: The uploaded data will be saved to the specified directory with a file name that is automatically generated based on the system date and time. The best practice requires specifying reasonable polling time with Keep online for receiving data automatically enabled. Auto append: If the file name you give is the same as of an existing file, the uploaded data will be appended to the original data. Otherwise, it will create a new file. The best practice requires specifying reasonable polling time with Keep online for receiving data automatically enabled. Name by the first record: The received data will be saved to a file named by its first record. For example, in Batch Application Generator you may design Form 1 to allow only one line for a specific file name and proceed to other forms for collecting data. Thus, the first record will be used to keep its file name. However, if the file name you give is the same as of an existing file, the uploaded data will overwrite the original data. 4. Under Options, select appropriate settings for the file mode you selected in step In the Interface box under Communication Parameters, select the upload interface. Interface Description RS-232/IrDA/USB VCOM is available on 711/8000/8300/8400/8500 Series Mobile Computers. Proceed to configure COM port (1~255) and baud rate settings. Cradle-IR interface is available on 711/8000/8300/8500 Series Mobile Computers. Cradles or IR-Transceivers are required. Proceed to configure COM port (1~255) and baud rate settings. Modem interface is available on 8000/8300/8400/8500 Series Mobile Computers. Modem Cradles are required. Select Modem-TAPI when using TAPI-compliant communication application on the host computer. Proceed to configure modem if necessary. 89

98 FORGE Batch Application Generator User Guide Modem interface is available on 8000/8300/8400/8500 Series Mobile Computers. Modem Cradles are required. Select Modem-COM when using COM port based modem, and proceed to configure COM port and baud rate settings. Note: Mobile Link is provided for mobile computers to establish a connection with the host via Ethernet Cradles. However, it only allows uploading data currently. 6. Select whether to delete the data file, as well as lookup files, upon completion of auto upload. 7. Click OK to start the upload process. 90

99 Chapter 7 Startup Run Command Line You can use the command line to download the lookup file as well. At the command line prompt, use the following command line arguments: Data_Read <File name>,<upload via>,<com Port>,<Baud rate>,<save mode>, <Add CR character>,<add LF character>,<show error>,<show data>, <Show dialog box>,<keep online>,<polling time>,<inter-char delay> For example, Data_Read DataFile_1.TXT,1,1,1,1,1,1,1,1,0,1,2,0 // RS-232/IrDA, COM 1, bps, Overwrite, Add CR, Add LF, Show error message, Show data, Hide dialog box, Keep online, Polling time 2 seconds, No Inter-Char delay If command line arguments are not given, you may select the appropriate parameters from the dialog box that pops up. Each argument is explained in the table below. Argument File name Upload via Description Max length: 256 bytes Range: 1 ~ 4 (It is set to 1 by default in the utility program.) 1 (R) : RS-232 or IrDA 2 (I) : Cradle-IR 3 (T) : Modem-TAPI 4 (M) : Modem-COM COM port Baud rate Range: 1 ~ 255 (It is set to 1 by default in the utility program.) Range: 1 ~ 5 (It is set to 1 by default in the utility program.) 1 (115200) : bps 2 ( 57600) : bps 3 ( 38400) : bps 4 ( 19200) : bps 5 ( 9600) : 9600 bps Save mode Range: 1 ~ 5 (It is set to 1 by default in the utility program.) 1: 2: 3: 4: 5: Overwrite Append Keyboard emulation Auto file name Auto append Add CR character Range: 0 ~ 1 (It is set to 1 by default in the utility program.) 0: 1: Disable Enable 91

100 FORGE Batch Application Generator User Guide Add LF character Range: 0 ~ 1 (It is set to 1 by default in the utility program.) 0: 1: Disable Enable Show error Range: 0 ~ 1 (It is set to 1 by default in the utility program.) 0: 1: Disable Enable Show data Range: 0 ~ 1 (It is set to 1 by default in the utility program.) 0: 1: Disable Enable Show dialog box Range: 0 ~ 1 (It is set to 1 by default in the utility program.) 0: 1: Disable Enable Keep online Range: 0 ~ 1 (It is set to 0 by default in the utility program.) 0: 1: Disable Enable Polling time Inter-Char delay Range: 1 ~ 999 sec (It is set to 2 by default in the utility program.) Range: 0 ~ 255 ms (It is set to 2 by default in the utility program.) 92

101 Chapter 7 Startup AGX_READ When using the Forge AG program version or later to create and download a template file, it may be configured to allow uploading the template file from the mobile computer at a later time. Without the need to run the Batch Application Generator programs, you can use AGX_Read.exe to receive a template file (*.AGX) from your mobile computer Note: Cradle-IR is not supported on

102 FORGE Batch Application Generator User Guide Run AGX_Read.exe 1. In the Directory box, type the file path where the.agx file is to be saved. Otherwise, click to locate where to save the file. You may change the file name as well 2. In the Password box, enter the correct password for access to the template file. 3. In the Interface box, select the upload interface. Comm Type RS-232/IrDA/USB VCOM Cradle-IR Description Connection via direct RS-232 cable, IrDA port, or USB Virtual COM Connection via cradle 4. Click OK to start the download process Note: Mobile Link is provided for mobile computers to establish a connection with the host via Ethernet Cradles. However, it only allows uploading data currently. 94

103 Chapter 7 Startup 7.3 MOBILE LINK Mobile Link is provided for mobile computers to establish a connection with the host via Ethernet Cradles, and it only allows uploading data currently. Menu Bar Toolbar PREREQUISITES By default, it is set to automatically start the link service upon execution of Mobile Link. Once you select to upload data from the mobile computer, you can view the link status and file status respectively as shown above. You must have configured your Ethernet Cradle to work in Data Mode and connect to the host computer with correct host IP and port number. You must select Ethernet for the upload interface on the mobile computer. Note: On the System menu, click Link Properties, and then change the Auto Start Link Service setting. 95

104 FORGE Batch Application Generator User Guide MENU BAR & TOOLBAR File Menu Open Open a selected data file. Save As Save a selected data file to a different file path. Rename Rename a selected data file. Delete File Delete a selected data file. Remove from List Remove a selected data file from the file list. Convert Convert a selected data file to Excel file format. Exit Close the Mobile Link program. Link Menu Start Start the link service. Restart Stop Re-start the link service. Stop the link service. Information Menu Device Information Get system information about a specific mobile computer. System Menu Link Properties Configure link properties. File Properties Configure file properties. Help Menu About Mobile Link View information about the Mobile Link program. 96

105 Chapter 7 Startup VIEW LINK STATUS 1) Connect your Ethernet Cradle to the host computer over the network. In Mobile Link, click Links on the left pane of the work area and the IP and MAC address of Ethernet Cradle will be displayed on the right pane. Note: You must have configured your Ethernet Cradle to connect to the host computer with correct host IP and port number. 2) Seat the mobile computer into your Ethernet Cradle, and start with uploading data. For 8000/8300/8400, it will automatically start uploading. For 8500, it requires selecting Upload Data from the main menu on the mobile computer. 3) In Mobile Link, more information about the connection will be displayed on the right pane. The connection details include: Ethernet Cradle IP Ethernet Cradle MAC Address Terminal Serial Number (= the mobile computer) Terminal Type (= the mobile computer) Connect Time (start time) Elapse (time elapsed upon completion of receiving data) Note: You must select Ethernet for the upload interface on the mobile computer. 97

106 FORGE Batch Application Generator User Guide 4) Except for Ethernet Cradle IP and MAC address, the rest information will be cleared upon completion of uploading data. 98

107 Chapter 7 Startup VIEW RECEIVED FILES 1) In Mobile Link, click Files on the left pane of the work area and the received file or files will be displayed on the right pane. Note: You must have configured your Ethernet Cradle to connect to the host computer with correct host IP and port number. 2) Click a file from the file list, and choose a command from the File menu: On the File menu, click Open to open the selected data file. On the File menu, click Save As to save the selected data file to a different file path. 99

108 FORGE Batch Application Generator User Guide On the File menu, click Rename to rename the selected data file. On the File menu, click Delete File to delete the selected data file. On the File menu, click Remove from List to remove the selected data file from the file list. 100

109 Chapter 7 Startup On the File menu, click Convert to convert the selected data file to Excel file format. 101

110 FORGE Batch Application Generator User Guide VIEW DEVICE INFORMATION In Mobile Link, you can also view the device information while a mobile computer is uploading data. 1) Click an entry from the link list that provides detailed information on each of the current connections. 2) On the Information menu, click Device Information to view system information of a specific mobile computer, such as: Serial Number (on the title of the dialog box) Manufacture Date Library Version Kernel Version Font Version Program Version Device Type 102

111 Chapter 7 Startup CHANGE CONNECTION SETTINGS You must have configured your Ethernet Cradle to connect to the host computer with correct host IP and port number. On the System menu, click Link Properties to change the following settings: Link Port: The port number is 2000 by default. You may change it in Mobile Link, as well as on your Ethernet Cradle. Maximum Links: It allows up to 25 mobile computers to upload data by default. You may change the number to meet your needs. Refresh Link Information: Type or select an appropriate period of time for Mobile Link to refresh the link status, in units of second. Attempt to resume connection when disconnection is detected: Type or select how many times Mobile Link will try to resume connection. Auto Start Link Service: By default, it is set to automatically start the link service upon execution of Mobile Link. You may disable it if necessary. 103

112 FORGE Batch Application Generator User Guide CHANGE DATA FILE SETTINGS On the System menu, click File Properties to change the following settings: 104

113 Chapter 7 Startup File Path By default, the received data files will be saved in the same folder where the Mobile Link program is saved. Type the file path where the data files will be saved. File Name: Auto File Name By default, each data file will be saved by automatically giving it a blank name. However, you may specify the format of the file name by selecting more than one element from the five listed above. For example, selecting 1 and 4 will result in a file name based on the information from which Ethernet Cradle IP the data comes and the date when it is received. You may select a combination to make a proper file name. File Name: User Specified In the User Specify box, type the file name you want to use. Save Mode: Overwrite If the file name is the same as of an existing file, the uploaded data will overwrite the original data. Otherwise, it will create a new file. Save Mode: Append If the file name is the same as of an existing file, the uploaded data will be appended to the original data. Otherwise, it will create a new file. Append Return character to each record. By default, it will add Return character to each record. However, you may change it if necessary. Add Line-Feed character to each record. By default, it will add Line-Feed character to each record. However, you may change it if necessary. 105

114 FORGE Batch Application Generator User Guide 7.4 SD DBF CONVERTER (8400 ONLY) For 8400, it allows downloading template file (.AGX) and lookup files via SD card. Before you download the lookup files, you must convert text files (.TXT) to DBF format (.DB0,.DB1). The result files will be copied to the directory automatically when the Distribute setting is enabled. Note: The default working directory is \AG\DBF, which will be created on SD card automatically ) For the source lookup file, select a text file (.TXT). 2) For the lookup properties, specify from scratch or select a template file (.AGX) and the target lookup file. For the latter, the properties will be loaded automatically. 3) For the output DBF file, make sure to select the check box of [Convert] and [Distribute]. Specify a file name or select an existing DBF file to save the result files on PC side. 4) On 8400, select 3. Utilities 8. Load Lookup File and identify the lookup file. 106

115 Chapter 7 Startup Note: The download interface must be set to SD. Refer to Download Method. 5) Click [Go]. It will convert the source file to DBF format and save the result files on PC side. If you have selected the check box of [Distribute], it will automatically copy the result files to the import directory \AG\DBF on SD card. 6) On 8400, press [Enter] to confirm copying files to SD card and checking DBF format. Depending on the DBF location specified in the template file, it will either (1) load the associated lookup file(s) to SRAM via SD card, or (2) keep the files on SD card for direct access. Refer to DBF File Location (8400 Only). Note: It is suggested to check DBF format upon completion of downloading lookup files. 107

116 FORGE Batch Application Generator User Guide 7.5 PROGRAM SIMULATION When you have completed the entire configuration, you may click Tools Simulator to run program simulation and verify whether these program sequences meet your requirements. Collect Data Main Menu User Menu Form 1 108

117 Chapter 7 Startup Upload Data No simulation. Refer to section Record and Lookup Data Can Be Uploaded. Normally, it will proceed to connect via the selected upload port. Refer to section Data Manipulation for Data Deletion upon completion of uploading data. Utilities Only partial simulation is allowed. Note: If a lookup file is specified in use on the Lookup property page, 3. Utilities 8. Calculator will be replaced by 3. Utilities 8. Load Lookup File after you have downloaded the template file to the real mobile computer. 109