DB.SetPrefix

SetPrefix (Работа с префиксами)
Объект: Объект базы данных Статус разработки: Реализована Тип: Функция Обращение к БД: Нет Исключения: Невозможно превратить в строку, неверный реквизит Визуальность: Нет

• Начальная страница
• Общее описание
• Объекты
• Объект базы данных

Функция задает или получает префикс для указанного строкового реквизита-нумератора текущего объекта, она работает как для нового несохраненного объекта, так и для не выбранного объекта, который только будет создан (New). Новые номера будут начинаться на этот префикс и заканчиваться числовым значением с длиной, которая совпадает с длиной значения нумератора за минусом длины префикса. По умолчанию для нумераторов используется префикс, который можно изменить функцией SetDefaultPrefix.

Синтаксис

DB.SetPrefix(<Указание на реквизит (STRING)>,<Новый префикс реквизита (STRING)>):<Текущий префикс реквизита (STRING)>

Аргументы

• <Указание на реквизит (STRING)> - Задает наименование реквизита-нумератора, префикс по умолчанию которого необходимо изменить или получить, если реквизит находится в строчной части, указывает также на наименование строчной части. Общий формат аргумента: [<Наименование строчной части>.]<Наименование реквизита>.
• <Новый префикс реквизита (STRING)> - (необязательный аргумент) Если аргумент задан, он задает новый префикс указанного в первом аргументе реквизита, иначе префикс реквизита не изменяется.

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

Функция возвращает текущий префикс реквизита-нумератора текущего объекта.

Примеры

//Функция задает префикс для текущего документа, если он новый
//Префикс будет состоять из значения DBVar.ПрефиксИБ и реквизита ПрефиксЮЛ, находящегося в юр. лице, выбранном в документе.
If aEl.Selected()>0 Then
  Exit;
EndIf;
Префикс:=Trim(DBVar.ПрефиксИБ)+Trim(aEl.Аналитика.ЮрЛицо.ПрефиксЮЛ);

//Установим новый префикс для реквизита
aEl.SetPrefix("DocNum",Префикс);