> Markdown versions of all pages of this connector library are available by appending `.md` to the page URL. For the full index of connectors, see [llms.txt](https://connectors.appmixer.com/llms.txt).

# appmixer.utils.filters.Range

- Component: `appmixer.utils.filters.Range`
- Kind: Action
- Version: 1.0.0
- Visibility: Public
- Connector: [appmixer.utils.filters 1.0.5](https://connectors.appmixer.com/connector/appmixer.utils.filters/1.0.5.md)
- Component page: <https://connectors.appmixer.com/connector/appmixer.utils.filters/1.0.5/component/appmixer.utils.filters.Range>

A message passes through this filter if a field from a previous connector contains a value that falls into the range specified. Values can be both numbers or dates.

## Input ports

### Port `in`

| Field | Type | Description |
| --- | --- | --- |
| Data (`sourceData`) | text | The data that we want to check (number or date). You can select data from any previous connector via the select box. |
| Minimum value (`rangeMin`) | text | Any number or date (e.g. 2017-04-23 22:45). If the value under _Data_ falls into the interval specified, the filter passes the message through. Otherwise, it ignores the message. |
| Maximum value (`rangeMax`) | text | Any number or date (e.g. 2017-04-23 22:45). If the value under _Data_ falls into the interval specified, the filter passes the message through. Otherwise, it ignores the message. |
| Exclusive minimum (`exclusiveMin`) | toggle | Turn exclusivity on if you want to exclude test on equality for the minimum value. |
| Exclusive maximum (`exclusiveMax`) | toggle | Turn exclusivity on if you want to exclude test on equality for the maximum value. |

## Output ports

### Port `inRange`

_No fields defined for this port._

### Port `notInRange`

_No fields defined for this port._

## Full metadata (component.json)

```json
{
  "name": "appmixer.utils.filters.Range",
  "author": "Tomáš Waldauf <tomas@client.io>",
  "description": "A message passes through this filter if a field from a previous connector contains a value that falls into the range specified. Values can be both numbers or dates.",
  "private": false,
  "inPorts": [
    {
      "name": "in",
      "schema": {
        "properties": {
          "sourceData": {
            "type": "string"
          },
          "rangeMin": {
            "type": "string"
          },
          "rangeMax": {
            "type": "string"
          },
          "exclusiveMin": {
            "type": "boolean"
          },
          "exclusiveMax": {
            "type": "boolean"
          }
        },
        "required": [
          "sourceData",
          "rangeMin",
          "rangeMax"
        ]
      },
      "inspector": {
        "inputs": {
          "sourceData": {
            "type": "text",
            "label": "Data",
            "index": 1,
            "tooltip": "The data that we want to check (number or date). You can select data from any previous connector via the select box."
          },
          "rangeMin": {
            "type": "text",
            "label": "Minimum value",
            "index": 2,
            "tooltip": "Any number or date (e.g. 2017-04-23 22:45). If the value under <i>Data</i> falls into the interval specified, the filter passes the message through. Otherwise, it ignores the message."
          },
          "rangeMax": {
            "type": "text",
            "label": "Maximum value",
            "index": 4,
            "tooltip": "Any number or date (e.g. 2017-04-23 22:45). If the value under <i>Data</i> falls into the interval specified, the filter passes the message through. Otherwise, it ignores the message."
          },
          "exclusiveMin": {
            "type": "toggle",
            "label": "Exclusive minimum",
            "index": 3,
            "tooltip": "Turn exclusivity on if you want to exclude test on equality for the minimum value."
          },
          "exclusiveMax": {
            "type": "toggle",
            "label": "Exclusive maximum",
            "index": 5,
            "tooltip": "Turn exclusivity on if you want to exclude test on equality for the maximum value."
          }
        }
      }
    }
  ],
  "outPorts": [
    "inRange",
    "notInRange"
  ],
  "icon": "(data URI omitted)"
}
```
