Base filters

DefaultFilter

The default filter model is a base model that can be used to create more specific filter models.

Table

Property	Type	Required	Description
operator	one of the enums below	Yes	The operator to apply to the filter value
value	any	Yes	The value to use for the filter operation

Formats

Example

A JSON example of this field is:

{
  "operator": "eq",
  "value": "example"
}

TypeSpec

The TypeSpec code for this field is:

/** A base filter model that can be used to create more specific filter models */
model DefaultFilter {
  /** The operator to apply to the filter value */
  operator:
      | ComparisonOperators
      | ArrayOperators
      | StringOperators
      | RangeOperators
      | AllOperators;

  /** The value to use for the filter operation */
  value: unknown;
}

JSON Schema

The JSON schema for this field is:

$schema: https://json-schema.org/draft/2020-12/schema
$id: DefaultFilter.yaml
type: object
properties:
  operator:
    anyOf:
      - $ref: ComparisonOperators.yaml
      - $ref: ArrayOperators.yaml
      - $ref: StringOperators.yaml
      - $ref: RangeOperators.yaml
      - $ref: AllOperators.yaml
    description: The operator to apply to the filter value
  value:
    description: The value to use for the filter operation
required:
  - operator
  - value
description: A base filter model that can be used to create more specific filter models

EquivalenceOperators

Operators that filter a field based on an exact match to a value. Supported value types include:

• string
• number
• boolean
• date
• money

Table

Operator	Description	Property	True value	False value
eq	Equal to a value	"foo"	"foo"	"bar"
neq	Not equal to a value	"foo"	"bar"	"foo"

Formats

Example

A JSON example of this field is:

"eq"

TypeSpec

The TypeSpec code for this field is:

/** Operators that filter a field based on an exact match to a value */
enum EquivalenceOperators {
  /** Equal to a value */
  eq,

  /** Not equal to a value */
  neq,
}

JSON Schema

The JSON schema for this field is:

$schema: https://json-schema.org/draft/2020-12/schema
$id: EquivalenceOperators.yaml
type: string
enum:
  - eq
  - neq
description: Operators that filter a field based on an exact match to a value

ComparisonOperators

Operators that filter a field based on a comparison to a value. Supported value types include:

• number
• date
• money

Table

Operator	Description	Property	True value	False value
gt	Greater than a value	10	15	5
gte	Greater than or equal to a value	10	10	9
lt	Less than a value	10	5	15
lte	Less than or equal to a value	10	10	11

Formats

Example

A JSON example of this field is:

"gt"

TypeSpec

The TypeSpec code for this field is:

/** Operators that filter a field based on a comparison to a value */
enum ComparisonOperators {
  /** Greater than a value */
  gt,

  /** Greater than or equal to a value */
  gte,

  /** Less than a value */
  lt,

  /** Less than or equal to a value */
  lte,
}

JSON Schema

The JSON schema for this field is:

$schema: https://json-schema.org/draft/2020-12/schema
$id: ComparisonOperators.yaml
type: string
enum:
  - gt
  - gte
  - lt
  - lte
description: Operators that filter a field based on a comparison to a value

StringOperators

Operators that filter a field based on a string value.

Table

Operator	Description	Property	True value	False value
like	Like	"hello"	"hell"	"world"
not_like	Not like	"hello"	"world"	"hell"

Formats

Example

A JSON example of this field is:

"like"

JSON Schema

The JSON schema for this field is:

$schema: https://json-schema.org/draft/2020-12/schema
$id: StringOperators.yaml
type: string
enum:
  - like
  - not_like
description: Operators that filter a field based on a string value

TypeSpec

The TypeSpec code for this field is:

/** Operators that filter a field based on a string value */
enum StringOperators {
  /** Like */
  like,

  /** Not like */
  not_like,
}

ArrayOperators

Operators that filter a field based on an array of values. Supported value types include:

• string
• number

Table

Operator	Description	Property	True value	False value
in	In an array of values	"A"	["A", "B"]	["B", "C"]
not_in	Not in an array of values	"A"	["B", "C"]	["A", "B"]

Formats

Example

A JSON example of this field is:

"in"

JSON Schema

The JSON schema for this field is:

$schema: https://json-schema.org/draft/2020-12/schema
$id: ArrayOperators.yaml
type: string
enum:
  - in
  - not_in
description: Operators that filter a field based on an array of values

TypeSpec

The TypeSpec code for this field is:

/** Operators that filter a field based on an array of values */
enum ArrayOperators {
  /** In an array of values */
  in,

  /** Not in an array of values */
  not_in,
}

RangeOperators

Operators that filter a field based on a range of values. Supported value types include:

• number
• date
• money

Table

Operator	Description	Property	True value	False value
between	The value must be between the two values	5	{"min": 1, "max": 10}	{"min": 10, "max": 20}
outside	The value must be outside the two values	5	{"min": 10, "max": 20}	{"min": 1, "max": 10}

Formats

Example

A JSON example of this field is:

"between"

JSON Schema

The JSON schema for this field is:

$schema: https://json-schema.org/draft/2020-12/schema
$id: RangeOperators.yaml
type: string
enum:
  - between
  - outside
description: Operators that filter a field based on a range of values

TypeSpec

The TypeSpec code for this field is:

/** Operators that filter a field based on a range of values */
enum RangeOperators {
  /** Between a range of values */
  between,

  /** Outside a range of values */
  outside,
}