Differences

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

--- transformations:append [2015/04/17 23:33] – elenap
+++ transformations:append [2021/07/19 02:32] (current) – [Examples] 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====
+ 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=====
+**Example:** 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
-**Objective:** Append Table 2 to Table 1
+^River  ^Outflow  ^
+| Nile  |Mediterranean  |
+| Amazon  |Atlantic Ocean  |
+| Yangtze  |East China Sea  |
+| Mississippi  |Gulf of Mexico  |
+\\
+**Action parameters:**
+>  Append columns to the right
+\\
+**Result table:**
-**Result:**
+^River  ^Length (km)  ^Continent  ^Outflow  ^
+| Nile  |  6650|Africa  |
+| Amazon  |  6400|South America  |
+| Yangtze  |  6300|Asia  |
+| Mississippi  |  6275|North America  |
+| Nile  |    |    |Mediterranean  |
+| Amazon  |    |    |Atlantic Ocean  |
+| Yangtze  |    |    |East China Sea  |
+| Mississippi  |    |    |Gulf of Mexico  |
-^  River  ^  Length (km)  ^  Continent  ^  Outflow  ^
+\\
-| Nile  |  6650  |  Africa  |
+====Community examples====
-| Amazon  |  6400  |  South America  |
+  * [[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//)
-| Yangtze  |  6300  |  Asia  |
+  * [[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//)
-| Mississippi  |  6275  |  North America  |
+  * [[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//)
-| Nile  |    |    |  Mediterranean  |
+  * [[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//)
-| Amazon  |    |    |  Atlantic Ocean  |
+  * [[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//)
-| Yangtze  |    |    |  East China Sea  |
-| Mississippi  |    |    |  Gulf of Mexico  |
-=== See also ===
+\\
-  * [[transformations:merge|Blend in/ Merge another table]]
+=====See also=====
+  * [[transformations:merge|Merge another table]]
+  * [[transformations:peek|Peek]]