Differences

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

--- transformations:append [2020/12/04 08:00] – dmitry
+++ transformations:append [2021/04/03 23:01] – craigt
@@ Line 1: / Line 1: @@
-===== Append table =====
+{{ transformations:AppendTableAction.png}}
+====== APPEND ANOTHER TABLE ======
+Category: Transform / Basic\\
-Appends another table. The action can operate in 2 modes:
+\\
+=====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.
-**Appends rows** - the other table (dataset) is appended as new rows at the bottom of current table. Columns with the same name in both tables appear as one column in the result table. Columns on 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.\\
-This mode has the useful feature of preserving the order of columns of the main dataset to which the other dataset is appended.
+\\
+=====Use cases=====
+  * (Append rows) To combine two smaller, similar datasets to create a single consolidated dataset.
-**Append columns** - the other table (dataset) is appended as new columns to the right. Columns from the appended table with the same name as in the main table are automatically renamed. The length of the resulting table has the length of the longest of the two table.
+\\
+=====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)|
-EXAMPLE
+Regardless of the mode, a dotted line will connect this action to the appended dataset in the application window.
+\\
+=====Examples=====
+**Objective:** Append Table 2 to Table 1 as additional columns.
 **Table 1:** The longest rivers in the world
-^  River  ^  Length (km)  ^  Continent  ^
+^River  ^Length (km)  ^Continent  ^
-| 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  |
 **Table 2:** The outflow
-^  River  ^  Outflow  ^
+^River  ^Outflow  ^
-| 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  |
+\\
+**Action parameters:**
-**Objective:** Append Table 2 to Table 1
+>  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|Example #1]]
+=====More examples=====
-  * [[https://community.easymorph.com/t/product-of-rows-in-a-column/1854/2|Example #2]]
+  * [[https://community.easymorph.com/t/excel-import-date-headings-as-number/2297|Community:  Excel: Import Date Headings as number]]
-  * [[https://community.easymorph.com/t/how-to-parse-edi-file-e-g-x12-transaction-set-837/2267|Example #3]]
+  * [[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 ===
+\\
+=====See also=====
   * [[transformations:merge|Merge another table]]
   * [[transformations:peek|Peek]]