User Tools

Site Tools


transformations:exportplaintext

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
transformations:exportplaintext [2021/07/15 11:48] craigttransformations:exportplaintext [2023/03/08 13:59] (current) – updates for v5.4.1 - append mode craigt
Line 14: Line 14:
 =====Action settings===== =====Action settings=====
 ^ Setting  ^ Description  ^ ^ Setting  ^ Description  ^
-| Column  | Select the column to export into the target text file.  | 
 |File<sup>*</sup>|Enter a fully-qualified file name for the output file (includes relative or absolute path).| |File<sup>*</sup>|Enter a fully-qualified file name for the output file (includes relative or absolute path).|
-|Encoding|Select the encoding format to use for the exported file. If you're not sure what to choose, try UTF-8\\ as it's the most common Unicode encoding.| +|Column  | Select the column to export into the target text file.  |
-|Don't write BOM|When checked, the [[https://en.wikipedia.org/wiki/Byte_order_mark|byte order mark]] is not written at the beginning of the output file.|+
 |Decimal|Select the character used within numeric values to define decimal places.  Options: //Point// or //Comma//.| |Decimal|Select the character used within numeric values to define decimal places.  Options: //Point// or //Comma//.|
-| Export the column header too  When checked, the column name will be exported as the 1st line of the target file.+|Export mode|Choose whether the action will create a new file or append to an existing file.  Options: //Create new file// or //Append to file (or create)// (appends to the file if it already existsor creates the file if it //doesn't// exist).|
-| Preserve formatting | If checked, and the exported column has a format specified (e.g. for dates), use the format\\ when exporting numbers.|+
 |File already exists|If a file with the same name already exists, choose whether to overwrite the existing file, rename the\\ existing file, or halt the action's execution.  See the "File already exists options" table below for details.| |File already exists|If a file with the same name already exists, choose whether to overwrite the existing file, rename the\\ existing file, or halt the action's execution.  See the "File already exists options" table below for details.|
 <sup>*</sup> Setting can be specified using a [[:parameters|parameter]].\\ <sup>*</sup> Setting can be specified using a [[:parameters|parameter]].\\
Line 29: Line 26:
 |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.| |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.| |Halt project execution|The project will stop processing and this action will display a warning symbol.|
 +
 +\\ 
 +=====Advanced options=====
 +^ Setting  ^ Description  ^
 +|Encoding|Select the encoding format to use for the exported file. If you're not sure what to choose, try UTF-8 as it's\\ the most common Unicode encoding.|
 +|Don't write BOM|When checked, the byte order mark is not written to the output file.  See [[https://en.wikipedia.org/wiki/Byte_order_mark|Wikipedia - Byte order mark]] for details. |
 +|Wrap in quotes|Select which values are wrapped in quotation marks in the export file.  See the table below for details.|
 +|Don't write column headers|Column headings are not written into the exported file.|
 +|Preserve formatting| Export number values (including dates) using the currently selected column format. |
 +\\ 
 +====Wrap in quotes options====
 +^Option ^Description ^
 +|Auto|Only values that contain the chosen separator or a line break, or numeric values data-typed as text, will be wrapped in double-quotes.  Other value types will not be.|
 +|Everything|All values will be wrapped in double-quotes.|
 +|Nothing|No values will be wrapped in double quotes, even if they contain spaces, separators, or line breaks.  //Use this option with care//.|
  
 \\ \\
transformations/exportplaintext.txt · Last modified: 2023/03/08 13:59 by craigt

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki