http://wiki.gbsoft.ru/api.php?action=feedcontributions&feedformat=atom&user=AlexeyGB wiki - Вклад участника [ru]2026-04-09T21:06:27ZВклад участникаMediaWiki 1.30.0http://wiki.gbsoft.ru/index.php?title=ASSIGN&diff=3307ASSIGN2025-11-24T04:46:03Z<p>Alexey: </p>
<hr />
<div>{{Функция ГБ<br />
|Название=ASSIGN<br />
|Описание=Изменяет одно поле текущей записи [[Датасет|датасета]]. <br />
|Синтаксис=ASSIGN ('''Датасет и поле''', '''Значение''')<br />
|Аргументы=<br />
{{Аргумент<br />
|Название=Датасет и поле<br />
|Пояснение=строка, которая состоит из имени одного из датасетов электронной или печатной формы и имени поля этого датасета, разделенных точкой.<br>Можно указать через ";" сразу несколько полей данного датасета: ''датасет.поле1;поле2;поле3;...''<br />
Особыe режимы:<br />
*Если перед именем датасета указан символ "*", то поле изменяется во всех записях датасета. В этом случае второй аргумент - всегда выражение, потому записывается в кавычках.<br>'''Примечание: датасет не должен быть отфильтрован и(или) отсортирован по полям, которые изменяются функцией, вызываемой в этом режиме.'''<br />
*Если вместо имени поля указан символ "*", то изменятся все данные датасета. В этом случае значением должны быть данные другого датасета, либо 1/0 (тогда датасет будет закрыт).<br />
*Имя поля может иметь вид Heap.XXX, в этом случае модифицируется одна строка поля Heap<br />
*Префикс EMBEDDED:Имя_контейнера: означает, что датасет нужно искать в форме, [[Внедрение форм|внедренной]] в указанный контейнер<br />
*Префикс EMBEDDING: означает, что датасет нужно искать в форме, в которую [[Внедрение форм|внедрена]] текущая форма<br />
*Префикс LAUNCHFORM: означает, что датасет нужно искать в форме, с которой запущена текущая форма<br />
}}<br/>{{Аргумент<br />
|Название=Значение<br />
|Пояснение=значение произвольного типа данных для записи в поле. Если изменяется сразу несколько полей датасета, то их значения перечисляются через ",".<br>В режиме изменения всех записей датасета &ndash; строка с формулой.<br />
}}<br />
|Пример=Assign( `Goodies.Price`, 1 ) &ndash; изменит текущую запись<br />
<br/>Assign( `Dataset.Document;Articul;Certificate;BarCode`, :Id, :Art, :Cert, :BC ) &ndash; изменит сразу несколько полей<br />
<br/>Assign( `*Goodies.Price`, `Price*2` ) &ndash; изменит все записи (удвоит цену)<br />
<br/>Assign( `*dsGds.Qty;New`, `1,0` ) &ndash; инициализация двух полей во всех записях датасета (в данном случае значения полей - это выражение, поэтому записываются в кавычках)<br />
<br/>Assign( `*dsLines.Name;Note`, `'Имя','Комментарий'` ) &ndash; то же самое с текстовыми значениями<br />
<br/>Assign( `*ds.f1;f2;f3`, `IIF( f1=11,f1*5,f1),0,IIF( f1=55,'b',f3 )` ) &ndash; то же самое с выражениями для каждого поля (вычисление значений полей производится в порядке их следования)<br />
<br/>Assign( `DataSet.Heap.xxx`, 1 ) &ndash; изменит хиповое поле<br />
<br/>Assign( `launchform:HeapSet.@FullName`, HeapSet.FullName ) &ndash; изменит поле родительской формы<br />
<br />
В целях оптимизации перед записью нового значения оно вначале сравнивается с прежним, а запись производится только при их неравенстве. При этой проверке старое значение приводится к типу нового значения.<br />
<br/>Пример. Нужно преобразовать значения "01", "02" и т.п. в строковом поле Type в значения без ведущих нулей. Если использовать функцию так:<br />
Assign( `*dsDocs.Type`, `StrToFloat( Type )` )<br />
то запись изменённых значений не произойдёт, поскольку при проверке старое значение будет приведено к типу нового значения, т.е. "01" -> 1, после чего будет сравнение с новым значением (1=1) и, поскольку равенство выполнится, записи не будет.<br />
<br/>Чтобы произвести запись, нужно для нового значения принудительно указать тип старого значения, тогда будет сравнение значений с одинаковым типом, т.е. в примере строки со строкой "01"<>"1":<br />
Assign( `*dsDocs.Type`, `""+StrToFloat( Type )` )<br />
}}</div>Alexeyhttp://wiki.gbsoft.ru/index.php?title=ASSIGN&diff=3306ASSIGN2025-10-28T03:50:23Z<p>Alexey: </p>
<hr />
<div>{{Функция ГБ<br />
|Название=ASSIGN<br />
|Описание=Изменяет одно поле текущей записи [[Датасет|датасета]]. <br />
|Синтаксис=ASSIGN ('''Датасет и поле''', '''Значение''')<br />
|Аргументы=<br />
{{Аргумент<br />
|Название=Датасет и поле<br />
|Пояснение=строка, которая состоит из имени одного из датасетов электронной или печатной формы и имени поля этого датасета, разделенных точкой.<br>Можно указать через ";" сразу несколько полей данного датасета: ''датасет.поле1;поле2;поле3;...''<br />
Особыe режимы:<br />
*Если перед именем датасета указан символ "*", то поле изменяется во всех записях датасета. В этом случае второй аргумент - всегда выражение, потому записывается в кавычках.<br>'''Примечание:''' датасет не должен быть отфильтрован и(или) отсортирован по полям, которые изменяются функцией, вызываемой в этом режиме<br />
*Если вместо имени поля указан символ "*", то изменятся все данные датасета. В этом случае значением должны быть данные другого датасета, либо 1/0 (тогда датасет будет закрыт).<br />
*Имя поля может иметь вид Heap.XXX, в этом случае модифицируется одна строка поля Heap<br />
*Префикс EMBEDDED:Имя_контейнера: означает, что датасет нужно искать в форме, [[Внедрение форм|внедренной]] в указанный контейнер<br />
*Префикс EMBEDDING: означает, что датасет нужно искать в форме, в которую [[Внедрение форм|внедрена]] текущая форма<br />
*Префикс LAUNCHFORM: означает, что датасет нужно искать в форме, с которой запущена текущая форма<br />
}}<br/>{{Аргумент<br />
|Название=Значение<br />
|Пояснение=значение произвольного типа данных для записи в поле. Если изменяется сразу несколько полей датасета, то их значения перечисляются через ",".<br>В режиме изменения всех записей датасета &ndash; строка с формулой.<br />
}}<br />
|Пример=Assign( `Goodies.Price`, 1 ) &ndash; изменит текущую запись<br />
<br/>Assign( `Dataset.Document;Articul;Certificate;BarCode`, :Id, :Art, :Cert, :BC ) &ndash; изменит сразу несколько полей<br />
<br/>Assign( `*Goodies.Price`, `Price*2` ) &ndash; изменит все записи (удвоит цену)<br />
<br/>Assign( `*dsGds.Qty;New`, `1,0` ) &ndash; инициализация двух полей во всех записях датасета (в данном случае значения полей - это выражение, поэтому записываются в кавычках)<br />
<br/>Assign( `*dsLines.Name;Note`, `'Имя','Комментарий'` ) &ndash; то же самое с текстовыми значениями<br />
<br/>Assign( `*ds.f1;f2;f3`, `IIF( f1=11,f1*5,f1),0,IIF( f1=55,'b',f3 )` ) &ndash; то же самое с выражениями для каждого поля (вычисление значений полей производится в порядке их следования)<br />
<br/>Assign( `DataSet.Heap.xxx`, 1 ) &ndash; изменит хиповое поле<br />
<br/>Assign( `launchform:HeapSet.@FullName`, HeapSet.FullName ) &ndash; изменит поле родительской формы<br />
<br />
В целях оптимизации перед записью нового значения оно вначале сравнивается с прежним, а запись производится только при их неравенстве. При этой проверке старое значение приводится к типу нового значения.<br />
<br/>Пример. Нужно преобразовать значения "01", "02" и т.п. в строковом поле Type в значения без ведущих нулей. Если использовать функцию так:<br />
Assign( `*dsDocs.Type`, `StrToFloat( Type )` )<br />
то запись изменённых значений не произойдёт, поскольку при проверке старое значение будет приведено к типу нового значения, т.е. "01" -> 1, после чего будет сравнение с новым значением (1=1) и, поскольку равенство выполнится, записи не будет.<br />
<br/>Чтобы произвести запись, нужно для нового значения принудительно указать тип старого значения, тогда будет сравнение значений с одинаковым типом, т.е. в примере строки со строкой "01"<>"1":<br />
Assign( `*dsDocs.Type`, `""+StrToFloat( Type )` )<br />
}}</div>Alexeyhttp://wiki.gbsoft.ru/index.php?title=PROCESSCOMMAND&diff=3305PROCESSCOMMAND2025-09-19T11:01:25Z<p>Alexey: </p>
<hr />
<div>{{Функция ГБ<br />
|Название=PROCESSCOMMAND<br />
|Описание=Функция позволяет выполнить любую команду ГБ - открыть электронную форму, запустить отчет, создать объект, удалить его, сменить состояние, напечатать и т.д.<br/><br />
Список некоторых команд можно посмотреть в [[:Категория:Справочник команд ГБ|справочнике команд]].<br />
|Синтаксис=PROCESSCOMMAND ('''Тип объекта''','''Строка параметров''','''Команда''') <br/><br />
или <br/><br />
PROCESSCOMMAND ('CURRENT','''Строка параметров''','''Команда''') <br/><br />
или <br/><br />
PROCESSCOMMAND ('''тип:коды''','''Строка параметров''','''Команда''')<br />
|Аргументы=<br />
{{Аргумент<br />
|Название=Тип объекта<br />
|Пояснение=Целое число, являющееся кодом типа объекта (см. Объектная модель данных ГБ). Если указано слово 'CURRENT' - берется тип активного в данный момент объекта. Если указано тип:коды, берется множество объектов заданного типа с указанными кодами.<br />
}}<br/>{{Аргумент<br />
|Название=Строка параметров<br />
|Пояснение=Строка, которая содержит через "," список параметров команды.<br />
<br />
{{Внимание|1=Если значение любого из параметров содержит пробелы, запятые или кавычки, следует всю строку Имя=Значение взять в двойные кавычки. Например, '''SET:Heap.@Note=Это комментарий''' - неправильно. Правильно '''"SET:Heap.@Note=Это комментарий"'''<br />
}}<br />
<br />
Вот полный список параметров, которые можно передать в объект при создании и открытии существующего через ProcessCommand:<br />
*То, что работает в любой форме свойств: <br />
**DuplicateId - ид объекта, копию которого мы хотим создать. Причем установка поля Node является обязательным.<br />
**DoOnOpen - скрипт, выполняемый сразу после открытия <br />
**DoOnSave - скрипт, выполняемый непосредственно перед сохранением <br />
**ActivePage - имя закладки по умолчанию <br />
**SaveImmediate=Y - сохранить изменения сразу, не показывая форму пользователю<br />
**SendSaveMessage=1 - ожидать успешного завершения сохранения объекта. ''С версии 1.9.0.9 в ProcessCommand с SaveImmediate больше не нужно писать SendSaveMessage=1, такое поведение стало поведением по умолчанию. Если нужно из соображений совместимости сделать, чтобы скрипт продолжил выполняться до отработки команды ProcessCommand, следует писать SendSaveMessage=0''<br />
**AddZero=1 - разрешить добавлять товарные строки с количеством товара ноль (GoodiesQty=0)<br />
**CloseOnError=1 - при ошибке закрывать форму (иначе форма будет показана пользователю)<br />
*установка любых полей '''ПРИ СОЗДАНИИ НОВОГО ОБЪЕКТА''' (но в документах этого лучше не делать, т.к. там с большинством полей связана специфическая функциональность - используйте параметры, описанные ниже): <br />
**SET:Field= <br />
**SET:Heap.Field= <br />
* в документах основные поля через SET ставить нельзя, надо использовать стандартные параметры: <br />
**Partner - заполняет соотв. поле <br />
**Agent - заполняет соотв. поле <br />
**Kind - заполняет соотв. поле <br />
**OpDate - заполняет сразу и OperationDate и DocDate <br />
**NOTE - заполняет поле HeapSet.@Note <br />
**DOCNUMBER - для товарных документов заполняет соответствующее поле. Для нетоварных используется SET:DOCNUMBER<br />
**WWWORDER - заполняет поле Imported_Id <br />
**CURRENCY - заполняет поле DocCurrency <br />
**PRICELIST - заполняет поле HeapSet.@PriceList <br />
**ActiveLinkPage - открывает документ на закладке "связи", на подзакладке с заданным номером. <br />
**Link (Link1, ...) - список кодов документов, с которыми нужно связать создаваемый <br />
**LinkSide (LinkSide1, ...) - направление связи - LinkSide=С означает что новый (т.е. создаваемый) документ будет записан в связях в поле CreditDoc, иначе - в DebetDoc <br />
**LinkType (LinkType1, ...) - тип связи <br />
**Update=True - при создании не имеет значения, а при открытии существующего документа означает, что товарные **строки необходимо заполнить заново, а не дописывать к существующим <br />
**PosOnly=True - означает что из списка товарных строк нужно выбрать только положительные количества <br />
**NegOnly=True - означает что из списка товарных строк нужно выбрать только отрицательные количества <br />
**DontCreateEmpty - не создавать пустой документ (без тов. строк) <br />
**GoodiesDs=имя - имя датасета, который содержит список товарных строк <br />
**GoodiesDs==выражение - запрос, который вернет нам список товарных строк <br />
**GoodiesArt <br />
**GoodiesCert <br />
**GoodiesQty <br />
**GoodiesNote <br />
**GoodiesHeap.XXXX - запись в хиповое поле ХХХХ<br />
**GoodiesField.AutoSaveXXXX - запись в поле вида AutoSaveCert@Apt <br />
**GoodiesPrice - цена с НДС и затратами (выражение, вычисляемое на GoodieDs)<br />
**GoodiesPriceList - цена без НДС и затрат (выражение, вычисляемое на GoodieDs)<br />
**ExpensesDs - имя датасета со списком затрат <br />
**ExpensesDs.Field <br />
**ExpensesDs.Heap.Field - выражения, вычисляемые на ExpensesDs, заполняют соотв. поля<br />
**EntriesDs - имя датасета со списком проводок (например, документ типа "Бухгалтерская операция")<br />
*'''ДЛЯ ИЗМЕНЕНИЯ ЗНАЧЕНИЙ ПОЛЕЙ В СУЩЕСТВУЮЩЕМ ОБЪЕКТЕ НУЖНО ИСПОЛЬЗОВАТЬ СКРИПТ DoOnOpen'''<br />
Управление остатками:<br />
**UseAvailableRest - для команды "импорт товарных документов" (ID125), позволяет создавать документы в пределах свободного остатка товара<br />
**CutToRest - для команды "PROPERTIES", позволяет создавать документы в пределах свободного остатка<br />
**AutoCompensate - для команды "импорт товарных документов" (ID125) и "PROPERTIES", включает автоматическое создание компенсационных документов при нехватке товара<br />
:''UseAvailableRest (CutToRest) и AutoCompensate взаимоисключающие, т.о. если задан UseAvailableRest, то компенсации не будут создаваться''<br />
}}<br/>{{Аргумент<br />
|Название=Команда<br />
|Пояснение=Строка, описывающая команду. Возможные варианты:<br />
*'''"EXPLORE"''' - открыть справочник. Возможные параметры:<br />
**Id=X - открыть справочник на объекте с кодом X<br />
*'''"PROPERTIES"''' - открыть свойства объекта. Возможные параметры:<br />
**Id=X - открыть свойства объекта с кодом X.<br />
**Id=-1 - создать новый объект, при этом:<br />
**DuplicateId=Y - создать копию объекта с кодом Y.<br />
**SubType=Y - создать объект с подтипом Y.<br />
**ItemType=0 - создать новую папку.<br />
**ItemType=1 - создать новую запись.<br />
**Node=Y - создать объект в папке с кодом Y.<br />
**KeepPack=1 - принудительная простановка типа упаковки (без него, например, при количестве < целой коробки упаковка приводится к минимальной).<br />
**GoodiesDsMaxLines=100 - ограничение количества товарных строк в документе (в примере ограничение равно ста строкам).<br />
**CheckPostConds=1 - перед открытием свойств электронной формы создаваемого документа проверить постусловия. Осуществится выполнение только постусловий с вызовом [[Функции ГБ|Exception]]. В случае срабатывания исключения текст ошибки поместится в переменную :LastError.<br />
**ActivePage=Имя закладки - установить активную закладку.<br />
**SaveImmediate=Y - сохранить изменения сразу по открытии.<br />
**DoOnOpen=скрипт - выполнить скрипт после открытия.<br />
**DoOnSave=скрипт - выполнить скрипт после сохранения.<br />
**Кроме того, для документов:<br />
***Имя поля=значение - присвоить данному полю датасета DataSet данное значение.<br />
*'''"PRINT"''' - напечатать объект. Возможные параметры:<br />
**ReportId=X или CmdParams=X -печатать форму с кодом X (ReportId=X).<br />
**ShowForm=Y - вывести окно для выбора печатной формы.<br />
**Target=файл - печатать в файл (для текстовых, Word и Excel форм).<br />
**Template=файл - шаблон для Word и Excel форм.<br />
*'''"SETFLAG"''' - изменить [[Флаг|состояние]] документа. Возможные параметры:<br />
**SetState=X -Установить [[флаг]]=X.<br />
*'''"SETREADONLY"''' - сделать текущую форму доступной только для чтения. Возможные параметры:<br />
**ReadOnly=1 - Вся форма будет доступна только для чтения.<br />
**Кроме того, для документов:<br />
**ReadOnlyDesc=причина - При попытке что-то поправить, будет выдаваться сообщение: Документ доступен только для чтения, так как недостаточно полномочий для изменения документов с + причина<br />
**GoodiesReadOnly=1 - нельзя добавлять и удалять товарные строки, также нельзя менять количества. цены менять можно.<br />
**GoodiesCannotDeleteDesc=причина - при попытке удалить товаоные строки, будет возникать ошибка: причина<br />
**GoodiesPriceReadOnly=1 - запретить изменение цен.<br />
**ReadOnlyDiffs=номер_закладки - запретить изменение закладок связей.<br />
*'''"IDXXX"''' - выполнить команду с кодом XXX (см. [[:Категория:Справочник команд ГБ]]).<br />
**Если XXX - код отчета, то возможны параметры:<br />
***Param:Поле=Значение - изменить параметр.<br />
***Immediate=Y - сразу вывести результаты.<br />
***ParamsSettings=X - код предустановки параметров.<br />
***GridSettings=X - код предустановки результатов.<br />
*"OPENREPORT" - позволяет запустить команду (см. [[Типы объектов ГБ]]). <br />
}}<br />
|Пример=PROCESSCOMMAND(11, 'Id=-1,SubType=17', 'properties') создать новый заказ<br/><br />
PROCESSCOMMAND('CURRENT', 'CmdParams=1007', 'print') напечатать выделенные объекты<br/><br />
PROCESSCOMMAND(11, ['Id': :CurrentIds, 'SetState': 100], 'SETFLAG') изменить состояние документа<br/><br />
PROCESSCOMMAND(11, ['Id': :CurrentIds, 'SET:Flag': 100], 'SETFLAG') изменить состояние документа, для которого не создан класс<br/><br />
PROCESSCOMMAND('11:19713613;19708614;19712711;19707700;', ``, 'SETFLAG') вызвать окно Состояние документа на список документов<br/><br />
PROCESSCOMMAND(14,'Id=1000','OPENREPORT') запустить команду с Id = 1000<br/><br />
ProcessCommand(1, [`Id`:100661, `Node`:114, `Category`:1], `EXPLORE`) открыть справочник товаров, позиционироваться на товар 100661 в папке 114, альтернативного дерева 1<br />
}}</div>Alexeyhttp://wiki.gbsoft.ru/index.php?title=QUERYPARAMS&diff=3304QUERYPARAMS2025-06-24T06:51:51Z<p>Alexey: </p>
<hr />
<div>{{Функция ГБ<br />
|Название=QUERYPARAMS<br />
|Описание=Предлагает пользователю форму для ввода параметров. Возвращает "истина", если пользователь нажал в предложенной форме кнопку "Принять", и "ложь" в противном случае. Введенные пользователем параметры сохраняются в переменных.<br />
|Синтаксис=QUERYPARAMS ('''Строка описания параметров''',Заголовок окна)<br />
|Аргументы=<br />
{{Аргумент<br />
|Название=Строка описания параметров<br />
|Пояснение=Строка, описывающая требуемые параметры. Формат тот же, что для описания параметров отчетов.<br />
}}<br/>{{Аргумент<br />
|Название=Заголовок окна<br />
|Пояснение=Строка, заголовок окна для ввода параметров.<br />
}}<br />
|Результат=Логическое значение.<br />
|Пример=Если пользователь ввел требуемые параметры и нажал "Принять", то в переменных :MyStock и :MyString сохранятся введенные параметры:<br />
QueryParams("Stock['Склад']=MyStock,String['Строка']=MyString")<br />
<br><br />
Ввод пароля, который отображается "звёздочками":<br />
QueryParams(`String['Пароль']=pwd{Constraints='password=*'}`,`Ввод пароля`)<br />
<br><br />
Зависимое поле<br />
<pre><br />
QueryParams(`File['Файл']=FileName{Constraints='Ext=*.xlsx'},PriceList.ByNode(219)['Тип тарифа']=utType,PriceList['Опция тарифа']:Folder=utSubType{Constraints='Src=OpenDataSet( "PRICELISTS_LIST",[ "Node,I" : ifempty(?utType,-1) ],"dsR" ),dsR.$data;KeyField=Id;ListField=Id.Name;DependsOn=?utType'}`),<br />
</pre><br />
<br />
}}<br />
<br />
== Отображение таблиц ==<br />
Специальный режим работы функции QUERYPARAMS - это отображение одного из датасетов текущей формы в виде таблицы.<br />
Синтаксис:<br />
QueryParams(`Grid=MyDs`)<br />
<br />
Замечания:<br />
# поскольку таблица лежит в форме ввода параметров команды, а датасет в родительской, нельзя делать правила (изменять одни поля при изменении других, запрещать вставку и удаление)<br />
# поскольку форма ввода параметров создается с одним и тем же именем, настройка таблицы в реестре хранится всего одна. Поэтому в случае использования QUERYPARAMS для отображения разных датасетов может потребоваться задавать настройку таблицы прямо в функции:<br />
<br />
<pre><br />
`Grid=MyDs,String['aaa']=aaa,GridParams:__AutoGridMyDs='"RequiredLayout=|""reason"",""-100"",""Причина""|;|""NewField1[Тест,]=1+2"",""-40"",""Тест!""|"'`, `Заголовок` <br />
</pre><br />
<br />
<pre><br />
CreateDataSet( `dsUID`,[`UID,S` : 1/0] ),<br />
QueryParams(<br />
`Grid=dsUID`<br />
+ `,GridParams:__AutoGriddsUID='"RequiredColumns=|""UID"",""-240"",""UID документа""|;|""GB$Ordering"",""0""|"'`,<br />
`Список UID для импорта`<br />
)<br />
<pre><br />
<br />
Заметим, что двойные кавычки в настройке таблицы удваиваются.<br />
Для разбивки заголовка колонок на несколько строк следует использовать управляющую комбинацию #13#10</div>Alexeyhttp://wiki.gbsoft.ru/index.php?title=GB_FINDOBJECT&diff=3303GB FINDOBJECT2025-06-05T10:11:38Z<p>Alexey: </p>
<hr />
<div>{{Underscore}}<br />
{{Функция ГБ<br />
|Название=GB_FINDOBJECT<br />
|Описание=Осуществляет поиск объекта по имени. Если существует ровно один объект заданного типа, имя которого точно совпадает с заданным, возвращает его код. Если такого объекта не существует, или их несколько - возвращает NULL<br/><br />
Для партнеров поиск производится не только по названию, но и по ИНН.<br />
|Синтаксис=GB_FINDOBJECT('''Тип объекта''', '''Название объекта''')<br />
|Аргументы=<br />
{{Аргумент<br />
|Название=Тип объекта<br />
|Пояснение=Целое число, являющееся кодом типа объекта ГБ (описание типов см. Объектная модель данных ГБ).<br />
}}<br/>{{Аргумент<br />
|Название=Название объекта<br />
|Пояснение=Строка, являющаяся именем объекта. Для партнеров поиск производится не только по имени, но и по ИНН.<br />
}}<br />
|Результат=Целое число, являющееся кодом объекта.<br />
|Пример=Gb_FindObject( 0,`ООО Рога и Копыта` ) &ndash; ищем партнёра по всем папкам<br><br />
Gb_FindObject( 0,`TSD.SP.3`,`Node`,100 ) &ndash; ищем партнёра в папке с Id=100<br><br />
Gb_FindObject( 17,`номер_серии`,`Articul`,ид_товара ) &ndash; ищем серию с номером "номер_серии" для товара "ид_товара"<br />
}}</div>Alexeyhttp://wiki.gbsoft.ru/index.php?title=GB_FINDOBJECT&diff=3302GB FINDOBJECT2025-06-05T10:11:26Z<p>Alexey: </p>
<hr />
<div>{{Underscore}}<br />
{{Функция ГБ<br />
|Название=GB_FINDOBJECT<br />
|Описание=Осуществляет поиск объекта по имени. Если существует ровно один объект заданного типа, имя которого точно совпадает с заданным, возвращает его код. Если такого объекта не существует, или их несколько - возвращает NULL<br/><br />
Для партнеров поиск производится не только по названию, но и по ИНН.<br />
|Синтаксис=GB_FINDOBJECT('''Тип объекта''', '''Название объекта''')<br />
|Аргументы=<br />
{{Аргумент<br />
|Название=Тип объекта<br />
|Пояснение=Целое число, являющееся кодом типа объекта ГБ (описание типов см. Объектная модель данных ГБ).<br />
}}<br/>{{Аргумент<br />
|Название=Название объекта<br />
|Пояснение=Строка, являющаяся именем объекта. Для партнеров поиск производится не только по имени, но и по ИНН.<br />
}}<br />
|Результат=Целое число, являющееся кодом объекта.<br />
|Пример=Gb_FindObject( 0,`ООО Рога и Копыта` ) &ndash; ищем партнёра по всем папкам<br><br />
Gb_FindObject( 0,`TSD.SP.3`,`Node`,100 ) &ndash; ищем партнёра в папке с Id=100<br />
Gb_FindObject( 17,`номер_серии`,`Articul`,ид_товара ) &ndash; ищем серию с номером "номер_серии" для товара "ид_товара"<br><br />
}}</div>Alexeyhttp://wiki.gbsoft.ru/index.php?title=GB_FINDOBJECT&diff=3301GB FINDOBJECT2025-06-05T10:10:08Z<p>Alexey: </p>
<hr />
<div>{{Underscore}}<br />
{{Функция ГБ<br />
|Название=GB_FINDOBJECT<br />
|Описание=Осуществляет поиск объекта по имени. Если существует ровно один объект заданного типа, имя которого точно совпадает с заданным, возвращает его код. Если такого объекта не существует, или их несколько - возвращает NULL<br/><br />
Для партнеров поиск производится не только по названию, но и по ИНН.<br />
|Синтаксис=GB_FINDOBJECT('''Тип объекта''', '''Название объекта''')<br />
|Аргументы=<br />
{{Аргумент<br />
|Название=Тип объекта<br />
|Пояснение=Целое число, являющееся кодом типа объекта ГБ (описание типов см. Объектная модель данных ГБ).<br />
}}<br/>{{Аргумент<br />
|Название=Название объекта<br />
|Пояснение=Строка, являющаяся именем объекта. Для партнеров поиск производится не только по имени, но и по ИНН.<br />
}}<br />
|Результат=Целое число, являющееся кодом объекта.<br />
|Пример=Gb_FindObject( 0,`ООО Рога и Копыта` ) &ndash; ищем фирму<br><br />
Gb_FindObject( 17,`номер_серии`,`Articul`,ид_товара ) &ndash; ищем серии с номером "номер_серии" для товара "ид_товара"<br><br />
Gb_FindObject( 0,`TSD.SP.3`,`Node`,100 ) &ndash; ищем партнёра в папке с Id=100<br />
}}</div>Alexeyhttp://wiki.gbsoft.ru/index.php?title=GB_FINDOBJECT&diff=3300GB FINDOBJECT2025-06-05T10:09:54Z<p>Alexey: </p>
<hr />
<div>{{Underscore}}<br />
{{Функция ГБ<br />
|Название=GB_FINDOBJECT<br />
|Описание=Осуществляет поиск объекта по имени. Если существует ровно один объект заданного типа, имя которого точно совпадает с заданным, возвращает его код. Если такого объекта не существует, или их несколько - возвращает NULL<br/><br />
Для партнеров поиск производится не только по названию, но и по ИНН.<br />
|Синтаксис=GB_FINDOBJECT('''Тип объекта''', '''Название объекта''')<br />
|Аргументы=<br />
{{Аргумент<br />
|Название=Тип объекта<br />
|Пояснение=Целое число, являющееся кодом типа объекта ГБ (описание типов см. Объектная модель данных ГБ).<br />
}}<br/>{{Аргумент<br />
|Название=Название объекта<br />
|Пояснение=Строка, являющаяся именем объекта. Для партнеров поиск производится не только по имени, но и по ИНН.<br />
}}<br />
|Результат=Целое число, являющееся кодом объекта.<br />
|Пример=Gb_FindObject( 0,`ООО Рога и Копыта` )<br> &ndash; ищем фирму<br />
Gb_FindObject( 17,`номер_серии`,`Articul`,ид_товара ) &ndash; ищем серии с номером "номер_серии" для товара "ид_товара"<br><br />
Gb_FindObject( 0,`TSD.SP.3`,`Node`,100 ) &ndash; ищем партнёра в папке с Id=100<br />
}}</div>Alexeyhttp://wiki.gbsoft.ru/index.php?title=ASSIGN&diff=3299ASSIGN2025-02-27T10:18:44Z<p>Alexey: </p>
<hr />
<div>{{Функция ГБ<br />
|Название=ASSIGN<br />
|Описание=Изменяет одно поле текущей записи [[Датасет|датасета]]. <br />
|Синтаксис=ASSIGN ('''Датасет и поле''', '''Значение''')<br />
|Аргументы=<br />
{{Аргумент<br />
|Название=Датасет и поле<br />
|Пояснение=строка, которая состоит из имени одного из датасетов электронной или печатной формы и имени поля этого датасета, разделенных точкой.<br>Можно указать через ";" сразу несколько полей данного датасета: ''датасет.поле1;поле2;поле3;...''<br />
Особыe режимы:<br />
*Если перед именем датасета указан символ "*", то поле изменяется во всех записях датасета. В этом случае второй аргумент - всегда выражение, потому записывается в кавычках.<br />
*Если вместо имени поля указан символ "*", то изменятся все данные датасета. В этом случае значением должны быть данные другого датасета, либо 1/0 (тогда датасет будет закрыт).<br />
*Имя поля может иметь вид Heap.XXX, в этом случае модифицируется одна строка поля Heap<br />
*Префикс EMBEDDED:Имя_контейнера: означает, что датасет нужно искать в форме, [[Внедрение форм|внедренной]] в указанный контейнер<br />
*Префикс EMBEDDING: означает, что датасет нужно искать в форме, в которую [[Внедрение форм|внедрена]] текущая форма<br />
*Префикс LAUNCHFORM: означает, что датасет нужно искать в форме, с которой запущена текущая форма<br />
}}<br/>{{Аргумент<br />
|Название=Значение<br />
|Пояснение=значение произвольного типа данных для записи в поле. Если изменяется сразу несколько полей датасета, то их значения перечисляются через ",".<br>В режиме изменения всех записей датасета &ndash; строка с формулой.<br />
}}<br />
|Пример=Assign( `Goodies.Price`, 1 ) &ndash; изменит текущую запись<br />
<br/>Assign( `Dataset.Document;Articul;Certificate;BarCode`, :Id, :Art, :Cert, :BC ) &ndash; изменит сразу несколько полей<br />
<br/>Assign( `*Goodies.Price`, `Price*2` ) &ndash; изменит все записи (удвоит цену)<br />
<br/>Assign( `*dsGds.Qty;New`, `1,0` ) &ndash; инициализация двух полей во всех записях датасета (в данном случае значения полей - это выражение, поэтому записываются в кавычках)<br />
<br/>Assign( `*dsLines.Name;Note`, `'Имя','Комментарий'` ) &ndash; то же самое с текстовыми значениями<br />
<br/>Assign( `*ds.f1;f2;f3`, `IIF( f1=11,f1*5,f1),0,IIF( f1=55,'b',f3 )` ) &ndash; то же самое с выражениями для каждого поля (вычисление значений полей производится в порядке их следования)<br />
<br/>Assign( `DataSet.Heap.xxx`, 1 ) &ndash; изменит хиповое поле<br />
<br/>Assign( `launchform:HeapSet.@FullName`, HeapSet.FullName ) &ndash; изменит поле родительской формы<br />
<br />
В целях оптимизации перед записью нового значения оно вначале сравнивается с прежним, а запись производится только при их неравенстве. При этой проверке старое значение приводится к типу нового значения.<br />
<br/>Пример. Нужно преобразовать значения "01", "02" и т.п. в строковом поле Type в значения без ведущих нулей. Если использовать функцию так:<br />
Assign( `*dsDocs.Type`, `StrToFloat( Type )` )<br />
то запись изменённых значений не произойдёт, поскольку при проверке старое значение будет приведено к типу нового значения, т.е. "01" -> 1, после чего будет сравнение с новым значением (1=1) и, поскольку равенство выполнится, записи не будет.<br />
<br/>Чтобы произвести запись, нужно для нового значения принудительно указать тип старого значения, тогда будет сравнение значений с одинаковым типом, т.е. в примере строки со строкой "01"<>"1":<br />
Assign( `*dsDocs.Type`, `""+StrToFloat( Type )` )<br />
}}</div>Alexeyhttp://wiki.gbsoft.ru/index.php?title=EXECCONSOLEAPP&diff=3298EXECCONSOLEAPP2024-12-17T03:06:26Z<p>Alexey: </p>
<hr />
<div>{{Функция ГБ<br />
|Название=EXECCONSOLEAPP<br />
|Описание=Выполняет внешнее приложение. Возвращает код завершения приложения, помещает его текстовый вывод в переменную :AppStdOut<br />
|Синтаксис=Вариант 1 &ndash; выполнение операции над указанным файлом, используя приложение по умолчанию<br/><br />
EXECCONSOLEAPP(`shellexecute`, '''Операция''', '''Файл''', '''Параметры''', '''Путь к файлу''', Вид окна)<br/><br />
либо (упрощенный вариант)<br/><br />
EXECCONSOLEAPP(`start`, '''Файл''', Режим)<br/><br />
Вариант 2 &ndash; запуск консольного приложения<br/><br />
EXECCONSOLEAPP('''Командная строка''', Режим ожидания, Флаги)<br />
|Аргументы=<br />
{{Аргумент<br />
|Название=Операция<br />
|Пояснение=Одна из операций Windows, варианты:<br />
*`find` &ndash; стандартный поиск Windows (файлов, папок, компьютеров и т.д.). Файл - путь к папке, начиная с которой выполняется поиск, остальные параметры не используются.<br />
*`explore` &ndash; стандартный проводник Windows. Файл - путь к папке, на которой открывается проводник, остальные параметры не используются.<br />
*`edit` &ndash; редактирование файла в приложении по умолчанию<br />
*`open` &ndash; открытие файла в приложении по умолчанию<br />
*`print`,`printto` &ndash; печать файла из приложения по умолчанию<br />
}}<br/><br />
{{Аргумент<br />
|Название=Файл<br />
|Пояснение=Имя файла, с которым следует выполнить операцию.<br />
}}<br/><br />
{{Аргумент<br />
|Название=Параметры<br />
|Пояснение=Список параметров, передаваемых загружаемому приложению. Например, для операции printto параметром может быть имя принтера<br />
}}<br/><br />
{{Аргумент<br />
|Название=Путь к файлу<br />
|Пояснение=Путь к файлу, указанному в параметре Файл. Если Файл уже содержит путь, то Путь=пустая строка<br />
}}<br/><br />
{{Аргумент<br />
|Название=Вид окна<br />
|Пояснение=Вид окна приложения (необязательный параметр):<br />
*0 (`SW_HIDE`) &ndash; скрывает окно загружаемого приложения и активизирует другое окно;<br />
*1 (`SW_SHOWNORMAL`) &ndash; отображает главное окно приложения и делает его активным. Если окно приложения минимизировано или максимизировано, Windows восстанавливает его первоначальный размер и позицию;<br />
*2 (`SW_SHOWMINIMIZED`) &ndash; окно загружаемого приложения минимизировано;<br />
*3 (`SW_MAXIMIZE`) &ndash; раскрывает окно приложения на весь экран и делает его активным;<br />
*4 (`SW_SHOWNOACTIVATE`) &ndash; отображает окно приложения в его последних сохранённых размерах, но не делает его активным.<br />
}}<br/><br />
{{Аргумент<br />
|Название=Командная строка<br />
|Пояснение=строка, полный или относительный путь к исполняемому файлу, а также аргументы командной строки (ключи).<br />
:Для вызова команд ОС нужно использовать синтаксис '''«cmd /c <команда>»'''.<br />
}}<br/><br />
{{Аргумент<br />
|Название=Режим<br />
|Пояснение=строка, режим запуска Windows-приложения для функции ShellExecute:<br />
*`open` &ndash; открытие документа<br />
*`print` &ndash; печать документа.<br />
}}<br/><br />
{{Аргумент<br />
|Название=Режим ожидания<br />
|Пояснение=целое число:<br />
*0 &ndash; с ожиданием. Никакие формы ГБ недоступны до окончания работы внешней программы;<br />
*1 &ndash; условное ожидание. Форма, с которой произведен вызов, становится недоступной, но можно работать в других. По окончании работы внешней программы недоступная форма становится вновь доступной;<br />
*2 &ndash; без ожидания.<br />
При значениях режима ожидания 0 и 1 результат вызова - это exitcode процесса.<br />
}}<br/><br />
{{Аргумент<br />
|Название=Флаги<br />
|Пояснение=целое число (битовая маска):<br />
*бит #0=1 &ndash; скрыть окно консоли;<br />
*бит #1=1 &ndash; НЕ перехватывать стандартный вывод (stdout).<br />
<br />
Стандартный вывод консольных приложений, запущенных через ExecConsoleApp в режиме с ожиданием (0 и 1) и флагом со сброшенным битом #1 (бит #1=0), перехватывается и записывается в переменную ''':AppStdOut'''. Не всегда работает надёжно, поэтому можно перенаправить вывод в файл, а затем читать из него.<br />
}}<br />
|Результат=Целое число<br />
|Пример=Запустит "Блокнот":<br />
ExecConsoleApp(`start`, `notepad`)<br />
Удалит из папки c:\temp все файлы:<br />
ExecConsoleApp(`cmd /c del c:\temp\*.txt`, 2)<br />
Запустит проводник Windows и отобразит в нём папку "e:\1\":<br />
ExecConsoleApp(`shellexecute`, `explore`, `e:\1\`, ``, ``, `SW_SHOWNORMAL`)<br />
Запустит winrar.exe, который создаст архив C:\myarchive.rar и заархивирует файл "C:\Program Files\WinRAR\WinRAR.chm":<br />
ExecConsoleApp(`shellexecute`,<br />
`open`,<br />
`"C:\Program Files\WinRAR\WinRAR.exe"`,<br />
`a C:\myarchive.rar "C:\Program Files\WinRAR\WinRAR.chm"`,<br />
``<br />
)<br />
Печать на выбранный принтер (работает не со всеми типами документов, вопросы - к Microsoft). Путь и имя файла, а также имя принтера, если они содержат пробелы, нужно передавать в кавычках:<br />
ExecConsoleApp(<br />
`shellexecute`,<br />
`printto`,<br />
`"D:\Файлы для печати\1.doc"`,<br />
`"\\AGENT007\hpLJ1010HB"`,<br />
0,<br />
`SW_HIDE`<br />
)<br />
Пример скрипта для пакетной печатной формы (печатает файл, путь и имя которого хранится в документе, на принтер, выбранный в стандартной форме печати):<br />
IfEmpty(<br />
DataSet.Heap.FileToPrint,<br />
0,<br />
(<br />
ExecConsoleApp(<br />
`shellexecute`,<br />
`printto`,<br />
`"`+DataSet.Heap.FileToPrint+`"`,<br />
`"`+:PrinterName+`"`,<br />
0,<br />
`SW_HIDE`<br />
),<br />
0<br />
)<br />
)<br />
Печать на принтер "по умолчанию":<br />
ExecConsoleApp(<br />
`shellexecute`,<br />
`print`,<br />
`d:\aaa.pdf`,<br />
``,<br />
0,<br />
`SW_HIDE`<br />
)<br />
}}</div>Alexeyhttp://wiki.gbsoft.ru/index.php?title=EXECCONSOLEAPP&diff=3297EXECCONSOLEAPP2024-12-12T07:10:19Z<p>Alexey: </p>
<hr />
<div>{{Функция ГБ<br />
|Название=EXECCONSOLEAPP<br />
|Описание=Выполняет внешнее приложение. Возвращает код завершения приложения, помещает его текстовый вывод в переменную :AppStdOut<br />
|Синтаксис=Вариант 1 &ndash; выполнение операции над указанным файлом, используя приложение по умолчанию<br/><br />
EXECCONSOLEAPP(`shellexecute`, '''Операция''', '''Файл''', '''Параметры''', '''Путь к файлу''', Вид окна)<br/><br />
либо (упрощенный вариант)<br/><br />
EXECCONSOLEAPP(`start`, '''Файл''', Режим)<br/><br />
Вариант 2 &ndash; запуск консольного приложения<br/><br />
EXECCONSOLEAPP('''Командная строка''', Режим ожидания, Флаги)<br />
|Аргументы=<br />
{{Аргумент<br />
|Название=Операция<br />
|Пояснение=Одна из операций Windows, варианты:<br />
*`find` &ndash; стандартный поиск Windows (файлов, папок, компьютеров и т.д.). Файл - путь к папке, начиная с которой выполняется поиск, остальные параметры не используются.<br />
*`explore` &ndash; стандартный проводник Windows. Файл - путь к папке, на которой открывается проводник, остальные параметры не используются.<br />
*`edit` &ndash; редактирование файла в приложении по умолчанию<br />
*`open` &ndash; открытие файла в приложении по умолчанию<br />
*`print`,`printto` &ndash; печать файла из приложения по умолчанию<br />
}}<br/><br />
{{Аргумент<br />
|Название=Файл<br />
|Пояснение=Имя файла, с которым следует выполнить операцию.<br />
}}<br/><br />
{{Аргумент<br />
|Название=Параметры<br />
|Пояснение=Список параметров, передаваемых загружаемому приложению. Например, для операции printto параметром может быть имя принтера<br />
}}<br/><br />
{{Аргумент<br />
|Название=Путь к файлу<br />
|Пояснение=Путь к файлу, указанному в параметре Файл. Если Файл уже содержит путь, то Путь=пустая строка<br />
}}<br/><br />
{{Аргумент<br />
|Название=Вид окна<br />
|Пояснение=Вид окна приложения (необязательный параметр):<br />
*0 (`SW_HIDE`) &ndash; скрывает окно загружаемого приложения и активизирует другое окно;<br />
*1 (`SW_SHOWNORMAL`) &ndash; отображает главное окно приложения и делает его активным. Если окно приложения минимизировано или максимизировано, Windows восстанавливает его первоначальный размер и позицию;<br />
*2 (`SW_SHOWMINIMIZED`) &ndash; окно загружаемого приложения минимизировано;<br />
*3 (`SW_MAXIMIZE`) &ndash; раскрывает окно приложения на весь экран и делает его активным;<br />
*4 (`SW_SHOWNOACTIVATE`) &ndash; отображает окно приложения в его последних сохранённых размерах, но не делает его активным.<br />
}}<br/><br />
{{Аргумент<br />
|Название=Командная строка<br />
|Пояснение=строка, полный или относительный путь к исполняемому файлу, а также аргументы командной строки (ключи).<br />
:Для вызова команд ОС нужно использовать синтаксис '''«cmd /c <команда>»'''.<br />
}}<br/><br />
{{Аргумент<br />
|Название=Режим<br />
|Пояснение=строка, режим запуска Windows-приложения для функции ShellExecute:<br />
*`open` &ndash; открытие документа<br />
*`print` &ndash; печать документа.<br />
}}<br/><br />
{{Аргумент<br />
|Название=Режим ожидания<br />
|Пояснение=целое число:<br />
*0 &ndash; с ожиданием. Никакие формы ГБ недоступны до окончания работы внешней программы;<br />
*1 &ndash; условное ожидание. Форма, с которой произведен вызов, становится недоступной, но можно работать в других. По окончании работы внешней программы недоступная форма становится вновь доступной;<br />
*2 &ndash; без ожидания.<br />
При значениях режима ожидания 0 и 1 результат вызова - это exitcode процесса.<br />
}}<br/><br />
{{Аргумент<br />
|Название=Флаги<br />
|Пояснение=целое число (битовая маска):<br />
*бит #0=1 &ndash; скрыть окно консоли;<br />
*бит #1=1 &ndash; НЕ перехватывать стандартный вывод (stdout).<br />
<br />
Стандартный вывод консольных приложений, запущенных через ExecConsoleApp в режиме с ожиданием (0 и 1) и флагом со сброшенным битом #1 (бит #1=0), перехватывается и записывается в переменную ''':AppStdOut'''. Не всегда работает надёжно, поэтому можно перенаправить вывод в файл, а затем читать из него.<br />
}}<br />
|Результат=Целое число<br />
|Пример=Запустит "Блокнот":<br />
ExecConsoleApp(`start`, `notepad`)<br />
Удалит из папки c:\temp все файлы:<br />
ExecConsoleApp(`cmd /c del c:\temp\*.txt`, 2)<br />
Запустит проводник Windows и отобразит в нём папку "e:\1\":<br />
ExecConsoleApp(`shellexecute`, `explore`, `e:\1\`, ``, ``, `SW_SHOWNORMAL`)<br />
Запустит winrar.exe, который создаст архив C:\myarchive.rar и заархивирует файл "C:\Program Files\WinRAR\WinRAR.chm":<br />
ExecConsoleApp(`shellexecute`,<br />
`open`,<br />
`"C:\Program Files\WinRAR\WinRAR.exe"`,<br />
`a C:\myarchive.rar "C:\Program Files\WinRAR\WinRAR.chm"`,<br />
``<br />
)<br />
Печать на выбранный принтер, работает не со всеми типами документов, вопросы - к Microsoft (если имя принтера содержит пробелы - передавать его в кавычках):<br />
ExecConsoleApp(<br />
`shellexecute`,<br />
`printto`,<br />
`E:\Temp\1.doc`,<br />
`"\\AGENT007\hpLJ1010HB"`,<br />
0,<br />
`SW_HIDE`<br />
)<br />
Печать на принтер "по умолчанию":<br />
ExecConsoleApp(<br />
`shellexecute`,<br />
`print`,<br />
`d:\aaa.pdf`,<br />
``,<br />
0,<br />
`SW_HIDE`<br />
)<br />
}}</div>Alexeyhttp://wiki.gbsoft.ru/index.php?title=SWITCHTEXT&diff=3296SWITCHTEXT2024-12-09T04:42:36Z<p>Alexey: </p>
<hr />
<div>{{Функция ГБ<br />
|Название=SWITCHTEXT<br />
|Описание=Переключает неправильно введенный текст в указанную раскладку. QWERTY<->ЙЦУКЕН<br />
|Синтаксис=SWITCHTEXT ('''Строка''','''Направление''')<br />
|Аргументы=<br />
{{Аргумент<br />
|Название=Строка<br />
|Пояснение=строка произвольного текста.<br />
}}<br/>{{Аргумент<br />
|Название=Направление<br />
|Пояснение=строка, возможные значения:<br />
:`R` &ndash; лат->рус<br />
:`E` &ndash; рус->лат<br />
:`WIN->UTF8` &ndash; очевидно Win1251->UTF-8<br />
:`REVERSECASE` &ndash; инвертировать регистр символов ("Привет" &ndash; "пРИВЕТ")<br />
:`ENCODEBASE64` &ndash; кодировать по BASE64<br />
:`DECODEBASE64` &ndash; декодировать по BASE64<br />
}}<br />
|Результат=Строка<br />
}}</div>Alexeyhttp://wiki.gbsoft.ru/index.php?title=EXECCONSOLEAPP&diff=3295EXECCONSOLEAPP2024-09-24T04:29:43Z<p>Alexey: </p>
<hr />
<div>{{Функция ГБ<br />
|Название=EXECCONSOLEAPP<br />
|Описание=Выполняет внешнее приложение. Возвращает код завершения приложения, помещает его текстовый вывод в переменную :AppStdOut<br />
|Синтаксис=Вариант 1 - выполнение операции над указанным файлом, используя приложение по умолчанию<br/><br />
EXECCONSOLEAPP(`shellexecute`, '''Операция''', '''Файл''', '''Параметры''', '''Путь к файлу''', Вид окна)<br/><br />
либо (упрощенный вариант)<br/><br />
EXECCONSOLEAPP(`start`, '''Файл''', Режим)<br/><br />
Вариант 2 – запуск консольного приложения<br/><br />
EXECCONSOLEAPP('''Командная строка''', Режим ожидания, Флаги)<br />
|Аргументы=<br />
{{Аргумент<br />
|Название=Операция<br />
|Пояснение=Одна из операций Windows, варианты:<br />
*`find` – стандартный поиск Windows (файлов, папок, компьютеров и т.д.). Файл - путь к папке, начиная с которой выполняется поиск, остальные параметры не используются.<br />
*`explore` – стандартный проводник Windows. Файл - путь к папке, на которой открывается проводник, остальные параметры не используются.<br />
*`edit` – редактирование файла в приложении по умолчанию<br />
*`open` – открытие файла в приложении по умолчанию<br />
*`print`,`printto` – печать файла из приложения по умолчанию<br />
}}<br/><br />
{{Аргумент<br />
|Название=Файл<br />
|Пояснение=Имя файла, с которым следует выполнить операцию.<br />
}}<br/><br />
{{Аргумент<br />
|Название=Параметры<br />
|Пояснение=Список параметров, передаваемых загружаемому приложению. Например, для операции printto параметром может быть имя принтера<br />
}}<br/><br />
{{Аргумент<br />
|Название=Путь к файлу<br />
|Пояснение=Путь к файлу, указанному в параметре Файл. Если Файл уже содержит путь, то Путь=пустая строка<br />
}}<br/><br />
{{Аргумент<br />
|Название=Вид окна<br />
|Пояснение=Вид окна приложения (необязательный параметр):<br />
*0 (`SW_HIDE`) - скрывает окно загружаемого приложения и активизирует другое окно;<br />
*1 (`SW_SHOWNORMAL`) - отображает главное окно приложения и делает его активным. Если окно приложения минимизировано или максимизировано, Windows восстанавливает его первоначальный размер и позицию;<br />
*2 (`SW_SHOWMINIMIZED`) - окно загружаемого приложения минимизировано;<br />
*3 (`SW_MAXIMIZE`) - раскрывает окно приложения на весь экран и делает его активным;<br />
*4 (`SW_SHOWNOACTIVATE`) - отображает окно приложения в его последних сохранённых размерах, но не делает его активным.<br />
}}<br/><br />
{{Аргумент<br />
|Название=Командная строка<br />
|Пояснение=строка, полный или относительный путь к исполняемому файлу, а также аргументы командной строки (ключи).<br />
:Для вызова команд ОС нужно использовать синтаксис '''«cmd /c <команда>»'''.<br />
}}<br/><br />
{{Аргумент<br />
|Название=Режим<br />
|Пояснение=строка, режим запуска Windows-приложения для функции ShellExecute:<br />
*`open` – открытие документа<br />
*`print` – печать документа.<br />
}}<br/><br />
{{Аргумент<br />
|Название=Режим ожидания<br />
|Пояснение=целое число:<br />
*0 – с ожиданием. Никакие формы ГБ недоступны до окончания работы внешней программы;<br />
*1 – условное ожидание. Форма, с которой произведен вызов, становится недоступной, но можно работать в других. По окончании работы внешней программы недоступная форма становится вновь доступной;<br />
*2 – без ожидания.<br />
При значениях режима ожидания 0 и 1 результат вызова - это exitcode процесса.<br />
}}<br/><br />
{{Аргумент<br />
|Название=Флаги<br />
|Пояснение=целое число (битовая маска):<br />
*Bin(0 or 1) – скрыть окно консоли;<br />
*Bin(0 or 2) – вернуть стандартный вывод (stdout). Не всегда работает надёжно, поэтому можно перенаправить вывод в файл, а затем читать из него.<br />
<br />
Стандартный вывод консольных приложений, запущенных через ExecConsoleApp в режиме с ожиданием (0 и 1) и флагом Bin(0 or 2), перехватывается и записывается в переменную ''':AppStdOut'''<br />
}}<br />
|Результат=Целое число<br />
|Пример=Запустит "Блокнот":<br />
ExecConsoleApp(`start`, `notepad`)<br />
Удалит из папки c:\temp все файлы:<br />
ExecConsoleApp(`cmd /c del c:\temp\*.txt`, 2)<br />
Запустит проводник Windows и отобразит в нём папку "e:\1\":<br />
ExecConsoleApp(`shellexecute`, `explore`, `e:\1\`, ``, ``, `SW_SHOWNORMAL`)<br />
Запустит winrar.exe, который создаст архив C:\myarchive.rar и заархивирует файл "C:\Program Files\WinRAR\WinRAR.chm":<br />
ExecConsoleApp(`shellexecute`,<br />
`open`,<br />
`"C:\Program Files\WinRAR\WinRAR.exe"`,<br />
`a C:\myarchive.rar "C:\Program Files\WinRAR\WinRAR.chm"`,<br />
``<br />
)<br />
Печать на выбранный принтер, работает не со всеми типами документов, вопросы - к Microsoft (если имя принтера содержит пробелы - передавать его в кавычках):<br />
ExecConsoleApp(<br />
`shellexecute`,<br />
`printto`,<br />
`E:\Temp\1.doc`,<br />
`"\\AGENT007\hpLJ1010HB"`,<br />
0,<br />
`SW_HIDE`<br />
)<br />
Печать на принтер "по умолчанию":<br />
ExecConsoleApp(<br />
`shellexecute`,<br />
`print`,<br />
`d:\aaa.pdf`,<br />
``,<br />
0,<br />
`SW_HIDE`<br />
)<br />
}}</div>Alexeyhttp://wiki.gbsoft.ru/index.php?title=EXECCONSOLEAPP&diff=3294EXECCONSOLEAPP2024-08-19T03:29:45Z<p>Alexey: </p>
<hr />
<div>{{Функция ГБ<br />
|Название=EXECCONSOLEAPP<br />
|Описание=Выполняет внешнее приложение. Возвращает код завершения приложения, помещает его текстовый вывод в переменную :AppStdOut<br />
|Синтаксис=Вариант 1 - выполнение операции над указанным файлом, используя приложение по умолчанию<br/><br />
EXECCONSOLEAPP(`shellexecute`, '''Операция''', '''Файл''', '''Параметры''', '''Путь к файлу''', Вид окна)<br/><br />
либо (упрощенный вариант)<br/><br />
EXECCONSOLEAPP(`start`, '''Файл''', Режим)<br/><br />
Вариант 2 – запуск консольного приложения<br/><br />
EXECCONSOLEAPP('''Командная строка''', Режим ожидания, Флаги)<br />
|Аргументы=<br />
{{Аргумент<br />
|Название=Операция<br />
|Пояснение=Одна из операций Windows, варианты:<br />
*`find` – стандартный поиск Windows (файлов, папок, компьютеров и т.д.). Файл - путь к папке, начиная с которой выполняется поиск, остальные параметры не используются.<br />
*`explore` – стандартный проводник Windows. Файл - путь к папке, на которой открывается проводник, остальные параметры не используются.<br />
*`edit` – редактирование файла в приложении по умолчанию<br />
*`open` – открытие файла в приложении по умолчанию<br />
*`print`,`printto` – печать файла из приложения по умолчанию<br />
}}<br/><br />
{{Аргумент<br />
|Название=Файл<br />
|Пояснение=Имя файла, с которым следует выполнить операцию.<br />
}}<br/><br />
{{Аргумент<br />
|Название=Параметры<br />
|Пояснение=Список параметров, передаваемых загружаемому приложению. Например, для операции printto параметром может быть имя принтера<br />
}}<br/><br />
{{Аргумент<br />
|Название=Путь к файлу<br />
|Пояснение=Путь к файлу, указанному в параметре Файл. Если Файл уже содержит путь, то Путь=пустая строка<br />
}}<br/><br />
{{Аргумент<br />
|Название=Вид окна<br />
|Пояснение=Вид окна приложения (необязательный параметр):<br />
*0 (`SW_HIDE`) - скрывает окно загружаемого приложения и активизирует другое окно;<br />
*1 (`SW_SHOWNORMAL`) - отображает главное окно приложения и делает его активным. Если окно приложения минимизировано или максимизировано, Windows восстанавливает его первоначальный размер и позицию;<br />
*2 (`SW_SHOWMINIMIZED`) - окно загружаемого приложения минимизировано;<br />
*3 (`SW_MAXIMIZE`) - раскрывает окно приложения на весь экран и делает его активным;<br />
*4 (`SW_SHOWNOACTIVATE`) - отображает окно приложения в его последних сохранённых размерах, но не делает его активным.<br />
}}<br/><br />
{{Аргумент<br />
|Название=Командная строка<br />
|Пояснение=строка, полный или относительный путь к исполняемому файлу, а также аргументы командной строки (ключи).<br />
:Для вызова команд ОС нужно использовать синтаксис '''«cmd /c <команда>»'''.<br />
}}<br/><br />
{{Аргумент<br />
|Название=Режим<br />
|Пояснение=строка, режим запуска Windows-приложения для функции ShellExecute:<br />
*`open` – открытие документа<br />
*`print` – печать документа.<br />
}}<br/><br />
{{Аргумент<br />
|Название=Режим ожидания<br />
|Пояснение=целое число:<br />
*0 – с ожиданием. Никакие формы ГБ недоступны до окончания работы внешней программы;<br />
*1 – условное ожидание. Форма, с которой произведен вызов, становится недоступной, но можно работать в других. По окончании работы внешней программы недоступная форма становится вновь доступной;<br />
*2 – без ожидания.<br />
При значениях режима ожидания 0 и 1 результат вызова - это exitcode процесса.<br />
}}<br/><br />
{{Аргумент<br />
|Название=Флаги<br />
|Пояснение=целое число (битовая маска):<br />
*Bin(0 or 1) – скрыть окно консоли;<br />
*Bin(0 or 2) – вернуть стандартный вывод (stdout). Не всегда работает надёжно, поэтому можно перенаправить вывод в файл, а затем читать из него.<br />
<br />
Стандартный вывод консольных приложений, запущенных через ExecConsoleApp в режиме с ожиданием (0 и 1) и флагом Bin(0 or 2), перехватывается и записывается в переменную ''':AppStdOut'''<br />
}}<br />
|Результат=Целое число<br />
|Пример=Запустит "Блокнот":<br />
ExecConsoleApp(`start`, `notepad`)<br />
Удалит из папки c:\temp все файлы:<br />
ExecConsoleApp(`cmd /c del c:\temp\*.txt`, 2)<br />
Запустит проводник Windows и отобразит в нём папку "e:\1\":<br />
ExecConsoleApp(`shellexecute`, `explore`, `e:\1\`, ``, ``, `SW_SHOWNORMAL`)<br />
Запустит winrar.exe, который создаст архив C:\myarchive.rar и заархивирует файл "C:\Program Files\WinRAR\WinRAR.chm":<br />
ExecConsoleApp(`shellexecute`,<br />
`open`,<br />
`"C:\Program Files\WinRAR\WinRAR.exe"`,<br />
`a C:\myarchive.rar "C:\Program Files\WinRAR\WinRAR.chm"`,<br />
``<br />
)<br />
Печать на выбранный принтер, работает не со всеми типами документов, вопросы - к Microsoft (если имя принтера содержит пробелы - передавать его в кавычках):<br />
ExecConsoleApp(<br />
`shellexecute`,<br />
`printto`,<br />
`E:\Temp\1.doc`,<br />
`"\\AGENT007\hpLJ1010HB"`,<br />
0,<br />
`SW_HIDE`<br />
)<br />
}}</div>Alexeyhttp://wiki.gbsoft.ru/index.php?title=EVAL&diff=3293EVAL2024-07-15T04:29:55Z<p>Alexey: </p>
<hr />
<div>{{Функция ГБ<br />
|Название=EVAL<br />
|Описание=Функция позволяет вычислить значение выражения, которое находится в строке. Отличается от EVALUATE_EXPRESSION только тем, что вычисление производится на чистом датасете.<br />
|Синтаксис=EVAL ('''Выражение''', '''json''')<br />
|Аргументы=<br />
{{Аргумент<br />
|Название=Выражение<br />
|Пояснение=Строка, в которой содержится вычисляемое выражение.<br />
}}<br />
{{Аргумент<br />
|Название=json<br />
|Пояснение=Строка, можно задать значение "json" для парсинга JSON (начиная с версии 1.9.0.31)<br />
}}<br />
|Результат=Значение произвольного типа.<br />
|Пример=<br />
Получить значение переменной, имя которой находится в другой переменной:<br />
Eval( `:`+:varname )<br />
<br />
Добываем данные из JSON:<br />
:data:=Eval( :data,`json` ),<br />
Info(<br />
:data[`providerName`]<br />
),<br />
IterateList(<br />
:data[`items`],<br />
:row,<br />
Info(<br />
:row[`code`]<br />
)<br />
)<br />
<br />
Преобразовать дату из формата ISO:<br />
:date:=`2024-04-12T15:31:13+07:00`,<br />
:Res:=Eval( `['`+:date+`']`,`json` ),<br />
Info( :Res[0] )<br />
результат (тип &ndash; Date): 12.04.2024 15:31:13<br />
}}</div>Alexeyhttp://wiki.gbsoft.ru/index.php?title=EVAL&diff=3292EVAL2024-07-15T04:26:23Z<p>Alexey: </p>
<hr />
<div>{{Функция ГБ<br />
|Название=EVAL<br />
|Описание=Функция позволяет вычислить значение выражения, которое находится в строке. Отличается от EVALUATE_EXPRESSION только тем, что вычисление производится на чистом датасете.<br />
|Синтаксис=EVAL ('''Выражение''', '''json''')<br />
|Аргументы=<br />
{{Аргумент<br />
|Название=Выражение<br />
|Пояснение=Строка, в которой содержится вычисляемое выражение.<br />
}}<br />
{{Аргумент<br />
|Название=json<br />
|Пояснение=Строка, можно задать значение "json" для парсинга JSON (начиная с версии 1.9.0.31)<br />
}}<br />
|Результат=Значение произвольного типа.<br />
|Пример=<br />
Получить значение переменной, имя которой находится в другой переменной:<br />
Eval( `:`+:varname )<br />
<br />
Добываем данные из JSON:<br />
:data:=Eval( :data,`json` ),<br />
Info(<br />
:data[`providerName`]<br />
),<br />
IterateList(<br />
:data[`items`],<br />
:row,<br />
Info(<br />
:row[`code`]<br />
)<br />
)<br />
<br />
Преобразовать дату из формата ISO:<br />
:date:=`2024-04-12T10:11:12+07:00`,<br />
Eval( `['`+:date+`']`,`json` )<br />
результат (тип &ndash; Date): 12.04.2024 10:11:12<br />
}}</div>Alexeyhttp://wiki.gbsoft.ru/index.php?title=EVAL&diff=3291EVAL2024-07-15T04:24:51Z<p>Alexey: </p>
<hr />
<div>{{Функция ГБ<br />
|Название=EVAL<br />
|Описание=Функция позволяет вычислить значение выражения, которое находится в строке. Отличается от EVALUATE_EXPRESSION только тем, что вычисление производится на чистом датасете.<br />
|Синтаксис=EVAL ('''Выражение''', '''json''')<br />
|Аргументы=<br />
{{Аргумент<br />
|Название=Выражение<br />
|Пояснение=Строка, в которой содержится вычисляемое выражение.<br />
}}<br />
{{Аргумент<br />
|Название=json<br />
|Пояснение=Строка, можно задать значение "json" для парсинга JSON (начиная с версии 1.9.0.31)<br />
}}<br />
|Результат=Значение произвольного типа.<br />
|Пример=<br />
Получить значение переменной, имя которой находится в другой переменной:<br />
Eval(":"+:varname)<br />
<br />
Добываем данные из JSON:<br />
:data:=Eval(:data,`json` ),<br />
Info(<br />
:data['providerName']<br />
),<br />
IterateList(<br />
:data[`items`],<br />
:row,<br />
Info(<br />
:row[`code`]<br />
)<br />
)<br />
<br />
Преобразовать дату из формата ISO:<br />
:date:=`2024-04-12T15:31:13+07:00`,<br />
Eval( `['`+:date+`']`,`json` )<br />
результат (тип &ndash; Date): 12.04.2024 15:31:13<br />
}}</div>Alexeyhttp://wiki.gbsoft.ru/index.php?title=ASSIGN&diff=3288ASSIGN2024-01-22T07:22:44Z<p>Alexey: </p>
<hr />
<div>{{Функция ГБ<br />
|Название=ASSIGN<br />
|Описание=Изменяет одно поле текущей записи [[Датасет|датасета]]. <br />
|Синтаксис=ASSIGN ('''Датасет и поле''', '''Значение''')<br />
|Аргументы=<br />
{{Аргумент<br />
|Название=Датасет и поле<br />
|Пояснение=строка, которая состоит из имени одного из датасетов электронной или печатной формы и имени поля этого датасета, разделенных точкой.<br>Можно указать через ";" сразу несколько полей данного датасета: ''датасет.поле1;поле2;поле3;...''<br />
Особыe режимы:<br />
*Если перед именем датасета указан символ "*", то поле изменяется во всех записях датасета. В этом случае второй аргумент - всегда выражение, потому записывается в кавычках.<br />
*Если вместо имени поля указан символ "*", то изменятся все данные датасета. В этом случае значением должны быть данные другого датасета, либо 1/0 (тогда датасет будет закрыт).<br />
*Имя поля может иметь вид Heap.XXX, в этом случае модифицируется одна строка поля Heap<br />
*Префикс EMBEDDED:Имя_контейнера: означает, что датасет нужно искать в форме, [[Внедрение форм|внедренной]] в указанный контейнер<br />
*Префикс EMBEDDING: означает, что датасет нужно искать в форме, в которую [[Внедрение форм|внедрена]] текущая форма<br />
*Префикс LAUNCHFORM: означает, что датасет нужно искать в форме, с которой запущена текущая форма<br />
}}<br/>{{Аргумент<br />
|Название=Значение<br />
|Пояснение=значение произвольного типа данных для записи в поле. Если изменяется сразу несколько полей датасета, то их значения перечисляются через ",".<br>В режиме изменения всех записей датасета &ndash; строка с формулой.<br />
}}<br />
|Пример=Assign( `Goodies.Price`, 1 ) &ndash; изменит текущую запись<br />
<br/>Assign( `Dataset.Document;Articul;Certificate;BarCode`, :Id, :Art, :Cert, :BC ) &ndash; изменит сразу несколько полей<br />
<br/>Assign( `*Goodies.Price`, `Price*2` ) &ndash; изменит все записи (удвоит цену)<br />
<br/>Assign( `*dsGds.Qty;New`, `1,0` ) &ndash; инициализация двух полей во всех записях датасета (в данном случае значения полей - это выражение, поэтому записываются в кавычках)<br />
<br/>Assign( `*dsLines.Name;Note`, `'Имя','Комментарий'` ) &ndash; то же самое с текстовыми значениями<br />
<br/>Assign( `*ds.f1;f2;f3`, `IIF( f1=11,f1*5,f1),0,IIF( f1=55,'b',f3 )` ) &ndash; то же самое с выражениями для каждого поля (вычисление значений полей производится в порядке их следования)<br />
<br/>Assign( `DataSet.Heap.xxx`, 1 ) &ndash; изменит хиповое поле<br />
<br/>Assign( `launchform:HeapSet.@FullName`, HeapSet.FullName ) &ndash; изменит поле родительской формы<br />
}}</div>Alexeyhttp://wiki.gbsoft.ru/index.php?title=ASSIGN&diff=3287ASSIGN2024-01-22T07:13:11Z<p>Alexey: </p>
<hr />
<div>{{Функция ГБ<br />
|Название=ASSIGN<br />
|Описание=Изменяет одно поле текущей записи [[Датасет|датасета]]. <br />
|Синтаксис=ASSIGN ('''Датасет и поле''', '''Значение''')<br />
|Аргументы=<br />
{{Аргумент<br />
|Название=Датасет и поле<br />
|Пояснение=строка, которая состоит из имени одного из датасетов электронной или печатной формы и имени поля этого датасета, разделенных точкой.<br>Можно указать через ";" сразу несколько полей данного датасета: ''датасет.поле1;поле2;поле3;...''<br />
Особыe режимы:<br />
*Если перед именем датасета указан символ "*", то поле изменяется во всех записях датасета. В этом случае второй аргумент - всегда выражение, потому записывается в кавычках.<br />
*Если вместо имени поля указан символ "*", то изменятся все данные датасета. В этом случае значением должны быть данные другого датасета, либо 1/0 (тогда датасет будет закрыт).<br />
*Имя поля может иметь вид Heap.XXX, в этом случае модифицируется одна строка поля Heap<br />
*Префикс EMBEDDED:Имя_контейнера: означает, что датасет нужно искать в форме, [[Внедрение форм|внедренной]] в указанный контейнер<br />
*Префикс EMBEDDING: означает, что датасет нужно искать в форме, в которую [[Внедрение форм|внедрена]] текущая форма<br />
*Префикс LAUNCHFORM: означает, что датасет нужно искать в форме, с которой запущена текущая форма<br />
}}<br/>{{Аргумент<br />
|Название=Значение<br />
|Пояснение=значение произвольного типа данных для записи в поле. Если изменяется сразу несколько полей датасета, то их значения перечисляются через ",".<br>В режиме изменения всех записей датасета &ndash; строка с формулой.<br />
}}<br />
|Пример=Assign( `Goodies.Price`, 1 ) &ndash; изменит текущую запись<br />
<br/>Assign( `Dataset.Document;Articul;Certificate;BarCode`, :Id, :Art, :Cert, :BC ) &ndash; изменит сразу несколько полей<br />
<br/>Assign( `*Goodies.Price`, `Price*2` ) &ndash; изменит все записи (удвоит цену)<br />
<br/>Assign( `*dsGds.Qty;New`, `1,0` ) &ndash; инициализация двух полей во всех записях датасета (в данном случае значения полей - это выражение, поэтому записываются в кавычках)<br />
<br/>Assign( `*dsLines.Name;Note`, `'Имя','Комментарий'` ) &ndash; то же самое с текстовыми значениями<br />
<br/>Assign( `*ds.f1;f2;f3`, `IIF( f1=11,f1*5,f1),0,IIF( f1=1,'b',f3 )` ) &ndash; то же самое с выражениями для каждого поля<br />
<br/>Assign( `DataSet.Heap.xxx`, 1 ) &ndash; изменит хиповое поле<br />
<br/>Assign( `launchform:HeapSet.@FullName`, HeapSet.FullName ) &ndash; изменит поле родительской формы<br />
}}</div>Alexeyhttp://wiki.gbsoft.ru/index.php?title=OPENDATASET&diff=3286OPENDATASET2023-11-15T03:44:51Z<p>Alexey: </p>
<hr />
<div>{{Функция ГБ<br />
|Название=OPENDATASET<br />
|Описание=Открывает датасет при помощи вызова процедуры, либо путем импорта данных из файла (текстового, DBF, Excel, CDS)<br />
|Синтаксис=OPENDATASET('''Имя процедуры''', '''Датасет параметров''', '''Датасет результатов''')<br />
|Аргументы={{Аргумент<br />
|Название=Имя процедуры<br />
|Пояснение=Строка, содержащая одно из значений:<br />
* имя процедуры в БД. Имя процедуры может иметь вид ''`GBDB://База/Процедура`'' для осуществления [[Распределенные вызовы|распределенных вызовов]] либо ''`GBTCP://Адрес:Порт/Процедура`'' для вызова метода [[Бизнес-сервер|бизнес-сервера]];<br />
* константа '''`file:`''' для импорта данных из файла;<br />
* константа '''`copy:`''' для создания копии датасета;<br />
* константа '''`array:`''' для создания датасета на основе данных из ассоциативного массива.<br />
}}<br />
{{Аргумент<br />
|Название=Датасет параметров<br />
|Пояснение=Строка с именем или непосредственно описанием датасета, содержащего входные параметры процедуры либо '''параметры импорта файла'''.<br />
}}<br />
{{Аргумент<br />
|Название=Датасет результатов<br />
|Пояснение=Строка, определяющая имя создаваемого датасета. Если задана пустая строка ``, то датасет не будет создан (используется, если нам не интересно, что вернула процедура).<br />
}}<br />
|Результат=Нет<br />
<br />
<h2>Параметры импорта файла</h2><br />
<h6>Общие параметры</h6><br />
* '''UseOpenOffice''' &ndash; если передано значение "1", для импорта будет принудительно использован OpenOffice (LibreOffice), в противном случае OO (LO) используется только в случае, если не установлен Microsoft Office (версии ГБ после 14.11.2023);<br />
* '''FileType''' &ndash; строка, тип файла (TXT, CSV, DBF, XLS, CDS);<br />
* '''FileName''' &ndash; строка, имя файла;<br />
<br />
<h6>Управление кодировкой</h6><br />
* '''CharSet''' &ndash; строка, тип кодировки файла. Возможны следующие значения:<br />
**`CP866` &ndash; включает кодировку DOS;<br />
**`UTF-8` &ndash; включает кодировку UTF-8;<br />
**`WIN1251` &ndash; включает кодировку WIN1251;<br />
* <span style="color:gray;">'''CP866''' &ndash; строка, любое непустое значение означает, что текстовый файл в кодировке DOS (было в старых версиях ГБ, оставлено для совместимости);</span><br />
* <span style="color:gray;">'''WIN1251''' &ndash; строка, любое непустое значение означает, что DBF файл в кодировке Windows (было в старых версиях ГБ, оставлено для совместимости);</span><br />
<br />
<h6>Настройка полей</h6><br />
* '''FieldCount''' &ndash; число, количество полей в строке файла (по умолчанию количество полей определяется по первой импортируемой строке);<br />
* '''FieldsMap''' &ndash; строка, содержит описание полей создаваемого датасета.<br>Представляет собой список формул вида имя,тип=выражение через «;», определяющих поля создаваемого датасета и их вычисление через поля исходного файла. Возможные значения для типа поля: I, F, D, S, B.<br>При задании константы '''`auto`''' для файла типа DBF, структура '''Датасета результатов''' повторит структуру импортируемого файла DBF.<br />
:Если FieldsMap не задан, структура датасета формируется автоматически, а поля именуются как: fld0, fld1, ..., fldN (где N &ndash; количество полей, определённое по первой строке файла, либо заданное в параметре FieldCount). Тип таких полей &ndash; S, размер поля &ndash; 250 (см. также FieldSize).<br />
* '''Separator''' &ndash; строка, разделитель полей в текстовом файле;<br />
* '''Tabs''' &ndash; строка, список (через символ ";") отступов полей в текстовом файле, отсчет начинается с 0;<br />
* '''FieldSize''' &ndash; размер строковых полей. Если FieldSize не задан, а количество полей более 200, то размер строковых полей будет принудительно установлен равным 40 символам.<br />
<br />
<h6>Управление строками</h6><br />
* '''StartLine''' &ndash; число, номер строки с которой начинается импорт (отсчет начинается с 0);<br />
* '''EndLine''' &ndash; число, номер строки, на которой заканчивается импорт (отсчет начинается с 0). Отрицательное значение означает, что не нужно импортировать соответствующее число последних строк;<br />
* '''StopIfEmpty''' &ndash; строка, любое непустое значение означает, что нужно остановить импорт, встретив пустую строку (для файлов Excel проверяется первая ячейка в строке);<br />
* '''Filter''' &ndash; выражение для фильтрации строк исходного файла;<br />
:''Из-за бага в dbclient (и не только) в старых версиях ГБ (до 04.10.2017) при задании фильтра результирующий датасет содержал в логе изменений "мусор", т.е. записи, отсеянные фильтром. Эти записи воспринимались udf'кой как не удалённые, из-за чего при передаче датасета в процедуру, она получала неотфильтрованный набор записей.''<br />
:''Обойти это можно путём задания параметра '''LogChanges=1''', что позволит обойти баг dbclient, но резко увеличит объём расходуемой памяти и снизит скорость загрузки. Вариант, когда при загрузке не используется Filter, а ненужные записи удаляются позже (с помощью функции Delete), также потребует задание параметра '''LogChanges=1'''.''<br />
* '''Comment''' &ndash; строка, символ комментария в текстовом файле. При встрече данного символа в начале строки, эта строка игнорируется и не попадает в '''Датасет результатов''';<br />
* '''ProcessCR''' &ndash; строка, любое непустое значение включает режим импорта XLS-файлов, при котором ячейка, содержащая символы перевода строки (ячейка содержит несколько строк, введённых через Alt+Enter), импортируется как одно поле. При этом такие строки объединяются в одну через пробел.<br>При импорте по-умолчанию (значение ProcessCR не задано), такие ячейки импортируются, как несколько записей;<br />
* '''ProcessCRFrom''' &ndash; число, номер строки XLS-файла, начиная с которой применяется алгоритм импорта, включенный параметром ProcessCR (отсчет начинается с 0);<br />
* '''QuoteChar''' &ndash; строка, если задан символ кавычек (обычно - `"`), то алгоритм импорта, включенный параметром ProcessCR, объединяет строки в одну не через пробел, а через перевод строки (#13#10);<br />
<br />
<h6>Прочие параметры</h6><br />
* '''Sheet''' &ndash; строка, название листа для импорта из Excel.<br />
<br />
|Пример=Вызов отчёта "Реестр документов" (в датасете dsDoc - входные параметры процедуры):<br />
OpenDataSet(<br />
`Documents_PeriodRegistry`,<br />
`dsDoc`,<br />
`dsRes`<br />
)<br />
<br />
Некоторые процедуры могут возвращать сообщения о результатах своей работы, например ''"Обработано 1234 строк. Найдено и отмечено 110 товаров"''. Такое сообщение в процедурах принято передавать в выходном датасете в поле Message:<br />
<br />
OpenDataSet(<br />
`MZ_ArticulsImport`,<br />
`dsTXT`,<br />
`dsRes`<br />
),<br />
IfEmpty(<br />
dsRes.Message,<br />
0,<br />
Info( dsRes.Message )<br />
)<br />
<br />
Создание датасета из массива:<br />
OpenDataSet(<br />
`array:`,<br />
[<br />
[<br />
`a` : 1,<br />
`b` : 2<br />
]<br />
],<br />
`ds`<br />
)<br />
}}</div>Alexeyhttp://wiki.gbsoft.ru/index.php?title=OPENDATASET&diff=3285OPENDATASET2023-11-15T03:43:55Z<p>Alexey: </p>
<hr />
<div>{{Функция ГБ<br />
|Название=OPENDATASET<br />
|Описание=Открывает датасет при помощи вызова процедуры, либо путем импорта данных из файла (текстового, DBF, Excel, CDS)<br />
|Синтаксис=OPENDATASET('''Имя процедуры''', '''Датасет параметров''', '''Датасет результатов''')<br />
|Аргументы={{Аргумент<br />
|Название=Имя процедуры<br />
|Пояснение=Строка, содержащая одно из значений:<br />
* имя процедуры в БД. Имя процедуры может иметь вид ''`GBDB://База/Процедура`'' для осуществления [[Распределенные вызовы|распределенных вызовов]] либо ''`GBTCP://Адрес:Порт/Процедура`'' для вызова метода [[Бизнес-сервер|бизнес-сервера]];<br />
* константа '''`file:`''' для импорта данных из файла;<br />
* константа '''`copy:`''' для создания копии датасета;<br />
* константа '''`array:`''' для создания датасета на основе данных из ассоциативного массива.<br />
}}<br />
{{Аргумент<br />
|Название=Датасет параметров<br />
|Пояснение=Строка с именем или непосредственно описанием датасета, содержащего входные параметры процедуры либо '''параметры импорта файла'''.<br />
}}<br />
{{Аргумент<br />
|Название=Датасет результатов<br />
|Пояснение=Строка, определяющая имя создаваемого датасета. Если задана пустая строка ``, то датасет не будет создан (используется, если нам не интересно, что вернула процедура).<br />
}}<br />
|Результат=Нет<br />
<br />
<h2>Параметры импорта файла</h2><br />
<h6>Общие параметры</h6><br />
* '''UseOpenOffice''' &ndash; если передано значение "1", для импорта будет принудительно использован OpenOffice (LibreOffice), в противном случае OO (LO) используется только в случае, если не установлен Microsoft Office<br />
* '''FileType''' &ndash; строка, тип файла (TXT, CSV, DBF, XLS, CDS);<br />
* '''FileName''' &ndash; строка, имя файла;<br />
<br />
<h6>Управление кодировкой</h6><br />
* '''CharSet''' &ndash; строка, тип кодировки файла. Возможны следующие значения:<br />
**`CP866` &ndash; включает кодировку DOS;<br />
**`UTF-8` &ndash; включает кодировку UTF-8;<br />
**`WIN1251` &ndash; включает кодировку WIN1251;<br />
* <span style="color:gray;">'''CP866''' &ndash; строка, любое непустое значение означает, что текстовый файл в кодировке DOS (было в старых версиях ГБ, оставлено для совместимости);</span><br />
* <span style="color:gray;">'''WIN1251''' &ndash; строка, любое непустое значение означает, что DBF файл в кодировке Windows (было в старых версиях ГБ, оставлено для совместимости);</span><br />
<br />
<h6>Настройка полей</h6><br />
* '''FieldCount''' &ndash; число, количество полей в строке файла (по умолчанию количество полей определяется по первой импортируемой строке);<br />
* '''FieldsMap''' &ndash; строка, содержит описание полей создаваемого датасета.<br>Представляет собой список формул вида имя,тип=выражение через «;», определяющих поля создаваемого датасета и их вычисление через поля исходного файла. Возможные значения для типа поля: I, F, D, S, B.<br>При задании константы '''`auto`''' для файла типа DBF, структура '''Датасета результатов''' повторит структуру импортируемого файла DBF.<br />
:Если FieldsMap не задан, структура датасета формируется автоматически, а поля именуются как: fld0, fld1, ..., fldN (где N &ndash; количество полей, определённое по первой строке файла, либо заданное в параметре FieldCount). Тип таких полей &ndash; S, размер поля &ndash; 250 (см. также FieldSize).<br />
* '''Separator''' &ndash; строка, разделитель полей в текстовом файле;<br />
* '''Tabs''' &ndash; строка, список (через символ ";") отступов полей в текстовом файле, отсчет начинается с 0;<br />
* '''FieldSize''' &ndash; размер строковых полей. Если FieldSize не задан, а количество полей более 200, то размер строковых полей будет принудительно установлен равным 40 символам.<br />
<br />
<h6>Управление строками</h6><br />
* '''StartLine''' &ndash; число, номер строки с которой начинается импорт (отсчет начинается с 0);<br />
* '''EndLine''' &ndash; число, номер строки, на которой заканчивается импорт (отсчет начинается с 0). Отрицательное значение означает, что не нужно импортировать соответствующее число последних строк;<br />
* '''StopIfEmpty''' &ndash; строка, любое непустое значение означает, что нужно остановить импорт, встретив пустую строку (для файлов Excel проверяется первая ячейка в строке);<br />
* '''Filter''' &ndash; выражение для фильтрации строк исходного файла;<br />
:''Из-за бага в dbclient (и не только) в старых версиях ГБ (до 04.10.2017) при задании фильтра результирующий датасет содержал в логе изменений "мусор", т.е. записи, отсеянные фильтром. Эти записи воспринимались udf'кой как не удалённые, из-за чего при передаче датасета в процедуру, она получала неотфильтрованный набор записей.''<br />
:''Обойти это можно путём задания параметра '''LogChanges=1''', что позволит обойти баг dbclient, но резко увеличит объём расходуемой памяти и снизит скорость загрузки. Вариант, когда при загрузке не используется Filter, а ненужные записи удаляются позже (с помощью функции Delete), также потребует задание параметра '''LogChanges=1'''.''<br />
* '''Comment''' &ndash; строка, символ комментария в текстовом файле. При встрече данного символа в начале строки, эта строка игнорируется и не попадает в '''Датасет результатов''';<br />
* '''ProcessCR''' &ndash; строка, любое непустое значение включает режим импорта XLS-файлов, при котором ячейка, содержащая символы перевода строки (ячейка содержит несколько строк, введённых через Alt+Enter), импортируется как одно поле. При этом такие строки объединяются в одну через пробел.<br>При импорте по-умолчанию (значение ProcessCR не задано), такие ячейки импортируются, как несколько записей;<br />
* '''ProcessCRFrom''' &ndash; число, номер строки XLS-файла, начиная с которой применяется алгоритм импорта, включенный параметром ProcessCR (отсчет начинается с 0);<br />
* '''QuoteChar''' &ndash; строка, если задан символ кавычек (обычно - `"`), то алгоритм импорта, включенный параметром ProcessCR, объединяет строки в одну не через пробел, а через перевод строки (#13#10);<br />
<br />
<h6>Прочие параметры</h6><br />
* '''Sheet''' &ndash; строка, название листа для импорта из Excel.<br />
<br />
|Пример=Вызов отчёта "Реестр документов" (в датасете dsDoc - входные параметры процедуры):<br />
OpenDataSet(<br />
`Documents_PeriodRegistry`,<br />
`dsDoc`,<br />
`dsRes`<br />
)<br />
<br />
Некоторые процедуры могут возвращать сообщения о результатах своей работы, например ''"Обработано 1234 строк. Найдено и отмечено 110 товаров"''. Такое сообщение в процедурах принято передавать в выходном датасете в поле Message:<br />
<br />
OpenDataSet(<br />
`MZ_ArticulsImport`,<br />
`dsTXT`,<br />
`dsRes`<br />
),<br />
IfEmpty(<br />
dsRes.Message,<br />
0,<br />
Info( dsRes.Message )<br />
)<br />
<br />
Создание датасета из массива:<br />
OpenDataSet(<br />
`array:`,<br />
[<br />
[<br />
`a` : 1,<br />
`b` : 2<br />
]<br />
],<br />
`ds`<br />
)<br />
}}</div>Alexeyhttp://wiki.gbsoft.ru/index.php?title=ASSIGN&diff=3284ASSIGN2023-11-02T03:32:00Z<p>Alexey: </p>
<hr />
<div>{{Функция ГБ<br />
|Название=ASSIGN<br />
|Описание=Изменяет одно поле текущей записи [[Датасет|датасета]]. <br />
|Синтаксис=ASSIGN ('''Датасет и поле''', '''Значение''')<br />
|Аргументы=<br />
{{Аргумент<br />
|Название=Датасет и поле<br />
|Пояснение=строка, которая состоит из имени одного из датасетов электронной или печатной формы и имени поля этого датасета, разделенных точкой.<br>Можно указать через ";" сразу несколько полей данного датасета: ''датасет.поле1;поле2;поле3;...''<br />
Особыe режимы:<br />
*Если перед именем датасета указан символ "*", то поле изменяется во всех записях датасета. В этом случае второй аргумент - всегда выражение, потому записывается в кавычках.<br />
*Если вместо имени поля указан символ "*", то изменятся все данные датасета. В этом случае значением должны быть данные другого датасета, либо 1/0 (тогда датасет будет закрыт).<br />
*Имя поля может иметь вид Heap.XXX, в этом случае модифицируется одна строка поля Heap<br />
*Префикс EMBEDDED:Имя_контейнера: означает, что датасет нужно искать в форме, [[Внедрение форм|внедренной]] в указанный контейнер<br />
*Префикс EMBEDDING: означает, что датасет нужно искать в форме, в которую [[Внедрение форм|внедрена]] текущая форма<br />
*Префикс LAUNCHFORM: означает, что датасет нужно искать в форме, с которой запущена текущая форма<br />
}}<br/>{{Аргумент<br />
|Название=Значение<br />
|Пояснение=значение произвольного типа данных для записи в поле. Если изменяется сразу несколько полей датасета, то их значения перечисляются через ",".<br>В режиме изменения всех записей датасета &ndash; строка с формулой.<br />
}}<br />
|Пример=Assign( `Goodies.Price`, 1 ) &ndash; изменит текущую запись<br />
<br/>Assign( `Dataset.Document;Articul;Certificate;BarCode`, :Id, :Art, :Cert, :BC ) &ndash; изменит сразу несколько полей<br />
<br/>Assign( `*Goodies.Price`, `Price*2` ) &ndash; изменит все записи (удвоит цену)<br />
<br/>Assign( `*dsGds.Qty;New`, `1,0` ) &ndash; инициализация двух полей во всех записях датасета (в данном случае значения полей - это выражение, поэтому записываются в кавычках)<br />
<br/>Assign( `*dsLines.Name;Note`, `'Имя','Комментарий'` ) &ndash; то же самое с текстовыми значениями<br />
<br/>Assign( `DataSet.Heap.xxx`, 1 ) &ndash; изменит хиповое поле<br />
<br/>Assign( `launchform:HeapSet.@FullName`, HeapSet.FullName ) &ndash; изменит поле родительской формы<br />
}}</div>Alexeyhttp://wiki.gbsoft.ru/index.php?title=OPENDATASET&diff=3283OPENDATASET2023-10-19T03:00:42Z<p>Alexey: </p>
<hr />
<div>{{Функция ГБ<br />
|Название=OPENDATASET<br />
|Описание=Открывает датасет при помощи вызова процедуры, либо путем импорта данных из файла (текстового, DBF, Excel, CDS)<br />
|Синтаксис=OPENDATASET('''Имя процедуры''', '''Датасет параметров''', '''Датасет результатов''')<br />
|Аргументы={{Аргумент<br />
|Название=Имя процедуры<br />
|Пояснение=Строка, содержащая одно из значений:<br />
* имя процедуры в БД. Имя процедуры может иметь вид ''`GBDB://База/Процедура`'' для осуществления [[Распределенные вызовы|распределенных вызовов]] либо ''`GBTCP://Адрес:Порт/Процедура`'' для вызова метода [[Бизнес-сервер|бизнес-сервера]];<br />
* константа '''`file:`''' для импорта данных из файла;<br />
* константа '''`copy:`''' для создания копии датасета;<br />
* константа '''`array:`''' для создания датасета на основе данных из ассоциативного массива.<br />
}}<br />
{{Аргумент<br />
|Название=Датасет параметров<br />
|Пояснение=Строка с именем или непосредственно описанием датасета, содержащего входные параметры процедуры либо '''параметры импорта файла'''.<br />
}}<br />
{{Аргумент<br />
|Название=Датасет результатов<br />
|Пояснение=Строка, определяющая имя создаваемого датасета. Если задана пустая строка ``, то датасет не будет создан (используется, если нам не интересно, что вернула процедура).<br />
}}<br />
|Результат=Нет<br />
<br />
<h2>Параметры импорта файла</h2><br />
<h6>Общие параметры</h6><br />
* '''FileType''' &ndash; строка, тип файла (TXT, CSV, DBF, XLS, CDS);<br />
* '''FileName''' &ndash; строка, имя файла;<br />
<br />
<h6>Управление кодировкой</h6><br />
* '''CharSet''' &ndash; строка, тип кодировки файла. Возможны следующие значения:<br />
**`CP866` &ndash; включает кодировку DOS;<br />
**`UTF-8` &ndash; включает кодировку UTF-8;<br />
**`WIN1251` &ndash; включает кодировку WIN1251;<br />
* <span style="color:gray;">'''CP866''' – строка, любое непустое значение означает, что текстовый файл в кодировке DOS (было в старых версиях ГБ, оставлено для совместимости);</span><br />
* <span style="color:gray;">'''WIN1251''' – строка, любое непустое значение означает, что DBF файл в кодировке Windows (было в старых версиях ГБ, оставлено для совместимости);</span><br />
<br />
<h6>Настройка полей</h6><br />
* '''FieldCount''' &ndash; число, количество полей в строке файла (по умолчанию количество полей определяется по первой импортируемой строке);<br />
* '''FieldsMap''' &ndash; строка, содержит описание полей создаваемого датасета.<br>Представляет собой список формул вида имя,тип=выражение через «;», определяющих поля создаваемого датасета и их вычисление через поля исходного файла. Возможные значения для типа поля: I, F, D, S, B.<br>При задании константы '''`auto`''' для файла типа DBF, структура '''Датасета результатов''' повторит структуру импортируемого файла DBF.<br />
:Если FieldsMap не задан, структура датасета формируется автоматически, а поля именуются как: fld0, fld1, ..., fldN (где N &ndash; количество полей, определённое по первой строке файла, либо заданное в параметре FieldCount). Тип таких полей &ndash; S, размер поля &ndash; 250 (см. также FieldSize).<br />
* '''Separator''' &ndash; строка, разделитель полей в текстовом файле;<br />
* '''Tabs''' &ndash; строка, список (через символ ";") отступов полей в текстовом файле, отсчет начинается с 0;<br />
* '''FieldSize''' &ndash; размер строковых полей. Если FieldSize не задан, а количество полей более 200, то размер строковых полей будет принудительно установлен равным 40 символам.<br />
<br />
<h6>Управление строками</h6><br />
* '''StartLine''' &ndash; число, номер строки с которой начинается импорт (отсчет начинается с 0);<br />
* '''EndLine''' &ndash; число, номер строки, на которой заканчивается импорт (отсчет начинается с 0). Отрицательное значение означает, что не нужно импортировать соответствующее число последних строк;<br />
* '''StopIfEmpty''' &ndash; строка, любое непустое значение означает, что нужно остановить импорт, встретив пустую строку (для файлов Excel проверяется первая ячейка в строке);<br />
* '''Filter''' &ndash; выражение для фильтрации строк исходного файла;<br />
:''Из-за бага в dbclient (и не только) в старых версиях ГБ (до 04.10.2017) при задании фильтра результирующий датасет содержал в логе изменений "мусор", т.е. записи, отсеянные фильтром. Эти записи воспринимались udf'кой как не удалённые, из-за чего при передаче датасета в процедуру, она получала неотфильтрованный набор записей.''<br />
:''Обойти это можно путём задания параметра '''LogChanges=1''', что позволит обойти баг dbclient, но резко увеличит объём расходуемой памяти и снизит скорость загрузки. Вариант, когда при загрузке не используется Filter, а ненужные записи удаляются позже (с помощью функции Delete), также потребует задание параметра '''LogChanges=1'''.''<br />
* '''Comment''' &ndash; строка, символ комментария в текстовом файле. При встрече данного символа в начале строки, эта строка игнорируется и не попадает в '''Датасет результатов''';<br />
* '''ProcessCR''' &ndash; строка, любое непустое значение включает режим импорта XLS-файлов, при котором ячейка, содержащая символы перевода строки (ячейка содержит несколько строк, введённых через Alt+Enter), импортируется как одно поле. При этом такие строки объединяются в одну через пробел.<br>При импорте по-умолчанию (значение ProcessCR не задано), такие ячейки импортируются, как несколько записей;<br />
* '''ProcessCRFrom''' &ndash; число, номер строки XLS-файла, начиная с которой применяется алгоритм импорта, включенный параметром ProcessCR (отсчет начинается с 0);<br />
* '''QuoteChar''' &ndash; строка, если задан символ кавычек (обычно - `"`), то алгоритм импорта, включенный параметром ProcessCR, объединяет строки в одну не через пробел, а через перевод строки (#13#10);<br />
<br />
<h6>Прочие параметры</h6><br />
* '''Sheet''' &ndash; строка, название листа для импорта из Excel.<br />
<br />
|Пример=Вызов отчёта "Реестр документов" (в датасете dsDoc - входные параметры процедуры):<br />
OpenDataSet(<br />
`Documents_PeriodRegistry`,<br />
`dsDoc`,<br />
`dsRes`<br />
)<br />
<br />
Некоторые процедуры могут возвращать сообщения о результатах своей работы, например ''"Обработано 1234 строк. Найдено и отмечено 110 товаров"''. Такое сообщение в процедурах принято передавать в выходном датасете в поле Message:<br />
<br />
OpenDataSet(<br />
`MZ_ArticulsImport`,<br />
`dsTXT`,<br />
`dsRes`<br />
),<br />
IfEmpty(<br />
dsRes.Message,<br />
0,<br />
Info( dsRes.Message )<br />
)<br />
<br />
Создание датасета из массива:<br />
OpenDataSet(<br />
`array:`,<br />
[<br />
[<br />
`a` : 1,<br />
`b` : 2<br />
]<br />
],<br />
`ds`<br />
)<br />
}}</div>Alexeyhttp://wiki.gbsoft.ru/index.php?title=OPENDATASET&diff=3282OPENDATASET2023-10-19T02:57:08Z<p>Alexey: </p>
<hr />
<div>{{Функция ГБ<br />
|Название=OPENDATASET<br />
|Описание=Открывает датасет при помощи вызова процедуры, либо путем импорта данных из файла (текстового, DBF, Excel, CDS)<br />
|Синтаксис=OPENDATASET('''Имя процедуры''', '''Датасет параметров''', '''Датасет результатов''')<br />
|Аргументы={{Аргумент<br />
|Название=Имя процедуры<br />
|Пояснение=Строка, содержащая одно из значений:<br />
* имя процедуры в БД. Имя процедуры может иметь вид ''`GBDB://База/Процедура`'' для осуществления [[Распределенные вызовы|распределенных вызовов]] либо ''`GBTCP://Адрес:Порт/Процедура`'' для вызова метода [[Бизнес-сервер|бизнес-сервера]];<br />
* константа '''`file:`''' для импорта данных из файла;<br />
* константа '''`copy:`''' для создания копии датасета;<br />
* константа '''`array:`''' для создания датасета на основе данных из ассоциативного массива.<br />
}}<br />
{{Аргумент<br />
|Название=Датасет параметров<br />
|Пояснение=Строка с именем или непосредственно описанием датасета, содержащего входные параметры процедуры либо '''параметры импорта файла'''.<br />
}}<br />
{{Аргумент<br />
|Название=Датасет результатов<br />
|Пояснение=Строка, определяющая имя создаваемого датасета. Если задана пустая строка ``, то датасет не будет создан (используется, если нам не интересно, что вернула процедура).<br />
}}<br />
|Результат=Нет<br />
<br />
<h2>Параметры импорта файла</h2><br />
<h6>Общие параметры</h6><br />
* '''FileType''' &ndash; строка, тип файла (TXT, CSV, DBF, XLS, CDS);<br />
* '''FileName''' &ndash; строка, имя файла;<br />
<br />
<h6>Управление кодировкой</h6><br />
* '''CharSet''' &ndash; строка, тип кодировки файла. Возможны следующие значения:<br />
**`CP866` &ndash; включает кодировку DOS;<br />
**`UTF-8` &ndash; включает кодировку UTF-8;<br />
**`WIN1251` &ndash; включает кодировку WIN1251;<br />
* <span style="color:gray;">'''CP866''' – строка, любое непустое значение означает, что текстовый файл в кодировке DOS (было в старых версиях ГБ, оставлено для совместимости);</span><br />
* <span style="color:gray;">'''WIN1251''' – строка, любое непустое значение означает, что DBF файл в кодировке Windows (было в старых версиях ГБ, оставлено для совместимости);</span><br />
<br />
<h6>Настройка полей</h6><br />
* '''FieldCount''' &ndash; число, количество полей в строке файла (по умолчанию количество полей определяется по первой импортируемой строке);<br />
* '''FieldsMap''' &ndash; строка, содержит описание полей создаваемого датасета.<br>Представляет собой список формул вида имя,тип=выражение через «;», определяющих поля создаваемого датасета и их вычисление через поля исходного файла. Возможные значения для типа поля: I, F, D, S, B.<br>При задании константы '''`auto`''' для файла типа DBF, структура '''Датасета результатов''' повторит структуру импортируемого файла DBF.<br />
:Если FieldsMap не задан, структура датасета формируется автоматически, а поля именуются как: fld0, fld1, ..., fldN (где N &ndash; количество полей, определённое по первой строке файла, либо заданное в параметре FieldCount). Тип таких полей &ndash; S, размер поля &ndash; 250 (см. также FieldSize).<br />
* '''Separator''' &ndash; строка, разделитель полей в текстовом файле;<br />
* '''Tabs''' &ndash; строка, список (через символ ";") отступов полей в текстовом файле, отсчет начинается с 0;<br />
* '''FieldSize''' &ndash; размер строковых полей. Если FieldSize не задан, а количество полей более 200, то размер строковых полей будет принудительно установлен равным 40 символам.<br />
<br />
<h6>Управление строками</h6><br />
* '''StartLine''' &ndash; число, номер строки с которой начинается импорт (отсчет начинается с 0);<br />
* '''EndLine''' &ndash; число, номер строки, на которой заканчивается импорт (отсчет начинается с 0). Отрицательное значение означает, что не нужно импортировать соответствующее число последних строк;<br />
* '''StopIfEmpty''' &ndash; строка, любое непустое значение означает, что нужно остановить импорт, встретив пустую строку (для файлов Excel проверяется первая ячейка в строке);<br />
* '''Filter''' &ndash; выражение для фильтрации строк исходного файла;<br />
:''Из-за бага в dbclient (и не только) в старых версиях ГБ (до 04.10.2017) при задании фильтра результирующий датасет содержал в логе изменений "мусор", т.е. записи, отсеянные фильтром. Эти записи воспринимались udf'кой как не удалённые, из-за чего при передаче датасета в процедуру, она получала неотфильтрованный набор записей.''<br />
:''Обойти это можно путём задания параметра '''LogChanges=1''', что позволит обойти баг dbclient, но резко увеличит объём расходуемой памяти и снизит скорость загрузки. Вариант, когда при загрузке не используется Filter, а ненужные записи удаляются позже (с помощью функции Delete), также потребует задание параметра '''LogChanges=1'''.''<br />
* '''Comment''' &ndash; строка, символ комментария в текстовом файле. При встрече данного символа в начале строки, эта строка игнорируется и не попадает в '''Датасет результатов''';<br />
* '''ProcessCR''' &ndash; строка, любое непустое значение включает режим импорта XLS-файлов, при котором ячейка, содержащая символы перевода строки (ячейка содержит несколько строк, введённых через Alt+Enter), импортируется как одно поле. При этом такие строки объединяются в одну через пробел.<br>При импорте по-умолчанию (значение ProcessCR не задано), такие ячейки импортируются, как несколько записей;<br />
* '''ProcessCRFrom''' &ndash; число, номер строки XLS-файла, начиная с которой применяется алгоритм импорта, включенный параметром ProcessCR (отсчет начинается с 0);<br />
* '''QuoteChar''' &ndash; строка, если задан символ кавычек (обычно - `"`), то алгоритм импорта, включенный параметром ProcessCR, объединяет строки в одну не через пробел, а через перевод строки (#13#10);<br />
<br />
<h6>Прочие параметры</h6><br />
* '''Sheet''' &ndash; строка, название листа для импорта из Excel.<br />
<br />
|Пример=Вызов отчёта "Реестр документов" (в датасете dsDoc - входные параметры процедуры):<br />
OPENDATASET(<br />
`Documents_PeriodRegistry`,<br />
`dsDoc`,<br />
`dsRes`<br />
)<br />
<br />
Не все процедуры возвращают массивы с данными. Но при этом некоторые процедуры могут возвращать различные сообщения о результатах своей работы, например ''"Обработано 1234 строк. Найдено и отмечено 110 товаров"''. Такое сообщение в процедурах принято передавать в выходном датасете в поле Message, а вывести его можно так:<br />
<br />
OpenDataSet(`MZ_ArticulsImport`, `dsTXT`, `dsRes`),<br />
IfEmpty(dsRes.Message, 0, Info(dsRes.Message))<br />
<br />
Создание датасета из массива:<br />
OpenDataSet(<br />
`array:`,<br />
[<br />
[<br />
`a` : 1,<br />
`b` : 2<br />
]<br />
],<br />
`ds`<br />
)<br />
}}</div>Alexeyhttp://wiki.gbsoft.ru/index.php?title=OPENDATASET&diff=3281OPENDATASET2023-10-19T02:56:08Z<p>Alexey: </p>
<hr />
<div>{{Функция ГБ<br />
|Название=OPENDATASET<br />
|Описание=Открывает датасет при помощи вызова процедуры, либо путем импорта данных из файла (текстового, DBF, Excel, CDS)<br />
|Синтаксис=OPENDATASET('''Имя процедуры''', '''Датасет параметров''', '''Датасет результатов''')<br />
|Аргументы={{Аргумент<br />
|Название=Имя процедуры<br />
|Пояснение=Строка, содержащая одно из значений:<br />
* имя процедуры в БД. Имя процедуры может иметь вид ''`GBDB://База/Процедура`'' для осуществления [[Распределенные вызовы|распределенных вызовов]] либо ''`GBTCP://Адрес:Порт/Процедура`'' для вызова метода [[Бизнес-сервер|бизнес-сервера]];<br />
* константа '''`file:`''' для импорта данных из файла;<br />
* константа '''`copy:`''' для создания копии датасета;<br />
* константа '''`array:`''' для создания датасета на основе данных из ассоциативного массива.<br />
}}<br />
{{Аргумент<br />
|Название=Датасет параметров<br />
|Пояснение=Строка с именем или непосредственно описанием датасета, содержащего входные параметры процедуры либо '''параметры импорта файла'''.<br />
}}<br />
{{Аргумент<br />
|Название=Датасет результатов<br />
|Пояснение=Строка, определяющая имя создаваемого датасета. Если задана пустая строка ``, то датасет не будет создан (используется, если нам не интересно, что вернула процедура).<br />
}}<br />
|Результат=Нет<br />
<br />
<h2>Параметры импорта файла</h2><br />
<h6>Общие параметры</h6><br />
* '''FileType''' &ndash; строка, тип файла (TXT, CSV, DBF, XLS, CDS);<br />
* '''FileName''' &ndash; строка, имя файла;<br />
<br />
<h6>Управление кодировкой</h6><br />
* '''CharSet''' &ndash; строка, тип кодировки файла. Возможны следующие значения:<br />
**`CP866` &ndash; включает кодировку DOS;<br />
**`UTF-8` &ndash; включает кодировку UTF-8;<br />
**`WIN1251` &ndash; включает кодировку WIN1251;<br />
* <span style="color:gray;">'''CP866''' – строка, любое непустое значение означает, что текстовый файл в кодировке DOS (было в старых версиях ГБ, оставлено для совместимости);</span><br />
* <span style="color:gray;">'''WIN1251''' – строка, любое непустое значение означает, что DBF файл в кодировке Windows (было в старых версиях ГБ, оставлено для совместимости);</span><br />
<br />
<h6>Настройка полей</h6><br />
* '''FieldCount''' &ndash; число, количество полей в строке файла (по умолчанию количество полей определяется по первой импортируемой строке);<br />
* '''FieldsMap''' &ndash; строка, содержит описание полей создаваемого датасета.<br>Представляет собой список формул вида имя,тип=выражение через «;», определяющих поля создаваемого датасета и их вычисление через поля исходного файла. Возможные значения для типа поля: I, F, D, S, B.<br>При задании константы '''`auto`''' для файла типа DBF, структура '''Датасета результатов''' повторит структуру импортируемого файла DBF.<br />
:Если FieldsMap не задан, структура датасета формируется автоматически, а поля именуются как: fld0, fld1, ..., fldN (где N &ndash; количество полей, определённое по первой строке файла, либо заданное в параметре FieldCount). Тип таких полей &ndash; S, размер поля &ndash; 250 (см. также FieldSize).<br />
* '''Separator''' &ndash; строка, разделитель полей в текстовом файле;<br />
* '''Tabs''' &ndash; строка, список (через символ ";") отступов полей в текстовом файле, отсчет начинается с 0;<br />
* '''FieldSize''' &ndash; размер строковых полей. Если FieldSize не задан, а количество полей более 200, то размер строковых полей будет принудительно установлен равным 40 символов.<br />
<br />
<h6>Управление строками</h6><br />
* '''StartLine''' &ndash; число, номер строки с которой начинается импорт (отсчет начинается с 0);<br />
* '''EndLine''' &ndash; число, номер строки, на которой заканчивается импорт (отсчет начинается с 0). Отрицательное значение означает, что не нужно импортировать соответствующее число последних строк;<br />
* '''StopIfEmpty''' &ndash; строка, любое непустое значение означает, что нужно остановить импорт, встретив пустую строку (для файлов Excel проверяется первая ячейка в строке);<br />
* '''Filter''' &ndash; выражение для фильтрации строк исходного файла;<br />
:''Из-за бага в dbclient (и не только) в старых версиях ГБ (до 04.10.2017) при задании фильтра результирующий датасет содержал в логе изменений "мусор", т.е. записи, отсеянные фильтром. Эти записи воспринимались udf'кой как не удалённые, из-за чего при передаче датасета в процедуру, она получала неотфильтрованный набор записей.''<br />
:''Обойти это можно путём задания параметра '''LogChanges=1''', что позволит обойти баг dbclient, но резко увеличит объём расходуемой памяти и снизит скорость загрузки. Вариант, когда при загрузке не используется Filter, а ненужные записи удаляются позже (с помощью функции Delete), также потребует задание параметра '''LogChanges=1'''.''<br />
* '''Comment''' &ndash; строка, символ комментария в текстовом файле. При встрече данного символа в начале строки, эта строка игнорируется и не попадает в '''Датасет результатов''';<br />
* '''ProcessCR''' &ndash; строка, любое непустое значение включает режим импорта XLS-файлов, при котором ячейка, содержащая символы перевода строки (ячейка содержит несколько строк, введённых через Alt+Enter), импортируется как одно поле. При этом такие строки объединяются в одну через пробел.<br>При импорте по-умолчанию (значение ProcessCR не задано), такие ячейки импортируются, как несколько записей;<br />
* '''ProcessCRFrom''' &ndash; число, номер строки XLS-файла, начиная с которой применяется алгоритм импорта, включенный параметром ProcessCR (отсчет начинается с 0);<br />
* '''QuoteChar''' &ndash; строка, если задан символ кавычек (обычно - `"`), то алгоритм импорта, включенный параметром ProcessCR, объединяет строки в одну не через пробел, а через перевод строки (#13#10);<br />
<br />
<h6>Прочие параметры</h6><br />
* '''Sheet''' &ndash; строка, название листа для импорта из Excel.<br />
<br />
|Пример=Вызов отчёта "Реестр документов" (в датасете dsDoc - входные параметры процедуры):<br />
OPENDATASET(<br />
`Documents_PeriodRegistry`,<br />
`dsDoc`,<br />
`dsRes`<br />
)<br />
<br />
Не все процедуры возвращают массивы с данными. Но при этом некоторые процедуры могут возвращать различные сообщения о результатах своей работы, например ''"Обработано 1234 строк. Найдено и отмечено 110 товаров"''. Такое сообщение в процедурах принято передавать в выходном датасете в поле Message, а вывести его можно так:<br />
<br />
OpenDataSet(`MZ_ArticulsImport`, `dsTXT`, `dsRes`),<br />
IfEmpty(dsRes.Message, 0, Info(dsRes.Message))<br />
<br />
Создание датасета из массива:<br />
OpenDataSet(<br />
`array:`,<br />
[<br />
[<br />
`a` : 1,<br />
`b` : 2<br />
]<br />
],<br />
`ds`<br />
)<br />
}}</div>Alexeyhttp://wiki.gbsoft.ru/index.php?title=%D0%A0%D0%B0%D1%81%D1%87%D0%B5%D1%82_%D0%B2%D0%B5%D1%81%D0%B0_%D0%B8_%D0%BE%D0%B1%D1%8A%D0%B5%D0%BC%D0%B0_%D0%B2_%D0%B4%D0%BE%D0%BA%D1%83%D0%BC%D0%B5%D0%BD%D1%82%D0%B0%D1%85&diff=3280Расчет веса и объема в документах2023-10-11T07:05:23Z<p>Alexey: /* Автоматический расчёт веса и объёма в документах */</p>
<hr />
<div>[[Категория:Стандартные решения в ГБ]]<br />
==== Автоматический расчёт веса и объёма в документах ====<br />
<br />
Если в карточке товара заполнены поля '''Heap.BoxWeight''' и '''Heap.BoxVolume''', а в типе данного документа '''Heap.@CalcWV=1''', то при любых изменениях количества в форме документа, при импорте, разбиении заказа и смене флага общий вес и объём, посчитанный исходя из Ceil(Quantity/Articul.RatioSale) (где Ceil() &ndash; округление вверх), будут записаны в документ в поля '''Heap.@DocWeight''' и '''Heap.@DocVolume''' соответственно.</div>Alexeyhttp://wiki.gbsoft.ru/index.php?title=CASE&diff=3276CASE2023-07-19T09:23:03Z<p>Alexey: </p>
<hr />
<div>{{Функция ГБ<br />
|Название=CASE<br />
|Описание=Условная функция.<br />
|Синтаксис=CASE('''Значение для проверки''','''Значение для сравнения(1): Значение(1)''','''Значение для сравнения(2): Значение(2)''',''':''','''$default: Значение по умолчаниию''')<br />
|Аргументы=<br />
{{Аргумент<br />
|Название=Значение для проверки<br />
|Пояснение=значение произвольного типа, которое сравнивается со значениями для сравнения.<br />
}}<br/>{{Аргумент<br />
|Название=Значение для сравнения(N)<br />
|Пояснение=значение произвольного типа, с которым сравнивается со значениями для проверки.<br />
}}<br/>{{Аргумент<br />
|Название=Значение(N)<br />
|Пояснение=значение произвольного типа, которое вернет функция CASE, если значение для проверки совпало с значением для сравнения(N).<br />
}}<br/>{{Аргумент<br />
|Название=Значение по умолчанию<br />
|Пояснение=значение произвольного типа, которое вернет функция CASE, если значение для проверки не совпало ни с одним из значений для сравнения.<br />
}}<br />
|Результат=Значение произвольного типа.<br />
|Пример=Здесь 1/0 служит для проверки на NULL:<br />
Case(<br />
Articul.RootFolder,<br />
100 : `папка 100`,<br />
200 : `папка 200`,<br />
(1/0) : `где делась папка?`,<br />
$default : `другая папка`<br />
)<br />
<br />
А можно и так (будет выполнено выражение из первого подходящего условия):<br />
Case(<br />
-1,<br />
Flag>=1000 : `Обработан`,<br />
Flag=300 and Str=Places : `ГРР завершены`,<br />
Flag=300 and Placed>0 : `В работе`,<br />
Flag=300 and Placed=0 : `Готов к приёмке`,<br />
$default : `Новый`<br />
)<br />
}}</div>Alexeyhttp://wiki.gbsoft.ru/index.php?title=OPENDATASET&diff=3275OPENDATASET2023-06-22T09:02:06Z<p>Alexey: </p>
<hr />
<div>{{Функция ГБ<br />
|Название=OPENDATASET<br />
|Описание=Открывает датасет при помощи вызова процедуры, либо путем импорта данных из файла (текстового, DBF, Excel, CDS)<br />
|Синтаксис=OPENDATASET('''Имя процедуры''', '''Датасет параметров''', '''Датасет результатов''')<br />
|Аргументы={{Аргумент<br />
|Название=Имя процедуры<br />
|Пояснение=Строка, содержащая одно из значений:<br />
* имя процедуры в БД. Имя процедуры может иметь вид ''`GBDB://База/Процедура`'' для осуществления [[Распределенные вызовы|распределенных вызовов]] либо ''`GBTCP://Адрес:Порт/Процедура`'' для вызова метода [[Бизнес-сервер|бизнес-сервера]];<br />
* константа '''`file:`''' для импорта данных из файла;<br />
* константа '''`copy:`''' для создания копии датасета;<br />
* константа '''`array:`''' для создания датасета на основе данных из ассоциативного массива.<br />
}}<br />
{{Аргумент<br />
|Название=Датасет параметров<br />
|Пояснение=Строка с именем или непосредственно описанием датасета, содержащего входные параметры процедуры либо '''параметры импорта файла'''. Вместо строки с описанием можно использовать ассоциативный массив.<br />
<br />
Ниже перечислены '''параметры импорта файла'''.<br />
<br />
Общие параметры:<br />
* FileType – строка, тип файла (TXT, CSV, DBF, XLS, CDS);<br />
* FileName – строка, имя файла;<br />
<br />
Управление кодировкой:<br />
* CharSet – строка, тип кодировки файла. Возможны следующие значения:<br />
**`CP866` – включает кодировку DOS;<br />
**`UTF-8` – включает кодировку UTF-8;<br />
**`WIN1251` – включает кодировку WIN1251;<br />
* <span style="color:gray;">CP866 – строка, любое непустое значение означает, что текстовый файл в кодировке DOS (было в старых версиях ГБ, оставлено для совместимости);</span><br />
* <span style="color:gray;">WIN1251 – строка, любое непустое значение означает, что DBF файл в кодировке Windows (было в старых версиях ГБ, оставлено для совместимости);</span><br />
<br />
Настройка полей:<br />
* FieldCount – число, количество полей в строке файла (по умолчанию количество полей определяется по первой импортируемой строке);<br />
* FieldsMap – строка, содержит описание полей создаваемого датасета.<br>Представляет собой список формул вида имя,тип=выражение через «;», определяющих поля создаваемого датасета и их вычисление через поля исходного файла. Возможные значения для типа поля: I, F, D, S, B.<br>При задании константы '''`auto`''' для файла типа DBF, структура '''Датасета результатов''' повторит структуру импортируемого файла DBF;<br />
* Separator – строка, разделитель полей в текстовом файле;<br />
* Tabs – строка, список (через символ ";") отступов полей в текстовом файле, отсчет начинается с 0;<br />
<br />
Управление строками:<br />
* StartLine – число, номер строки с которой начинается импорт (отсчет начинается с 0);<br />
* EndLine – число, номер строки, на которой заканчивается импорт (отсчет начинается с 0). Отрицательное значение означает, что не нужно импортировать соответствующее число последних строк;<br />
* StopIfEmpty – строка, любое непустое значение означает, что нужно остановить импорт, встретив пустую строку (для файлов Excel проверяется первая ячейка в строке);<br />
* Filter – выражение для фильтрации строк исходного файла;<br />
:''Из-за бага в dbclient (и не только) в старых версиях ГБ (до 04.10.2017) при задании фильтра результирующий датасет содержал в логе изменений "мусор", т.е. записи, отсеянные фильтром. Эти записи воспринимались udf'кой как не удалённые, из-за чего при передаче датасета в процедуру, она получала неотфильтрованный набор записей.''<br />
:''Обойти это можно путём задания параметра '''LogChanges=1''', что позволит обойти баг dbclient, но резко увеличит объём расходуемой памяти и снизит скорость загрузки. Вариант, когда при загрузке не используется Filter, а ненужные записи удаляются позже (с помощью функции Delete), также потребует задание параметра '''LogChanges=1'''.''<br />
* Comment – строка, символ комментария в текстовом файле. При встрече данного символа в начале строки, эта строка игнорируется и не попадает в '''Датасет результатов''';<br />
* ProcessCR – строка, любое непустое значение включает режим импорта XLS-файлов, при котором ячейка, содержащая символы перевода строки (ячейка содержит несколько строк, введённых через Alt+Enter), импортируется как одно поле. При этом такие строки объединяются в одну через пробел.<br>При импорте по-умолчанию (значение ProcessCR не задано), такие ячейки импортируются, как несколько записей;<br />
* ProcessCRFrom – число, номер строки XLS-файла, начиная с которой применяется алгоритм импорта, включенный параметром ProcessCR (отсчет начинается с 0);<br />
* QuoteChar – строка, если задан символ кавычек (обычно - `"`), то алгоритм импорта, включенный параметром ProcessCR, объединяет строки в одну не через пробел, а через перевод строки (#13#10);<br />
<br />
Прочие параметры:<br />
* Sheet – строка, название листа для импорта из Excel.<br />
}}<br />
{{Аргумент<br />
|Название=Датасет результатов<br />
|Пояснение=Строка, определяющая имя создаваемого датасета. Если задана пустая строка ``, то датасет не будет создан (используется, если нам не интересно, что вернула процедура).<br />
}}<br />
|Пример=Вызов отчёта "Реестр документов" (в датасете dsDoc - входные параметры процедуры):<br />
OPENDATASET(<br />
`Documents_PeriodRegistry`,<br />
`dsDoc`,<br />
`dsRes`<br />
)<br />
<br />
Не все процедуры возвращают массивы с данными. Но при этом некоторые процедуры могут возвращать различные сообщения о результатах своей работы, например ''"Обработано 1234 строк. Найдено и отмечено 110 товаров"''. Такое сообщение в процедурах принято передавать в выходном датасете в поле Message, а вывести его можно так:<br />
<br />
OpenDataSet(`MZ_ArticulsImport`, `dsTXT`, `dsRes`),<br />
IfEmpty(dsRes.Message, 0, Info(dsRes.Message))<br />
<br />
Создание датасета из массива:<br />
OpenDataSet(<br />
`array:`,<br />
[<br />
[<br />
`a` : 1,<br />
`b` : 2<br />
]<br />
],<br />
`ds`<br />
)<br />
}}</div>Alexeyhttp://wiki.gbsoft.ru/index.php?title=%D0%98%D0%BC%D0%BF%D0%BE%D1%80%D1%82_%D0%B4%D0%B0%D0%BD%D0%BD%D1%8B%D1%85_ID115&diff=3274Импорт данных ID1152023-06-21T02:22:03Z<p>Alexey: /* Пример импорта с последующим расчётом */</p>
<hr />
<div>[[Категория:Справочник команд ГБ]]<br />
===Назначение команды===<br />
Команда '''ID115''' (синоним &ndash; '''IMPORT''') предназначена для импорта данных, для изменения значения полей в нескольких объектах и т.п.<br />
<br />
===Описание команды===<br />
=====Сопоставление с внешним справочником=====<br />
Команда может задавать соответствие между импортируемым объектом ГБ и объектом внешнего справочника.<br />
Поля, используемые для автоматического создания сопоставления с внешним справочником:<br />
* ExtType - тип объекта во внешнем справочнике;<br />
* ExtId - код объекта во внешнем справочнике;<br />
* Depot - код удаленного отдела (т.е. владельца внешнего справочника).<br />
<br />
=====Создание нового объекта=====<br />
Для создания нового объекта в команду импорта данных нужно передавать "пустой" (null) код объекта, т.е.<br />
Id = 1/0<br />
<br />
=====Изменение значения полей после импорта=====<br />
Можно импортировать данные и изменять значения полей после импорта в одной команде.<br/><br />
Например, нужно импортировать из файла поле "Вес коробки" (BoxWeight), после чего рассчитать значение поля "Вес штуки" (@MinBoxWeight), используя значение поля "Вместимость коробки" (RatioStock).<br />
<br />
Импорт происходит поэтапно:<br />
* вначале импортируются данные из датасета, при этом в поля, которые нужно изменить, записывается значение null;<br />
* затем с помощью конструкции "ImportDefValue:имя_поля" записываются выражения, которые изменят значения полей (см. примеры).<br />
<br />
<br />
===Примеры===<br />
=====Пример записи значения поля ''Heap.@Upakovshik'' в группу документов=====<br />
'''CreateDataSet'''(<br />
`dsImp`,<br />
[<br />
`DocId,I` : ``,<br />
`Up,I` : ``<br />
]<br />
),<br />
''<тут заполняем датасет dsImp кодами документов>,''<br />
'''ProcessCommand'''(<br />
11,<br />
[<br />
`SaveImmediate` : `Y`,<br />
`ImportDs` : `dsImp`,<br />
`ImportDsMap` : [<br />
`Id` : `DocId`,<br />
`Heap.@Upakovshik` : `Up`<br />
]<br />
],<br />
`IMPORT`<br />
),<br />
'''WaitForChildForms()'''<br />
<br />
=====Пример импорта справочника партнёров=====<br />
В примере партнёры импортируются в одну папку.<br />
'''ProcessCommand'''(<br />
0,<br />
[<br />
`SaveImmediate` : `Y`,<br />
`ImportDs` : `dsTXT`,<br />
`ImportDsMap` : [<br />
`Id` : `Id`,<br />
`Node` : `IfEmpty(Id,11,Id.Node)`, ''<--для новых карточек папка 11, для существующих папку не меняем''<br />
`SubType` : 11,<br />
`Name` : `fld3`,<br />
`FullName` : `fld13`,<br />
`Heap.@INN` : `fld1`,<br />
`Heap.@Phone` : `fld5`,<br />
`Heap.@Address` : `fld6`,<br />
`ExtType` : `0`,<br />
`ExtId` : `fld2`,<br />
`Depot` : 209<br />
]<br />
],<br />
`ID115`<br />
),<br />
'''WaitForChildForms()'''<br />
<br />
=====Пример импорта справочника товаров=====<br />
В примере товары импортируются в разные папки.<br />
'''ProcessCommand'''(<br />
1,<br />
[<br />
`ParentForm` : `launch`,<br />
`SaveImmediate` : `Y`,<br />
`ImportDs` : `dsTXT`,<br />
`ImportDsMap` : [<br />
`Id` : `ArtId`,<br />
`ItemType` : `ItemType`,<br />
`Node` : `IfEmpty(fld13,1,IfEmpty(MapGbId(10001,fld13,209,1),1))`,<br />
`Name` : `fld3`,<br />
`FullName` : `fld14`,<br />
`NUMBER` : `fld1`,<br />
`PackMin` : 101,<br />
`PackSale` : 102,<br />
`PackStock` : 102,<br />
`RatioSale` : `Ratio`,<br />
`RatioStock` : `Ratio`,<br />
`AddBarCode0` : `BC`,<br />
`Heap.@Weight` : `IfEmpty(StrToFloat(StrReplace(fld9,".",",")),0)`,<br />
`Heap.@PackType` : `IfEmpty(fld8,"")`,<br />
`ExtType` : `ExtType`,<br />
`ExtId` : `fld2`,<br />
`Depot` : 209<br />
]<br />
],<br />
`ID115`<br />
),<br />
'''WaitForChildForms()'''<br />
<br />
=====Пример импорта с последующим расчётом=====<br />
Нужно импортировать поле "Вес коробки" (Heap.BoxWeight), после чего рассчитать значение поля "Вес штуки" (Heap.@MinBoxWeight),<br/>используя значение поля "Вместимость коробки" (RatioStock)<br />
'''CreateDataSet'''(<br />
`ArticulsDs`,<br />
[<br />
`Articul,I` : ``,<br />
`Weight` : ``<br />
]<br />
),<br />
''<тут заполняем датасет ArticulsDs данными>,''<br />
'''ProcessCommand'''(<br />
1,<br />
[<br />
`SaveImmediate` : `Y`,<br />
`ImportDs` : `ArticulsDs`,<br />
`ImportDsMap` : [<br />
`Id` : `Articul`,<br />
`Heap.@MinBoxWeight` : `1/0`, /*либо '''Expr'''(1/0) - '''обязательно''' инициализируем поле для срабатывания ImportDefValue*/<br />
`Heap.BoxWeight` : `Weight`<br />
],<br />
`ImportDefValue:Heap@MinBoxWeight`: `FormatFloat('0.######',StrToFloat(Heap.BoxWeight)/RatioStock)`<br />
],<br />
`IMPORT`<br />
),<br />
'''WaitForChildForms()'''<br />
<br />
то же самое без использования ассоциативного массива:<br />
'''ProcessCommand'''(<br />
1,<br />
`SaveImmediate=Y,ImportDs=ArticulsDs,`<br />
+ `"ImportDsMap=Id=Articul||Heap.@MinBoxWeight=1/0||Heap.BoxWeight=Weight||",`<br />
+ `"ImportDefValue:Heap@MinBoxWeight=FormatFloat('0.######',StrToFloat(Heap.BoxWeight)/RatioStock)"`,<br />
`IMPORT`<br />
)</div>Alexeyhttp://wiki.gbsoft.ru/index.php?title=CREATETIMER&diff=3273CREATETIMER2023-02-10T04:40:59Z<p>Alexey: </p>
<hr />
<div>{{Функция ГБ<br />
|Название=CREATETIMER<br />
|Описание=Создает таймер, который сработает через заданное первым параметром число секунд, и выполнит заданный вторым параметром скрипт. Третьим параметром можно задать имя для таймера.<br />
|Синтаксис=CREATETIMER('''Интервал''', '''Выражение''', ''Имя таймера'')<br />
|Аргументы=<br />
{{Аргумент<br />
|Название=Интервал<br />
|Пояснение=действительное число, определяющее интервал времени (в секундах), через который срабатывает таймер<br />
}}<br/><br />
{{Аргумент<br />
|Название=Выражение<br />
|Пояснение=строка с выражением, которое будет выполнено по истечении интервала<br />
}}<br />
{{Аргумент<br />
|Название=Имя таймера<br />
|Пояснение=необязательный параметр, определяющий имя таймера.<br/>Если использовать имя с префиксом '''persist''' (например `persistTick`), то будет создан повторяющийся таймер.<br/>По имени можно остановить таймер, указав его имя и '''Интервал'''=0<br />
}}<br />
|Пример=1. Через 1 секунду откроется информационное окно:<br />
CREATETIMER(1, "INFO(`прошла секунда`)")<br />
2. Запуск таймера с ежесекундным отсчётом:<br />
:Tick:=0, CREATETIMER(1, Expr(:Tick:=:Tick+1, Assign(`HeapSet.CountDown`, :Tick)), `persistTick`)<br />
и его остановка (например, по нажатию кнопки):<br />
CREATETIMER(0, ``, `persistTick`)<br />
}}</div>Alexeyhttp://wiki.gbsoft.ru/index.php?title=QUERYPARAMS&diff=3272QUERYPARAMS2022-10-26T06:42:21Z<p>Alexey: </p>
<hr />
<div>{{Функция ГБ<br />
|Название=QUERYPARAMS<br />
|Описание=Предлагает пользователю форму для ввода параметров. Возвращает "истина", если пользователь нажал в предложенной форме кнопку "Принять", и "ложь" в противном случае. Введенные пользователем параметры сохраняются в переменных.<br />
|Синтаксис=QUERYPARAMS ('''Строка описания параметров''',Заголовок окна)<br />
|Аргументы=<br />
{{Аргумент<br />
|Название=Строка описания параметров<br />
|Пояснение=Строка, описывающая требуемые параметры. Формат тот же, что для описания параметров отчетов.<br />
}}<br/>{{Аргумент<br />
|Название=Заголовок окна<br />
|Пояснение=Строка, заголовок окна для ввода параметров.<br />
}}<br />
|Результат=Логическое значение.<br />
|Пример=Если пользователь ввел требуемые параметры и нажал "Принять", то в переменных :MyStock и :MyString сохранятся введенные параметры:<br />
QueryParams("Stock['Склад']=MyStock,String['Строка']=MyString")<br />
<br><br />
Ввод пароля, который отображается "звёздочками":<br />
QueryParams(`String['Пароль']=pwd{Constraints='password=*'}`,`Ввод пароля`)<br />
}}<br />
<br />
== Отображение таблиц ==<br />
Специальный режим работы функции QUERYPARAMS - это отображение одного из датасетов текущей формы в виде таблицы.<br />
Синтаксис:<br />
QueryParams(`Grid=MyDs`)<br />
<br />
Замечания:<br />
# поскольку таблица лежит в форме ввода параметров команды, а датасет в родительской, нельзя делать правила (изменять одни поля при изменении других, запрещать вставку и удаление)<br />
# поскольку форма ввода параметров создается с одним и тем же именем, настройка таблицы в реестре хранится всего одна. Поэтому в случае использования QUERYPARAMS для отображения разных датасетов может потребоваться задавать настройку таблицы прямо в функции:<br />
<br />
<pre><br />
QUERYPARAMS(<br />
`Grid=MyDs,String['aaa']=aaa,GridParams:__AutoGridMyDs='"RequiredLayout=|""reason"",""-100"",""Причина""|;|""NewField1[Тест,]=1+2"",""-40"",""Тест!""|"'`, `Заголовок` <br />
)<br />
</pre><br />
<br />
Заметим, что двойные кавычки в настройке таблицы удваиваются.<br />
Для разбивки заголовка колонок на несколько строк следует использовать управляющую комбинацию #13#10</div>Alexeyhttp://wiki.gbsoft.ru/index.php?title=INVALIDATECACHE&diff=3271INVALIDATECACHE2022-10-13T06:33:48Z<p>Alexey: </p>
<hr />
<div>{{Функция ГБ<br />
|Название=INVALIDATECACHE<br />
|Описание=Инвалидирует кэш<br />
|Синтаксис=INVALIDATECACHE('''Тип объекта''', Код объекта)<br><br />
или<br><br />
INVALIDATECACHE('''"IDMAP"''')<br />
|Аргументы=<br />
{{Аргумент<br />
|Название=Тип объекта<br />
|Пояснение=Код [[Типы объектов ГБ|типа объекта ГБ]], для которого требуется обновить кэш.<br><br />
Специальные значения:<br />
* '''"IDMAP"''' &ndash; обновление кэша для сопоставлений (objectsmap)<br />
* '''"CONFIGS"''' &ndash; обновление кэша для конфигурации ГБ<br />
* '''"ACTIVECONTRACTS"''' &ndash; обновление кэша кэша действующих договоров (ActiveContracts)<br />
}}<br />
{{Аргумент<br />
|Название=Код объекта<br />
|Пояснение=Код объекта, необязательный параметр. Если не задан, то кэш инвалидируется для всех объектов заданного типа<br />
}}<br />
|Результат=Нет<br />
|Пример=Обновить кэш для всех объектов с типом "товар" (тип "1") перед обновлением отчёта:<br />
InvalidateCache(1),<br />
ProcessCommand(<br />
`CURRENT`,<br />
``,<br />
'REFRESH'<br />
)<br />
<br />
Обновить кэш для сопоставлений:<br />
InvalidateCache(`IDMAP`),<br />
IfEmpty(<br />
MapGbId(0, :var.HPart60, 50, 1),<br />
Info(`Нет сопоставления с внешним справочником`)<br />
)<br />
}}</div>Alexeyhttp://wiki.gbsoft.ru/index.php?title=STRFROMLIST&diff=3270STRFROMLIST2022-10-13T02:38:10Z<p>Alexey: </p>
<hr />
<div>{{Функция ГБ<br />
|Название=STRFROMLIST<br />
|Описание=Получает элемент списка с заданным номером.<br />
|Синтаксис=STRFROMLIST('''Список''', '''Номер''', Разделитель)<br />
|Аргументы=<br />
{{Аргумент<br />
|Название=Список<br />
|Пояснение=строка, являющаяся списком значений с разделителем.<br />
}}<br/>{{Аргумент<br />
|Название=Номер<br />
|Пояснение=целое число, номер элемента в списке который нужно получить, начиная с 0. Если в списке нет элемента с таким номером, функция вернет пустую строку<br />
}}<br/>{{Аргумент<br />
|Название=Разделитель<br />
|Пояснение=строка, определяющая разделитель в списке, по умолчанию ";".<br>Специальные значения:<br />
*`EXTRACT WORD N` - найти в строке слово длиной не меньшей чем N<br />
*`EXTRACT INT N` - найти в строке целое число длиной не меньшей чем N<br />
}}<br />
|Результат=Строка.<br />
|Пример=STRFROMLIST(`1;2;3`,0)<br/><br />
STRFROMLIST(Articul.Name,0,`EXTRACT WORD 4`)<br />
}}</div>Alexeyhttp://wiki.gbsoft.ru/index.php?title=TRY_FINALLY_EXCEPT&diff=3269TRY FINALLY EXCEPT2022-05-20T09:20:19Z<p>Alexey: </p>
<hr />
<div>[[Category:Функции_ГБ]]<br />
{{Функция ГБ<br />
|Название=TRY...FINALLY...EXCEPT<br />
|Описание=Функции для обработки исключений (доступны с версии 1.9.0.9).<br />
|Синтаксис='''TRY'''(''выражение, выражение, ...'', '''FINALLY'''(''выражение, выражение, ...'') )<br />
<br/>или<br />
<br/>'''TRY'''(''выражение, выражение, ...'', '''EXCEPT'''(''выражение, выражение, ...'') )<br />
<br/>или<br />
<br/>'''TRY'''(''выражение, выражение, ...'', '''EXCEPT'''(''выражение, выражение, ...'', '''RAISE'''() ) )<br />
|Аргументы=<br />
{{Аргумент<br />
|Название=блок TRY<br />
|Пояснение=в блоке TRY находятся выражения, выполнение которых нужно проконтролировать<br />
}}<br/>{{Аргумент<br />
|Название=блок FINALLY<br />
|Пояснение=в блоке FINALLY находятся выражения, которые нужно выполнить независимо от того, возникло или нет исключение при выполнении блока TRY. Обычно используется для гарантированного освобождения ресурсов, выделенных в блоке TRY.<br>Фактически FINALLY не обрабатывает исключение, т.е. скрипт будет прерван, если нет никаких обработчиков EXCEPT. Чтобы всё-таки обработать исключение, нужно использовать вложенные конструкции TRY:<br />
TRY(<br />
TRY(<br />
...,<br />
EXCEPT(<br />
...<br />
)<br />
),<br />
FINALLY(<br />
...<br />
)<br />
)<br />
}}<br/>{{Аргумент<br />
|Название=блок EXCEPT<br />
|Пояснение=в блоке EXCEPT находятся выражения, которые будут выполнены только в том случае, если в блоке TRY возникнет исключение. При этом исключение считается обработанным и выполнение скрипта не прерывается стандартным сообщением об ошибке<br />
}}<br/>{{Аргумент<br />
|Название=RAISE()<br />
|Пояснение=функция RAISE(), помещённая в блок EXCEPT, возобновляет исключение, проталкивая его во внешний обработчик или, если такового нет - в стандартный обработчик исключений<br />
}}<br/>{{Аргумент<br />
|Название=Объект E<br />
|Пояснение=E - объект для работы с ошибками. Например: E.ClassName(), E.Message(), E.DbMessage().<br>E.DbMessage() содержит оригинальное сообщение из процедуры, если ошибка была при вызове процедуры, либо то же самое что E.Message() во всех остальных случаях<br />
}}<br />
|Пример=Пример 1.<br />
:SDt:=`aaa`,<br />
'''TRY'''(STRTODATE(:SDt),<br />
'''EXCEPT'''(<br />
INFO(`Ошибка преобразования даты`)<br />
)<br />
),<br />
INFO(`Продолжаем выполнение...`)<br />
<br />
Будут выведены следующие сообщения:<br />
* "Ошибка преобразования даты"<br />
* "Продолжаем выполнение..."<br />
и выполнение скрипта будет продолжено.<br />
<br />
<br><br />
Пример 2.<br />
:SDt:=`aaa`,<br />
'''TRY'''(STRTODATE(:SDt),<br />
'''EXCEPT'''(<br />
INFO(`Ошибка преобразования даты`),<br />
'''RAISE'''()<br />
)<br />
),<br />
INFO(`Продолжаем выполнение...`)<br />
<br />
Будут выведены следующие сообщения:<br />
* "Ошибка преобразования даты"<br />
* "'aaa' is not a valid date and time"<br />
и выполнение скрипта будет прервано.<br />
<br />
<br><br />
Пример 3.<br />
'''TRY'''(<br />
/*распределяем ресурсы*/<br />
:var.str:=TStringList.Create(),<br />
/*попытка прочитать несуществующий файл*/<br />
:var.str.LoadFromFile(`C:\0.txt`),<br />
'''FINALLY'''(<br />
/*ВСЕГДА освобождаем ресурсы*/<br />
:var.str.Free(),<br />
INFO(`Освободили ресурсы`)<br />
)<br />
),<br />
INFO(`Продолжаем выполнение...`)<br />
<br />
Будут выведены следующие сообщения:<br />
* "Освободили ресурсы"<br />
* "Не удалось открыть файл C:\0.txt"<br />
и выполнение скрипта будет прервано.<br />
<br />
<br><br />
Пример 3.1.<br>Аналогично предыдущему, но с обработкой исключения во вложенном блоке TRY..EXCEPT и, соответственно, продолжением выполнения скрипта.<br />
'''TRY'''(<br />
'''TRY'''(<br />
/*распределяем ресурсы*/<br />
:var.str:=TStringList.Create(),<br />
/*попытка прочитать несуществующий файл*/<br />
:var.str.LoadFromFile(`C:\0.txt`),<br />
'''EXCEPT'''(<br />
/*обрабатываем исключение*/<br />
INFO(`Не удалось прочитать файл`)<br />
)<br />
),<br />
'''FINALLY'''(<br />
/*ВСЕГДА освобождаем ресурсы*/<br />
:var.str.Free(),<br />
INFO(`Освободили ресурсы`)<br />
)<br />
),<br />
INFO(`Продолжаем выполнение...`)<br />
<br />
Будут выведены следующие сообщения:<br />
* "Не удалось прочитать файл"<br />
* "Освободили ресурсы"<br />
* "Продолжаем выполнение..."<br />
и выполнение скрипта будет продолжено.<br />
<br />
<br><br />
Пример 4.<br />
<br />
Можно использовать объект '''E''' для работы с ошибками:<br />
<br />
:SDt:=`aaa`,<br />
'''TRY'''(<br />
STRTODATE(:SDt),<br />
'''EXCEPT'''(<br />
INFO(<br />
`Произошла какая-то ошибка... Определим её тип.`<br />
+ \<br />
+ `Класс ошибки: `<br />
+ '''E.ClassName()'''<br />
+ \<br />
+ `Текст ошибки: `<br />
+ '''E.Message()'''<br />
)<br />
)<br />
),<br />
INFO(`Продолжаем выполнение...`)<br />
<br />
Будут выведены следующие сообщения:<br />
* Произошла какая-то ошибка... Определим её тип.<br />
:Класс ошибки: EConvertError<br />
:Текст ошибки: 'aaa' is not a valid date and time<br />
:в выражении<br />
:STRTODATE(:SDt)<br />
* Продолжаем выполнение...<br />
<br />
<br><br />
Пример 5.<br />
Использование Exit в блоке Finally:<br />
:var.Res:=<br />
'''Try'''(<br />
aaa,<br />
'''Finally'''(<br />
'''Exit'''(`Выходим из Finally, а ошибки нет!`)<br />
)<br />
),<br />
'''Info'''(:var.Res)<br />
<br />
Вместо ошибки при обращении к неопределённому полю "aaa", будет выведено сообщение:<br />
* Выходим из Finally, а ошибки нет!<br />
Связано это с тем, что функция Exit() в ГБ реализована также через исключения, потому ошибка при обращении к полю теряется. Следует избегать использования конструкций, аналогичных вышеприведённой.<br />
}}</div>Alexeyhttp://wiki.gbsoft.ru/index.php?title=TRY_FINALLY_EXCEPT&diff=3268TRY FINALLY EXCEPT2022-05-20T09:19:57Z<p>Alexey: </p>
<hr />
<div>[[Category:Функции_ГБ]]<br />
{{Функция ГБ<br />
|Название=TRY...FINALLY...EXCEPT<br />
|Описание=Функции для обработки исключений (доступны с версии 1.9.0.9).<br />
|Синтаксис='''TRY'''(''выражение, выражение, ...'', '''FINALLY'''(''выражение, выражение, ...'') )<br />
<br/>или<br />
<br/>'''TRY'''(''выражение, выражение, ...'', '''EXCEPT'''(''выражение, выражение, ...'') )<br />
<br/>или<br />
<br/>'''TRY'''(''выражение, выражение, ...'', '''EXCEPT'''(''выражение, выражение, ...'', '''RAISE'''() ) )<br />
|Аргументы=<br />
{{Аргумент<br />
|Название=блок TRY<br />
|Пояснение=в блоке TRY находятся выражения, выполнение которых нужно проконтролировать<br />
}}<br/>{{Аргумент<br />
|Название=блок FINALLY<br />
|Пояснение=в блоке FINALLY находятся выражения, которые нужно выполнить независимо от того, возникло или нет исключение при выполнении блока TRY. Обычно используется для гарантированного освобождения ресурсов, выделенных в блоке TRY.<br>Фактически FINALLY не обрабатывает исключение, т.е. скрипт будет прерван, если нет никаких обработчиков EXCEPT. Чтобы всё-таки обработать исключение, нужно использовать вложенные конструкции TRY:<br />
TRY(<br />
TRY(<br />
...,<br />
EXCEPT(<br />
...<br />
)<br />
),<br />
FINALLY(<br />
...<br />
)<br />
)<br />
}}<br/>{{Аргумент<br />
|Название=блок EXCEPT<br />
|Пояснение=в блоке EXCEPT находятся выражения, которые будут выполнены только в том случае, если в блоке TRY возникнет исключение. При этом исключение считается обработанным и выполнение скрипта не прерывается стандартным сообщением об ошибке<br />
}}<br/>{{Аргумент<br />
|Название=RAISE()<br />
|Пояснение=функция RAISE(), помещённая в блок EXCEPT, возобновляет исключение, проталкивая его во внешний обработчик или, если такового нет - в стандартный обработчик исключений<br />
}}<br/>{{Аргумент<br />
|Название=Объект E<br />
|Пояснение=E - объект для работы с ошибками. Например: E.ClassName(), E.Message(), E.DbMessage().<br>E.DbMessage() содержит оригинальное сообщение из процедуры, если ошибка была при вызове процедуры, либо то же самое что E.Message() во всех остальных случаях<br />
}}<br />
|Пример=Пример 1.<br />
:SDt:=`aaa`,<br />
'''TRY'''(STRTODATE(:SDt),<br />
'''EXCEPT'''(<br />
INFO(`Ошибка преобразования даты`)<br />
)<br />
),<br />
INFO(`Продолжаем выполнение...`)<br />
<br />
Будут выведены следующие сообщения:<br />
* "Ошибка преобразования даты"<br />
* "Продолжаем выполнение..."<br />
и выполнение скрипта будет продолжено.<br />
<br />
<br><br />
Пример 2.<br />
:SDt:=`aaa`,<br />
'''TRY'''(STRTODATE(:SDt),<br />
'''EXCEPT'''(<br />
INFO(`Ошибка преобразования даты`),<br />
'''RAISE'''()<br />
)<br />
),<br />
INFO(`Продолжаем выполнение...`)<br />
<br />
Будут выведены следующие сообщения:<br />
* "Ошибка преобразования даты"<br />
* "'aaa' is not a valid date and time"<br />
и выполнение скрипта будет прервано.<br />
<br />
<br><br />
Пример 3.<br />
'''TRY'''(<br />
/*распределяем ресурсы*/<br />
:var.str:=TStringList.Create(),<br />
/*попытка прочитать несуществующий файл*/<br />
:var.str.LoadFromFile(`C:\0.txt`),<br />
'''FINALLY'''(<br />
/*ВСЕГДА освобождаем ресурсы*/<br />
:var.str.Free(),<br />
INFO(`Освободили ресурсы`)<br />
)<br />
),<br />
INFO(`Продолжаем выполнение...`)<br />
<br />
Будут выведены следующие сообщения:<br />
* "Освободили ресурсы"<br />
* "Не удалось открыть файл C:\0.txt"<br />
и выполнение скрипта будет прервано.<br />
<br />
<br><br />
Пример 3.1.<br>Аналогично предыдущему, но с обработкой исключения во вложенном блоке TRY..EXCEPT и, соответственно, продолжением выполнения скрипта.<br />
'''TRY'''(<br />
'''TRY'''(<br />
/*распределяем ресурсы*/<br />
:var.str:=TStringList.Create(),<br />
/*попытка прочитать несуществующий файл*/<br />
:var.str.LoadFromFile(`C:\0.txt`),<br />
'''EXCEPT'''(<br />
/*обрабатываем исключение*/<br />
INFO(`Не удалось прочитать файл`)<br />
)<br />
),<br />
'''FINALLY'''(<br />
/*ВСЕГДА освобождаем ресурсы*/<br />
:var.str.Free(),<br />
INFO(`Освободили ресурсы`)<br />
)<br />
),<br />
INFO(`Продолжаем выполнение...`)<br />
<br />
Будут выведены следующие сообщения:<br />
* "Не удалось прочитать файл"<br />
* "Освободили ресурсы"<br />
* "Продолжаем выполнение..."<br />
и выполнение скрипта будет продолжено.<br />
<br />
<br><br />
Пример 4.<br />
<br />
Можно использовать объект '''E''' для работы с ошибками:<br />
<br />
:SDt:=`aaa`,<br />
'''TRY'''(<br />
STRTODATE(:SDt),<br />
'''EXCEPT'''(<br />
INFO(<br />
`Произошла какая-то ошибка... Определим её тип.`<br />
+ \<br />
+ `Класс ошибки: `<br />
+ '''E.ClassName()'''<br />
+ \<br />
+ `Текст ошибки: `<br />
+ '''E.Message()'''<br />
)<br />
)<br />
),<br />
INFO(`Продолжаем выполнение...`)<br />
<br />
Будут выведены следующие сообщения:<br />
* Произошла какая-то ошибка... Определим её тип.<br />
:Класс ошибки: EConvertError<br />
:Текст ошибки: 'aaa' is not a valid date and time<br />
:в выражении<br />
:STRTODATE(:SDt)<br />
* Продолжаем выполнение...<br />
<br />
<br><br />
Пример 5.<br />
Использование Exit в блоке Finally:<br />
:var.Res:=<br />
'''Try'''(<br />
aaa,<br />
'''Finally'''(<br />
'''Exit'''(`Выходим из Finally, а ошибки нет!`)<br />
)<br />
),<br />
Info(:var.Res)<br />
<br />
Вместо ошибки при обращении к неопределённому полю "aaa", будет выведено сообщение:<br />
* Выходим из Finally, а ошибки нет!<br />
Связано это с тем, что функция Exit() в ГБ реализована также через исключения, потому ошибка при обращении к полю теряется. Следует избегать использования конструкций, аналогичных вышеприведённой.<br />
}}</div>Alexeyhttp://wiki.gbsoft.ru/index.php?title=%D0%9F%D0%B5%D1%87%D0%B0%D1%82%D1%8C_%D0%B2_MSWord_%D0%B8_Open_Office_Writer&diff=3267Печать в MSWord и Open Office Writer2022-03-24T05:27:42Z<p>Alexey: /* Печать в MSWord из ГБ */</p>
<hr />
<div>[[Категория:Печатные формы]]<br />
<br />
== Печать в MSWord из ГБ ==<br />
<br />
<br />
'''''Для экспорта данных из ПФ в документ MS Word необходимо'''''<br />
<br />
# Создать новую печатную форму, выбрав вид формы «Word-овая».<br />
# В редакторе печатных форм в свойствах формы задать имя файла-шаблона и, если нужно, имя файла-результата. Если отмечен чекбокс «Внедрить», файл-шаблон будет внедрён в печатную форму.<br />
Остальные параметры установить как для основной печатной формы.<br />
<br />
'''''Структура печатной формы'''''<br />
<br />
# В ПФ должны располагаться все необходимые [[Бэнд|бэнды]] для вывода нужной информации. Тип бэндов &ndash; «Custom».<br />
# В каждом бэнде определяются поля, необходимые для передачи в документ Word (поля, уже имеющиеся в датасете бэнда переопределять не нужно).<br />
<br />
'''''Файл-шаблон'''''<br />
<br />
Создается документ-шаблон формата MS Word. Документ-шаблон &ndash; это обычный документ Word (doc), содержащий текст, таблицы, рисунки и пр., в котором для указания границ бэндов и последующего вывода данных из ГБ используются ''«Word-поля»'' типа «Формула» (в Word &ndash; пункт меню «Вставка» → «Поле…» → «Формула…» или Ctrl+F9).<br />
<br>Таким образом, в том месте документа, в котором нужно обозначить границу бэнда или вывести значение какого-то поля из ГБ, вставляются «Формулы», содержащие имена соответствующих датасетов и полей в ГБ.<br />
<br />
Границы бэндов в шаблоне обозначаются полями с ключевыми словами:<br />
$GBDataSetBegin.XXX (начало бэнда)<br />
$GBDataSetEnd.XXX (конец бэнда)<br />
где XXX &ndash; имя датасета данного бэнда в ГБ.<br />
<br />
Внутри бэнда располагаются поля, принадлежащие ему. Поля обозначаются ключевым словом $GBField.XXX.YYY, где XXX &ndash; имя датасета данного бэнда, YYY &ndash; имя поля в данном датасете, например:<br />
$GBField.DataSet.DocNumber<br />
Кроме имён полей можно использовать функции ГБ, например:<br />
$GBField.DataSet.FormatDate(`YYYY-MM-DD`,DocDate)<br />
<br />
Необходимо соблюдать вложенность бэндов в шаблоне. Например, внешний бэнд для основных полей документа (DataSet) и вложенный в него источник товарных строчек документа (Goodies):<br />
<br />
$GBDataSetBegin.DataSet<br />
$GBField.DataSet.DocNumber<br />
$GBDataSetBegin.Goodies<br />
$GBField.Goodies.Articul.Name<br />
$GBDataSetEnd.Goodies<br />
$GBDataSetEnd.DataSet<br />
<br />
В документах-шаблонах Word «поля-формулы» используются для вывода значений из ГБ как в обычном тексте, так и в ячейках таблиц.<br />
<br><br><br />
<br />
== Печать в LibreOffice Writer из ГБ ==<br />
<br />
'''''Для экспорта данных из ПФ в документ Writer необходимо'''''<br />
<br />
# Создать новую печатную форму, выбрав вид формы «Word-овая».<br />
# В редакторе печатных форм в свойствах формы задать имя файла-шаблона (тип odt) и, если нужно, имя файла-результата. Если отмечен чекбокс «Как файл», файл-шаблон будет внедрён в печатную форму (чекбокс «Внедрить» для печатных форм Writer неприменим из-за особенностей реализации LibreOffice).<br />
Остальные параметры установить как для основной печатной формы.<br />
<br />
'''''Структура печатной формы'''''<br />
<br />
# В ПФ должны располагаться все необходимые [[Бэнд|бэнды]] для вывода нужной информации. Тип бэндов &ndash; «Custom».<br />
# В каждом бэнде определяются поля, необходимые для передачи в документ Writer (поля, уже имеющиеся в датасеnе бэнда переопределять не нужно).<br />
<br />
'''''Файл-шаблон'''''<br />
<br />
Создается документ-шаблон формата Writer (odt). Документ-шаблон &ndash; это обычный документ Writer (odt), содержащий текст, таблицы, рисунки и пр., в котором для указания границ бэндов и последующего вывода данных из ГБ используются ''«Writer-поля»'' типа «Поле пользователя». Для вставки такого поля нужно во Writer открыть пункт меню «Вставка» → «Поле…» → «Ещё поля…» (или Ctrl+F2) и переключиться на вкладку «Переменные».<br />
<br>Затем добавляются поля. Для каждого такого поля нужно выбрать тип ''«Поле пользователя»'', формат ''«Текст»'', задать ''«Имя»'' (произвольное, не связано с именами в ГБ) и ''«Значение»'', содержащее имена датасета и поля в ГБ.<br />
<br>Таким образом, в том месте документа, в котором нужно обозначить границу бэнда или вывести значение какого-то поля из ГБ, вставляются «Поля пользователя», содержащие имена соответствующих датасетов и полей в ГБ.<br />
<br />
Ключевые слова для границ бэндов и полей, правила вложенности бэндов, возможность использования функций ГБ для полей и т.п. аналогичны таковым для печатных форм MS Word (см. выше).<br />
<br />
Примечание.<br />
В отличие от шаблонов Word, в документах-шаблонах Writer «Поля пользователя» используются только в обычном тексте, а ячейках таблиц нужно использовать текстовое описание поля (т.е. вместо вставки «Writer-поля» со значением $GBField.DataSet.DocNumber в ячейки таблиц нужно вставлять само это значение в виде обычного текста).<br />
<br />
Например:<br />
<br />
{|cellspacing="0" cellpadding="10" border="1"<br />
!align="center"|Наименование товара<br />
!align="center"|Артикул<br />
|-<br />
|$GBField.Goodies.Articul.Name<br />
|$GBField.Goodies.Articul.Number<br />
|}<br />
<br />
[[:File:Пример шаблона MsWord.doc|Пример файла-шаблона для MS Word]]<br />
<br>[[:File:Пример_ПФ_для_Writer.txt|Пример печатной формы для Writer]]</div>Alexeyhttp://wiki.gbsoft.ru/index.php?title=%D0%A4%D0%B0%D0%B9%D0%BB:%D0%9F%D1%80%D0%B8%D0%BC%D0%B5%D1%80_%D0%9F%D0%A4_%D0%B4%D0%BB%D1%8F_Writer.txt&diff=3266Файл:Пример ПФ для Writer.txt2022-03-10T08:45:34Z<p>Alexey: </p>
<hr />
<div></div>Alexeyhttp://wiki.gbsoft.ru/index.php?title=%D0%9F%D0%B5%D1%87%D0%B0%D1%82%D1%8C_%D0%B2_MSWord_%D0%B8_Open_Office_Writer&diff=3264Печать в MSWord и Open Office Writer2022-03-10T07:24:09Z<p>Alexey: /* Печать в LibreOffice Writer из ГБ */</p>
<hr />
<div>[[Категория:Печатные формы]]<br />
<br />
== Печать в MSWord из ГБ ==<br />
<br />
<br />
'''''Для экспорта данных из ПФ в документ MS Word необходимо'''''<br />
<br />
# Создать новую печатную форму, выбрав вид формы «Word-овая».<br />
# В редакторе печатных форм в свойствах формы задать имя файла-шаблона и, если нужно, имя файла-результата. Если отмечен чекбокс «Внедрить», файл-шаблон будет внедрён в печатную форму.<br />
Остальные параметры установить как для основной печатной формы.<br />
<br />
'''''Структура печатной формы'''''<br />
<br />
# В ПФ должны располагаться все необходимые [[Бэнд|бэнды]] для вывода нужной информации. Тип бэндов &ndash; «Custom».<br />
# В каждом бэнде определяются поля, необходимые для передачи в документ Word (поля, уже имеющиеся в датасете бэнда переопределять не нужно).<br />
<br />
'''''Файл-шаблон'''''<br />
<br />
Создается документ-шаблон формата MS Word. Документ-шаблон &ndash; это обычный документ Word (doc), содержащий текст, таблицы, рисунки и пр., в котором для указания границ бэндов и последующего вывода данных из ГБ используются ''«Word-поля»'' типа «Формула» (в Word &ndash; пункт меню «Вставка» → «Поле…» → «Формула…»).<br />
<br>Таким образом, в том месте документа, в котором нужно обозначить границу бэнда или вывести значение какого-то поля из ГБ, вставляются «Формулы», содержащие имена соответствующих датасетов и полей в ГБ.<br />
<br />
Границы бэндов в шаблоне обозначаются полями с ключевыми словами:<br />
$GBDataSetBegin.XXX (начало бэнда)<br />
$GBDataSetEnd.XXX (конец бэнда)<br />
где XXX &ndash; имя датасета данного бэнда в ГБ.<br />
<br />
Внутри бэнда располагаются поля, принадлежащие ему. Поля обозначаются ключевым словом $GBField.XXX.YYY, где XXX &ndash; имя датасета данного бэнда, YYY &ndash; имя поля в данном датасете, например:<br />
$GBField.DataSet.DocNumber<br />
Кроме имён полей можно использовать функции ГБ, например:<br />
$GBField.DataSet.FormatDate(`YYYY-MM-DD`,DocDate)<br />
<br />
Необходимо соблюдать вложенность бэндов в шаблоне. Например, внешний бэнд для основных полей документа (DataSet) и вложенный в него источник товарных строчек документа (Goodies):<br />
<br />
$GBDataSetBegin.DataSet<br />
$GBField.DataSet.DocNumber<br />
$GBDataSetBegin.Goodies<br />
$GBField.Goodies.Articul.Name<br />
$GBDataSetEnd.Goodies<br />
$GBDataSetEnd.DataSet<br />
<br />
В документах-шаблонах Word «поля-формулы» используются для вывода значений из ГБ как в обычном тексте, так и в ячейках таблиц.<br />
<br><br><br />
<br />
== Печать в LibreOffice Writer из ГБ ==<br />
<br />
'''''Для экспорта данных из ПФ в документ Writer необходимо'''''<br />
<br />
# Создать новую печатную форму, выбрав вид формы «Word-овая».<br />
# В редакторе печатных форм в свойствах формы задать имя файла-шаблона (тип odt) и, если нужно, имя файла-результата. Если отмечен чекбокс «Как файл», файл-шаблон будет внедрён в печатную форму (чекбокс «Внедрить» для печатных форм Writer неприменим из-за особенностей реализации LibreOffice).<br />
Остальные параметры установить как для основной печатной формы.<br />
<br />
'''''Структура печатной формы'''''<br />
<br />
# В ПФ должны располагаться все необходимые [[Бэнд|бэнды]] для вывода нужной информации. Тип бэндов &ndash; «Custom».<br />
# В каждом бэнде определяются поля, необходимые для передачи в документ Writer (поля, уже имеющиеся в датасеnе бэнда переопределять не нужно).<br />
<br />
'''''Файл-шаблон'''''<br />
<br />
Создается документ-шаблон формата Writer (odt). Документ-шаблон &ndash; это обычный документ Writer (odt), содержащий текст, таблицы, рисунки и пр., в котором для указания границ бэндов и последующего вывода данных из ГБ используются ''«Writer-поля»'' типа «Поле пользователя». Для вставки такого поля нужно во Writer открыть пункт меню «Вставка» → «Поле…» → «Ещё поля…» (или Ctrl+F2) и переключиться на вкладку «Переменные».<br />
<br>Затем добавляются поля. Для каждого такого поля нужно выбрать тип ''«Поле пользователя»'', формат ''«Текст»'', задать ''«Имя»'' (произвольное, не связано с именами в ГБ) и ''«Значение»'', содержащее имена датасета и поля в ГБ.<br />
<br>Таким образом, в том месте документа, в котором нужно обозначить границу бэнда или вывести значение какого-то поля из ГБ, вставляются «Поля пользователя», содержащие имена соответствующих датасетов и полей в ГБ.<br />
<br />
Ключевые слова для границ бэндов и полей, правила вложенности бэндов, возможность использования функций ГБ для полей и т.п. аналогичны таковым для печатных форм MS Word (см. выше).<br />
<br />
Примечание.<br />
В отличие от шаблонов Word, в документах-шаблонах Writer «Поля пользователя» используются только в обычном тексте, а ячейках таблиц нужно использовать текстовое описание поля (т.е. вместо вставки «Writer-поля» со значением $GBField.DataSet.DocNumber в ячейки таблиц нужно вставлять само это значение в виде обычного текста).<br />
<br />
Например:<br />
<br />
{|cellspacing="0" cellpadding="10" border="1"<br />
!align="center"|Наименование товара<br />
!align="center"|Артикул<br />
|-<br />
|$GBField.Goodies.Articul.Name<br />
|$GBField.Goodies.Articul.Number<br />
|}<br />
<br />
[[:File:Пример шаблона MsWord.doc|Пример файла-шаблона для MS Word]]<br />
<br>[[:File:Пример_ПФ_для_Writer.txt|Пример печатной формы для Writer]]</div>Alexeyhttp://wiki.gbsoft.ru/index.php?title=%D0%9F%D0%B5%D1%87%D0%B0%D1%82%D1%8C_%D0%B2_MSWord_%D0%B8_Open_Office_Writer&diff=3263Печать в MSWord и Open Office Writer2022-03-10T07:23:38Z<p>Alexey: </p>
<hr />
<div>[[Категория:Печатные формы]]<br />
<br />
== Печать в MSWord из ГБ ==<br />
<br />
<br />
'''''Для экспорта данных из ПФ в документ MS Word необходимо'''''<br />
<br />
# Создать новую печатную форму, выбрав вид формы «Word-овая».<br />
# В редакторе печатных форм в свойствах формы задать имя файла-шаблона и, если нужно, имя файла-результата. Если отмечен чекбокс «Внедрить», файл-шаблон будет внедрён в печатную форму.<br />
Остальные параметры установить как для основной печатной формы.<br />
<br />
'''''Структура печатной формы'''''<br />
<br />
# В ПФ должны располагаться все необходимые [[Бэнд|бэнды]] для вывода нужной информации. Тип бэндов &ndash; «Custom».<br />
# В каждом бэнде определяются поля, необходимые для передачи в документ Word (поля, уже имеющиеся в датасете бэнда переопределять не нужно).<br />
<br />
'''''Файл-шаблон'''''<br />
<br />
Создается документ-шаблон формата MS Word. Документ-шаблон &ndash; это обычный документ Word (doc), содержащий текст, таблицы, рисунки и пр., в котором для указания границ бэндов и последующего вывода данных из ГБ используются ''«Word-поля»'' типа «Формула» (в Word &ndash; пункт меню «Вставка» → «Поле…» → «Формула…»).<br />
<br>Таким образом, в том месте документа, в котором нужно обозначить границу бэнда или вывести значение какого-то поля из ГБ, вставляются «Формулы», содержащие имена соответствующих датасетов и полей в ГБ.<br />
<br />
Границы бэндов в шаблоне обозначаются полями с ключевыми словами:<br />
$GBDataSetBegin.XXX (начало бэнда)<br />
$GBDataSetEnd.XXX (конец бэнда)<br />
где XXX &ndash; имя датасета данного бэнда в ГБ.<br />
<br />
Внутри бэнда располагаются поля, принадлежащие ему. Поля обозначаются ключевым словом $GBField.XXX.YYY, где XXX &ndash; имя датасета данного бэнда, YYY &ndash; имя поля в данном датасете, например:<br />
$GBField.DataSet.DocNumber<br />
Кроме имён полей можно использовать функции ГБ, например:<br />
$GBField.DataSet.FormatDate(`YYYY-MM-DD`,DocDate)<br />
<br />
Необходимо соблюдать вложенность бэндов в шаблоне. Например, внешний бэнд для основных полей документа (DataSet) и вложенный в него источник товарных строчек документа (Goodies):<br />
<br />
$GBDataSetBegin.DataSet<br />
$GBField.DataSet.DocNumber<br />
$GBDataSetBegin.Goodies<br />
$GBField.Goodies.Articul.Name<br />
$GBDataSetEnd.Goodies<br />
$GBDataSetEnd.DataSet<br />
<br />
В документах-шаблонах Word «поля-формулы» используются для вывода значений из ГБ как в обычном тексте, так и в ячейках таблиц.<br />
<br><br><br />
<br />
== Печать в LibreOffice Writer из ГБ ==<br />
<br />
'''''Для экспорта данных из ПФ в документ Writer необходимо'''''<br />
<br />
# Создать новую печатную форму, выбрав вид формы «Word-овая».<br />
# В редакторе печатных форм в свойствах формы задать имя файла-шаблона (тип odt) и, если нужно, имя файла-результата. Если отмечен чекбокс «Как файл», файл-шаблон будет внедрён в печатную форму (чекбокс «Внедрить» для печатных форм Writer неприменим из-за особенностей реализации LibreOffice).<br />
Остальные параметры установить как для основной печатной формы.<br />
<br />
'''''Структура печатной формы'''''<br />
<br />
# В ПФ должны располагаться все необходимые [[Бэнд|бэнды]] для вывода нужной информации. Тип бэндов &ndash; «Custom».<br />
# В каждом бэнде определяются поля, необходимые для передачи в документ Writer (поля, уже имеющиеся в датасеnе бэнда переопределять не нужно).<br />
<br />
'''''Файл-шаблон'''''<br />
<br />
Создается документ-шаблон формата Writer (odt). Документ-шаблон &ndash; это обычный документ Writer (odt), содержащий текст, таблицы, рисунки и пр., в котором для указания границ бэндов и последующего вывода данных из ГБ используются ''«Writer-поля»'' типа «Поле пользователя». Для вставки такого поля нужно во Writer открыть пункт меню «Вставка» → «Поле…» → «Ещё поля…» (или Ctrl+F2) и переключиться на вкладку «Переменные».<br />
<br>Затем добавляются поля. Для каждого такого поля нужно выбрать тип ''«Поле пользователя»'', формат ''«Текст»'', задать ''«Имя»'' (произвольное, не связано с именами в ГБ) и ''«Значение»'', содержащее имена датасета и поля в ГБ.<br />
<br>Таким образом, в том месте документа, в котором нужно обозначить границу бэнда или вывести значение какого-то поля из ГБ, вставляются «Поля пользователя», содержащие имена соответствующих датасетов и полей в ГБ.<br />
<br />
Ключевые слова для границ бэндов и полей, правила вложенности бэндов, возможность использования функций ГБ для полей и т.п. аналогичны таковым для печатных форм MS Word (см. выше).<br />
<br />
Примечание.<br />
В отличие от шаблонов Word, в документах-шаблонах Writer «Поля пользователя» используются только в обычном тексте, а ячейках таблиц нужно использовать текстовое описание поля (т.е. вместо вставки «Writer-поля» со значением $GBField.DataSet.DocNumber в ячейку таблицы нужно вставлять само это значение в виде обычного текста).<br />
<br />
Например:<br />
<br />
{|cellspacing="0" cellpadding="10" border="1"<br />
!align="center"|Наименование товара<br />
!align="center"|Артикул<br />
|-<br />
|$GBField.Goodies.Articul.Name<br />
|$GBField.Goodies.Articul.Number<br />
|}<br />
<br />
[[:File:Пример шаблона MsWord.doc|Пример файла-шаблона для MS Word]]<br />
<br>[[:File:Пример_ПФ_для_Writer.txt|Пример печатной формы для Writer]]</div>Alexeyhttp://wiki.gbsoft.ru/index.php?title=%D0%9F%D0%B5%D1%87%D0%B0%D1%82%D1%8C_%D0%B2_MSWord_%D0%B8_Open_Office_Writer&diff=3262Печать в MSWord и Open Office Writer2022-03-10T07:14:00Z<p>Alexey: /* Печать в MSWord из ГБ */</p>
<hr />
<div>[[Категория:Печатные формы]]<br />
<br />
== Печать в MSWord из ГБ ==<br />
<br />
<br />
'''''Для экспорта данных из ПФ в документ MS Word необходимо'''''<br />
<br />
# Создать новую печатную форму, выбрав вид формы «Word-овая».<br />
# В редакторе печатных форм в свойствах формы задать имя файла-шаблона и, если нужно, имя файла-результата. Если отмечен чекбокс «Внедрить», файл-шаблон будет внедрён в печатную форму.<br />
Остальные параметры установить как для основной печатной формы.<br />
<br />
'''''Структура печатной формы'''''<br />
<br />
# В ПФ должны располагаться все необходимые [[Бэнд|бэнды]] для вывода нужной информации. Тип бэндов &ndash; «Custom».<br />
# В каждом бэнде определяются поля, необходимые для передачи в документ Word (поля, уже имеющиеся в датасете бэнда переопределять не нужно).<br />
<br />
'''''Файл-шаблон'''''<br />
<br />
Создается документ-шаблон формата MS Word. Документ-шаблон &ndash; это обычный документ Word (doc), содержащий текст, таблицы, рисунки и пр., в котором для указания границ бэндов и последующего вывода данных из ГБ используются ''«Word-поля»'' типа «Формула» (в Word &ndash; пункт меню «Вставка» → «Поле…» → «Формула…»).<br />
<br>Таким образом в том месте документа, в котором нужно обозначить границу бэнда или вывести значение какого-то поля из ГБ, вставляется «Формула», содержащая имена соответствующих датасета и поля в ГБ.<br />
<br />
Границы бэндов в шаблоне обозначаются полями с ключевыми словами:<br />
$GBDataSetBegin.XXX (начало бэнда)<br />
$GBDataSetEnd.XXX (конец бэнда)<br />
где XXX &ndash; имя датасета данного бэнда в ГБ.<br />
<br />
Внутри бэнда располагаются поля, принадлежащие ему. Поля обозначаются ключевым словом $GBField.XXX.YYY, где XXX &ndash; имя датасета данного бэнда, YYY &ndash; имя поля в данном датасете, например:<br />
$GBField.DataSet.DocNumber<br />
Кроме имён полей можно использовать функции ГБ, например:<br />
$GBField.DataSet.FormatDate(`YYYY-MM-DD`,DocDate)<br />
<br />
Необходимо соблюдать вложенность бэндов в шаблоне. Например, внешний бэнд для основных полей документа (DataSet) и вложенный в него источник товарных строчек документа (Goodies):<br />
<br />
$GBDataSetBegin.DataSet<br />
$GBField.DataSet.DocNumber<br />
$GBDataSetBegin.Goodies<br />
$GBField.Goodies.Articul.Name<br />
$GBDataSetEnd.Goodies<br />
$GBDataSetEnd.DataSet<br />
<br />
В документах-шаблонах MSWord для вывода значений из ГБ «поля-формулы» используются как в обычном тексте, так и в ячейках таблиц.<br />
<br><br><br />
<br />
== Печать в LibreOffice Writer из ГБ ==<br />
<br />
'''''Для экспорта данных из ПФ в документ Writer необходимо'''''<br />
<br />
# Создать новую печатную форму, выбрав вид формы «Word-овая».<br />
# В редакторе печатных форм в свойствах формы задать имя файла-шаблона (тип odt) и, если нужно, имя файла-результата. Если отмечен чекбокс «Как файл», файл-шаблон будет внедрён в печатную форму (чекбокс «Внедрить» для печатных форм Writer неприменим из-за особенностей реализации LibreOffice).<br />
Остальные параметры установить как для основной печатной формы.<br />
<br />
'''''Структура печатной формы'''''<br />
<br />
# В ПФ должны располагаться все необходимые [[Бэнд|бэнды]] для вывода нужной информации. Тип бэндов &ndash; «Custom».<br />
# В каждом бэнде определяются поля, необходимые для передачи в документ Writer (поля, уже имеющиеся в датаседе бэнда переопределять не нужно).<br />
<br />
'''''Файл-шаблон'''''<br />
<br />
Создается документ-шаблон формата Writer (odt). Документ-шаблон &ndash; это обычный документ Writer (odt), содержащий текст, таблицы, рисунки и пр., в котором для указания границ бэндов и последующего вывода данных из ГБ используются ''«Writer-поля»'' типа «Поле пользователя». Для вставки такого поля нужно во Writer открыть пункт меню «Вставка» - «Поле…» - «Ещё поля…» (или Ctrl+F2) и переключиться на вкладку «Переменные».<br />
<br>Затем добавляются поля. Для каждого такого поля нужно выбрать тип «Поля пользователя», формат «Текст», задать «Имя» (произвольное, не связано с именами в ГБ) и «Значение», содержащее имена датасета и поля в ГБ.<br />
<br>Таким образом в том месте документа, в котором нужно обозначить границу бэнда или вывести значение какого-то поля из ГБ, вставляется «Поле пользователя», содержащее имена соответствующих датасета и поля в ГБ.<br />
<br />
Ключевые слова для границ бэндов и полей, правила вложенности бэндов, возможность использования функций ГБ для полей и т.п. аналогичны таковым для печатных форм MS Word (см. выше).<br />
<br />
Примечание.<br />
В отличие от шаблонов Word, в документах-шаблонах Writer «Поля пользователя» используются только в обычном тексте, а ячейках таблиц нужно использовать текстовое описание поля (т.е. вместо вставки «Writer-поля» со значением $GBField.DataSet.DocNumber" нужно вставить само это значение в виде обычного текста.<br />
<br />
Например:<br />
<br />
{|cellspacing="0" cellpadding="10" border="1"<br />
!align="center"|Наименование товара<br />
!align="center"|Артикул<br />
|-<br />
|$GBField.Goodies.SArtName<br />
|$GBField.Goodies.SNumber<br />
|}<br />
<br />
[[:File:Пример шаблона MsWord.doc|Пример файла-шаблона для MS Word]]<br />
<br>[[:File:Пример_ПФ_для_Writer.txt|Пример печатной формы для Writer]]</div>Alexeyhttp://wiki.gbsoft.ru/index.php?title=%D0%9F%D0%B5%D1%87%D0%B0%D1%82%D1%8C_%D0%B2_MSWord_%D0%B8_Open_Office_Writer&diff=3261Печать в MSWord и Open Office Writer2022-03-10T07:10:48Z<p>Alexey: </p>
<hr />
<div>[[Категория:Печатные формы]]<br />
<br />
== Печать в MSWord из ГБ ==<br />
<br />
<br />
'''''Для экспорта данных из ПФ в документ MS Word необходимо'''''<br />
<br />
# Создать новую печатную форму, выбрав вид формы «Word-овая».<br />
# В редакторе печатных форм в свойствах формы задать имя файла-шаблона и, если нужно, имя файла-результата. Если отмечена галочка «Внедрить», файл-шаблон будет внедрён в печатную форму.<br />
Остальные параметры установить как для основной печатной формы.<br />
<br />
'''''Структура печатной формы'''''<br />
<br />
# В ПФ должны располагаться все необходимые [[Бэнд|бэнды]] для вывода нужной информации. Тип бэндов &ndash; «Custom».<br />
# В каждом бэнде определяются поля, необходимые для передачи в документ Word (поля, уже имеющиеся в датаседе бэнда переопределять не нужно).<br />
<br />
'''''Файл-шаблон'''''<br />
<br />
Создается документ-шаблон формата MSWord. Документ-шаблон &ndash; это обычный документ MSWord, содержащий текст, таблицы, рисунки и пр., в котором для указания границ бэндов и последующего вывода данных из ГБ используются ''«Word-поля»'' типа «Формула» (в Word &ndash; пункт меню «Вставка» - «Поле…» - «Формула…»).<br />
<br>Таким образом в том месте документа, в котором нужно обозначить границу бэнда или вывести значение какого-то поля из ГБ, вставляется «Формула», содержащая имена соответствующих датасета и поля в ГБ.<br />
<br />
Границы бэндов в шаблоне обозначаются полями с ключевыми словами:<br />
$GBDataSetBegin.XXX (начало бэнда)<br />
$GBDataSetEnd.XXX (конец бэнда)<br />
где XXX &ndash; имя датасета данного бэнда в ГБ.<br />
<br />
Внутри бэнда располагаются поля, принадлежащие ему. Поля обозначаются ключевым словом $GBField.XXX.YYY, где XXX &ndash; имя датасета данного бэнда, YYY &ndash; имя поля в данном датасете, например:<br />
$GBField.DataSet.DocNumber<br />
Кроме имён полей можно использовать функции ГБ, например:<br />
$GBField.DataSet.FormatDate(`YYYY-MM-DD`,DocDate)<br />
<br />
Необходимо соблюдать вложенность бэндов в шаблоне. Например, внешний бэнд для основных полей документа (DataSet) и вложенный в него источник товарных строчек документа (Goodies):<br />
<br />
$GBDataSetBegin.DataSet<br />
$GBField.DataSet.DocNumber<br />
$GBDataSetBegin.Goodies<br />
$GBField.Goodies.Articul.Name<br />
$GBDataSetEnd.Goodies<br />
$GBDataSetEnd.DataSet<br />
<br />
В документах-шаблонах MSWord для вывода значений из ГБ «поля-формулы» используются как в обычном тексте, так и в ячейках таблиц.<br />
<br><br><br />
== Печать в LibreOffice Writer из ГБ ==<br />
<br />
'''''Для экспорта данных из ПФ в документ Writer необходимо'''''<br />
<br />
# Создать новую печатную форму, выбрав вид формы «Word-овая».<br />
# В редакторе печатных форм в свойствах формы задать имя файла-шаблона (тип odt) и, если нужно, имя файла-результата. Если отмечен чекбокс «Как файл», файл-шаблон будет внедрён в печатную форму (чекбокс «Внедрить» для печатных форм Writer неприменим из-за особенностей реализации LibreOffice).<br />
Остальные параметры установить как для основной печатной формы.<br />
<br />
'''''Структура печатной формы'''''<br />
<br />
# В ПФ должны располагаться все необходимые [[Бэнд|бэнды]] для вывода нужной информации. Тип бэндов &ndash; «Custom».<br />
# В каждом бэнде определяются поля, необходимые для передачи в документ Writer (поля, уже имеющиеся в датаседе бэнда переопределять не нужно).<br />
<br />
'''''Файл-шаблон'''''<br />
<br />
Создается документ-шаблон формата Writer (odt). Документ-шаблон &ndash; это обычный документ Writer (odt), содержащий текст, таблицы, рисунки и пр., в котором для указания границ бэндов и последующего вывода данных из ГБ используются ''«Writer-поля»'' типа «Поле пользователя». Для вставки такого поля нужно во Writer открыть пункт меню «Вставка» - «Поле…» - «Ещё поля…» (или Ctrl+F2) и переключиться на вкладку «Переменные».<br />
<br>Затем добавляются поля. Для каждого такого поля нужно выбрать тип «Поля пользователя», формат «Текст», задать «Имя» (произвольное, не связано с именами в ГБ) и «Значение», содержащее имена датасета и поля в ГБ.<br />
<br>Таким образом в том месте документа, в котором нужно обозначить границу бэнда или вывести значение какого-то поля из ГБ, вставляется «Поле пользователя», содержащее имена соответствующих датасета и поля в ГБ.<br />
<br />
Ключевые слова для границ бэндов и полей, правила вложенности бэндов, возможность использования функций ГБ для полей и т.п. аналогичны таковым для печатных форм MS Word (см. выше).<br />
<br />
Примечание.<br />
В отличие от шаблонов Word, в документах-шаблонах Writer «Поля пользователя» используются только в обычном тексте, а ячейках таблиц нужно использовать текстовое описание поля (т.е. вместо вставки «Writer-поля» со значением $GBField.DataSet.DocNumber" нужно вставить само это значение в виде обычного текста.<br />
<br />
Например:<br />
<br />
{|cellspacing="0" cellpadding="10" border="1"<br />
!align="center"|Наименование товара<br />
!align="center"|Артикул<br />
|-<br />
|$GBField.Goodies.SArtName<br />
|$GBField.Goodies.SNumber<br />
|}<br />
<br />
[[:File:Пример шаблона MsWord.doc|Пример файла-шаблона для MS Word]]<br />
<br>[[:File:Пример_ПФ_для_Writer.txt|Пример печатной формы для Writer]]</div>Alexeyhttp://wiki.gbsoft.ru/index.php?title=%D0%9F%D0%B5%D1%87%D0%B0%D1%82%D1%8C_%D0%B2_MSWord_%D0%B8_Open_Office_Writer&diff=3260Печать в MSWord и Open Office Writer2022-03-05T09:33:11Z<p>Alexey: </p>
<hr />
<div>[[Категория:Печатные формы]]<br />
<br />
== Печать в MSWord из ГБ ==<br />
<br />
<br />
'''''Для создания Word-ой формы необходимо:'''''<br />
<br />
# Создать новую форму, выбрать вид формы Word-овая.<br />
# В редакторе печатных форм в свойствах формы (свойства элемента: TGBWordReport) задать имя файла-шаблона, имя файла-результата. Если отмечена галочка «Внедрить», содержимое файла-шаблона сохранится в печатной форме.<br />
Остальные параметры установить как для основной печатной формы.<br />
<br />
<br />
'''''Для формирования печатной формы:'''''<br />
<br />
# В ПФ должны располагаться все необходимые [[Бэнд|бэнды]] для вывода нужной информации. Тип бэндов – Custom.<br />
# В каждом бэнде определяем поля, необходимые для передачи в документ Word.<br />
<br />
'''''Файл-шаблон:'''''<br />
<br />
Создается документ-шаблон формата MSWord. В документе часть данных – константы, то есть текст, а часть – динамически изменяющиеся значения. В тех местах, где должны выводиться эти значения, вставляются поля (пункт меню «Вставка» - «Поле…» - «Формула…»).<br />
<br />
Поле должно иметь следующий вид:<br />
* Для описания начала датасета – $GBDataSetBegin.DataSet.<br />
* Для описания поля (хранящего переданное из ГБ значение) – $GBField.DataSet.SName.<br />
* Для описания конца датасета - $GBDataSetEnd.DataSet.<br />
<br />
<br />
Необходимо соблюдать вложенность бэндов в шаблоне. Например источник товарных строчек документа должен быть «вложен» в границы описания источника полей документа.<br />
<br />
Пример:<br />
<br />
$GBDataSetBegin.DataSet<br />
:$GBField.DataSet.SDocNum<br />
::$GBDataSetBegin.Goodies<br />
:::$GBField.Goodies.SArt<br />
::$GBDataSetEnd.Goodies<br />
$GBDataSetEnd.DataSet<br />
<br />
В данном примере поля SDocNum, SArt определены в соответствующих бэндах печатной формы. Отступы приведены для наглядности, поля могут располагаться в любом месте строки.<br />
<br />
== Печать в LibreOffice Writer из ГБ ==<br />
<br />
'''''Для осуществления экспорта данных из ПФ в документ Writer необходимо:'''''<br />
<br />
# Создать новую форму, выбрать вид формы Word-овая.<br />
# Настройка печатной формы в ГБ аналогична настройки формы для экспорта в MSWord.<br />
<br />
Файл-шаблон:<br />
<br />
# В поле «Имя файла-шаблона» указать файл с расширением «odt». <br />
# Создается документ-шаблон в Writer. <br />
<br />
Для передачи полей из ПФ используются поля двух типов: <br />
* Поле пользователя<br />
* Поле подстановки<br />
<br />
Формат для обоих типов полей «текст». Значения полей аналогичнs значениям полей в шаблоне формата MSWord.<br />
<br />
Пример: $GBDataSetBegin.DataSet<br />
<br />
Так же необходимо сохранять вложенность бэндов.<br />
<br />
ПРИМЕЧАНИЕ:<br />
<br />
Для вывода данных из ГБ в созданную в шаблоне таблицу поля вставлять не нужно, а описывать передаваемые из ГБ поля текстом.<br />
<br />
Например:<br />
<br />
{|cellspacing="0" cellpadding="10" border="1"<br />
!align="center"|Наименование товара<br />
!align="center"|Артикул<br />
|-<br />
|$GBDataSet.Goodies.SArtName<br />
|$GBDataSet.Goodies.SNumber<br />
|}<br />
<br />
[[File:Пример шаблона MsWord.doc]]</div>Alexeyhttp://wiki.gbsoft.ru/index.php?title=%D0%9F%D0%B5%D1%87%D0%B0%D1%82%D1%8C_%D0%B2_MSWord_%D0%B8_Open_Office_Writer&diff=3259Печать в MSWord и Open Office Writer2022-03-05T07:18:29Z<p>Alexey: /* Печать в MSWord из ГБ */</p>
<hr />
<div>[[Категория:Печатные формы]]<br />
<br />
== Печать в MSWord из ГБ ==<br />
<br />
<br />
'''''Для создания Word-ой формы необходимо:'''''<br />
<br />
# Создать новую форму, выбрать вид формы Word-овая.<br />
# В редакторе печатных форм в свойствах формы (свойства элемента: TGBWordReport) задать имя файла-шаблона, имя файла-результата. Если отмечена галочка «Внедрить», содержимое файла-шаблона сохранится в печатной форме.<br />
Остальные параметры установить как для основной печатной формы.<br />
<br />
<br />
'''''Для формирования печатной формы:'''''<br />
<br />
# В ПФ должны располагаться все необходимые [[Бэнд|бэнды]] для вывода нужной информации. Тип бэндов – Custom.<br />
# В каждом бэнде определяем поля, необходимые для передачи в документ Word.<br />
<br />
'''''Файл-шаблон:'''''<br />
<br />
Создается документ-шаблон формата MSWord. В документе часть данных – константы, то есть текст, а часть – динамически изменяющиеся значения. В тех местах, где должны выводиться эти значения, вставляются поля (пункт меню «Вставка» - «Поле…» - «Формула…»).<br />
<br />
Поле должно иметь следующий вид:<br />
* Для описания начала датасета – $GBDataSetBegin.DataSet.<br />
* Для описания поля (хранящего переданное из ГБ значение) – $GBField.DataSet.SName.<br />
* Для описания конца датасета - $GBDataSetEnd.DataSet.<br />
<br />
<br />
Необходимо соблюдать вложенность бэндов в шаблоне. Например источник товарных строчек документа должен быть «вложен» в границы описания источника полей документа.<br />
<br />
Пример:<br />
<br />
$GBDataSetBegin.DataSet<br />
:$GBField.DataSet.SDocNum<br />
::$GBDataSetBegin.Goodies<br />
:::$GBField.Goodies.SArt<br />
::$GBDataSetEnd.Goodies<br />
$GBDataSetEnd.DataSet<br />
<br />
В данном примере поля SDocNum, SArt определены в соответствующих бэндах печатной формы. Отступы приведены для наглядности, поля могут располагаться в любом месте строки.<br />
<br />
== Печать в OpenOffice.org Writer из ГБ ==<br />
<br />
'''''Для осуществления экспорта данных из ПФ в документ Writer необходимо:'''''<br />
<br />
# Создать новую форму, выбрать вид формы Word-овая.<br />
# Настройка печатной формы в ГБ аналогична настройки формы для экспорта в MSWord.<br />
<br />
Файл-шаблон:<br />
<br />
# В поле «Имя файла-шаблона» указать файл с расширением «odt». <br />
# Создается документ-шаблон в Writer. <br />
<br />
Для передачи полей из ПФ используются поля двух типов: <br />
* Поле пользователя<br />
* Поле подстановки<br />
<br />
Формат для обоих типов полей «текст». Значения полей аналогичнs значениям полей в шаблоне формата MSWord.<br />
<br />
Пример: $GBDataSetBegin.DataSet<br />
<br />
Так же необходимо сохранять вложенность бэндов.<br />
<br />
ПРИМЕЧАНИЕ:<br />
<br />
Для вывода данных из ГБ в созданную в шаблоне таблицу поля вставлять не нужно, а описывать передаваемые из ГБ поля текстом.<br />
<br />
Например:<br />
<br />
{|cellspacing="0" cellpadding="10" border="1"<br />
!align="center"|Наименование товара<br />
!align="center"|Артикул<br />
|-<br />
|$GBDataSet.Goodies.SArtName<br />
|$GBDataSet.Goodies.SNumber<br />
|}<br />
<br />
[[File:Пример шаблона MsWord.doc]]</div>Alexeyhttp://wiki.gbsoft.ru/index.php?title=JSON&diff=3258JSON2022-02-22T07:16:06Z<p>Alexey: </p>
<hr />
<div>{{Функция ГБ<br />
|Название=JSON<br />
|Описание=Формирование JSON из датасета или массива. Смотри также [[EVAL|парсинг JSON в массив]].<br />
|Синтаксис=JSON('''Источник данных''', `nulls`)<br />
|Аргументы=<br />
{{Аргумент<br />
|Название=Источник данных<br />
|Пояснение=датасет или ассоциативный массив, который требуется преобразовать в JSON<br />
}}<br />
{{Аргумент<br />
|Название=nulls<br />
|Пояснение=необязательный параметр. Если указана строка "nulls", то поля датасета (или элементы массива), имеющие значение ''null'', попадают в получаемый текст JSON. Если параметр не передан, поля со значением ''null'' в получаемом тексте JSON отсутствуют.<br />
}}<br />
|Результат=Текст JSON<br />
|Пример=<br />
Формирование JSON из массива, в котором элементы со значением ''null'' присутствуют<br />
'''JSON'''( [ `a` : 1, `b` : `текст`, `c` : 1/0 ], `nulls` )<br />
Результат:<br />
<nowiki>{"a":1,"b":"текст","c":null}</nowiki><br />
<br />
Формирование JSON из датасета, в котором элементы со значением ''null'' отсутствуют<br />
'''JSON'''( CreateDataSet(`ds`, [`a` : 1, `b` : `текст`, `c` : 1/0]) )<br />
Результат:<br />
<nowiki>{"a":1,"b":"текст"}</nowiki><br />
}}</div>Alexeyhttp://wiki.gbsoft.ru/index.php?title=JSON&diff=3257JSON2022-02-22T07:15:22Z<p>Alexey: </p>
<hr />
<div>{{Функция ГБ<br />
|Название=JSON<br />
|Описание=Формирование JSON из датасета или массива. Смотри также [[EVAL|парсинг JSON в массив]].<br />
|Синтаксис=JSON('''Источник данных''', `nulls`)<br />
|Аргументы=<br />
{{Аргумент<br />
|Название=Источник данных<br />
|Пояснение=датасет или ассоциативный массив, который требуется преобразовать в JSON<br />
}}<br />
{{Аргумент<br />
|Название=nulls<br />
|Пояснение=необязательный параметр. Если указана строка "nulls", то поля датасета (или элементы массива), имеющие значение ''null'', попадают в получаемый текст JSON. Если параметр не передан, поля со значением ''null'' в получаемом тексте JSON отсутствуют.<br />
}}<br />
|Результат=Текст JSON<br />
|Пример=<br />
Формирование JSON из массива, в котором элементы со значением ''null'' присутствуют<br />
'''JSON'''( [ `a` : 1,`b` : `текст`,`c`:1/0 ],`nulls` )<br />
Результат:<br />
<nowiki>{"a":1,"b":"текст","c":null}</nowiki><br />
<br />
Формирование JSON из датасета, в котором элементы со значением ''null'' отсутствуют<br />
'''JSON'''( CreateDataSet(`ds`, [`a` : 1, `b` : `текст`, `c` : 1/0]) )<br />
Результат:<br />
<nowiki>{"a":1,"b":"текст"}</nowiki><br />
}}</div>Alexeyhttp://wiki.gbsoft.ru/index.php?title=JSON&diff=3256JSON2022-02-22T07:14:03Z<p>Alexey: Новая страница: «{{Функция ГБ |Название=JSON |Описание=Формирование JSON из датасета или массива. |Синтаксис=JSON…»</p>
<hr />
<div>{{Функция ГБ<br />
|Название=JSON<br />
|Описание=Формирование JSON из датасета или массива.<br />
|Синтаксис=JSON('''Источник данных''', `nulls`)<br />
|Аргументы=<br />
{{Аргумент<br />
|Название=Источник данных<br />
|Пояснение=датасет или ассоциативный массив, который требуется преобразовать в JSON<br />
}}<br />
{{Аргумент<br />
|Название=nulls<br />
|Пояснение=необязательный параметр. Если указана строка "nulls", то поля датасета (или элементы массива), имеющие значение ''null'', попадают в получаемый текст JSON. Если параметр не передан, поля со значением ''null'' в получаемом тексте JSON отсутствуют.<br />
}}<br />
|Результат=Текст JSON<br />
Смотрите также [[EVAL|парсинг JSON в массив]]<br />
|Пример=<br />
Формирование JSON из массива, в котором элементы со значением ''null'' присутствуют<br />
'''JSON'''( [ `a` : 1,`b` : `текст`,`c`:1/0 ],`nulls` )<br />
Результат:<br />
<nowiki>{"a":1,"b":"текст","c":null}</nowiki><br />
<br />
Формирование JSON из датасета, в котором элементы со значением ''null'' отсутствуют<br />
'''JSON'''( CreateDataSet(`ds`, [`a` : 1, `b` : `текст`, `c` : 1/0]) )<br />
Результат:<br />
<nowiki>{"a":1,"b":"текст"}</nowiki><br />
}}</div>Alexeyhttp://wiki.gbsoft.ru/index.php?title=CREATEDATASET&diff=3255CREATEDATASET2022-01-13T07:07:23Z<p>Alexey: </p>
<hr />
<div>{{Функция ГБ<br />
|Название=CREATEDATASET<br />
|Описание=Создает датасет заданной структуры. Созданный датасет состоит из одной записи, поля и их значения определяются параметрами процедуры. Обычно используется для создания датасета параметров для функций AttachDataSet, OpenDataSet.<br />
|Синтаксис=CREATEDATASET('''Имя датасета''','''Описание структуры и значений''')<br />
|Аргументы=<br />
{{Аргумент<br />
|Название=Имя датасета<br />
|Пояснение=строка, определяющая имя создаваемого датасета.<br />
}}<br/>{{Аргумент<br />
|Название=Описание структуры и значений<br />
|Пояснение=строка, определяющая структуру датасета и значения его полей. Каждое поле описывается в виде: Имя поля,Тип,сущность,подпись="Значение". Описания полей между собой разделяются символом "<nowiki>|</nowiki>". Типы полей обозначаются буквами: I,F,D,S,B<BR>Начиная с версии ГБ 1.7.1.12 описание полей и значений можно передавать в виде ассоциативного массива:['Имя поля,Тип':'Значение','Имя поля,Тип':'Значение'].<BR><BR>Если в данном параметре указать имя другого датасета, то его данные будут скопированы в датасет, заданный в первом параметре, причём вычисляемые поля станут обычными (пригодится для передачи полей в процедуры)<br />
}}<br />
|Пример=Копирование датасета dsFrom в dsTo с преобразованием вычисляемых полей в обычные:<br />
CreateDataSet(`dsTo`,`dsFrom`)<br />
Создание датасета с описанием структуры в виде строки:<br />
CREATEDATASET('PParams','Node,I="0"<nowiki>|</nowiki>IStocks,S="4353;6659"<nowiki>|</nowiki>IOnDate,D="01.01.2001"')<br />
Создание датасета с описанием в виде ассоциативного массива:<br />
CREATEDATASET('PParams',['Node,I':'0','IStocks,S':'4353;6659','IOnDate,D':'01.01.2001'])<br />
}}<br />
'''Замечания''' <br />
*Если эта функция используется в добавленной колонке, то вместо символа ";" нужно использовать функцию Char(59). <br />
*Замечание: Строку, описывающую датасет, можно легко получить, запустив ГБ с ключом –packetlog (-packetlogfile) и выполнив нужный отчет. Параметры процедуры пишутся в лог в таком же формате.</div>Alexeyhttp://wiki.gbsoft.ru/index.php?title=CREATEDATASET&diff=3254CREATEDATASET2022-01-13T07:06:43Z<p>Alexey: </p>
<hr />
<div>{{Функция ГБ<br />
|Название=CREATEDATASET<br />
|Описание=Создает датасет заданной структуры. Созданный датасет состоит из одной записи, поля и их значения определяются параметрами процедуры. Обычно используется для создания датасета параметров для функций AttachDataSet, OpenDataSet.<br />
|Синтаксис=CREATEDATASET('''Имя датасета''','''Описание структуры и значений''')<br />
|Аргументы=<br />
{{Аргумент<br />
|Название=Имя датасета<br />
|Пояснение=строка, определяющая имя создаваемого датасета.<br />
}}<br/>{{Аргумент<br />
|Название=Описание структуры и значений<br />
|Пояснение=строка, определяющая структуру датасета и значения его полей. Каждое поле описывается в виде: Имя поля,Тип,сущность,подпись="Значение". Описания полей между собой разделяются символом "<nowiki>|</nowiki>". Типы полей обозначаются буквами: I,F,D,S,B<BR>Начиная с версии ГБ 1.7.1.12 описание полей и значений можно передавать в виде ассоциативного массива:['Имя поля,Тип':'Значение','Имя поля,Тип':'Значение'].<br />
<BR>Если в данном параметре указать имя другого датасета, то его данные будут скопированы в датасет, заданный в первом параметре, причём вычисляемые поля станут обычными (пригодится для передачи полей в процедуры)<br />
}}<br />
|Пример=Копирование датасета dsFrom в dsTo с преобразованием вычисляемых полей в обычные:<br />
CreateDataSet(`dsTo`,`dsFrom`)<br />
Создание датасета с описанием структуры в виде строки:<br />
CREATEDATASET('PParams','Node,I="0"<nowiki>|</nowiki>IStocks,S="4353;6659"<nowiki>|</nowiki>IOnDate,D="01.01.2001"')<br />
Создание датасета с описанием в виде ассоциативного массива:<br />
CREATEDATASET('PParams',['Node,I':'0','IStocks,S':'4353;6659','IOnDate,D':'01.01.2001'])<br />
}}<br />
'''Замечания''' <br />
*Если эта функция используется в добавленной колонке, то вместо символа ";" нужно использовать функцию Char(59). <br />
*Замечание: Строку, описывающую датасет, можно легко получить, запустив ГБ с ключом –packetlog (-packetlogfile) и выполнив нужный отчет. Параметры процедуры пишутся в лог в таком же формате.</div>Alexeyhttp://wiki.gbsoft.ru/index.php?title=%D0%90%D0%B2%D1%82%D0%BE%D0%BE%D0%B1%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5_%D0%B2%D0%B5%D1%80%D1%81%D0%B8%D0%B8&diff=3253Автообновление версии2021-12-22T07:36:27Z<p>Alexey: /* Описание */</p>
<hr />
<div>[[Категория:Касса]]<br />
<br />
Имеется возможность автоматического обновления приложения "ГБ Касса", файла настроек GbReg.ini, а также файла с настройками таблиц gbRegGrids.ini.<br />
<br />
Автообновление приложения осуществляется с HTTP сервера. Для настройки функции автообновления нужно в файл GbReg.ini добавить секцию [AutoUpdate] и настроить ряд параметров.<br />
<br />
==== Секция AutoUpdate ====<br />
[AutoUpdate]<br />
Enabled=1<br />
Version_URL=<nowiki>http://192.168.100.1/gbreg/update/version.txt</nowiki><br />
EXE_URL=<nowiki>http://192.168.100.1/gbreg/update/GbReg.zip</nowiki><br />
INI_URL=<nowiki>http://192.168.100.1/gbreg/update/ini.txt</nowiki><br />
GRIDS_INI_URL=<nowiki>http://192.168.100.1/gbreg/update/gridsini.txt</nowiki><br />
REPORT_URL=<nowiki>http://192.168.100.1/gbreg/post.php</nowiki><br />
iniversion=1.2<br />
Downloaded=2.1.1.10<br />
<br />
===== Описание параметров =====<br />
* '''Enabled'''<br>1 - разрешает автообновление; 0 - запрещает автообновление<br />
* '''Version_URL'''<br>Адрес, путь к файлу [[#Пример файла version.txt|version.txt]]. В этом файле содержится информация о версии GbReg.exe, версии файла настроек GbReg.ini, а так же список складов, для которых разрешено выполнить данное обновление.<br />
* '''EXE_URL'''<br>Адрес, путь к файлу GbReg.zip. Архив файла GbReg.exe. Формат архива - только ZIP.<br />
* '''INI_URL'''<br>Адрес, путь к файлу [[#Пример файла ini.txt|ini.txt]]. Файл ini.txt не является полной версией файла GbReg.ini, а содержит только те секции и параметры с их значениями, которые нужно изменить.<br />
* '''GRIDS_INI_URL'''<br>Адрес, путь к файлу gridsini.txt. Файл gridsini.txt является '''полной версией''' файла gbRegGrids.ini и при обновлении заменяется полностью.<br />
* '''REPORT_URL'''<br>Адрес, путь к скрипту post.php. После завершения процесса обновления на сервер посылается [[#Формат сообщения|сообщение]] об этом.<br />
* '''iniversion'''<br>Номер версии обновлений, применённых для файла GbReg.ini. Значение этого параметра устанавливается автоматически.<br />
* '''Downloaded'''<br>Номер версии файла GbReg.exe после последнего обновления. Значение этого параметра устанавливается автоматически.<br />
<br />
==== Пример файла version.txt ====<br />
version=2.1.1.11<br />
iniversion=1.3<br />
gridsiniversion=1.1<br />
stocks=10;11;12<br />
<br />
===== Описание =====<br />
* '''version'''<br>Номер версии файла GbReg.exe, который заархивирован и расположен на сервере.<br />
* '''iniversion'''<br>Номер версии изменений для GbReg.ini, которые расположены на сервере в файле ini.txt.<br />
* '''gridsiniversion'''<br>Номер версии для gbRegGrids.ini, которая расположена на сервере в файле gridsini.txt.<br />
* '''stocks'''<br>Список кодов складов (через ";"), для которых разрешено применить данное обновление. Вместо списка допустимо указать символ звёздочки "*" или оставить пустое значение. В этом случае обновления разрешены для всех складов.<br />
<br />
==== Пример файла ini.txt ====<br />
[DocParams]<br />
Firm=12345<br />
Stock=123<br />
<br />
===== Описание =====<br />
В этом примере при обновлении в файле GbReg.ini в секции [DocParams] будут изменены значения параметров Firm и Stock.<br />
<br />
==== Формат сообщения ====<br />
После завершения процесса обновления на сервер посылается сообщение, содержащее значения следующих полей:<br />
version=<br />
iniversion=<br />
stock=<br />
depot=<br />
ecrnum=</div>Alexeyhttp://wiki.gbsoft.ru/index.php?title=%D0%90%D0%B2%D1%82%D0%BE%D0%BE%D0%B1%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5_%D0%B2%D0%B5%D1%80%D1%81%D0%B8%D0%B8&diff=3252Автообновление версии2021-12-22T07:34:59Z<p>Alexey: </p>
<hr />
<div>[[Категория:Касса]]<br />
<br />
Имеется возможность автоматического обновления приложения "ГБ Касса", файла настроек GbReg.ini, а также файла с настройками таблиц gbRegGrids.ini.<br />
<br />
Автообновление приложения осуществляется с HTTP сервера. Для настройки функции автообновления нужно в файл GbReg.ini добавить секцию [AutoUpdate] и настроить ряд параметров.<br />
<br />
==== Секция AutoUpdate ====<br />
[AutoUpdate]<br />
Enabled=1<br />
Version_URL=<nowiki>http://192.168.100.1/gbreg/update/version.txt</nowiki><br />
EXE_URL=<nowiki>http://192.168.100.1/gbreg/update/GbReg.zip</nowiki><br />
INI_URL=<nowiki>http://192.168.100.1/gbreg/update/ini.txt</nowiki><br />
GRIDS_INI_URL=<nowiki>http://192.168.100.1/gbreg/update/gridsini.txt</nowiki><br />
REPORT_URL=<nowiki>http://192.168.100.1/gbreg/post.php</nowiki><br />
iniversion=1.2<br />
Downloaded=2.1.1.10<br />
<br />
===== Описание параметров =====<br />
* '''Enabled'''<br>1 - разрешает автообновление; 0 - запрещает автообновление<br />
* '''Version_URL'''<br>Адрес, путь к файлу [[#Пример файла version.txt|version.txt]]. В этом файле содержится информация о версии GbReg.exe, версии файла настроек GbReg.ini, а так же список складов, для которых разрешено выполнить данное обновление.<br />
* '''EXE_URL'''<br>Адрес, путь к файлу GbReg.zip. Архив файла GbReg.exe. Формат архива - только ZIP.<br />
* '''INI_URL'''<br>Адрес, путь к файлу [[#Пример файла ini.txt|ini.txt]]. Файл ini.txt не является полной версией файла GbReg.ini, а содержит только те секции и параметры с их значениями, которые нужно изменить.<br />
* '''GRIDS_INI_URL'''<br>Адрес, путь к файлу gridsini.txt. Файл gridsini.txt является '''полной версией''' файла gbRegGrids.ini и при обновлении заменяется полностью.<br />
* '''REPORT_URL'''<br>Адрес, путь к скрипту post.php. После завершения процесса обновления на сервер посылается [[#Формат сообщения|сообщение]] об этом.<br />
* '''iniversion'''<br>Номер версии обновлений, применённых для файла GbReg.ini. Значение этого параметра устанавливается автоматически.<br />
* '''Downloaded'''<br>Номер версии файла GbReg.exe после последнего обновления. Значение этого параметра устанавливается автоматически.<br />
<br />
==== Пример файла version.txt ====<br />
version=2.1.1.11<br />
iniversion=1.3<br />
gridsiniversion=1.1<br />
stocks=10;11;12<br />
<br />
===== Описание =====<br />
* '''version'''<br>Номер версии файла GbReg.exe, который заархивирован и расположен на сервере.<br />
* '''iniversion'''<br>Номер версии изменений для GbReg.ini, которые расположены на сервере в файле ini.txt.<br />
* '''gridsiniversion'''<br>Номер версии изменений для gbRegGrids.ini, которые расположены на сервере в файле gridsini.txt.<br />
* '''stocks'''<br>Список кодов складов (через ";"), для которых разрешено применить данное обновление. Вместо списка допустимо указать символ звёздочки "*" или оставить пустое значение. В этом случае обновления разрешены для всех складов.<br />
<br />
==== Пример файла ini.txt ====<br />
[DocParams]<br />
Firm=12345<br />
Stock=123<br />
<br />
===== Описание =====<br />
В этом примере при обновлении в файле GbReg.ini в секции [DocParams] будут изменены значения параметров Firm и Stock.<br />
<br />
==== Формат сообщения ====<br />
После завершения процесса обновления на сервер посылается сообщение, содержащее значения следующих полей:<br />
version=<br />
iniversion=<br />
stock=<br />
depot=<br />
ecrnum=</div>Alexey