DBObjectFromDBCode

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

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

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

Внутренний код является строкой с длиной обычно 20 символов, содержащей только символы ANSI. Код может содержать пробелы как в начале строки, так и в конце строки. Если код неверный, функция получит пустой объект базы данных или простой пустой объект, если код верный, но не указывает на какой-либо объект в базе данных (либо объект был удален), получится объект, который невозможно загрузить. При сохранении нового объекта, ему будет автоматически присвоен уникальный внутренний код. Сортировка по внутренним кодам позволяет получить последовательность объектов по времени их первого сохранения в базу данных. Для получения внутреннего кода, можно использовать функцию DBCode.

Синтаксис

DBObjectFromDBCode(<Внутренний код базы данных (STRING)>):<Объект базы данных (DB)>

Аргументы

• <Внутренний код базы данных (STRING)> - Код объекта базы данных в виде строки.

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

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

Примеры

//Загрузить объект по его реквизиту Code
aEl:=DB("Ref.Номенклатура","Code","000000041788");
//Загрузить объект по его внутреннему коду БД
bEl:=DBObjectFromDBCode(aEl.DBCode);
//Если объект с кодом 000000041788 существовал, будет выведена строка
//"Объекты одинаковы"
Message("Объекты "+?(aEl=bEl,"одинаковы","не одинаковы"));