Filters
Overview
You can use filters in your source and target configurations to define specific subsets of data that you want to use in your syncs.
Source filters
When syncing a Data Source, you may have the option to add additional configuration sections, such as a Filter, under the "Add a Section" drop down tab in the Connection Experience (Image 1).
Note that if your source only has one of the listed options, it will appear by default instead of in a drop-down.
![](https://platform.docs.cinchy.com/~gitbook/image?url=https%3A%2F%2F3728216363-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FuXTzhcF5GwEVWPr9Y2dX%252Fuploads%252FIeVG73o2ZWRffC3CFaNc%252Fimage.png%3Falt%3Dmedia%26token%3Da5bd1591-2a5a-445d-8bf2-aa7344414e87&width=768&dpr=4&quality=100&sign=3450239b&sv=1)
A filter on your source is optional. It relies on a source specific syntax for filtering out records from your source target. The filter can reference execution parameters.
Source | Definition |
---|---|
File | For a file data sources (delimited, fixed width & Excel) the syntax conforms to the .NET frameworks RowFilter on a DataView |
Salesforce | For Salesforce syntax is the SOQL where clause (without the where expression) |
Dynamics | For Dynamics syntax is the OData $filter clause (without the $filter=expression) |
Cinchy | For Cinchy syntax is the CQL where clause (without the where expression) |
SqlServer | For SqlServer the syntax is the T-SQL where clause (without the where expression) |
This is only available if using a table, not a query. For queries, include the filter in the query itself.
There can only be one <Filter> for each source. To specify more than one condition, use AND/OR to allow logical combination of multiple expressions.
Conditional filters
For REST API, SOAP 1.2, Kafka Topic, Platform Event, and Parquet sources, there is a "Conditional" option for source filters in the Connections UI.
Once selected you will be able to define the conditions upon which data is pulled into your source via the filter. After data is pulled from the source, new conditional UI filters down the set of returned records to ones that match the defined conditions.
Multiple Conditions can be added to a single data sync by using the AND/OR and +Rule buttons.
You are able to group your Rules into a rule set by using the +Ruleset button.
The left-most drop down is used to select either a source or a target column as defined in your Source and Destination tabs.
The centre drop-down is used to select from the following options:
=
!=
Contains
Is Null
Is Not Null
The right-most drop-down can either be used for a plain value (ex: text, numerical, etc.) This will adjust based on the column data type picked in the left-most drop down. For example, if in the source schema the column is a date, then it renders a date picker.
For example, the below condition would only bring in records where the source column Employee Status isn't null (Image 2).
![](https://platform.docs.cinchy.com/~gitbook/image?url=https%3A%2F%2F3728216363-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FuXTzhcF5GwEVWPr9Y2dX%252Fuploads%252F1XXrXOpXZq5oBMFMEuPa%252Fimage.png%3Falt%3Dmedia%26token%3Dd6e3bf5c-3bb4-49d8-bfae-034329c3fddd&width=768&dpr=4&quality=100&sign=8a2522f&sv=1)
Source filter examples
Example 1: Use a filter to sync only source records with [net worth] > 10000 (Image 3).
![](https://platform.docs.cinchy.com/~gitbook/image?url=https%3A%2F%2F3728216363-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FuXTzhcF5GwEVWPr9Y2dX%252Fuploads%252FPur58fnFZn5z2c0ZjB6u%252Fimage.png%3Falt%3Dmedia%26token%3Ddd41811f-5fac-41f9-af7f-a3691c969c42&width=768&dpr=4&quality=100&sign=ae67dcd5&sv=1)
Example 2: Use a filter to sync only source records with a status like "Complete" (Image 4).
![](https://platform.docs.cinchy.com/~gitbook/image?url=https%3A%2F%2F3728216363-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FuXTzhcF5GwEVWPr9Y2dX%252Fuploads%252FGalq5ux4hJZDnciRBbEg%252Fimage.png%3Falt%3Dmedia%26token%3D55bc079b-3001-425a-bcd3-4041e272437b&width=768&dpr=4&quality=100&sign=900afd19&sv=1)
Target filters
A target destination filter is optional. It relies on a source specific syntax for filtering out records from your target. The filter can reference execution parameters.
Source | Definition |
---|---|
Salesforce | For Salesforce the syntax is the SOQL where clause (without the where expression) |
Dynamics | For Dynamics syntax is the OData $filter clause (without the $filter=expression) |
Cinchy | For Cinchy syntax is the CQL where clause (without the where expression) |
SqlServer | For SqlServer the syntax is the TSQL where clause (without the where expression) |
There can only be one <Filter> for each target. To specify more than one condition, use AND/OR to allow logical combination of multiple expressions.
Filter examples
Example 1: Filter only target records where the Assignee is Null (Image 5).
![](https://platform.docs.cinchy.com/~gitbook/image?url=https%3A%2F%2F3728216363-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FuXTzhcF5GwEVWPr9Y2dX%252Fuploads%252FTXkptljOz6oAKweSQFRy%252Fimage.png%3Falt%3Dmedia%26token%3D1a415d42-2126-4477-934c-e91e8ef3387b&width=768&dpr=4&quality=100&sign=a07b9c42&sv=1)
Example 2:Filter only target records where the Override ID isn't Null (Image 6).
![](https://platform.docs.cinchy.com/~gitbook/image?url=https%3A%2F%2F3728216363-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FuXTzhcF5GwEVWPr9Y2dX%252Fuploads%252FYeyL1mIbemzIdXxpUxeU%252Fimage.png%3Falt%3Dmedia%26token%3D3f79791b-f323-4f14-aa12-ef73d7125bf4&width=768&dpr=4&quality=100&sign=f9dd34b6&sv=1)
Example 3:Filter only target records from a specific source (Image 7).
![](https://platform.docs.cinchy.com/~gitbook/image?url=https%3A%2F%2F3728216363-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FuXTzhcF5GwEVWPr9Y2dX%252Fuploads%252Fn0YyHzrndkIi56NEr0Ml%252Fimage.png%3Falt%3Dmedia%26token%3D9a2dd7b6-715d-4bf8-8e6d-a6bb3f1292e6&width=768&dpr=4&quality=100&sign=49ee5c44&sv=1)
Last updated