Command Line Migration

Quick Fields 6/7 sessions must be converted to the Quick Fields 9 format. The conversion process will retain virtually all of a session's settings. There are different ways to migrate sessions, one of which is using Microsoft Windows' command line.

Things to Remember

Keep the following points in mind when using the command line interface:

• References to file paths must be enclosed in quotations marks. For example, "C:\Documents and Settings\username\Desktop\MyQuickFieldsSession.qfs."
• A single space should appear between all paths and parameters. For example: "Path1" "Path2" -Parameter "Path3."
• Converting a session from the 6/7 format to the 9 format will create a new file; it will not modify the original session. You can distinguish the two files by referring to their extensions: .qfs (6/7 format) and .qfx (8 and later format).
• See the Sample Command Line Migration Scenarios topic for sample scenarios and commands that illustrate different ways to control the Quick Fields Migration Utility from the command line.

Syntax

When using the command-line interface, you can use the following commands. Be sure to use the following order and syntax.

1. Path to Quick Fields Migration Utility. By default this is C:\Program Files\Laserfiche\Quick Fields 9\QFMigrator.exe.
2. One of the following:
   
   
   • Path to a directory that may contain .qfs files. For example, C:\Documents and Settings\username\Desktop.
   • Path to a single .qfs file. For example, C:\Documents and Settings\username\Desktop\MyQuickFieldsSession.qfs.

     Tip: You can use wildcards to represent file names or folders. Use ? (question mark) to represent a single unknown character and * (asterisk) to represent one or more unknown characters. For example, C:\Documents and Settings\username\Desktop\Session*.qfs would match the following files: SessionA.qfs, Session765.qfs, SessionABC.qfs. Wildcards cannot be used to in the middle of a path. For example, C:\Documents and Settings\*\Desktop would not work and neither would C:\Documents and Settings\?sername\Desktop.

3. Optional: One or more of the following parameters.
   
   
   • -r: If the input is a directory, the utility will search for .qfs files recursively (i.e., the utility will search in the folder you specify and any subfolders that it may contain). If the input isn't a directory, this parameter will be ignored. Unless an additional parameter is used to specify a uniform output path for all converted files (e.g., -o or -d), new files will be created in the same directory as their source file.
   • -o "path": Specifies an output file name and, optionally, an output path (i.e., file name is required while path is optional). If you specify only a file name and no path, the migrated file will be created in the same directory as the source .qfs file. When specifying file name, the .qfx extension is optional.
   • -d "path": Specifies an output path. You can enter an absolute or a relative path starting from the location of the input file. Do not enter a file name after the output path.
   • -y: Specifies that output should not be printed to the console (for scripting purposes). Also specifies that, in the event that a migrated file shares the same name of an existing .qfx file in the same location, the new file should overwrite the existing file.