OPENDATASET — различия между версиями

Материал из GB wiki
Перейти к: навигация, поиск
(Новая страница: «{{Функция ГБ |Название=OPENDATASET |Пояснение=Открывает датасета при помощи вызова процедуры, л…»)
 
Строка 1: Строка 1:
 
{{Функция ГБ
 
{{Функция ГБ
 
  |Название=OPENDATASET
 
  |Название=OPENDATASET
  |Пояснение=Открывает датасета при помощи вызова процедуры, либо путем импорта данных из файла (текстового, DBF, Excel, CDS)
+
  |Описание=Открывает датасет при помощи вызова процедуры, либо путем импорта данных из файла (текстового, DBF, Excel, CDS)
 
  |Синтаксис=OPENDATASET('''Имя процедуры''','''Датасет параметров''',Имя датасета)
 
  |Синтаксис=OPENDATASET('''Имя процедуры''','''Датасет параметров''',Имя датасета)
 
  |Аргументы={{Аргумент
 
  |Аргументы={{Аргумент
 
   |Название=Имя процедуры
 
   |Название=Имя процедуры
   |Пояснение=Строка, [[имя процедуры]] в БД, либо константа `file:` для импорта данных из файла, либо константа `copy:` для создания копии датасета параметров
+
   |Пояснение=Строка, имя процедуры в БД, либо константа `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`
)