community
cancel
Showing results for 
Search instead for 
Did you mean: 

Alteryx Knowledge Base

Definitive answers from Designer experts.
Upgrade Alteryx Designer in 10 Steps

Debating whether or not to upgrade to the latest version of Alteryx Designer?

LEARN MORE
Question I am reading a large(ish) .txt file, with fields separated by semicolons. Out of more than 2 million records, on about 800 I get the error: "not enough fields in record" from the Input Data Tool.   Answer This error is very similar to the error mentioned in this article. Generally it refers to an issue where a particular row of data has less delimiters than previous rows. There are a couple of ways to resolve this and fix the row that is causing the issue. Both solutions from the original forum post will help to make it so you can read the file into Alteryx. Personally, I prefer the option where you read in the data file without a delimiter (either specify None or use \0). This forces all the data into a single field which you can then easily parse out using the Text to Columns tool as noted in the first article linked above.   Attached is a sample that shows the parsing method to resolve the issue.   The other way to go about it is to use the process below:   In the Input Tool configuration, there is a "Treat Read Errors as Warnings".  If you check this it will typically allow all the records to be imported and then you can determine where the issue is (it should give you warnings on the records with an issue).    
View full article
Question Why am I getting the error "InvalidArgument=Value of '0' is not valid for 'itemIndex'. Parameter name: itemIndex" when trying to load an Excel file in and Input tool? Answer This error has come up when an Excel file that had the extension .xls, but was saved as .xlsx, or vice versa. The resolution to this is to save the file with the original extension.
View full article
Sometimes when reading a delimited text file (like CSV) an error like this may appear ‘Error reading “FILEPATH\MYFILE.txt”: Too many fields in record #’ The cause of this error is that too many delimiters were located in that specified record. For example if I had a text file with the contents below:   x,y 1,a 2,b 3,c 4,d 5,e 6,f,y   You see that at record 6 (assuming x and y are field headers) I have an extra comma. If I’m specifying the delimiter to be a comma, Alteryx has recognized from the first record that there should only be two columns in this dataset. Since it sees three on record 6, it will error.   If you had the opposite case where you started with three commas for each record then suddenly had two like this:   x,y,z 1,a,p 2,b,r 3,c,t 4,d,y 5,e,z 6,f   You would just get a warning like this: 'Warning: Input Data (1): Record #6: Not enough fields in record' And the last record in the third field will just be null.   So how do we get around this? Well we could always go into the text file itself and edit the file. This could be cumbersome if you have a lot of records in the text file. Instead let’s just use Alteryx to solve our problems.     First, let’s change our Input Data Tool to bring in the file as a non-delimited text file:     Now we can attach the Text To Columns Tool to separate the fields by our specified delimiter.       Now that our fields have been brought in it’s up to you to decide how handle that extra field, we could simply delete it or keep it. If you’re still wondering about its contents we can simply use a filter tool where the Record ID will be set equal to the record number that popped up in the error.   Attached to this article is a workflow I built in 10.6 that should illustrate this example.
View full article
Every so often we get questions about a .tde (Tableau Data Extract) file that is being output from Alteryx that has a file size of 30k when the original data is much larger. When the file is opened in Tableau this error sometimes comes up: An error occurred while communicating with data Source ‘yourfilename.tde’
View full article
When importing a delimited file, have you ever run across an error saying ‘Too many fields in record…’ and it’s something like record number 1478254 and you think to yourself, “how the heck am I going to find that record and correct it?”   Well, let us help you with that.   This message is essentially telling us that some particular row of data, when parsed, has more fields that the first row of data (usually caused by an extra delimiter in that row). The first step in identifying the row is to change the delimiter in the Input Data configuration window. Change the delimiter from the current delimiter to \0 (that is a backslash zero, which stands for no delimiter). This will read in your file but instead of parsing, it’ll just read in the data as is.   Current delimiter:   Versus:   No delimeter:   Now just add a RecordID tool and Filter tool so we can filter on RecordID 2 (or 1478254) to find the row that is holding us up.     Now that you’ve identified the row that is causing issues, you could go back to your original data, correct it and try importing it again.    If you were looking closely at the example data, you may have noticed that record 4 also had a different number of fields as row 1.  After correcting row 2 and importing , again, we would get an error for row 4. Just follow the same procedure to correct additional errors.  This could probably be done through an automated/iterative process, but that will have to wait for another time.   (attached is an example workflow created in Alteryx 10.0)  
View full article
Error: "system.data.oracle client requires 8.1.7 or greater"   Please bear in mind this error is not related to Alteryx but to Oracle. This error message is returned from the Oracle Database, therefore please check with your DBA about the configuration and set up of your machine and server before reaching out to support@alteryx.com. However, we are always happy to help so here are a few troubleshooting tips!   Which database connection did you use? If you tried using the ODBC connection, try using the OCI (New Oracle Connection).  If you do not know what the TNS server name it can be found in the TNSnames.ORA file. Your DBA will also know this.    What permissions do you have? Go to the Oracle Client folder. 2- Right Click on the folder. 3- On security Tab, Add “Authenticated Users” and give this account Read & Execute permission. 4- Apply this security for all folders, Subfolders and Files (IMPORTANT). 5- Don’t Forget to REBOOT your Machine; if you forgot to do this you will still face the same problem unless you restart your machine.  *Before changing any permission settings please check with your IT   How many instances of Oracle do you have installed? Oracle may find it difficult to navigate and select the correct version if it has more than one version installed. If you only need one of them it is better just to remove them all and reinstall the one that is needed.   Do you have the correct drivers installed? One way to check to see if you have the right drivers installed is to set up the DSN connection through Alteryx, navigate to the ODBC admin and see if any drivers populate for either the 32 or 64 bit connections.   Do you have one of the supported client versions? Please see the Technical Specifications   Please bear in mind often this error is not related to Alteryx but to Oracle. This error message is returned from the Oracle Datbase side and therefore please check with your DBA about the configuration and set up of your client before reaching out to Alteryx Support   Best,   Jordan Barker Client Service Support Engineer
View full article
Errors from the R tool, and macros using R, such as the Association Analysis tool, can be a challenge to troubleshoot.  Since R is very particular about naming conventions, and the R macros are very particular about delimiters, one easy way to preemptively limit these errors is to make sure your field names are R-friendly and compliant.   Best practices is to use only letters, numbers and the underscore.  Any special characters will likely upset R. One hint is "Error: No valid fields were selected."  This means that one of the Pipe-to-Rows tools embedded in the R macros could not appropriately parse the field names.   For example, the following errors came from the Association Analysis tool, where the field names contain the gamut from asterisks to ampersands:   Error: Association Analysis (4): The Action "select fields A" has an error: ParseError: Expected entity name for reference at line 7 and column 30 while processing "Action_UpdateRawXml" Error: Association Analysis (4): The Action "select fields A" has an error: ParseError: Expected whitespace at line 13 and column 63 while processing "Action_UpdateRawXml" Error: Association Analysis (3): The Action "select fields A" has an error: ParseError: Unterminated entity reference, 'test' at line 4 and column 30 while processing "Action_UpdateRawXml"   If you have a thousand fields with every special character, don't fret.  Dynamic Rename and regex to the rescue!   Using the Rename Mode: Formula, select all your fields, and replace any non-word character with an underscore:     Crisis averted!  Happy Alteryx-ing.
View full article
Symptoms   My workflow was doing just great, reading in a bunch of stuff and cranking out new data like a boss. But then I saved the workflow, closed down Alteryx, and now when I try to open that file up again, I get the following error:   There was an error opening "C:\my file name.yxmd" There is an unclosed literal string. Line 3042, position 42.   Does this mean anything to you guys? Diagnosis The workflow has likely become corrupted, perhaps after saving it across a network, and has dropped something in the save process.  Solution   Alteryx creates backups of the workflows (same name with a .bak extension). Try to open the .bak file in Alteryx.    Go to File ->Open and change the "Files of Type" to All Files. The .bak files will show up and you can open the one you are having difficulty with.    Another alternative would be to check if Alteryx auto-saved it prior to your last save. Go to File -> Open Autosaved files.
View full article
Question  Why did all of my scheduled workflows fail? What does the error “Logon Failure: unknown user name or bad password” mean?        Answer This error is due to the credentials that are used for the scheduler are no longer valid and have most likely expired. To fix this, the Run As setting has to be updated in the scheduler machine. Someone with local admin rights to the machine should go to the System Settings (Alteryx > Options > Advanced Options > System Settings) then click Next until the “Run the Worker as a Different User” menu is selected and update those credentials.    
View full article
I am getting a Conversion error when trying to summarize a number with a comma in it.
View full article
The error above is usually due to a company firewall restriction. If you are receiving the error above when installing, please download run the individual installers from this page: http://downloads.alteryx.com. You can choose admin or non-admin depending on the permissions on your machine.     If you are still having trouble downloading, don't hesitate to open a Support ticket through the Case Portal.
View full article
Within an Alteryx workflow you may have instances where you have to hard code a value or only want to run workflows which have a certain field schema.   Both of these cases may cause errors in the workflow when the value or schema differ to that expected. Fortunately, there are two methods you can use to try and circumvent potential errors.    Option 1 - Conditional macros – CREW Macros Within the CREW macros pack there will be the conditional runner macro. This macro will allow you to set off another workflow if a workflow fails or succeeds. Therefore, if you are running a list of workflows from a Directory Tool and you want all the workflows to run even if a workflow fails, you can use the conditional runner to manage and continue the flow of workflows if one of them errors.   Option 2 - Expecting a set number of records or values?  You can use a combination of the Filter Tool and the Message Tool to look for patterns in the various records or files you are reading in. An example could be you are using a batch macro to read a list of files in. In each of these files you want to ensure a number of fields are included, so you transpose the data giving you a NAME & VALUE. Based on the NAME field you can use a Filter Tool and Count Records Tool to ensure you have the correct number of fields. In the false node you can have the records which didn't meet the expected value in the filter go into a Browse Tool or Output Data Tool so you can check out that file with more detail. Those records which did have the correct field headers you can crosstab the data back and continue that file through the process.    This is just a quick two ways you can look to avoid errors in a workflow, but I encourage those community members who can think of other alternatives and use cases please post below. this topic can be highly valuable for workflow conitnuity so learning more techniques can only help :)   Best,  Jordan Barker Solutions Consultant 
View full article
The Message Tool  within the Alteryx Designer is your own personal car alarm. This tool can provide you warnings or errors when your data doesn't meet a user-specified criteria or it can set up to tell you when data does not match.   The Message Tool can be set up to pick up records before, during and after the records have passed through the tool itself. This makes it useful for evaluating your dataset at different parts of your workflow.
View full article
  Occasionally you may see one of these errors from the Join Multiple tool.  It is a result of Cartesian joins.   A Cartesian join is when you join every row of one table to every row of another table. You can also get one by joining every row of a table to every row of itself. A Cartesian join is very CPU intensive.   For example, if you have four files and each file has the same ID in it twice, that means it will join 2*2*2*2 times on the ID (the field on which you're joining is the key referenced in the error; in this example, it's Field1, and the duplicated value is 12345).  The same can be caused by multiple nulls in each file. After your data prep and investigation, and when you know your data are correct, your choices on how to handle Cartesian joins include:   Allow multidimensional joins: The multidimensional join will occur with no error or warning reported. Warn on multidimensional joins of more than 16 records: A warning will be reported in the Results window that a multidimensional join has occurred. Error on multidimensional joins of more than 16 records: An error will be reported in the Results window that a multidimensional join has occurred and downstream processing will stop.     Happy Alteryx-ing!
View full article
Troubleshooting instructions for the error The system cannot find the file specified when attempting to use a 32-bit database connection in the Input Data or Dynamic Input Tool.  
View full article
Question I'm getting an error that says "Type mismatch in operator +" in my formula, what does it mean? Answer This error often means that you're trying to add a number to a string field. If you are trying to concatenate your fields, you need to be sure that all fields being combined are string values. When Alteryx sees a numeric value and a + operator it wants to add the values together as opposed to concatenate.    There are (at least) two ways to resolve this error:   1) Use a Select Tool to change the field type before feeding the data into your Formula Tool 2) Use the ToString() function to convert the field to a String value within the expression itself   Both solutions are demonstrated within the attached v10.5 sample.
View full article
Here at Alteryx we believe in working smart, not hard. Building out reports to highlight business-critical metrics is a pretty smart way to track goals. Customizing those reports to everyone in the department, then distributing them as attachments to individual emails? That sounds like a lot of hard work. Scheduling those reports from a refreshing data source each month so you don’t have to remake or rerun the reports yourself - that’s genius. Logging into your work computer to open up Alteryx, then having to check the scheduled results before having any peace of mind those reports were delivered without a hitch? Hard.
View full article
If you haven’t used the Run Command Tool just yet, that’s great. It means that whatever your analyses required, we had it covered with basic Designer functionality. But in spite of how great the Designer is, it just can’t do everything. There is a utility on your computer that can do just about anything, however, and it’s the command line . The Run Command Tool pairs the two into a dynamic tag-team duo that can wrestle all the computation you could need into one, integrated, Designer workflow:
View full article
If you are un lucky  while rendering a map in Alteryx with a Carto base map, you may encounter the error message Error: AGG error loading font (C:\WINDOWS\fonts\C:\Program). This article explains the cause of this error, and how to resolve it. 
View full article
Sometimes you may want to stop a workflow if certain conditions are met! Luckily within Alteryx we have the combination of the   Test Tool and   Workflow Properties to stop the workflow.
View full article