This node can be used to call other workflows that reside either locally or remotely on the KNIME Hub. The called workflow may contain one or multiple of the following nodes to receive data from the workflow containing this node:
Container Input (Table)
Container Input (Variable)
Container Input (Credentials)
\n It may also contain a \n Container Output (Table)\n node\n to define the interface between this workflow and the called workflow in the following way: \n \n \n \n \n Send Table. \n The data table provided at the input of the \n Call Workflow (Table Based)\n node can be sent to a \n Container Input (Table)\n node in the called workflow via the input parameter\n defined in the \n Container Input (Table)\n node \n \n \n \n \n Receive Table.\n After the\n execution of the called workflow, a data table can be received from a \n Container Output (Table)\n node in the called workflow via the output parameter defined in the \n Container Output (Table)\n node. The received data table will be made available at the output port of the \n Call Workflow (Table Based)\n node \n \n \n \n \n Send Flow Variables.\n Certain flow variables available in the\n \n Call Workflow (Table Based)\n node can be sent to a \n Container Input (Variable)\n node in the\n called workflow. Currently, neither boolean, long, nor list or set flow variables are supported and will\n be ignored without warning. The supported types are mostly converted to string flow variables (e.g.,\n path or URI flow variables), except for integer flow variables and non-NaN double flow variables. Note\n that the \n Call Workflow Service\n node supports all flow variable types. \n \n \n \n \n Send Flow Credentials.\n All flow credentials available in the \n Call Workflow (Table Based)\n node can be\n sent to a \n Container Input (Credential)\n node in the called workflow via the credential-input\n defined in the \n Container Input (Credential)\n node\n \n \n \n To call workflows on a KNIME Hub, a\n \n KNIME Space Connector\n node must be connected to this node. You can add a File System Connection\n port by clicking on the three dots on the node. \n \n \n \n ","shortDescription":"Calls workflows","keywords":[],"deprecated":false,"streamable":false,"tags":["Workflow Abstraction","Workflow Invocation"],"icon":"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAE6SURBVHgBpVI9S8NQFD331Q8oDh0DiiSg7nZKhIpuoj/CaP6AjtKhLkL/RKlrW3VT3Iyg8v5AXS3SIWMlWeqQmPdqgpGXUNozvXffvfec+84F5kSp6LG2Y9rrq2uVz+FwkJezUNSAImoQk0cjL4ehgB0EPT7qNcs6yyVRBfdMUw+Jnn4bCIzY0rLhuu5oKgUh4fJPsUAlHI8bUymQ7Iw+VMnfYWRwzgeFCiR7jKtmE5qmZd4WidqFCsTHESZJz69vMvb4cI92qwXP8yYEYbT/wrmrVCBs+89wcHiEzu0dLup1qYixrIpShp3ITu4njpNptLG5he1qFe/9fmWlXP6Kl4unIyhsS0cQCAIfvU4XN70uAt8XodRWuYkK2/IKEyS2nlOebfapoyrMQNhKu5Z5DaJjzIAogot58QOo3Hc17XpigwAAAABJRU5ErkJggg==","views":[],"inPorts":[{"objectClass":"org.knime.core.node.BufferedDataTable","color":"000000","dataType":"Table","optional":false,"name":"Input table","description":"The data to send to the callee workflow."}],"outPorts":[{"objectClass":"org.knime.core.node.BufferedDataTable","color":"000000","dataType":"Table","optional":false,"name":"Output","description":"Data returned by the callee workflow."}],"dynInPorts":[{"groupName":"File System Connection","groupDescription":"An optional connection to a file system that contains the callee workflow or a hub instance that provides deployed workflows. The callee workflow will be executed where it is located, e.g., on the KNIME Hub. If a Hub Authenticator is connected, only workflows that have previously been deployed can be executed. If a Space Connector or Mountpoint connector is connected, any workflow can be selected and executed.","types":[{"objectClass":"org.knime.filehandling.core.port.FileSystemPortObject","color":"178ba5","dataType":"File System"},{"objectClass":"org.knime.workflowservices.connection.AbstractHubAuthenticationPortObject","color":"9b9b9b","dataType":"AbstractHubAuthenticationPortObject"}]}],"dynOutPorts":[],"additionalSiteInformation":{"url":"https://update.knime.com/analytics-platform/5.12","trusted":true,"enabledByDefault":true,"name":"KNIME Analytics Platform 5.12 Update Site","version":"5.12.0"},"dialog":[{"sectionName":"Options","fields":[{"name":"Invocation duration","description":"Choose the expected duration of the called workflow execution.\n
Long duration : Choose this if the called workflow is expected to run for more than ten seconds. When selected, the invocation will poll its status repeatedly until the job completes (or fails). The polling is implemented so that for the first few seconds there will be frequent status checks (poll interval 100ms or 500ms), whereas jobs that run minutes or hours will be checked only every few seconds.
Short duration : Choose this if the called workflow is expected to finish within ten seconds. When selected, the invocation will not poll its status but wait until the job completes (or fails). This removes the polling overhead and makes this option quicker for short-running workflows. Choosing this option for long-running workflows (> a minute) will cause timeout problems.
","optional":false},{"name":"Retain job on failure","description":"When selected, failing jobs of the called workflow will be kept on the remote executor. This can be useful for debugging purposes. When not selected, the failing jobs will be discarded.","optional":false},{"name":"Discard job on successful execution","description":"When selected, successful jobs of the called workflow will be discarded from the remote executor. When not selected, successful jobs will be kept.","optional":false},{"name":"Workflow","description":"The path to the workflow you want to call.","optional":false},{"name":"Workflow version","description":"If available, select the version of the workflow to read. A limited number of versions will be fetched and provided in a dropdown menu. If the desired version is not included in the dropdown list, it can be set with a flow variable (e.g. "333" for version 333 on the hub).","optional":false},{"name":"Execution context","description":"Only for workflows on a KNIME Hub. The workflow will be executed in the selected context. An execution context of a hub space defines for instance the installed extensions, available credentials, and the pool from which computation resources are used when the service is invoked.","optional":false},{"name":"Deployment","description":"The deployed workflow to execute. This option is only visible when the node is connected to a KNIME Hub Authenticator node.","optional":false},{"name":"Read input table from","description":"The data table provided at the input of the Call Workflow (Table Based) node can be sent to a Container Input (Table) node in the called workflow via the input parameter defined in the Container Input (Table) node.","optional":false},{"name":"Fill output table from","description":"After the execution of the called workflow, a data table can be received from a Container Output (Table) node in the called workflow via the output parameter defined in the Container Output (Table) node. The received data table will be made available at the output port of the Call Workflow (Table Based) node.","optional":false},{"name":"Push flow variables to","description":"Certain flow variables available in the Call Workflow (Table Based) node can be sent to a Container Input (Variable) node in the called workflow. Currently, neither boolean, long, nor list or set flow variables are supported and will be ignored without warning.","optional":false},{"name":"Push flow credentials to","description":"All flow credentials available in the Call Workflow (Table Based) node can be sent to a Container Input (Credential) node in the called workflow via the credential-input defined in the Container Input (Credential) node","optional":false},{"name":"Use fully qualified names for parameters","description":"If checked, use the full parameter name to select the input and output. The parameter names are defined by the user in the configuration dialog of each of the parameters (like Container Input (Table) and Container Output (Table)node), e.g. "timeout", "count", etc. Using these 'simple names' may lead to duplicates, hence a 'fully qualified name' is constructed by appending a suffix, e.g. "timeout-1" or "count-5:6". While these suffixes guarantee unique parameter names across one workflow they may cause names not to match in case you call out to different workflows (e.g. in a loop). It's good practice to (manually) ensure that parameter names in the called workflow are unique and hence often the 'simple name' is sufficient (= do not check the box).\n \n \nIn the case a parameter defined in any of the Container Input (Table) , Container Output (Table) or Container Input (Variable) nodes is not unique, the node ID will be appended to the parameter even though the use fully qualified names check box has not been checked.","optional":false},{"name":"Workflow load timeout","description":"The maximum amount of time to wait for the remote executor when trying to initialize remote workflow execution. Specified in seconds. A value of 0 means that no timeout will be used.","optional":false},{"name":"Fetch parameters timeout","description":"The maximum amount of time to wait for the remote executor when fetching the input and output parameters of the called workflow. Specified in seconds. A value of 0 means that no timeout will be used.","optional":false},{"name":"Base timeout (milliseconds)","description":"During asynchronous invocation (option "Long duration"), if a HTTP 5XX error occurs when polling for the job status, the node will retry the request. The node will wait a certain amount of time before each retry. The time to wait before the n -th attempt is determined by base * multiplier^n .","optional":false},{"name":"Multiplier","description":"The multiplier for the backoff delay calculation. Use a multiplier of 1 for a constant backoff, or a multiplier greater than 1 for an exponential backoff.","optional":false},{"name":"Maximum number of retries","description":"The maximum number of retries. Set to 0 to disable retrying.","optional":false}]}],"links":[],"kudos":[],"kudosCount":0,"bundleInformation":{"bundleVersion":"5.12.0.v202604301232","bundleName":"KNIME Nodes to build and use KNIME workflow services","bundleSymbolicName":"org.knime.workflowservices","bundleVendor":"KNIME AG, Zurich, Switzerland","featureSymbolicName":"org.knime.features.personalproductivity","featureName":"KNIME Personal Productivity Tools","featureVersion":"5.12.0.v202605041104","featureVendor":"KNIME AG, Zurich, Switzerland","extensionId":"*P5Q0cAn8GZLrQ9v-"},"frequentSuccessors":[]}