AlteryxRunModule_Pipe2
AlteryxRunModule_Pipe2 is used to run a workflow in a separate process and memory space from the calling application.
Returns 0 if an error occurs; non-zero when successful.
Reason: The AlteryxRunModule2 and AlteryxRunModule_Pipe2 methods are identical except the AlteryxRunModule_Pipe runs the workflow in a separate process from the calling application. This is useful when running in a server environment and will not cause the calling application to fail if Alteryx encounters a problem.
Risks: This method instantiates the Alteryx Engine each time a workflow is run. This can increase processing time.
Method declaration
int AlteryxRunModule_Pipe2(
const wchar_t* strXmlModule,
const wchar_t* strPathContext,
TCallbackToolProgress pCallbackToolProgress,
TCallbackMessage pCallbackMessage,
__int64 userData
)
strXmlModule: A path to the workflow, or a string containing the full XML of the workflow to be run.
strPathContext: The default path for resolving relative paths in the workflow. If strXmlModule was set to a file, this is optional and will default to the path of the file.
pCallbackToolProgress: A callback function for progress of individual tools. Optional - can be NULL
. See TCallbackToolProgress for more information.
pCallbackMessage: A callback function for status messages. Optional - can be NULL
. See TCallbackMessage for more information.
userData: User data that will be passed to the callback methods. Optional. Can be 0
if Callbacks are either NULL or do not access userData. See Alteryx Engine API Example for more detail on how to define a custom userData structure.
Example
AlteryxRunModule_Pipe2(strModule, NULL, NULL, pCallbackMessage, 0);