Differences

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

--- transformations:append [2015/04/17 23:31] – elenap
+++ transformations:append [2021/04/07 14:17] – [Use cases (Append rows)] dmitry
@@ Line 1: / Line 1: @@
-===== Append table =====
+{{ transformations:AppendTableAction.png}}
+====== APPEND ANOTHER TABLE ======
+Category: Transform / Basic\\
-This transformation appends another table at the bottom of current table. Columns with the same name in both tables appear as one column in the result table.
+\\
+=====Description=====
+This action appends another table to the current dataset.  This action can operate in 2 modes:\\
+\\
+====Append rows====
+ The other table (dataset) is appended as new rows at the bottom of the current table. Columns with the same name in both tables appear as one column in the result table. Columns in the appended table that don't exist in the main table are appended on the right.
-EXAMPLE
+This mode has the useful feature of preserving the order of columns of the main dataset to which the other dataset is appended.\\
+\\
+====Append columns====
+The other table (dataset) is appended as new columns to the right of the current dataset. Columns from the appended table with the same name as in the main table are automatically renamed. The length of the resulting table is the longest length of the two tables.\\
-**Table 1:** The longest rivers in the world
+\\
+=====Use cases (Append rows)=====
+  * Concatenation of similar datasets.
+  * Incremental loading.
-^  River  ^  Length (km)  ^  Continent  ^
+To append multiple datasets, apply the "Append" action multiple times.
-| Nile  |  6650  |  Africa  |
-| Amazon  |  6400  |  South America  |
-| Yangtze  |  6300  |  Asia  |
-| Mississippi  |  6275  |  North America  |
-**Table 2:** The outflow
+\\
+=====Action settings=====
+^Setting^Description^
+|Table to append|Select the dataset to append to the current one.|
+|Mode|Options:  //Append rows// at the bottom (columns with the same name are concatenated into one column), and,\\ //Append columns// to the right (columns with the same names are automatically renamed)|
-^  River  ^  Outflow  ^
+Regardless of the mode, a dotted line will connect this action to the appended dataset in the application window.
-| Nile  |  Mediterranean  |
-| Amazon  |  Atlantic Ocean  |
-| Yangtze  |  East China Sea  |
-| Mississippi  |  Gulf of Mexico  |
+\\
+=====Examples=====
-**Objective:** Append Table 2 to Table 1
+**Objective:** Append Table 2 to Table 1 as additional columns.
+**Table 1:** The longest rivers in the world
+^River  ^Length (km)  ^Continent  ^
+| Nile  |  6650|Africa  |
+| Amazon  |  6400|South America  |
+| Yangtze  |  6300|Asia  |
+| Mississippi  |  6275|North America  |
+**Table 2:** The outflow
+^River  ^Outflow  ^
+| Nile  |Mediterranean  |
+| Amazon  |Atlantic Ocean  |
+| Yangtze  |East China Sea  |
+| Mississippi  |Gulf of Mexico  |
+\\
+**Action parameters:**
+>  Append columns to the right
+\\
 **Result:**
-^  River  ^  Length (km)  ^  Continent  ^  Outflow  ^
+^River  ^Length (km)  ^Continent  ^Outflow  ^
-| Nile  |  6650  |  Africa  |
+| Nile  |  6650|Africa  |
-| Amazon  |  6400  |  South America  |
+| Amazon  |  6400|South America  |
-| Yangtze  |  6300  |  Asia  |
+| Yangtze  |  6300|Asia  |
-| Mississippi  |  6275  |  North America  |
+| Mississippi  |  6275|North America  |
-| Nile  |    |    |  Mediterranean  |
+| Nile  |    |    |Mediterranean  |
-| Amazon  |    |    |  Atlantic Ocean  |
+| Amazon  |    |    |Atlantic Ocean  |
-| Yangtze  |    |    |  East China Sea  |
+| Yangtze  |    |    |East China Sea  |
-| Mississippi  |    |    |  Gulf of Mexico  |
+| Mississippi  |    |    |Gulf of Mexico  |
+\\
+=====More examples=====
+  * [[https://community.easymorph.com/t/excel-import-date-headings-as-number/2297|Community:  Excel: Import Date Headings as number]]
+  * [[https://community.easymorph.com/t/product-of-rows-in-a-column/1854/2|Community:  Product of Rows in a Column
+]]
+  * [[https://community.easymorph.com/t/how-to-parse-edi-file-e-g-x12-transaction-set-837/2267|Community:  How to parse EDI file (e.g. X12 transaction set 837)]]
-=== See also ===
+\\
-  * [[transformations:merge|Blend in another table]]
+=====See also=====
+  * [[transformations:merge|Merge another table]]
+  * [[transformations:peek|Peek]]