AlteryxEngine API Overview

Version:
Current
Last modified: June 11, 2020

The AlteryxEngine API allows you to call into the Alteryx Engine. This provides you with the ability to build applications that can programmatically execute Alteryx Designer workflows.

To do this, link your application with the Alteryx.lib library, and then call into the engine using the methods defined in the AlteryxEngineAPI.h header. The engine checks that Alteryx is licensed whenever it receives a request to execute a workflow.

Prerequisites

  • A licensed copy of Alteryx
  • Knowledge of C++

You can download the AlteryxSDK from the Alteryx Designer installation folder: C:\Program Files\Alteryx\APIs\AlteryxSDK.zip.

API Use

Workflows and applications can be executed one of two ways, a separate child process, and in-process. The calling convention for the two styles differs only in the name of the method, so it is easy to switch back and forth between them. Using a child process is recommended because it isolates the calling application from unexpected runtime errors. There is a small performance penalty when using a child process when messages are marshalled between the engine and the caller. The AlteryxEngine API Methods and Callbacks help pages provide a description, syntax, parameters and example:

  • Methods: A collection of methods used for workflow interactions. For example, you can change the configuration of the engine before running a workflow or query the currently installed version of Alteryx. See Alteryx Engine API Methods.
  • Callbacks: Callbacks allow you to define a function that the Alteryx Engine will call based on certain events. See AlteryxEngine¬†API Callbacks.
  • See AlteryxEngine API Example for an example of using Methods and Callbacks together.

Steps to Use the AlteryxEngine API

  1. Build your application.
  2. Link your application with the Alteryx.lib library.
  3. Call in to the engine using the methods defined in the AlteryxEngineAPI.h header.
Was This Helpful?

Running into problems or issues with your Alteryx product? Visit the Alteryx Community or contact support.