User Tools

Site Tools


transformations:excelcommand

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
transformations:excelcommand [2022/01/31 13:07] – Add Re-save and Save to PDF modes. craigttransformations:excelcommand [2023/04/20 19:36] (current) – [Action settings] craigt
Line 5: Line 5:
 \\  \\ 
 =====Description===== =====Description=====
-This action performs a process on an Excel file.+This action performs a command on an Excel file.
   * List sheets/ranges   * List sheets/ranges
   * Run VBA macro   * Run VBA macro
Line 23: Line 23:
 =====Action settings===== =====Action settings=====
 ^ Setting  ^ Description  ^ ^ Setting  ^ Description  ^
-|File<sup>*</sup>|Enter or browse to the fully qualified path and filename of the Excel file (.xlsx or .xlsm) to perform and command on.|+|File<sup>*</sup>|Enter or browse to the fully qualified path and filename of the Excel file (.xlsx, .xslm, .xlsb, or .xls) to perform and command on.|
 |Command|Select the command to run on the selected Excel file.  Options:  //List sheets/ranges//, //Run VBA macro//, //Rename sheet//, //Delete sheet//, or //Recalculate workbook// See below for details of each command.| |Command|Select the command to run on the selected Excel file.  Options:  //List sheets/ranges//, //Run VBA macro//, //Rename sheet//, //Delete sheet//, or //Recalculate workbook// See below for details of each command.|
  
Line 47: Line 47:
 |Capture return value|If the macro being run is a function that returns a value, checking this will capture the return value.| |Capture return value|If the macro being run is a function that returns a value, checking this will capture the return value.|
 |Macro arguments<sup>*</sup>|If the macro being run accepts arguments, the values to be passed in are listed here.  Arguments should be\\ listed in the order the macro is expecting them.| |Macro arguments<sup>*</sup>|If the macro being run accepts arguments, the values to be passed in are listed here.  Arguments should be\\ listed in the order the macro is expecting them.|
 +|If macro fails|Select how EasyMorph behaves if the Excel macro fails to run.  Options: //Fail// (display an error and stop the workflow) or //Warn// (display a warning and continue the workflow).|
  
 <sup>*</sup> Setting can be specified using a [[:parameters|parameter]] or the first value of a column.\\ <sup>*</sup> Setting can be specified using a [[:parameters|parameter]] or the first value of a column.\\
Line 82: Line 83:
 ^Setting^ Description  ^ ^Setting^ Description  ^
 |PDF file<sup>*</sup>|Enter the fully qualified path and filename of the PDF file to be generated.| |PDF file<sup>*</sup>|Enter the fully qualified path and filename of the PDF file to be generated.|
-|If the PDF file already exists|Choose how EasyMorph will handle situations when the PDF file already exists.  Options:  //Overwrite// (replace the existing file), //Rename// (generate a new name for file being created), or //Halt project execution// (stop the workflow with a warning).|+|If the PDF file already exists|Refer to the //File already exists options// table below for details.|
 |Page range|Choose which pages to include in the PDF file.  Options:  //All pages// (all pages in the select sheet will be exported to the PDF file), or //Pages// (and enter the starting and ending number of the pages to be exported).| |Page range|Choose which pages to include in the PDF file.  Options:  //All pages// (all pages in the select sheet will be exported to the PDF file), or //Pages// (and enter the starting and ending number of the pages to be exported).|
 |Sheets|Choose which workbook sheets will be exported to the PDF file.  Options:  //All sheets// (the content from all worksheets will be exported), or //Selected sheets// (select the sheets to include from the list).| |Sheets|Choose which workbook sheets will be exported to the PDF file.  Options:  //All sheets// (the content from all worksheets will be exported), or //Selected sheets// (select the sheets to include from the list).|
Line 88: Line 89:
 <sup>*</sup> Setting can be specified using a [[:parameters|parameter]] or the first value of a column.\\ <sup>*</sup> Setting can be specified using a [[:parameters|parameter]] or the first value of a column.\\
  
 +\\ 
 +====File already exists options====
 +^Option ^Description ^
 +|Overwrite|The new file replaces the original file.|
 +|Rename|The original file will be renamed with "backup" and a serial number appended to the file name.  The new file will\\ possess the name specified in the //File// setting.|
 +|Halt project execution|The project will stop processing and this action will display a warning symbol.|
 \\  \\ 
 =====Remarks===== =====Remarks=====
transformations/excelcommand.txt · Last modified: 2023/04/20 19:36 by craigt

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki