Saving results and specifying output folders
When you perform an operation on an Analytics table and save the results to a new Analytics table or a text file, you have several options regarding the manner in which you save the results, and the location of the output folder.
Note
Analytics tables include a table layout, visible in the Navigator, and an associated source data file with a .fil extension, not visible in the Navigator, stored in a Windows folder.
Understanding the difference between the table layout and the source data file can be important when saving results and specifying output folders.
For more information, see The structure of Analytics tables.
Saving results
When saving results to an Analytics table or a text file, you have the following options:
- Save save the results to a new Analytics table or a text file
- Append append the results to an existing Analytics table or a text file
- Overwrite overwrite an existing Analytics table or a text file
Appending updates the source data file but does not alter the table layout. Overwriting replaces both the source data file and the table layout.
Note
Some Analytics operations support saving result to either an Analytics table or a text file, but not both.
Appending or overwriting source data in another project
Typically, you append to or overwrite a table in the open Analytics project. By navigating to the appropriate Windows folder when saving results, you can append to or overwrite the source data file for an Analytics table in another project.
When you do so, the updated or overwritten table remains in the other project and is also added to the open project, with both table layouts in the two projects sharing the same source data file.
Caution
Before saving results in this manner, you should be certain that overwriting source data in another project is your intended outcome.
Specifying output folders
When you save results, there are two types of ‘output folder’ to consider:
- An Analytics project folder contains the resulting Analytics table layout (does not apply when saving results to a text file)
- A Windows folder contains the resulting source data file (.fil) associated with the Analytics table layout, or contains the resulting text file
Analytics project folders are not Windows folders
Analytics project folders are not Windows folders, and creating an Analytics project folder does not create a corresponding Windows folder. Analytics project folders are virtual folders inside the Analytics project file (.acl). You can move a table layout between Analytics project folders and it has no effect on the location of the table’s source data file in a Windows folder.
Table layout and source data file placement options
When saving results to an Analytics table, you have several options regarding placement of the table layout and the source data file. You can independently control placement of the table layout and the source data file by using the SET FOLDER command for table layout placement, and standard Windows navigation for source data file placement.
Item |
Placement options (output folder) |
---|---|
Table layout |
|
Source data file (.fil) |
|
Using SET FOLDER to specify the Analytics project output folder
Before outputting results, you can use the SET FOLDER command to set which Analytics project folder is used for the table layout. You enter the SET FOLDER command in the Analytics command line, or include it in a script. Several examples are provided below.
The output folder remains as whatever you set it – until you reset it, or close the project. When you reopen the project, the output folder reverts to the default of the active table folder.
Note
File paths specified in the SET FOLDER command must use a forward slash.
Command syntax |
Description |
---|---|
SET FOLDER /Results |
The table layout is placed in the Results Analytics project folder rather than the active table folder. |
SET FOLDER /Results/Duplicates |
The table layout is placed in the Duplicates Analytics project subfolder rather than the active table folder. |
SET FOLDER / |
The table layout is placed in the Analytics project root directory rather than the active table folder. |
SET FOLDER |
Resets the output folder to the default of the active table folder. |
DISPLAY OUTPUTFOLDER |
Displays the current Analytics project output folder. |
Interaction between table layouts and Analytics project folders
The interaction between table layouts resulting from operations and Analytics project folders is summarized in the table below.
In all cases, the Windows folder where you choose to save the source data file has no bearing on the location of the table layout or the project folder within Analytics.
Action |
Output folder in Analytics is active table folder (default) |
Output folder in Analytics is specified by SET FOLDER command |
---|---|---|
Save results to new Analytics table |
Table layout added to same Analytics project folder as active table |
Table layout added to Analytics project folder specified by SET FOLDER command |
Append results to existing Analytics table in project |
Existing table layout not moved |
Existing table layout not moved |
Save results and overwrite existing Analytics table in project |
Table layout moved to same Analytics project folder as active table, unless already in same folder |
Table layout moved to Analytics project folder specified by SET FOLDER command, unless already in same folder |
Append results to existing Analytics table in another project |
Table layout added to same Analytics project folder as active table Table layout in other project unaltered Both table layouts share the same source data file |
Table layout added to Analytics project folder specified by SET FOLDER command Table layout in other project unaltered Both table layouts share the same source data file |
Save results and overwrite existing Analytics table in another project |
Specifying the Windows output folder
By default, the source data file (.fil) associated with a table layout is output to the Windows folder containing the Analytics project. To output the data file to a different Windows folder:
- in the user interface navigate to the folder when using a command dialog box
- in a script specify a file path in any command that outputs a table. For example:
CLASSIFY ON Vendor_Number SUBTOTAL Invoice_Amount TO "C:\Data analysis\January\Classified_transactions_Jan.FIL"