Admin: 1 revision imported

2021-02-07T06:50:41Z

1 revision imported

Admin at 11:03, 3 July 2020

2020-07-03T11:03:53Z

New page

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

== Синтаксис ==
<code>
{{Grey|ExternalDBase.}}'''DB'''({{Optional|<Идентификация создаваемого объекта (STRING)>,<Стандартные фильтры поиска>}}):''<Новый объект БД (DB)>''
</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>
//Пример работы с внешней базой данных, создание объектов БД
db2:=exdb.create();
db2.Connect("127.0.0.1:13521:TCPPassword","User","Password");

aEl:=db2.DB("Ref.Контрагенты","Code","000000000603");

//Будет выведен 0
Message(aEl.BelongsToDB());

//Будет выведен 1
Message(aEl.BelongsToDB(db2));
</pre>

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

ExternalDBase.DB - Revision history

Admin: 1 revision imported

Admin at 11:03, 3 July 2020