Address Book Release Note

Версия

Дата Выхода

1.7.3

11.06.2026

Версия 1.7.3.

Новые возможности

Добавлена возможность нормализовать номера при импорте из внешнего источника данных.

В settings.yaml добавлена новая настройка: «normalize».

additional_import_settings:
  common:
    normalize:
      default:
        - rule: reject
          regex: "^$"
      fields:
        phones.number:
          - rule: replace
            regex: "(?!^\\+)[^\\d]"
            replace: ""

Область применения правил

  • default — правила, которые применяются ко всем полям и подполям контакта;

  • fields — правила, которые применяются только к указанным полям или подполям.

Поддерживаемые правила

  • reject — удаляет значение поля, если оно соответствует регулярному выражению, переданному в параметре regex этого правила;

  • replace — заменяет части значения, соответствующие регулярному выражению из параметра regex, на строку из параметра replace этого правила.


Механизм позволяет применять правила не только к полям верхнего уровня, но и к подполям. Чтобы применить правила к подполю (например, к подполю номера телефона), его название указывается через точку (например, phones.number).


Правила нормализации не применяются к системным полям: external_id, org, inserted_at, updated_at, kind, rev, position, source, realm, owner_id, _id, id

Пример использования нормализации

Номер во внешнем источнике данныхНомер в Address Book
8-912-345-67-89
89123456789
+7(903)123*45*67
+79031234567
+7 (123) 456-78-90
+71234567890
+7.916.123.45.67
+79161234567
8(812)123_45_67
88121234567
0555-123456
0555123456