Struct.DataTypeName - Revision history

Admin: 1 revision imported

2021-04-16T14:18:29Z

1 revision imported

1>Admin at 20:26, 12 April 2021

2021-04-12T20:26:55Z

Admin: 1 revision imported

2021-02-07T06:52:44Z

1 revision imported

Admin at 10:00, 6 October 2020

2020-10-06T10:00:33Z

New page

{{infobox function
|name=Struct.<Тип данных>, Meta.<Тип данных>
|object=[[Объект структуры базы данных]]
|caption=Создание объекта
|type=1
|status=2
|db=0
|exception=Невозможно превратить в число или строку, неверный тип данных
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Объект структуры базы данных]]}}
Атрибут создает новый объект структуры, позиционированный на объектах базы данных указанного вида. Возможные значения видов базы данных:
* '''Ref''', '''References''' -- справочники.
* '''Doc''', '''Documents''' -- документы.
* '''Stor''', '''Storages''' -- накопители.
* '''Enum''', '''Enumerations''' -- перечисления.
* '''DBVar''' -- глобальные переменные.
* '''Jor''', '''Journals''' -- журналы.
* '''Num''', '''Numerators''' -- общие нумераторы
* '''RootOptions''' -- особые общие объекты (к примеру, порядок блокировки накопителей и т.д.).
Если задан аргумент, производится также позиционирование на определенном виде объектов указанном в виде наименования или в виде индекса. Количество объектов данного типа в проекте можно найти с помощью функции [[Struct.Count|Count]]. К примеру, <code>Struct.Ref("Номенклатура")</code> создает объект структуры базы данных, позиционированный на справочнике "Номенклатура", если такого справочника не существует, функция возвратит вместо объекта пустое значение. Второй способ вызова с позиционированием: <code>Struct.Doc(12)</code> -- создает объект структуры базы данных, позиционированный на документе с индексом 12. При этом, чтобы получить общее число документов в проекте, можно использовать конструкцию <code>Struct.Doc.Count()</code>. При отсутствии аргумента, создается объект, неопределенного вида, к которому, к примеру, можно применить тот же самый метод [[Struct.Count|Count]]. После указания на вид объекта цепочку ссылок можно продолжать пока функции возвращают объект структуры (к примеру, <code>Struct.Ref("Номенклатура").LineParts("Штрихкоды").Props("ТипШтрихкода").DataType</code>, однако, если какого-либо типа объекта не существует, промежуточная функция возвратит пустое значение и следующий по цепочке вызов функции создаст исключение (к примеру, если строчная часть "Штрихкоды" в справочнике "Номенклатура" не задана, при попытке получить доступ к реквизитам строчной части ([[Struct.LineParts.Properties|.Props...]]) будет создано исключение.

== Синтаксис ==
<code>
'''Struct.<Тип данных>'''({{Optional|<Наименование или индекс вида объекта (STRING,INT)>}}):''<Объект структуры, позиционированный на указанном типе данных (и виде, если задан аргумент) объектов базы данных (DBSTRUCT)>''
</code>

==== Аргументы ====
* <code>''<Наименование или индекс вида объекта (STRING,INT)>''</code> - Аргумент задает идентификатор вида объекта (если аргумент является строкой), либо его порядковый номер (если аргумент является числом).

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

== Примеры ==
<pre>
//Фрагмент проверяет, является реквизит Code справочника ВидСпр числовым.
If Struct.Ref(ВидСпр).Props("Code").Numerator.DataType="NUMBER" Then
Message("Код справочника "+ВидСпр+" является числовым!");
EndIf;
</pre>

← Older revision	Revision as of 14:18, 16 April 2021
(No difference)

@@ Line 20: / Line 20: @@
 * '''DBVar''' -- глобальные переменные.
 * '''Jor''', '''Journals''' -- журналы.
-* '''Num''', '''Numerators''' -- общие нумераторы
+* '''Num''', '''Numerators''' -- общие (свободные) нумераторы
 * '''RootOptions''' -- особые общие объекты (к примеру, порядок блокировки накопителей и т.д.).
 Если задан аргумент, производится также позиционирование на определенном виде объектов указанном в виде наименования или в виде индекса. Количество объектов данного типа в проекте можно найти с помощью функции [[Struct.Count|Count]]. К примеру, <code>Struct.Ref("Номенклатура")</code> создает объект структуры базы данных, позиционированный на справочнике "Номенклатура", если такого справочника не существует, функция возвратит вместо объекта пустое значение. Второй способ вызова с позиционированием: <code>Struct.Doc(12)</code> -- создает объект структуры базы данных, позиционированный на документе с индексом 12. При этом, чтобы получить общее число документов в проекте, можно использовать конструкцию <code>Struct.Doc.Count()</code>. При отсутствии аргумента, создается объект, неопределенного вида, к которому, к примеру, можно применить тот же самый метод [[Struct.Count|Count]]. После указания на вид объекта цепочку ссылок можно продолжать пока функции возвращают объект структуры (к примеру, <code>Struct.Ref("Номенклатура").LineParts("Штрихкоды").Props("ТипШтрихкода").DataType</code>, однако, если какого-либо типа объекта не существует, промежуточная функция возвратит пустое значение и следующий по цепочке вызов функции создаст исключение (к примеру, если строчная часть "Штрихкоды" в справочнике "Номенклатура" не задана, при попытке получить доступ к реквизитам строчной части ([[Struct.LineParts.Properties|.Props...]]) будет создано исключение.

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