RegEx Tool

Use the Regular Expression (RegEx) tool to build an expression to parse, match, or replace data.

Regular expression support

While regular expressions are supported in Designer, you are responsible for your own expressions and how the expressions impact your data.

For more information about Boost RegEx, visit the following:

Here are some outside resources that may be helpful. These are not affiliated with Alteryx in any way:

Perl Regular Expression Syntax.
RegEx Coach

Configure the tool

  1. Column to parse: Select the column you want to search and parse, match, or replace data.
  2. Regular Expression: Click the plus sign to start building an expression that will be used to find data to parse, match, or replace.
  3. Case Insensitive: Selected by default. Searches do not distinguish between uppercase and lowercase letters.

  4. Output Method: Which output method do you want to use after the search finds data matching the expression you built? Select a method and then configure the related output properties for the method.
    • Replace: Use this method to replace the expression you search for with a second expression.
      • Replacement Text: Enter an expression you want the tool to use when replacing text that matches your original regular expression. The drop down provides common regular expressions that you may need while creating your expression.
      • Copy unmatched text to output: Selected by default. All text that was not matched is included in the output.
    • Tokenize: Split the incoming data using a regular expression. This options works similarly to the Text To Columns Tool, except instead of matching and removing what you do not want, you match for what you want to keep. You want to match to the whole token, and if you have a marked group, only that part is returned.
      • Split to columns: Split a single column of data at each instance of the specified delimiter into multiple columns.
        • Number of columns: Set how many columns are created.
        • Extra columns: Select the behavior that is applied to extra columns.
          • Drop extra with warning: Data that extends past the split is dropped and a warning is generated indicating that there was excess information.
          • Drop extra without warning: Data that extends past the split is dropped and no warning is generated.
          • Error: Data the extends past the split causes an error and the workflow stops processing.
        • Output Root Name: Enter the name for the newly generated columns to be based off of. The new columns are named as the root name with a serially increasing integer appended.
      • Split to rows: Split a single column of data at each instance of the specified delimiter into multiple rows. Use a key column in your record so you don't lose track of which value came from which row.
    • Parse: Separate the expression into new columns, and set the name, type, and size of the new columns.
      • A new column is created in the Output columns table. In the table:
        • Click on column names to rename.
        • Use the drop down to select the new data type.
        • Enter the new size.
        • Expression is populated automatically.
    • Match: Append a column containing a number; 1 if the expression matched, 0 if it did not.
      • Column name for match status: Provide a name for the appended column.
      • Error if not matched: This is not selected by default. Select if you want the system to stop processing and display an error when the expression and string do not match.