backstage/.changeset/smart-fans-complain.md

@backstage/plugin-catalog-backend

@backstage/plugin-catalog-backend
minor

BREAKING EntitiesSearchFilter fields have changed.

EntitiesSearchFilter now has only two fields: key and value. The matchValueIn and matchValueExists fields are no longer are supported. Previous filters written using the matchValueIn and matchValueExists fields can be rewritten as follows:

Filtering by existence of key only:

  filter: {
    {
      key: 'abc',
-     matchValueExists: true,
    },
  }

Filtering by key and values:

  filter: {
    {
      key: 'abc',
-     matchValueExists: true,
-     matchValueIn: ['xyz'],
+     values: ['xyz'],
    },
  }

Negation of filters can now be achieved through a not object:

filter: {
  not: {
    key: 'abc',
    values: ['xyz'],
  },
}