Differences

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

--- transformations:exportplaintext [2021/01/16 10:08] – created dmitry
+++ transformations:exportplaintext [2021/05/08 01:49] – craigt
@@ Line 1: / Line 1: @@
-===== Export plain text =====
+{{ transformations:ExportPlainTextAction.png}}
+======EXPORT AS PLAIN TEXT======
+Category: Export / File\\
+\\
+=====Description=====
+Export the contents of a column into a text file, as is. Each column value is exported as text into one line of the file.\\
+\\
+=====Use cases=====
+ Most frequently, this action is used to create text files in a format not natively supported by EasyMorph.\\
+\\
+=====Action settings=====
+^ 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).|
+|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 [[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//.|
+| Export the column header too  | When checked, the column name will be exported as the 1st line of the target file.|
+| 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.|
+<sup>*</sup> Setting can be specified using a [[:parameters|parameter]].\\
+\\
+====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.|
+\\
+=====See also=====
+  * [[transformations:exporttext|Export into delimited text file]]
+  * [[transformations:importplaintext|Import plain text]]
-Export the contents of a column into a text file, as is. Each column value is exported as text into one line of the file. Most frequently, the action is used to create text files in a format not natively supported by EasyMorph.
-Action settings:
-^ Settings  ^ Description  ^
-| Column  | The column which values are exported into the target text file.  |
-| File    | The path to the target file. Can be specified using a parameter.  |
-| Encoding   | The encoding of the target file.  |
-| Don't write BOM  | Do not write the [[https://en.wikipedia.org/wiki/Byte_order_mark|byte order mark]] at the beginning of the file.
-| Decimal  | The decimal separator for numbers.  |
-| Export the column header too  | When checked, the column name will be exported as the 1st line of the target file.  |
-| Preserve formatting | If checked and the exported column has a format specified (e.g. for dates), use the format when exporting numbers.  |
-=== See also ===
-  * [[transformations:importplaintext|Import plain text]]
-  * [[transformations:exporttext|Export into delimited text file]]