Dev Space

Customize & extend the power of Alteryx. SDKs, APIs, custom tools, and more!

General Discussions has some can't miss conversations going on right now! From conversations about automation to sharing your favorite Alteryx memes, there's something for everyone. Make it part of your community routine!


Input PDFs (they are images)

11 - Bolide

Hey @Awesomeville, so I ended up taking a shot at this Azure service today.  I was able to sign up for the free tier and start testing things out.


I was able to get a custom tool working that sends images and PDFs to the Azure endpoint, waits for Azure to process the files, and then downloads and parses the results.  I tested this on some handwritten sentences I wrote and scanned to PDF for testing, and am amazed at how well it works.  I can see a huge potential use case for my department regarding things like contract analysis.  This is a powerful OCR service Microsoft provides.  The tool is attached to this message if you want to try it out.  Let me know if you run into issues.  Also, you can view the code here on GitHub.


If you want to talk about how it works, feel free to start a discussion and I can walk you through the code.

9 - Comet
9 - Comet

Not too shabby at all @tlarsen7572  (awesome)



7 - Meteor

Thanks for the awesome work!


I can't input the tool so will need to use the code on GitHub. Can you walk me through how to put this into a workflow? I'm quite new to the Python SDK world. 


If you attach an example workflow showing how to convert a PDF into data, that would be perfect

11 - Bolide

Hey @MattDuncan, welcome to the Python SDK world!


The easiest place to start would be installing the tool from the yxi.  What do you mean by, 'I can't input the tool'?  Inside the zip should be a yxi file.  Extract it and open it from Alteryx.  Alteryx will present an installation dialog.  Once you install the tool you can find it in the Laboratory tab:



If you cannot find the Laboratory tab, click the plus sign at the right of the tabs and make sure Laboratory is selected:



Once the tool is installed, start your workflow by creating a list of file paths you want converted.  I usually use the Text Input tool or the Directory tool for this:



Add the OCR tool and configure it with the endpoint and key from your Azure portal:



The easiest way to get the endpoint and key is to go to the Overview or Quick start sections on Azure.  This is what my Quick start looks like.  I can copy the endpoint and key right from this page and paste it into the Alteryx tool:



And that should be it.  The beauty of the Python SDK is that there is no configuration required on your end beyond installing the tool with the YXI file.  If you are having an error doing so, let us know and we can troubleshoot.

5 - Atom

Hi @


Thank you for sharing! I was able to successfully install the OCR tool in Alteryx. However, I've been having trouble locating the endpoint to use in the configuration since my Quick Start section in Azure doesn't look like yours in the screenshot. In an attempt to create an endpoint, I added a virtual machine in Azure with a static IP address and tried to use that as the endpoint. Though, I'm not sure if that is correct or necessary.


I was also unsure if the Subscription Key needed for the configuration is the same as the Subscription ID that I see in Azure. I would greatly appreciate any tips you have on how to overcome this!

11 - Bolide

Hi @Jamie12!  Did you create a Computer Vision resource in your Azure portal?  I just checked my Quick Start and it hasn't changed it's appearance.


From the home page of your Azure portal, click 'Create a resource'

Computer Vision 1.JPG


Search the marketplace for 'computer vision'.  You should see something like below

Computer Vision 2.JPG


Once you create the Computer Vision resource, you should have access to the Quick Start page that looks like mine and which will provide you with the key and the endpoint.


Does that help, or are you still unable to access the API?

5 - Atom

That did the trick! Thank you so much @

8 - Asteroid

Awesome tool! @tlarsen7572. Is there any way to see the backend code behind the tool? I know you can do this for macros but I can't figure out in this case. I am guessing this was developed using the python SDK? 

11 - Bolide

Hi @trettelap, glad you like the tool!  It certainly was developed using the Python SDK.


The code is available on GitHub here.  Also, you can see the code on your local PC at one of the following paths:


If you installed the tool as admin: C:\ProgramData\Alteryx\Tools\OCR

If you installed the tool user-specific: C:\Users\Your User Name\AppData\Roaming\Alteryx\Tools\OCR

5 - Atom

Hey @tlarsen7572 I downloaded the OCR tool and was able to input a pdf into alteryx. However, it seems that it's not taking any pdf documents above 200 KB, do you have any idea why and how I could fix this if possible? Thanks 🙂