File Name Generation

• Introduction

  Icon

  
  
  
  The "File name generation" TAB settings control where the files output by ScanToPDF are stored.

• 1. Output file path

  Enter (or choose using the "Choose folder" button) a folder and file output path where the PDF documents will be saved - THIS SHOULD BE A FULLY QUALIFIED PATH (including the document extension)
  
  For example
  
  c:\pdf files\{GetBarcodeText()}.pdf
  
  For more detailed information about the possible syntax which can be used in the output file path setting please visit our Syntax page
  
  New Version v1.1.5.4 - Click the + button next to the Choose folder button to open a multiple line editor to enable complex syntax to be entered. Syntax can then be entered over several lines

• 2. Auto create folder

  Checking this option indicates that any new folder required in order to save a document can be created automatically by ScanToPDF.

• 3. Show file save dialog

  Check this option to display the usual windows save dialog enabling the user to select a folder and enter a file name manually

• 4. Only allow save in this folder

  DEPRECATED IN VERSION 5.0.5.12
  Checking this option indicates that PDF documents can only be saved in the destination folder and not overridden by the user manually.

• 5. If document already exists

  Choose an option for append action from the drop down list.

• 6. Show append choice dialog

  Check this option to display a dialog box to allow the user to select an append choice (see option 5)
  
  For more detailed information about the append choice dialog visit this page

• 7. Enable path re-formatting

  Check this option to use the Post-choice re-format syntax.
  
  Once the option is set use the post-choice re-format option to enter syntax to enable additional formatting to be applied to a filename AFTER the user has entered a file name (using the "Show file save dialog" option). This can be used to append a unique increment
  
  For example

   

  {GetFolderName(OutputFilePath)}\{GetFileNameWithoutExtension(OutputFilePath)}-{IncrementCounter():0000}.pdf

• 8. Post-choice format

  Enter a syntax to be used for the post-choice format to enable additional formatting to be applied to a filename AFTER the user has entered a file name (using the "Show file save dialog" option). This can be used to append a unique increment

  For example

   

  {GetFolderName(OutputFilePath)}\{GetFileNameWithoutExtension(OutputFilePath)}-{IncrementCounter():0000}.pdf

• 9. On error proceed with

  On Error Proceed With - This controls the behaviour when an error case prevents the filenamer creating the required filename (for example a misread barcode). There are 3 choices

   

  1. Error case - use the error case rules defined in the "Error case file name generation" TAB

  2. Save as dialog - Display the save as dialog to name the file manually

  3. Cancel save - Do nothing
  
  

  Click here for more information about the Error case

• 10. Trigger error case if the generated file path already exists

  Check this option to enable ScanToPDF to trigger the error case when the generated file path already exists to avoid overwrite or append.