OPENDATASET — различия между версиями
Материал из GB wiki
Bars (обсуждение | вклад) (Новая страница: «{{Функция ГБ |Название=OPENDATASET |Пояснение=Открывает датасета при помощи вызова процедуры, л…») |
Bars (обсуждение | вклад) |
||
Строка 1: | Строка 1: | ||
{{Функция ГБ | {{Функция ГБ | ||
|Название=OPENDATASET | |Название=OPENDATASET | ||
− | | | + | |Описание=Открывает датасет при помощи вызова процедуры, либо путем импорта данных из файла (текстового, DBF, Excel, CDS) |
|Синтаксис=OPENDATASET('''Имя процедуры''','''Датасет параметров''',Имя датасета) | |Синтаксис=OPENDATASET('''Имя процедуры''','''Датасет параметров''',Имя датасета) | ||
|Аргументы={{Аргумент | |Аргументы={{Аргумент | ||
|Название=Имя процедуры | |Название=Имя процедуры | ||
− | |Пояснение=Строка, | + | |Пояснение=Строка, имя процедуры в БД, либо константа `file:` для импорта данных из файла, либо константа `copy:` для создания копии датасета параметров. |
+ | Имя процедуры может иметь вид ''GBDB://База/Процедура'' для осуществления [[Распределенные вызовы|распределенных вызовов]] либо ''GBTCP://Адрес:Порт/Процедура'' для вызова метода [[Бизнес-сервер|бизнес-сервера]] | ||
}} | }} | ||
{{Аргумент | {{Аргумент |
Версия 15:59, 9 апреля 2010
Открывает датасет при помощи вызова процедуры, либо путем импорта данных из файла (текстового, DBF, Excel, CDS)
Синтаксис
OPENDATASET(Имя процедуры,Датасет параметров,Имя датасета)
Аргументы
- Имя процедуры
- Строка, имя процедуры в БД, либо константа `file:` для импорта данных из файла, либо константа `copy:` для создания копии датасета параметров.
Имя процедуры может иметь вид GBDB://База/Процедура для осуществления распределенных вызовов либо GBTCP://Адрес:Порт/Процедура для вызова метода бизнес-сервера
- Датасет параметров
- Строка, имя либо описание датасета, хранящего параметры процедуры либо параметры импорта
Параметры импорта файлов:
- FileType – строка, тип файла (TXT,CSV,DBF,XLS,CDS)
- FileName – строка, имя файла
- FieldsMap – строка, список формул вида имя[подпись,тип]=выражение через «;», определяющих поля создаваемого датасета и их вычисление через поля исходного файла
- Filter – выражение для фильтрации строк исходного файла
- Separator – строка, разделитель полей в текстовом файле
- Tabs – строка, список отступов полей в текстовом файле начиная с 0 через “;”
- Comment – строка, символ комментария в текстовом файле, при встрече которого в начале строки нужно эту строку игнорировать
- CP866 – строка, любое непустое значение означает, что текстовый файл в досовской кодировке
- WIN1251 – строка, любое непустое значение означает, что DBF файл в кодировке windows
- StartLine – число, номер строки с которой начинается импорт (первая строка – 0)
- EndLine – число, номер строки которой заканчивается импорт (отрицательное число означает что не нужно импортировать соответствующее число последних строк).
- StopIfEmpty – строка, любое непустое значение означает, что нужно остановить импорт, встретив пустую строку
- Sheet – строка, название листа для импорта из Excel
- Имя датасета
- Строка, определяющая имя создаваемого датасета. Если не задана, датасет не будет создан (используется, если нам не интересно, что вернула процедура).
Тип результата
- Нет
Примеры
OPENDATASET(
`Documents_PeriodRegistry`,
`DDoc`, `Res`
)