DB

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

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

Создать объект базы данных с заданным типом и видом (наименованием), с возможностью его заполнения, либо возвратить значение переменной БД по ее наименованию.

Синтаксис

DB(<Идентификация создаваемого объекта (STRING)>,<Стандартные фильтры поиска>):<Новый объект БД>

Аргументы

• <Идентификация создаваемого объекта (STRING)> - (необязательный аргумент) Строка с типом и видом создаваемого объекта, при отсутствии аргумента будет создан пустой объект базы данных. Строка имеет формат: <Тип нового объекта>[.<Вид нового объекта>[.<Наименование значения перечисления>]]. Принимаемые типы нового объекта:
  • Ref или Reference -- справочник
  • Doc или Document -- документ
  • Stor или Storage -- накопитель
  • Enum или Enumeration -- перечисление
  • DBVar или DBVariable -- переменная БД, функция будет возвращать значение переменной БД, а не объект базы данных.
  • Jor, Jour или Journal -- журнал справочников или документов

Виды объектов задаются в Студии, наименование значения перечисления может присутствовать только для объектов перечисления.

• <Стандартные фильтры поиска> - (необязательный аргумент) При создании объектов, типа справочник, документ или журнал, могут применяться стандартные фильтры для позиционирования на конкретный объект. В этом случае, функция будет работать как комбинация двух функций a:=DB(<Тип объекта>.<Вид объекта>);a.Find(<Стандартные фильтры>);. Если в результате применения фильтров, объект найден, функция возвратит выбранный и загруженный новый объект, иначе будет возвращен не выбранный объект (см. Объект базы данных). Стандартные фильтры описаны в статье Стандартные фильтры.

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

Возвращается новый объект базы данных (выбранный или не выбранный), либо значение переменной БД на текущую дату реквизитов данного потока.

Примеры

//Фрагмент создает справочник с видом, заданным в переменной ВидСпр
aEl:=DB("Ref."+ВидСпр);

//Фрагмент создает справочник с видом Номенклатура, и выполняет поиск элемента с реквизитом Code равным "000000015182"
aEl:=DB("Ref.Номенклатура","Code","000000015182");