Filters

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 RECEIVE.

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.

Defining Filter Rules

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)

Send if… Rules

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.

Determining Filtered Status

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 Filtered

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.

API Access

Filters can also be created via API. See the documentation here: https://redox-platform-api.readme.io/reference/filters

Excluded Event Types

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