Thursday, July 4, 2019

Debugging Alteryx Analytic Apps

Analytic Apps in Alteryx are great, they can either be hosted on an Alteryx Server with a web-based user interface which allows non-Alteryx users to run the workflow or a user with Designer can run them on their desktop without devling inside the workflow. This post isn't focused on what an Analytic App is or how to build them. If you want to know more about creating Analytic Apps then check out this Alteryx YouTube video.

I use Analytic Apps a lot as they are a way of having a user easily run a workflow on new data without fiddling around with the workflow to point the input tools at the new datasource. However, as I recently found out, a downside of running an app is you don't get the benefit of running the workflow directly inside Designer to see what happens to the flow of your data (which is one of the reasons I love Alteryx). For example, in Designer it is clear how many records are passing through each tool.

Capture.PNG

However, when you run it as an analytic app it becomes a bit of a black box. Yes you can see the results window which tells you some of the information but you don't get to see your data at each anchor like you do in Designer. So if something unexpected starts happening to your workflow it can tricky to workout why.
Capture2

Debugging mode to the rescue

So I need to admit now, that when Interface Designer window is loaded this big button called 'Open Debug' I'd never pressed before and while it's obvious from the name it was only after a couple of hours of going 'the workflow runs fine in Designer, I can't work out why when it is run as an app that it goes wrong?' that I decided to press it and see what it does! So the workflow that I discovered this on was the one below where I have lots of nested text input boxes and detour tools to run an API via different end points depending on the user's inputs. Capture3

Analytic App.gif

I was finding that I could run the workflow in Designer fine, and I would manually update the direction of the detour tools to run each branch of the workflow and hence check each API call was working correctly. Yet when I tried to do the same in the App Interface I was getting errors as the API calls were not being correctly formed, which is when I turned to Debug mode. Debug mode is activated in the Interface Designer. First press on the magic wand icon to load up this screen (below) and then complete the Analytic App with the data you want, then click on the 'Open Debug' button to the right.
Debug1

This then opens up a new workflow with the settings from the App detailed at the top of the workflow.

  Debug2.PNG

You can now run the workflow and see the data running through the workflow to help understand where the Analytic App is (or in my case not) updating a specific value and flowing through the workflow.

Debug3

As you can see Company X is now passed into the workflow in the q field which was what I selected in the Analytic App so i know it is working as expected and can now save myself many headaches in the future!!!

No comments:

Post a Comment