Differences

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

--- transformations:input [2016/06/19 20:19] – created dmitry
+++ transformations:input [2021/03/19 17:44] – craigt
@@ Line 1: / Line 1: @@
-===== Input =====
+{{ transformations:InputAction.png}}
+====== INPUT ======
+Category: Create / Input
+=====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 transformation works together with [[transformations:call|Call]] transformation in another project. It obtains input dataset of [[transformations:call|Call]] transformation of the other project that called current project. If current project was not called from another project 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.\\
-To simplify development, it is possible to paste test data from the clipboard into Input transformation, similarly to [[transformations:sandbox|Sandbox]] transformation. Typically, a small subset is pasted and then used for designing transformation. The pasted data is not saved and doesn't survive project re-opening.
+\\
+=====Populating the Input dataset from within the same project=====
+====Within the Input action====
+^Option^Description^
+|Populate automatically|This option will attempt to retrieve data from a Call or Iterate... action within the same project.|
+|Paste data|This option will paste data that has been copied to the clipboard.  Options for //headers//, //delimiters//, and //decimal//\\ provide fine-tuning of the pasted data.|
+|Import dataset|This option allows for browsing to and selecting an external dataset (.dset file) to populate the Input action with.|
-**See also**
+====Externally====
-  * [[transformations:call|Call]]
+^Option^Description^
+|Send to //module//|Data can be sent to the Input action by right-clicking on an action that produces data in the calling module and selecting\\ //Send to sandbox/module//. Select the module containing the Input action from the list at the bottom of the menu.|
+|Send to clipboard|Data can be sent to the clipboard by right-clicking on an action that produces data in the calling module and selecting\\ //Send to sandbox/module// and choosing //Send to Clipboard//.  From the Input action, choose the //Paste data// option.|
+\\
+=====Populating the Input dataset from another project=====
+An Input action called from another project cannot be //automatically// populated with preliminary 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=====
+Such a table can be used later for iterations, folder commands, or file commands.\\
+\\
+=====See also=====
+  * [[transformations:call|Call]]
+  * [[transformations:iterate|Iterate]]
+  * [[transformations: iteratecolumns|Iterate columns]]
+  * [[transformations:iteratetable|Iterate table]]
+  * [[transformations:iterateprogram|Iterate external program]]