Skip to main content

AlteryxRunWizard_Pipe

AlteryxRunWizard_Pipe AlteryxEngine API method is used to run a wizard in a separate process and memory space from the calling application. Returns 0 if an error occurs; non-zero when successful.

Important

In server-side applications, use AlteryxRunWizard_Pipe instead of AlteryxRunWizard unless performance is a critical concern.

The AlteryxRunWizard and AlteryxRunWizard_Pipe methods are identical except the AlteryxRunWizard_Pipe runs the application in a separate process and memory space 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 application is run. This can increase processing time.

Method Declaration

int AlteryxRunWizard( 
        const wchar_t* strXmlModule,
        const wchar_t* strXmlWizardValues,
        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.

  • strXmlWizardValues: The application values XML. The strXmlWizardValues parameter must contain an XML string value that includes the values for the questions the application requires to run. Find the XML string by clicking the Test button on the Questions or Actions tab in the application's Properties window. This displays the application's Show Values button. Click Show Values to display the XML that Alteryx is expecting.

  • 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

AlteryxRunWizard(strWizard, wizardValues, NULL, NULL, 
  pCallbackMessage, 0);
In this section: