# tMultiPatternCheck

Checks all existing data in multiple columns against a given Java regular expression.

tMultiPatternCheck can give two output flows: Matching Data and Non-Matching Data. The first collects all data that match a given pattern, and the second collects all data that do not match the pattern. You can then implement any required corrections.

This component is not shipped with your Talend Studio by default. You need to install it using the Feature Manager. For more information, see [Installing features using the Feature Manager](https://help.qlik.com/talend/r/en-US/8.0/studio-user-guide/install-features-to-talend-studio).

## tMultiPatternCheck Standard properties

These properties are used to configure tMultiPatternCheck running in the Standard Job framework.

The Standard tMultiPatternCheck component belongs to the Data Quality family.

This component is available in Talend Data Management Platform, Talend Big Data Platform, Talend Real-Time Big Data Platform, Talend Data Services Platform and in Talend Data Fabric.

## Basic settings

| Properties | Description |
| --- | --- |
| Schema and Edit schema | <ul> <li> <p>A schema is a row description, it defines the number of fields to be processed and              passed on to the next component. The schema is either <span>Built-in</span> or stored remotely in the <span>Repository</span>.</p> </li> <li> <p> <span>Built-in</span>: You create the schema and store it              locally for this component only. For more information about a component schema in its <span>Basic settings</span> tab, see <a href="https://help.qlik.com/talend/r/en-US/8.0/studio-user-guide/basic-settings-tab" target="_blank">Basic settings tab</a>.</p> </li> <li> <p> <span>Repository</span>: You have already created the schema              and stored it in the Repository. You can reuse it in various projects and Job designs.              For more information about a component schema in its <span>Basic settings</span> tab, see <a href="https://help.qlik.com/talend/r/en-US/8.0/studio-user-guide/basic-settings-tab" target="_blank">Basic settings tab</a>.</p> </li> </ul> |
| Logical operator used to combine check conditions | In the case you want to combine the conditions you set on columns, select from<br>this list the combine mode you want to use. |
| Columns To Check | Set a regular expression for each of the analyzed columns.<br><br><ul> <li> <span>Column</span>: list of the analyzed columns.</li> <li> <span>Property</span>: <span>The pattern against which you want to check the data                        is either <span>Built-in</span> or stored remotely in the                           <span>Repository</span>.</span> </li> <li> <span>Pattern Selection</span>: You can click fields in this                        column only if you have selected <span>Repository</span> from the                           <span>Property</span> list. To select the pattern against which                        you want to check the column data from the <span>Pattern                           Selector</span>, click the <span>[...]</span> button in the                        corresponding field. <span>These patterns are retrieved from the                                    <span>DQ Repository</span> of <span>Talend Studio</span>.</span> The list includes the system and user-defined patterns.</li> <li> <span>Pattern Regex</span>: You can enter your own customized                        regular expression if you have selected <span>Built-in</span> in                        the <span>Property</span> column.</li> <li> <span>Is Case sensitive</span>: select the check boxes of the                        column name where you want to consider, when doing the pattern check, lower                        and upper cases.</li> <li> <span>Check</span>: select the check boxes of the column(s) you                        want to check against the defined patterns.</li> <li> <span>Message</span>: leave this column empty to have automatic                        messages about which pattern has invalidated the data row and caused it to                        be rejected. You can also enter your own personalized message to enrich the                        Job result with information about the patterns that cause the row to be                        rejected.</li> </ul> |

## Advanced settings

| Properties | Description |
| --- | --- |
| tStatCatcher<br>Statistics | Select this check box to collect log data at the component level. |

## Global Variables

| Variables | Description |
| --- | --- |
| Global Variables | NB\_LINE: the number<br>of rows read by an input component or transferred to an output component. This is an<br>After variable and it returns an integer.<br><br><br>NB\_LINE\_OK: the number of rows matching a given<br>pattern. This is an After variable and it returns an integer.<br><br><br>NB\_LINE\_REJECT:<br>the number of rows not matching a given pattern. This is an After variable and it<br>returns an integer.<br><br><br>ERROR\_MESSAGE: the error message generated by the<br>component when an error occurs. This is an After variable and it returns a string. This<br>variable functions only if the Die on error checkbox is<br>cleared, if the component has this checkbox.<br><br>A Flow variable functions during the execution of a component<br>while an After variable functions after the execution of the component.<br><br>To fill up a field or expression with a variable, press Ctrl+Space to access the variable list and choose the variable to use from<br>it.<br><br>For more information about variables, see [Using contexts and variables](https://help.qlik.com/talend/r/en-US/8.0/studio-user-guide/contexts-and-variables). |

## Usage

| Usage guidance | Description |
| --- | --- |
| **Usage rule** | This component is usually used as an intermediate component, and it requires an<br>input component and an output component. |
| Limitation | When exporting a Job using<br>tMultiPatternCheck with a user-defined pattern<br>stored in the DQ Repository, you must export the<br>pattern with the Job. Otherwise, the pattern will switch to Built-in<br>mode when importing the Job in another project.<br><br>When importing a Job using tMultiPatternCheck with a<br>system pattern, the pattern will switch to Built-in mode.<br><br>For more information about importing Jobs with<br>patterns in Talend Studio,<br>see Importing data profiling items or projects. |

**Related concepts**

* [Checking the data in multiple columns against patterns](https://help.qlik.com/talend/en-US/components/8.0/pattern-validation/tmultipatterncheck-tlogrow-tmysqlinput-tmysqlinput-checking-data-in-multiple-columns-against-patterns-standard-component-enterprise-this)