Differences

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

--- transformations:append [2015/04/17 23:33] – elenap
+++ transformations:append [2025/01/10 16:23] (current) – craigt
@@ 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
+  * Append columns
+\\
-EXAMPLE
+=====Use cases=====
+  * 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.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.
+  * Concatenation of similar datasets.
+  * Incremental loading.
+\\
+=====Remarks=====
+To append multiple datasets, apply the "Append" action multiple times.
-**Table 1:** The longest rivers in the world
+\\
+=====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  ^  Length (km)  ^  Continent  ^
+Regardless of the mode, a dotted line will connect this action to the appended dataset in the application window.
-| Nile  |  6650  |  Africa  |
-| Amazon  |  6400  |  South America  |
-| Yangtze  |  6300  |  Asia  |
-| Mississippi  |  6275  |  North America  |
-**Table 2:** The outflow
+\\
+=====Examples=====
-^  River  ^  Outflow  ^
+====Example #1====
-| Nile  |  Mediterranean  |
+>Append Table 2 to Table 1 as additional columns.
-| Amazon  |  Atlantic Ocean  |
-| Yangtze  |  East China Sea  |
-| Mississippi  |  Gulf of Mexico  |
+===Before (source table)===
+Table 1: Rivers list
-**Objective:** Append Table 2 to Table 1
+^River  ^Continent  ^
+| Nile  |Africa  |
+| Amazon  |South America  |
-**Result:**
+Table 2: The outflow
-^  River  ^  Length (km)  ^  Continent  ^  Outflow  ^
+^River  ^Outflow  ^
-| Nile  |  6650  |  Africa  |
+| Nile  |Mediterranean  |
-| Amazon  |  6400  |  South America  |
+| Amazon  |Atlantic Ocean  |
-| Yangtze  |  6300  |  Asia  |
-| Mississippi  |  6275  |  North America  |
+===After (result table)===
-| Nile  |    |    |  Mediterranean  |
+^River  ^Continent  ^Outflow  ^
-| Amazon  |    |    |  Atlantic Ocean  |
+| Nile  |Africa  |
-| Yangtze  |    |    |  East China Sea  |
+| Amazon  |South America  |
-| Mississippi  |    |    |  Gulf of Mexico  |
+| Nile  | |**Mediterranean**  |
+| Amazon  | |**Atlantic Ocean**  |
+===Action parameters===
+>Append columns to the right
+\\
+=====Community examples=====
+  * [[https://community.easymorph.com/t//675/5|Compare two Excel sheets with EasyMorph]] ([[https://community.easymorph.com/uploads/short-url/xQLWtAogCqcMrglyfXLKmrAF7aR.morph|Project]]; Module: //Main//; Group: //Compare column names//; Table: //Compare column names//; Action position: //2//)
+  * [[https://community.easymorph.com/t//1854/2|Product of Rows in a Column]] ([[https://community.easymorph.com/uploads/short-url/8o7F1FHzlEr0hUV2BgCLFNEMKqk.morph|Project]]; Module: //Main//; Group: //Tab 1//; Table: //Result//; Action position: //2//)
+  * [[https://community.easymorph.com/t//1926/3|Sort column in an export alphabetically (tab)]] ([[https://community.easymorph.com/uploads/short-url/b1cFUp2TMl0yEassYLlT4oO3hxp.morph|Project]]; Module: //Main//; Group: //Enum/pivot/append//; Table: //Result//; Action position: //2//)
+  * [[https://community.easymorph.com/t//2267/1|How to parse EDI file (e.g. X12 transaction set 837)]] ([[https://community.easymorph.com/uploads/short-url/6tzpyfamtKPeOq37FyUjBxKud4F.morph|Project]]; Module: //Build line//; Group: //Append result//; Table: //Result//;\\ Action position: //5//)
+  * [[https://community.easymorph.com/t//2297/2|Excel: Import Date Headings as number]] ([[https://community.easymorph.com/uploads/short-url/ppgiXxeiQbK0O3owwca3pxAsOyH.morph|Project]]; Module: //Main//; Group: //Group 1//; Table: //New header//; Action position: //6//)
+\\
+=====See also=====
+  * [[transformations:merge|Merge another table]]
+  * [[transformations:peek|Peek]]
-=== See also ===
-  * [[transformations:merge|Blend in/ Merge another table]]