Admin: 1 revision imported

2021-02-07T06:43:27Z

1 revision imported

Admin at 08:02, 28 January 2021

2021-01-28T08:02:50Z

New page

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

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

== Синтаксис ==
<code>
'''DBObjectFromDBCode'''(''<Внутренний код базы данных (STRING)>''):''<Объект базы данных (DB)>''
</code>
==== Аргументы ====
* <code>''<Внутренний код базы данных (STRING)>''</code> - Код объекта базы данных в виде строки.

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

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

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

DBObjectFromDBCode - Revision history

Admin: 1 revision imported

Admin at 08:02, 28 January 2021