Using the Batch Grouper

Owned by David Webster (Unlicensed)
Last updated: 24-08-2017
2 min read

Your Install Directory

The batch grouper is very easy to use.  When you install QuickSnap, the default directory is:

Windows 7 or 8: C:\Program Files (x86)\AHSRI\AHSRI QuickSnap

Windows XP: C:\Program Files\AHSRI\AHSRI QuickSnap

You may have chosen a different directory when you ran the installer.  This folder will be referred to as the 'install directory'.

Open a command prompt window and navigate to the install directory

  • Click the Start Menu:  then click: All Programs - Accessories
  • Click the item 'Command Prompt'

In this window type the following, depending on your 'install directory':

  • cd "\Program Files\AHSRI\AHSRI QuickSnap"
  • cd "\Program Files (x86)\AHSRI\AHRSI QuickSnap"
  • cd <install_directory> (replacing your install directory)

Press <enter> to confirm this command.

Run QuickSnap

Use the following command:

	QuickSnap <file_format> <input_filename> <output_filename> <error_filename> <has_header_line>

 Here is an explanation of the parameters:

  • File Format: 
    • AN-SNAP v3 formats:
      • 1 - QuickSnap Native Format
      • 2 - QuickSnap DSS Compatible Format
    • AN-SNAP v4 formats (only available from QuickSnap 2.0 (not yet available)
      • 4 - QuickSnap Native Format v4 (FIM Detail)
      • 5 - QuickSnap Native Format v4 (FIM Summary)
      • 6 - QuickSnap Native Format v4 (Full Detail)
      • 7 - QuickSnap DSS Compatible Format v4 
         
  • Input Filename: name of the input file containing AN-SNAP data items e.g. C:\SNAP\snap_source.csv
  • Output Filename: name of the output file to create, which will contain the same data with the AN-SNAP class or error-class at the end of each line, e.g. C:\SNAP\snap_output.csv
  • Error Filename: name of the error file to create, which will contain a list of the errors , e.g. C:\SNAP\snap_error.csv
  • Has Header Line:
    • 0 - if your file does not have a header line
    • 1 - if your file does have a header line (this can be convenient for creating input files which are easy for a person to interpret)
    • Please note that the line_number reported in the error file is the literal line of the file in which the record occurred regardless of whether or not there is a header line. 
    • The only effect of the <has_header_line> option is to prevent QuickSnap from generating errors based on the first line.

QuickSnap will tell you if it was able to process the input file.  If successful, you will see the message:

  • 'Successfully processed your SNAP data.'

If it was unable to read the input file, or create the output or error files, an error message will be displayed.

Other relevant Information