НазваниеРаздела

Формирует полное название раздела иерархии, в котором находится текущая запись.

Синтаксис

Запись.НазваниеРаздела([Иерархия])

Параметры

Иерархия (текст) – имя поля иерархии. Если параметр не указан, берётся первое поле типа "Иерархия" в записи.

Возвращает

Текст - строку с полным названием папки иерархии, в котором находится текущая запись. В качестве разделителя между именами папок используется точка. В связи с этим, если в названии папки уже присутствует точка, то чтобы не путать с разделителем, функция заменить точку в названии папки на символ "\.". Фактически возвращается то же самое, что содержится в верхней строке окна с иерархической таблицей.

Примеры

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

оСотр = Лицо("102", "Сотрудники")
оСотр.НазваниеРаздела()

Например, если сотрудник находится в подразделении "Участок сборки", которое в свою очередь находится в отделе "Цех 10", то этот фрагмент вернёт строку "Цех 10.Участок сборки".

Если в поле документа "Лицо1", указана организация, то полное название раздела, в котором находится запись этой организации выводится так:

Лицо1.Лицо_.НазваниеРаздела();

Запись "Лицо1.Лицо_" перед вызовом функции означает, что будет браться не текущая запись, запись объекта "Лицо1.Лицо_". Почему не просто "Лицо1"? Дело в том, что поле иерархии находится не в самой таблице "Лицо", запись которой содержит объект "Лицо1", а в таблице, связанной с ней по связи "Лицо_".

НазваниеРаздела("Прайс-лист"); # возвращает полное название раздела иерархии "ПрайсЛист", в котором находится текущая запись.

См. также:

•  НазваниеТаблицы

•  ПерейтиВРаздел