Для поиска элементов размерности при настройке фильтра используется метод filter_pattern_change:

filter_pattern_change(dim_id: str, num: int, pattern_list: list) -> dict:

В методе используются следующие аргументы:

АргументОписание
dim_id: (str)Идентификатор размерности, по элементам которой требуется выполнить поиск. При вводе несуществующего идентификатора будет сгенерирована ошибка.
num: (int)Максимальное количество элементов размерности в результатах поиска.
pattern_list: (list)Условия поиска.

Значение аргумента pattern_list должно содержать список словарей со следующей структурой:

{"pattern": <value>, "type": <value>}
КлючОписание
pattern: (str)Любой паттерн поиска. Не может быть пустым.
type: (str) 

Тип поиска. Принимает одно из следующих значений:

'strict' — точное вхождение,
'inclusion' — вхождение,
'regex' — регулярное выражение.

Точное вхождение: возвращаются только точные совпадения названий элементов размерности с ключевыми словами. Регистрозависимый поиск. 

Вхождение: возвращаются все элементы размерности, в которых встречается ключевое слово. Регистронезависимый поиск. 

Регулярное выражение: возвращаются элементы в результате поиска по регулярному выражению спецификации ECMAScript. Подробнее об использовании поиска по регулярному выражению см. в разделе «Типы фильтров размерности» руководства пользователя для соответствующей версии системы.

Пример использования метода:

session.filter_pattern_change(dim_id='1f425592', num=10, pattern_list=[{'pattern':'MasterCard', 'type': 'inclusion'}])
или
session.filter_pattern_change(dim_id='1f425592', num=15, pattern_list=[{'pattern':'Master', 'type': 'inclusion'}, {'pattern':'Gold', 'type': 'inclusion'}])
или
session.filter_pattern_change(dim_id='1f425592', num=10, pattern_list=[{'pattern':'.*M.*', 'type': 'regex'}])

В результате использования метода возвращается ответ от сервера, как при выполнении команды filter: pattern_change.

Пример ответа:

{'state': 1,
 'queries': [{'uuid': '0fedabe4-bbd1f140-29505ded-cb47d7ed',
   'command': {'plm_type_code': 504,
    'state': 4,
    'runtime_id': '0fedabe4',
    'command_id': '00000000-00000000-00000000-00000000',
    'module_id': '0fedabe4-bbd1f140-29505ded-cb47d7ed',
    'pattern': '',
    'pattern_list': [{'pattern': 'MasterCard',
      'type': 'inclusion',
      'case_sensitive': False}],
    'total': 7,
    'global': 15,
    'global_selected': 7,
    'from': 0,
    'data': ['MasterCard Electronic',
     'MasterCard Gold',
     'MasterCard Gold (Currency)',
     'MasterCard Platinum',
     'MasterCard Standard',
     'MasterCard Unembossed',
     'MasterCard Unembossed (No name)'],
    'marks': [1, 1, 1, 1, 1, 1, 1],
    'indexes': [6, 3, 9, 14, 2, 4, 8],
    'groups_marks': [],
    'dimension_name': 'Группа карт',
    'range_first': '',
    'range_second': '',
    'filter_view_id': '4dc7acf9-d02526ba-e080b53b-9fe787c0'}}]}