Admin: 1 revision imported

2021-02-07T06:43:16Z

1 revision imported

Admin at 07:56, 2 September 2019

2019-09-02T07:56:37Z

New page

{{infobox function
|name=DB
|object=[[Объект базы данных]]
|caption=Создание объекта БД
|type=1
|status=2
|db=2
|exception=Невозможно превратить в строку, ошибка сервера
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Объект базы данных]]}}
Создать объект базы данных с заданным типом и видом (наименованием), с возможностью его заполнения, либо возвратить значение переменной БД по ее наименованию.

== Синтаксис ==
<code>
'''DB'''({{Optional|<Идентификация создаваемого объекта (STRING)>,<Стандартные фильтры поиска>}}):''<Новый объект БД>''
</code>
==== Аргументы ====
* <code>''<Идентификация создаваемого объекта (STRING)>''</code> - {{Optional}} Строка с типом и видом создаваемого объекта, при отсутствии аргумента будет создан пустой объект базы данных. Строка имеет формат: <code><Тип нового объекта>[.<Вид нового объекта>[.<Наименование значения перечисления>]]</code>. Принимаемые типы нового объекта:
** '''Ref''' или '''Reference''' -- справочник
** '''Doc''' или '''Document''' -- документ
** '''Stor''' или '''Storage''' -- накопитель
** '''Enum''' или '''Enumeration''' -- перечисление
** '''DBVar''' или '''DBVariable''' -- переменная БД, функция будет возвращать значение переменной БД, а не объект базы данных.
** '''Jor''', '''Jour''' или '''Journal''' -- журнал справочников или документов
:Виды объектов задаются в Студии, наименование значения перечисления может присутствовать только для объектов перечисления.
* <code>''<Стандартные фильтры поиска>''</code> - {{Optional}} При создании объектов, типа справочник, документ или журнал, могут применяться стандартные фильтры для позиционирования на конкретный объект. В этом случае, функция будет работать как комбинация двух функций <code>a:=DB(<Тип объекта>.<Вид объекта>);a.Find(<Стандартные фильтры>);</code>. Если в результате применения фильтров, объект найден, функция возвратит выбранный и загруженный новый объект, иначе будет возвращен не выбранный объект (см. [[Объект базы данных]]). Стандартные фильтры описаны в статье [[Стандартные фильтры]].

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

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

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

← Older revision	Revision as of 06:43, 7 February 2021
(No difference)

DB - Revision history

Admin: 1 revision imported

Admin at 07:56, 2 September 2019