The Filters custom processing step allows you to specify what traffic should be sent to your destination based on the information in the data payload. Specifically, Filters can be applied to asynchronous, one-way traffic of Log type
Filter rules are written based on Redox Data Model JSON properties, as represented in our data models documentation. For a property or set of properties in the data model, you can specify a set of allowed or disallowed values as criteria for sending the request from Redox to your destination. These filter rules are defined in the context of a subscription, meaning they are specific to a source, data model, and your destination.
You can set filter rules on the subscription settings page. Filters can only be viewed or created by users with PHI access for destinations that your organization owns.
For each subscription, filter rules begin by defining “Send if…” or “Block All”:
- “Send if…” allows you to set criteria for sending
- “Block All” will block all traffic until the filter is removed
(often helpful when preparing a new integration)
For both options, filter rules are evaluated for all applicable event types of a given data model (see “Excluded Event Types” below)
A “Send if…” filter is a collection of rules, each defining a data model property and a set of allowed or disallowed values for that property. For a request to be sent to your destination, all rules must be satisfied.
Each rule is evaluated based on the following criteria:
- “is in” – the property value must be equal to a value in the provided value set
- “is not in” – the property value must not be equal to a value in the provided value set
Value matching for either criteria is case-sensitive. Values can be added to a rule in a comma-delimited format. For values with a comma, the value with the comma should be encased in quotes, such as:
valueOne,"value,Two",valueThree. Trailing or leading spaces are ignored, unless encased within quotes.
Multiple Payload Values
Some data model JSON properties are contained within an array list, meaning the transmission payload may have multiple values for that property. These properties will have a  within their title. In this case, if any value for that property satisfies the filter rule, the rule is satisfied.
Filter rules are applied to all request traffic going forward immediately after saving. A filtered request will show up as a Log in the Dashboard with type
RECEIVE and status
Historically, the implementation team at Redox has set up custom filter logic on behalf of our customers. This custom filter logic may also result in a Log status of
Filtered. If you have questions about existing filter logic or a specific request, please reach out to Redox support.
Filters can also be created via API. See the documentation here: https://redox-platform-api.readme.io/v0/reference/filters
Filter rules are not evaluated for synchronous traffic or event types. A list of synchronous event types can be found here: Data Models & Event Types