Admin: 1 revision imported

2021-02-07T06:54:36Z

1 revision imported

Admin at 07:11, 17 November 2019

2019-11-17T07:11:15Z

New page

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

== Синтаксис ==
<code>
{{Grey|TempDB.}}'''AddColumns'''(''<Наименования столбцов с типами данных (STRING)>'')
</code>

==== Аргументы ====
* <code>''<Наименования столбцов с типами данных (STRING)>''</code> - Задает наименования добавляемых столбцов через запятую, формат задания столбца: <code><Наименование столбца>:<Тип данных столбца>[:<Дополнительные флаги столбца>]</code>.
** Наименование столбца подчиняется стандартным правилам создания наименований в системе и может содержать международные символы.
** [[Нотация типов данных|Тип данных]] задается либо в виде прямого указания на тип данных <code><Тип>[:<Размер>[:<Точность>]]</code>, возможно указание на следующие типы:
*** '''NUMBER''', '''NUM''' -- задает вещественное число с указанием на точность его представления. Тип записывается в виде <code>NUMBER:<Общее количество цифр>:<Количество цифр после точки></code>.
*** '''INTEGER''', '''INT''' -- задает целое 64-битное число.
*** '''REAL''' -- задает произвольное вещественное число (в инженерной нотации)
*** '''DATE''' -- задает тип данных даты и времени.
*** '''STRING''', '''STR''' -- задает строковой тип данных с указанием длины строки в виде <code>STRING:<Длина строки в символах></code>. Для строк произвольной длины, необходимо указать ноль (возможности при работе с такими строками имеют определенные ограничения для SQL серверов).
*** '''ANY''', '''DB''' -- задает произвольный тип базы данных.
*** '''<Тип данных БД>[.<Вид данных БД>]''' -- задает определенный тип данных базы данных. В ''типе данных БД'' можно указать '''REF''', '''DOC''', '''JOUR''', '''STOR''' или '''ENUM'''.
** Также ''тип данных'' можно задать с помощью указания на существующий реквизит объекта базы данных, иногда такой способ является более универсальным. В это случае формат записи выглядит следующим образом: <code>-><Тип данных БД>.<Вид данных БД>.<Реквизит объекта БД></code>. Система автоматически использует тип данных указанного реквизита для создания столбца временной таблицы.
** ''Флаги столбца'' представляют совокупность букв-указаний. В данный момент можно использовать следующие указания:
*** '''I''' -- Добавить индекс к данному столбцу после создания
*** '''U''' -- Текстовые данные, хранящиеся в столбце будут использовать формат UTF-16. '''Внимание''': без такого указания, по умолчанию текст будет храниться в текущей кодировке ANSI, что может явиться причиной потери международных символов.

== Примеры ==
<pre>
//Пример создает таблицу аТемп, и заполняет ее резервами реализациями договора аДоговор с помощью загрузки движений накопителя Взаиморасчеты
// При этом суммы подчиненных документов возврата отнимаются от сумм документов реализации
//После создания, производится выборка записей по датам документов реализации
аТемп:=TempDB.Create("аДок:DB,Сумма:NUMBER.15.2");
аТемп.LoadFrom("Stor.Взаиморасчеты","@LINK->аДок,Сумма*?(@EXPENSE=1,-1,1)->Сумма","Договор=аДоговор","isEmpty(Тара)","IsType(@LINK,Doc.Реализация,Doc.ВозвратОтПокупателя)");
//Для документов возврата подставляем в столбик аДок их основание
аТемп.Update(,"аДок..Doc.ВозвратОтПокупателя.ДокОснование->аДок","IsType(аДок,Doc.ВозвратОтПокупателя)");
аТемп.Group("аДок","Сумма");
аТемп.Remove("(Сумма<=0)Or(Not isType(аДок,Doc.Реализация))");
аТемп.AddColumns("Дата:DATE");
аТемп.Update(,"аДок..Doc.Реализация.DocDate->Дата");
аТемп.Select("Дата-");
...
</pre>

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

TempDB.AddColumns - Revision history

Admin: 1 revision imported

Admin at 07:11, 17 November 2019