НайтиЛицо

Находит и извлекает объект типа "Лицо" по указанному коду и типу лица.

Синтаксис

НайтиЛицо(Код[, Тип])

Параметры

Код (текст) - ключевой идентификатор лица, по которому будет искаться нужная запись. В зависимости от справочника поиск будет осуществляться по определенным полям. Примеры возможных вариантов поиска приводятся в следующей таблице:

Имя справочника Имя поля
Сотрудники Табельный номер
Организации ИНН-КодФилиала
Частные лица ИНН
Номенклатура Номенклатурный номер
Аналитики Тема
Виды деятельности Имя
Статьи затрат Имя
Основные средства Инвентарный номер
Статьи бюджета Код статьи
Журнал лиц Код записи раздела в журнале

В зависимости от конфигурации программы список всевозможных справочников может изменяться.

Если в справочнике существует несколько записей с указанным кодом, будет возвращена первая найденная запись.

Тип (текст) - имя справочника, в котором будет осуществляться поиск, и из которого будет извлекаться запись. Не обязательно указывать полное имя справочника, достаточно указать несколько начальных символов, например, "Сотр", "Орг" и так далее.

Если параметр "Тип" не указан, справочники просматриваются в том  порядке, в котором они перечислены в таблице, пока не будет найдена подходящая по коду запись. Например, если есть сотрудник с табельным номером "10" и группа в журнале лиц с таким же номером, будет найден сотрудник. В большинстве случаев параметр "Тип" лучше всего указывать. Во-первых, это избавит от лишних поисков, а, во-вторых, гарантировано будет найдено "лицо" нужного типа.

Возвращает

Объект, содержащий запись таблицы "Лица" с указанным кодом и указанного типа. Если записи с указанным кодом и типом не существует, то функция "НайтиЛицо" в этом случае вернёт пустой объект.

Примеры

Проверим наличие в справочнике организации с указанным ИНН:

пЛицо = НайтиЛицо("7605012345", "Орг");
Если(пЛицо)
   Сообщить(пЛицо.Название)

См. также:

•  Лицо

•  ТипЛица