ExternalDBase.DB

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

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

Функция позволяет получить доступ к интерфейсу DB для текущей базы данных. Соединение в внешней БД должно быть активно.

Синтаксис

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

Аргументы

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

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

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

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

Возвращается объект БД, принадлежащий текущей внешней базе данных.

Примеры

//Пример работы с внешней базой данных, создание объектов БД
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));