| Both sides previous revisionPrevious revisionNext revision | Previous revision |
| transformations:input [2021/03/19 17:44] – craigt | transformations:input [2021/07/18 02:03] (current) – craigt |
|---|
| {{ transformations:InputAction.png}} | {{ transformations:InputAction.png}} |
| ====== INPUT ====== | ====== INPUT ====== |
| Category: Create / Input | Category: Create / Input\\ |
| | |
| | \\ |
| =====Description===== | =====Description===== |
| This transformation works together with the [[transformations:call|Call]], [[transformations:iterate|Iterate]], [[transformations:iteratecolumns|Iterate columns]], [[transformations:iteratetable|Iterate table]], or [[transformations:iterateprogram|Iterate external program]] actions. It obtains an input dataset from the project that called current project. If current project was not called from another project then Input returns empty dataset. | This action works together with the [[transformations:call|Call]], [[transformations:iterate|Iterate]], [[transformations:iteratecolumn|Iterate column]], [[transformations:iteratetable|Iterate table]], or [[transformations:repeat|Repeat]] actions. It obtains an input dataset from the module (or project) that called current module. If the current module was not called from another module (or project) then Input returns empty dataset.\\ |
| |
| To simplify development, it is possible to paste test data from the clipboard into Input action, similar to the [[transformations:sandbox|Sandbox]] action. Typically, a small subset is pasted for use in designing the workflow. The pasted data is not saved and does not survive project re-opening.\\ | \\ |
| | =====Use cases===== |
| | The Input action passes data between modules in memory which helps avoid potentially slow reading datasets from disk or writing to disk in every iteration or call. By removing the need to read/write datasets to disk, the action simplified workflows.\\ |
| |
| \\ | \\ |
| |
| \\ | \\ |
| =====Populating the Input dataset from another project===== | =====Remarks===== |
| An Input action called from another project cannot be //automatically// populated with preliminary data. Either | To simplify development, it is possible to paste test data from the clipboard into Input action, similar to the [[transformations:sandbox|Sandbox]] action. Typically, a small subset is pasted for use in designing the workflow. The pasted data is not saved and does not survive project re-opening.\\ |
| a .dset file export must be made from the calling dataset and imported into the Input action, or, the calling dataset must be copied to the clipboard and pasted into the receiving Input action. | |
| | An Input action called from another project cannot be //automatically// populated with test data. Either a .dset file export must be made from the calling dataset and imported into the Input action, or, the calling dataset must be copied to the clipboard and pasted into the receiving Input action.\\ |
| |
| \\ | \\ |
| =====Use cases===== | =====Community examples===== |
| Such a table can be used later for iterations, folder commands, or file commands.\\ | * [[https://community.easymorph.com/t//1625/4|Create a new table with columns based on row values]] ([[https://community.easymorph.com/uploads/short-url/4oGLUNDHrUfB971H80ciuOAtOTG.morph|Project]]; Module: //Module 1//; Group: //Tab 1//; Table: //Table 1//; Action position: //1//) |
| | * [[https://community.easymorph.com/t//1749/2|Match action - matching multiple values]] ([[https://community.easymorph.com/uploads/short-url/klCJavldZpx8EQbvoCRW6a6cYlr.morph|Project]]; Module: //Get matches//; Group: //Tab 1//; Table: //Lookup table//; Action position: //1//) |
| | * [[https://community.easymorph.com/t//1870/4|Send email - Add table extract to outlook email message]] ([[https://community.easymorph.com/uploads/short-url/xnfDuDCTN6iJgA4pEcQQsRIZET3.morph|Project]]; Module: //Calc column width//; Group: //Tab 1//; Table: //Table 1//;\\ Action position: //1//) |
| | * [[https://community.easymorph.com/t//2160/1|How to pull data from web APIs with pagination]] ([[https://community.easymorph.com/uploads/short-url/dvCSpcEDXYZ8aB0B2gtnt7qulTF.morph|Project]]; Module: //Query API//; Group: //Group 1//; Table: //Input//; Action position: //1//) |
| |
| \\ | \\ |
| * [[transformations:call|Call]] | * [[transformations:call|Call]] |
| * [[transformations:iterate|Iterate]] | * [[transformations:iterate|Iterate]] |
| * [[transformations: iteratecolumns|Iterate columns]] | * [[transformations: iteratecolumn|Iterate column]] |
| * [[transformations:iteratetable|Iterate table]] | * [[transformations:iteratetable|Iterate table]] |
| * [[transformations:iterateprogram|Iterate external program]] | * [[transformations:iterateprogram|Iterate external program]] |
