Проверяет адреса на соответствие адресному классификатору и для устаревших адресов возвращает актуальные варианты. Если адресные сведения региона адреса не загружены в программу, то проверка адреса будет выполнена через веб-сервис orgaddress и может занимать до 120 секунд. Поэтому для исключения зависаний пользовательского интерфейса, например при открытии формы, функцию следует вызвать в фоновом задании.

Синтаксис

Функция ПроверитьАдреса(Знач Адреса, ДополнительныеПараметры = Неопределено) Экспорт

Параметры

• Адреса — Соответствие из КлючИЗначение:
  • Ключ - Число - уникальный идентификатор адреса;
  • Значение - Строка - проверяемый адрес во внутреннем формате JSON. В целях обратной совместимости допускается передача адреса в виде XML, соответствующем XDTO-пакету Адрес (http://www.v8.1c.ru/ssl/contactinfo), но это негативно сказывается на времени выполнения функции.
• ДополнительныеПараметры — Структура:
  • ПроверятьУстареваниеАдресов - Булево - если адрес устарел, то свойство АктуальныеАдреса будут содержать актуальные варианты адреса. Для загруженных регионов адресного классификатора должна быть загружена история изменений адресных сведений. По умолчанию, Ложь.
  • ВключатьСтрануВПредставление - Булево - в поле Представление у свойства АктуальныеАдреса включать страну в представление актуального адреса. По умолчанию, Ложь.

Возвращаемое значение

Соответствие из КлючИЗначение:

• Ключ - Число - уникальный идентификатор адреса;
• Значение - Структура:
• АдресПроверен - Булево - признак, что адрес был проверен в классификаторе или через веб-сервис.
• АдресКорректный - Булево - признак, что адрес соответствует адресному классификатору. Устаревшие адреса считаются некорректными.
• Ошибки - Массив из Строка - список ошибок в адресе.
• АктуальныеАдреса - Массив из Структура - где: Если адрес устарел, то содержит варианты актуального адреса в виде полей адреса, где:
• Представление - Строка - представление актуального варианта адреса;
• Адрес - Строка - адрес во внутреннем формате JSON.

Пример вызова

Результат = РаботаСАдресами.ПроверитьАдреса(Адреса, ДополнительныеПараметры)

Доступность

Сервер, Толстый клиент, Внешнее соединение