Differences

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

--- transformations:call [2016/07/01 07:50] – dmitry
+++ transformations:call [2021/05/22 23:24] – craigt
@@ Line 1: / Line 1: @@
-===== Call =====
+{{ transformations:CallAction.png}}
+====== CALL ======
+Category: Workflow / Internal \\
-Runs another project once. The input dataset of Call transformation is passed into the called project. The called project should use [[transformations:input|Input]] transformation in order to receive the dataset.
+\\
+=====Description=====
+This action runs another project once. The input dataset of the //Call// action is passed into the called project. The called module or project should use [[transformations:input|Input]] action in order to receive the dataset.
-Depending on transformation settings a resulting table can be returned into the calling project, or not.
+Depending on action settings, a resulting table may or may not be returned to the calling project.
-This transformation is available in Professional edition only.
-**Use cases**
+\\
+=====Use cases=====
   * Run another project without iterating.
-  * Custom re-usable transformations.
+  * Custom re-usable actions.
-**See also**
+\\
+=====Action settings=====
+^Setting^Description^
+|Module/Project to run<sup>*</sup>|Select whether to call a module (within the current project), or an external project (.morph file), then select the\\ module, or browse to the project file.|
+|Mode|Select whether a result table will be returned, or not, or if errors will be captured.  Options: //Do not return result table//,\\ //Return table// (and select the table to be returned), or //Capture errors and continue//.|
+|Assign parameters|If values will be passed into the called module/project via parameters, select the parameter name to use,\\ and the value<sup>*</sup> being passed in.|
+<sup>*</sup> Setting can be specified using a [[:parameters|parameter]].\\
+\\
+=====Remarks=====
+The called process - whether a module in the same project file, or a different project file - needs to start with an [[transformations:input|Input]] action to receive the dataset sent by the //Call// action.\\
+  - Set up an Input action in a new module (or project file).
+  - In the //calling// process, add and configure the Call action pointing to the new target module or project file.
+  - Back in the //called// process, select "Populate automatically" to connect to the data from the Call action (in called //modules// only).  For called //project files//, you'll either need to "Paste data" (copied from the data source) or "Import dataset" (from a previous-saved .dset file), to populate the //Input// with sample data.\\
+The //Call// action's resultant dataset will either be the dataset returned from the called process (if "Return table" was selected), or the dataset passed to it in the current workflow (if "Do not return result table" was selected).\\
+\\
+=====Examples=====
+**Call a module in the same project (select module):**
+{{  transformations:call_module_pic.png?720  }}
+\\ \\ \\
+**Call a module in another project (browse to project file):**
+{{  transformations:call_project_pic.png?720  }}
+\\
+=====See also=====
   * [[transformations:input|Input]]
   * [[transformations:iterate|Iterate]]
+  * [[transformations:iteratecolumns|Iterate columns]]
+  * [[transformations:iteratetable|Iterate table]]