Difference between revisions of "Batch Run"

From mtab wikisupport
Jump to: navigation, search
Line 15: Line 15:
  
 
[[File:batchrun1.png|600px]]
 
[[File:batchrun1.png|600px]]
 
 
Using either [Ctrl-Click] or [Shift-Click] keyboard commands, select all of the Saved Tabs you would like to run.
 
Using either [Ctrl-Click] or [Shift-Click] keyboard commands, select all of the Saved Tabs you would like to run.
  
[[File:batchrun2.png|600px]]
 
  
 +
 +
[[File:batchrun2.png|600px]]
 
Click on the bottom section of the Run (lightning bolt) icon. <br />You'll see additional Run options. Click the '''Batch Run icon'''.
 
Click on the bottom section of the Run (lightning bolt) icon. <br />You'll see additional Run options. Click the '''Batch Run icon'''.
  
  
[[File:batchrun3.png|250px]]
 
  
 +
[[File:batchrun3.png|250px]]
 
Instead of using the icons, after selecting and highlighting the Saved Tabs, you can also right-click anywhere in the '''My Tabs''' window and a menu will appear. <br />The '''Batch Run''' option will appear at the bottom of the menu.
 
Instead of using the icons, after selecting and highlighting the Saved Tabs, you can also right-click anywhere in the '''My Tabs''' window and a menu will appear. <br />The '''Batch Run''' option will appear at the bottom of the menu.
  
[[File:Other batch-run file-name-imput.jpg|thumb|right|x300px]]
 
Clicking on this option brings up a dialog, which allowa you to select the directory where the resulting XLS files will be placed as they are output. Each file will automatically be given the same name as the tab from which it ran, making it easy to identify each tab's output.
 
  
  
Another tool that is available is having mTAB place some kind of prefix before the file name of each output file. This would allow the insertion of a common phrase, date or any other identifying information by the user. Simply type it into the '''File Name''' box in the dialog.  
+
[[File:batchrun4.png|600px]]
 +
After initiating Batch Run, a Save dialog window will appear. This will allows you to select the folder where the exported files will be saved to. Each spreadsheet file will automatically be given the same name as the Saved Tab, making it easy to identify.
 +
 
 +
 
 +
Within the same window, there is an option to specify a prefix before the file name of each output file. This allows for the insertion of a common phrase, date, or any other identifying information. Type the optional prefix text into the '''File Name''' box at the '<<Type batch prefix here if desired>>' prompt.
 +
 
 +
Click the '''Export''' button to proceed.
  
  
Once the Batch Run process is complete, mTAB checks to see if any problems occurred and, if so, displays a dialog to point these out to you. A copy of this detailed problem log is also saved to the same directory as your output files, for future reference.  
+
As the Batch Run process is running, mTAB checks to see if any export issues occur. If so, a dialog will be displayed when the Batch Run process has completed. A detailed issues log is also saved to the same folder as your output files, for future reference.
  
[[File:Other batch-run results-warnings-errors.jpg|thumb|center|x250px]]
+
[[File:batchrun5.png|250px]]

Revision as of 17:18, 2 August 2018

The Batch Run feature allows users to select multiple saved tabs, load and run the data, and export the data into spreadsheets with one click.


The benefit of Batch Run is that it saves a significant amount of time by eliminating the need to individually load each tab, type a filename for each spreadsheet, and then export one by one.


Batch Run allows users to initiate a very large number of tabs to run and export in the background. This allows users to save time to spend on other tasks. After Batch Run completes, each tab will have been run and the results exported to corresponding spreadsheet files. The most typical format being XLSX. Batch Run supports all spreadsheet file formats that can be exported with mTAB: XLSX, XLS, XML, HTML, CSV, and tab-delimited TXT.


How Batch Run Works

Batch Run starts in the My Tabs panel, where you will see all of your currently saved tabs listed.


Batchrun1.png Using either [Ctrl-Click] or [Shift-Click] keyboard commands, select all of the Saved Tabs you would like to run.


Batchrun2.png Click on the bottom section of the Run (lightning bolt) icon.
You'll see additional Run options. Click the Batch Run icon.


Batchrun3.png Instead of using the icons, after selecting and highlighting the Saved Tabs, you can also right-click anywhere in the My Tabs window and a menu will appear.
The Batch Run option will appear at the bottom of the menu.


Batchrun4.png After initiating Batch Run, a Save dialog window will appear. This will allows you to select the folder where the exported files will be saved to. Each spreadsheet file will automatically be given the same name as the Saved Tab, making it easy to identify.


Within the same window, there is an option to specify a prefix before the file name of each output file. This allows for the insertion of a common phrase, date, or any other identifying information. Type the optional prefix text into the File Name box at the '<<Type batch prefix here if desired>>' prompt.

Click the Export button to proceed.


As the Batch Run process is running, mTAB checks to see if any export issues occur. If so, a dialog will be displayed when the Batch Run process has completed. A detailed issues log is also saved to the same folder as your output files, for future reference.

Batchrun5.png