RecordSet (J1C 0.0.78)

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

ru.j1c
Class RecordSet

java.lang.Object
  ru.j1c.RecordSet

All Implemented Interfaces:: Statement, Wrapper

public class RecordSet
extends Object
implements Statement
extends Object
implements Statement

Класс используется для работы с данными 1С "напрямую", посредством SQL языка.
Так как класс реализует интерфейс Statement доступна вся функциональность выражений SQL для работы с данными. Кроме того имеется возможность использования метаимен.
Метаимена - это расширение SQL языка, облегчающие работу с данными 1С. Синтаксис метаимен совместим в большей части с синтаксисом языка запросов 1CPP.
Пример работы:
String statement = "SELECT Обороты.Период , Обороты.Номенклатура as [Товар $Справочник.Номенклатура] FROM $РегистрОбороты.ОстаткиНаСкладах(:НачДата" + ",:КонДата,Неделя"+ ",LEFT JOIN $Справочник.Номенклатура AS Товар" + ",Товар.id = $Остатки.Номенклатура,,) AS Обороты"; RecordSet1C recordSet = getV7().getRecordSet(); ResultSet res = recordSet.executeQuery(statement); while(res.next()){ CatalogReference ref = res.getObject("Товар"); System.out.println(ref); } recordSet.close();
Далее описывается расширение языка запросов.

Типизация колонок типами 1С в тексте запроса

Для получения в наборе данных агрегатных типов 1С, возможна типизация колонок в тексте запроса. Для этого необходимо использовать специальный типизирующий псевдоним (алиас) колонки.
Формат типизирующего псевдонима:

[<ИмяПоля> $<Тип1С>]

ИмяПоля - имя, которое будет доступно для обращения к полю

Тип1С - строка, представляющая тип 1С, который будет назначен полю

Спецификация типизирующих имен

Типизирующее имя	Допустимые SQL типы в наборе данных	Целевой тип j1c
{Справочник\|Reference}	char(13)	`CatalogReference`
{Справочник\|Reference}<Справочник>	char(9)	`CatalogReference`
{Документ\|Document}<Справочник>	char(13) Char(9) - Идентификатор объекта, кроме того, в наборе данных должна находиться колонка с именем составленным из имени этой колонки и суффикса {_вид\|_kind} (чувствительно к регистру), в которой должны содержаться идентификаторы видов документов. Тип колонки SQL: int, DBF: char(4).	`DocumentReference`
{ВидДокумента\|DocumentKind}	int - вид документа SQL формат char(4) - вид документа SQL формат (база 36)	`Document`
{Перечисление\|Enum}<ВидПеречисления>	char(9)	`EnumerationReference`
{Неопределенный\|Undefine}	char(23)	`Undefine`
{ВидРасчета\|CalculationKind}	int - идентификатор в журнале расчетов SQL формат char(13) - в остальных таблицах, где вид расчета содержится как реквизит.	`пока не реализовано`
{Календарь\|Calendar}	char(13)	`CalendarReference`
{Субконто\|Subconto}	char(13) - идентификатор значения субконто (с видом или без вида). Типизируется в значение субконто, кроме того в наборе данных должна находиться колонка с именем составленным из имени этой колонки и суффикса {_вид\|_kind} (чувствительно к регистру), в которой должны содержаться идентификаторы видов субконто. Тип колонки SQL: int, DBF: char(4). Типизация субконто простых типов (число, строка, дата) не поддерживается.	`Object`
{ВидСубконто\|SubcontoKind}	int - идентификатор вида субконто в SQL формат в бухгалтерских таблицах char(4) - идентификатор вида субконто в SQL формат в бухгалтерских таблицах char(9) - идентификатор вида субконто в реквзитах других элементов	`Metadatas.SubcontoKind`

Получение имен таблиц

таблица справочника:

${Справочник|Reference}.<Справочник> = scXXXX

таблица шапок документов:

${Документ|Document}.<Документ> = dhXXXX

таблица строк документов:

${ДокументСтроки|DocumentStrings}.<Документ> = dtXXXX

таблица движений регистра:

${Регистр|Register}.<Регистр> = raXXXX

таблица итогов (остатков/оборотов) регистра:

${РегистрИтоги|RegisterTotals}.<Регистр> = rgXXXX

таблица журнала расчетов:

${ЖурналРасчетов|CalcJournal}.<ЖурналРасчетов> = cjXXXX

Получение имен полей

имя поля таблицы справочника:

${Справочник|Reference}.<Справочник>.<Реквизит> = spХХХХ

имя поля таблицы шапок документов:

${Документ|Document}.<Документ>.<РеквизитШапки> = spХХХХ

имя поля таблицы строк документов:

${ДокументСтроки|DocumentStrings}.<Документ>.<РеквизитТабличнойЧасти> = spХХХХ

имя поля таблицы движений регистра:

${Регистр|Register}.<Регистр>.<Измерение | Ресурс | Реквизит> = spХХХХ

имя поля таблицы итогов (остатков/оборотов) регистра:

${РегистрИтоги|RegisterTotals}.<Регистр>.<Измерение | Ресурс> = spХХХХ

имя поля по псевдониму таблицы:

$.<Реквизит | РеквизитШапки | РеквизитТабличнойЧасти | Измерение | Ресурс> = .spХХХХ

имя поля общего реквизита:

${ОбщийРеквизит|CommonProperty}.<ОбщийРеквизит> = spХХХХ

имя поля флага движений по регистру:

${ФлагРегистра|RegisterFlag}.<Регистр> = rfХХХХ

имя поля последовательности:

${Последовательность|Sequence}.<Последовательность> = dsХХХХ

имя поля реквизита журнала расчетов:

${ЖурналРасчетов|CalcJournal}.<ЖурналРасчетов>.<Реквизит> = spXXXX

пока не реализовано

имя поля графы отбора журнала расчетов:

${ГрафаЖурналаРасчетов|ColumnCalcJournal}.<ЖурналРасчетов>.<ГрафаОтбораЖР> = ffXXXX

пока не реализовано

имя поля реквизита проводки:

${Проводка|Entry}.<Реквизит> = spXXXX

имя поля реквизита операции:

${Операция|Operation}.<Реквизит> = spXXXX

Получение внутренних идентификаторов

идентификатор константы, зависит от формата ИБ: SQL - литерал типа int; DBF - литерал типа char(4):

${Константа|Constant}.<Константа> = XXXX

идентификатор вида справочника:

${ВидСправочника|ReferenceKind}.<Справочник> = ХХХХ ${ВидСправочника36|ReferenceKind36}.<Справочник> = 'ZZZZ'

идентификатор вида документа, зависит от формата ИБ: SQL - литерал типа int; DBF - литерал типа char(4):

${ВидДокумента|DocumentKind}.<Документ> = {XXXX | 'ZZZZ'} ${ВидДокумента36|DocumentKind36}.<Документ> = 'ZZZZ'

идентификатор вида перечисления char(4):

${ВидПеречисления36|EnumKind36}.<ВидПеречисления> = 'ZZZZ'

идентификатор периодического реквизита:

${ИсторияРеквизита|PropertyHistory}.<Справочник>.<ПериодическийРеквизит> = ХХХХ

идентификатор журнала документов:

${ЖурналДокументов|DocsJournal}.<ЖурналДокументов> = ХХХХ

идентификатор графы отбора:

${ГрафаОтбора|SelectionColumn}.<ГрафыОтбора> = ХХХХ

идентификатор календаря:

${Календарь|Calendar}.<Календарь> = ХХХХ

идентификатор праздников:

${Праздники|Holidays} = ХХХХ

пока не реализовано

идентификатор журнала расчетов:

${ВидЖурналаРасчетов|CalcJournalKind}.<ЖурналРасчетов> = XXXX

пока не реализовано

идентификатор вида расчета, зависит от формата ИБ: SQL - литерал типа int; DBF - литерал типа char(4):

${ВидРасчета|Algorithm}.<ВидРасчета> = {XXXX | 'ZZZZ'}

пока не реализовано

идентификаторы пустых значений (зависит от формата ИБ):

${ПустойИД|EmptyID} = ' 0 ' - SQL, ' 0' - DBF ${ПустойИД13|EmptyID13} = ' 0 0 ' - SQL, ' 0 0' - DBF

идентификатор значения перечисления:

${Перечисление|Enumeration}.<Перечисление>.<ЗначениеПеречисления> : char(9) ${Перечисление23|Enumeration23}.<Перечисление>.<ЗначениеПеречисления> : char(23)

идентификатор значения вида субконто, зависит от формата ИБ: SQL - литерал типа int; DBF - литерал типа char(4):

${ВидСубконто|SubcontoKind}.<Идентификатор> : {XXXX | 'ZZZZ'}

идентификатор значения плана счетов, зависит от формата ИБ: SQL - литерал типа int; DBF - литерал типа char(4):

${ПланСчетов|Plan}.<Идентификатор> : {XXXX | 'ZZZZ'}

идентификатор значения плана счетов char(4):

${ПланСчетов36|Plan36}.<Идентификатор> : 'ZZZZ'

идентификатор значения основного плана счетов, зависит от формата ИБ: SQL - литерал типа int; DBF - литерал типа char(4):

${ОсновнойПланСчетов|MainPlan}.<Идентификатор> : {XXXX | 'ZZZZ'}

идентификатор значения основного плана счетов char(4):

${ОсновнойПланСчетов36|MainPlan36}.<Идентификатор> : 'ZZZZ'

Правила обозначения модификаторов

В тексте запроса модификаторы обозначаются символами "~" или "*" после имени параметра. Количество символов "~" после имени параметра определяет номер модификатора. Если после имени параметра не указан модификатор, то номер модификатора равен 0. Так как типом "Неопределенный" (char(23)) можно выразить любой тип 1С, для этого существует специальный модификатор, обозначаемый символом "*", который определен для любого передаваемого типа 1С. Модификаторы определены для следующих типов 1С:

Строка: `String`

char() - строка как есть

Дата: `Date`

char(8) - каноническое представление даты
char(9) - каноническое представление даты + символ "Z" (используется для обозначения момента времени конца этой даты)
datetime - odbc формат представления даты вида {d'yyyy-MM-dd'}

Число: `Integer`, `BigDecimal`

char() - число как есть в строковом представлении
Зависит от формата ИБ

SQL: int - int число как есть
DBF: char(4) - в 36-й системе

Зависит от формата ИБ

SQL: int - int число как есть
DBF: char(6) - в 36-й системе

Позиция: `Position`

char(23) - cтрока вида date_time_iddoc yyyyMMddXXXXXXIIIIIIIII
- yyyy - год
- MM - месяц
- dd - день
- XXXXXX - в 36-ричном представлении число секунд умноженное на 10000
- IIIIIIIII - идентификатор документа

Агрегатные типы: `EnumerationReference`, `DocumentReference`, `CatalogReference`, `AccountReference`:

char(9) - внутренний идентификатор объекта (короткая строка 6+3)
char(13) - внутренний идентификатор объекта с видом (длинная строка 4+6+3)
char(15) - внутренний идентификатор объекта с видом и типом (2+4+6+3) (на самом деле такой тип нигде в 1С не используется, модификатор существует исключительно для обратной совместимости)
Зависит от формата ИБ

SQL: int - идентификатор вида объекта
DBF: char(4) - 36-й идентификатор вида объекта

char(23) - cтрока вида date_time_iddoc yyyyMMddXXXXXXIIIIIIIII. Должен быть передан DocumentReference
- yyyy - год
- MM - месяц
- dd - день
- XXXXXX - в 36-ричном представлении число секунд умноженное на 10000
- IIIIIIIII - идентификатор документа

Метаданные: `Metadatas.Qualifier`

Зависит от формата ИБ

SQL: int - идентификатор метаданных;
DBF: char(4) - 36-й идентификатор метаданных

Виртуальные таблицы оперативного учета

Виртуальная таблица остатков

Синтаксис

$РегистрОстатки.<ИмяРегистра>([<ГраницаРасчета>][, <Соединение>][, <Условие>][, <Измерение>][,<Ресурс>] ) [as <Алиас>]

Параметры

ГраницаРасчета - тип: значение. Строка, представляющая период. Если передан период времени, остатки рассчитываются на начало периода. По умолчанию остатки на точку актуальности.
Соединение - тип: конструкция типа join. На языке SQL можно описать дополнительные соединения с таблицами, которые могут быть необходимы для формирования условий в следующем параметре. Можно оперировать полями измерений регистра, обращаясь к ним по идентификатору 1С. По умолчанию отсутствует.
Условие - тип: конструкция типа where. На языке SQL можно описать условие для ограничения выборки. Можно оперировать полями измерений регистра, обращаясь к ним по идентификатору 1С, а также полями таблиц, соединения с которыми были описаны в предыдущем параметре. По умолчанию отсутствует.
Измерение - тип: конструкция типа список идентификаторов. Указывается список измерений, по которым нужно рассчитать остатки. По умолчанию по всем.
Ресурс - тип: конструкция типа список идентификаторов. Указывается список ресурсов, которые нужно рассчитать. По умолчанию по всем.

Параметры

<ИмяИзмерения> - имена измерений, указанных к расчету;
<ИмяРесурса>Остаток - имена ресурсов с добавлением слова Остаток, указанных к расчету.

Оптимизация расчета:

при получении остатков по ТА, используется только таблица итогов;
при получении остатков по дату конца периода сохранения остатков - используется только таблица итогов;
при получении остатков на дату начала периода сохранения остатков - используется только таблица итогов;
при получении остатков на дату начала или конца периода сохранения остатков, и расчет идет по всем измерениям - используется только таблица итогов без группирования (без предложения group by в запросе);
при получении остатков на или по дату, близкую к концу текущего периода - сохранения остатков, используются остатки на конец текущего периода и обороты от границы расчета до конца текущего периода (обратный расчет);
при получении остатков на или по дату в актуальном периоде сохранения остатков, близкую к дате ТА, используются актуальные остатки и обороты от границы расчета по ТА (обратный расчет).

Виртуальная таблица оборотов

Синтаксис:

$РегистрОбороты.<ИмяРегистра>([<НачалоПериода>][, <КонецПериода>][,<Периодичность>][, <Соединение>][, <Условие>][, <Измерение>][,<Ресурс>] ) [as <Алиас>]

Параметры

НачалоПериода - Строка, представляющая период. По умолчанию начало ведения учета.
КонецПериода Строка, представляющая период. Если передан период времени, он в расчет не включается. По умолчанию точка актуальности.
ПериодичностьКонструкция типа ключевое слово. Указывается дополнительный разворот итогов по периодичности. Задается один из следующих вариантов:
- Период - только за период (не разворачивать);
- Документ - разворачивать по документу;
- День - разворачивать по дням;
- Неделя - разворачивать по неделям;
- Месяц - разворачивать по месяцам;
- Квартал - разворачивать по кварталам;
- Год - разворачивать по годам.
Соединение Конструкция типа join. На языке SQL можно описать дополнительные соединения с таблицами, которые могут быть необходимы для формирования условий в следующем параметре. Можно оперировать полями измерений и реквизитов регистра, обращаясь к ним по идентификатору 1С. По умолчанию отсутствует.
Условие Конструкция типа where. На языке SQL можно описать условие для ограничения выборки. Можно оперировать полями измерений и реквизитов регистра, обращаясь к ним по идентификатору 1С, а также полями таблиц, соединения с которыми были описаны в предыдущем параметре. По умолчанию отсутствует.
Измерение Конструкция типа список идентификаторов. Указывается список измерений, по которым нужно рассчитать обороты. По умолчанию по всем.
Ресурс Конструкция типа список идентификаторов. Указывается список ресурсов, которые нужно рассчитать. По умолчанию по всем.

Поля

<ИмяИзмерения> - имена измерений указанных к расчету; тип определяется типом измерения регистра;
<ИмяРесурса>Приход - имена ресурсов с добавлением слова Приход, указанных к расчету; тип определяется типом ресурса регистра; существует только для регистра остатков;
<ИмяРесурса>Расход - имена ресурсов с добавлением слова Расход, указанных к расчету; тип определяется типом ресурса регистра; существует только для регистра остатков;
<ИмяРесурса>Оборот - имена ресурсов с добавлением слова Оборот, указанных к расчету; тип определяется типом ресурса регистра; существует только для регистра оборотов;
Период - тип datetime; дата начала периода, по которому происходит разворот оборотов; существует только в том случае, если указана периодичность День, Неделя, Месяц, Квартал, Год;
ПозицияДокумента - тип char(23); строка в формате date_time_iddoc (8+6+9); существует только в том случае, если указана периодичность Документ;

ВидДокумента - тип int; идентификатор вида документа; существует только в том случае, если указана периодичность Документ.

Оптимизация расчета

существует только для оборотного регистра;
при получении оборотов за период, в который входят один или несколько периодов сохранения оборотов - используется таблица итогов;
если период получения оборотов состоит только из периодов сохранения оборотов - используется только таблица итогов;
если заданная периодичность расчета позволяет использовать таблицу итоговм - она используется;
если в соединении или условии были использованы реквизиты регистра - оптимизация невозможна.

Виртуальная таблица остатков и оборотов

Синтаксис:

$РегистрОбороты.<ИмяРегистра>([<НачалоПериода>][, <КонецПериода>][,<Периодичность>][,<МетодДополнения>][, <Соединение>][, <Условие>][, <Измерение>][,<Ресурс>] ) [as <Алиас>]

Параметры

НачалоПериода - Строка, представляющая период. По умолчанию начало ведения учета.
КонецПериода Строка, представляющая период. Если передан период времени, он в расчет не включается. По умолчанию точка актуальности.
ПериодичностьКонструкция типа ключевое слово. Указывается дополнительный разворот итогов по периодичности. Задается один из следующих вариантов:
- Период - только за период (не разворачивать);
- Документ - разворачивать по документу;
- День - разворачивать по дням;
- Неделя - разворачивать по неделям;
- Месяц - разворачивать по месяцам;
- Квартал - разворачивать по кварталам;
- Год - разворачивать по годам.
МетодДополнения - Конструкция типа ключевое слово. Имеет смысл, только когда используется разворот по периодам. Задается один из следующих вариантов
- Движения (Actions) - в таблицу включаются обороты по каждому периоду движений, и текущие остатки только по тем комбинациям измерений, по которым были движения в период расчета
- ДвиженияИГраницыПериода (ActionsAndPeriodBoundaries) - в таблицу включаются обороты по каждому периоду движений и текущие остатки; также таблица дополняется записями о ненулевых остатках на начало и/или конец на границы периода расчета
Соединение Конструкция типа join. На языке SQL можно описать дополнительные соединения с таблицами, которые могут быть необходимы для формирования условий в следующем параметре. Можно оперировать полями измерений и реквизитов регистра, обращаясь к ним по идентификатору 1С. По умолчанию отсутствует.
Условие Конструкция типа where. На языке SQL можно описать условие для ограничения выборки. Можно оперировать полями измерений и реквизитов регистра, обращаясь к ним по идентификатору 1С, а также полями таблиц, соединения с которыми были описаны в предыдущем параметре. По умолчанию отсутствует.
Измерение Конструкция типа список идентификаторов. Указывается список измерений, по которым нужно рассчитать обороты. По умолчанию по всем.
Ресурс Конструкция типа список идентификаторов. Указывается список ресурсов, которые нужно рассчитать. По умолчанию по всем.

Поля

<ИмяИзмерения> - имена измерений указанных к расчету; тип определяется типом измерения регистра;

ИмяРесурса>НачальныйОстаток - имена ресурсов с добавлением слова НачальныйОстаток, указанных к расчету; тип определяется типом ресурса регистра;
<ИмяРесурса>Приход - имена ресурсов с добавлением слова Приход, указанных к расчету; тип определяется типом ресурса регистра; существует только для регистра остатков;
<ИмяРесурса>Расход - имена ресурсов с добавлением слова Расход, указанных к расчету; тип определяется типом ресурса регистра; существует только для регистра остатков;
<ИмяРесурса>КонечныйОстаток - имена ресурсов с добавлением слова НачальныйОстаток, указанных к расчету; тип определяется типом ресурса регистра;
Период - тип datetime; дата начала периода, по которому происходит разворот оборотов; существует только в том случае, если указана периодичность День, Неделя, Месяц, Квартал, Год;
ПозицияДокумента - тип char(23); строка в формате date_time_iddoc (8+6+9); существует только в том случае, если указана периодичность Документ;

ВидДокумента - тип int; идентификатор вида документа; существует только в том случае, если указана периодичность Документ.

Оптимизация расчета

по таблицам итогов и движений рассчитывается всегда только один из остатков, другой вычисляется из оборотов при агрегировании;
рассчитывается тот остаток (начальный/конечный), который получить легче, исходя из оптимизации расчета остатков, См. выше описание виртуальной таблицы остатков;

Виртуальные таблицы бухгалтерии

Таблица субконто (по которым устанвлен принзнак отбора)

Синтаксис

$БИСубконто [AS <Алиас>]

Поля:

<РеквизитПроводки> - идентификатор реквизита проводки.
Вид
Значение
Документ
ПозицияДокумента
НомерПроводки
НомерКорреспонденции

Описание:

Таблица отбора проводок по значению субконто. Связь с таблицей проводок рекомендуется по полям ПозицияДокумента, НомерПроводки, НомерКорреспонденции. Поле Вид определяет вид субконто данного значения. ВТ содержит информацию только по тем видам субконто, по которым в конфигураторе включён отбор. Базовая таблица (_1SSBSEL) не привязана к планам счетов, поэтому синтаксис не включает в себя идентификатор плана.

Пример использования:

См. пример к ВТ БИДвиженияССубконто.

Таблица движений с субконто

Синтаксис

$БИДвиженияССубконто.<ПланСчетов>([<НачалоПериода>], [<КонецПериода>], [<Соединение>], [<Условие>]) [AS <Алиас>]

Параметры:

НачалоПериода - Строка, представляющая период.
КонецПериода Строка, представляющая период.
Соединение - тип: конструкция типа join. На языке SQL можно описать дополнительные соединения с таблицами, которые могут быть необходимы для формирования условий в следующем параметре. Можно оперировать полями виртуальной таблицы, обращаясь к ним по идентификатору 1С. По умолчанию отсутствует.
Условие - тип: конструкция типа where. На языке SQL можно описать условие для ограничения выборки. Можно оперировать полями измерений виртуальной таблицы, обращаясь к ним по идентификатору 1С, а также полями таблиц, соединения с которыми были описаны в предыдущем параметре. По умолчанию отсутствует.

Поля:

<РеквизитПроводки> - идентификатор реквизита проводки.
Сумма
Валюта
ВалютаДт
ВалютаКт
Количество
КоличествоДт
КоличествоКт
ВалютнаяСумма
ВалютнаяСуммаДт
ВалютнаяСуммаКт
Активность - Признак активности проводки.
- ' ' - активная проводка
- '*' - неактивная проводка
Неактивные проводки не учитываются при расчете остатков и оборотов.
ПозицияДокумента
НомерСтроки
НомерПроводки
НомерКорреспонденции
Документ
СубконтоДт<НомерСубконто>
СубконтоДт<НомерСубконто>_вид
СубконтоКт<НомерСубконто>
СубконтоКт<НомерСубконто>_вид
СчетДт
СчетКт

Пример использования:
SELECT ПозицияДокумента , СчетДт [СчетДт $Счет.Основной] , СчетКт [СчетКт $Счет.Основной] , Валюта [Валюта $Справочник.Валюты] , СубконтоДт1 [СубконтоДт1 $Субконто] , СубконтоДт1_вид , СубконтоДт2 [СубконтоДт2 $Субконто] , СубконтоДт2_вид , СубконтоДт3 [СубконтоДт3 $Субконто] , СубконтоДт3_вид , СубконтоКт1 [СубконтоКт1 $Субконто] , СубконтоКт1_вид , СубконтоКт2 [СубконтоКт2 $Субконто] , СубконтоКт2_вид , СубконтоКт3 [СубконтоКт3 $Субконто] , СубконтоКт3_вид , Сумма , ВалютнаяСумма , Количество , СодержаниеПроводки FROM $БИДвиженияССубконто.Основной({d'2001-01-01'},, INNER JOIN $БИСубконто БИС ON (ПозицияДокумента = БИС.ПозицияДокумента) AND (НомерПроводки = БИС.НомерПроводки) AND (НомерКорреспонденции = БИС.НомерКорреспонденции), (БИС.Вид = $ВидСубконто.Контрагенты) AND(Активность = ' ') ) Проводки

Виртуальные значения

Получение начала периода

Синтаксис:

$НачалоПериода|BeginPeriod.<Период>(<ИсходнаяДата>[,<ТипПредставления>])

<Период> - ключевое слово:

День
Неделя
Месяц
Квартал
Год

Параметры

ИсходнаяДата - тип: конструкция типа выражение MS T-SQL; дата по которой определять период;
ТипПредставления - тип: конструкция типа ключевое слово; представление даты в первом параметре:

Строка - char(8);
Дата - datetime.

Получение начала следующего периода

Синтаксис:

$СледующийПериод|NextPeriod.<Период>(<ИсходнаяДата>[,<ТипПредставления>])

<Период> - ключевое слово:

День
Неделя
Месяц
Квартал
Год

Параметры

ИсходнаяДата - тип: конструкция типа выражение MS T-SQL; дата по которой определять период;
ТипПредставления - тип: конструкция типа ключевое слово; представление даты в первом параметре:

Строка - char(8);
Дата - datetime.

Получение наиболее позднего периодического значения

Синтаксис:

$ПоследнееЗначение.{<ИмяСправочника> | Константа}.{<ИмяРеквизита | ИмяКонстанты>}( <ИдОбъекта>, <Дата>[, <Время>[, <ИДДокумента>]] )

Параметры

ИдОбъекта - тип: конструкция типа выражение MS T-SQL; внутренний идентификатор элемента справочника, или 0 для константы;
Дата - тип: конструкция типа выражение MS T-SQL; дата, на которую нужно получить последнее значение;
Время - тип: конструкция типа выражение MS T-SQL; время, на которое нужно получить последнее значение;
ИДДокумента - тип: конструкция типа выражение MS T-SQL; идентификатор документа, на позицию которого нужно получить последнее значение.

Author:: max

Field Summary

Fields inherited from interface java.sql.Statement
`CLOSE_ALL_RESULTS, CLOSE_CURRENT_RESULT, EXECUTE_FAILED, KEEP_CURRENT_RESULT, NO_GENERATED_KEYS, RETURN_GENERATED_KEYS, SUCCESS_NO_INFO`

Method Summary

void addBatch(String sql)

void cancel()

void clearBatch()

void clearWarnings()

void close()

boolean execute()

boolean execute(String sql)

boolean execute(String sql, int autoGeneratedKeys)

boolean execute(String sql, int[] columnIndexes)

boolean execute(String sql, String[] columnNames)

int[] executeBatch()

ResultSet1C executeQuery()
Выполнить запрос.

ResultSet1C executeQuery(String sql)

int executeUpdate()
Выполнить запрос.

int executeUpdate(String sql)

int executeUpdate(String sql, int autoGeneratedKeys)

int executeUpdate(String sql, int[] columnIndexes)

int executeUpdate(String sql, String[] columnNames)

Connection getConnection()

int getFetchDirection()

int getFetchSize()

ResultSet getGeneratedKeys()

int getMaxFieldSize()

int getMaxRows()

boolean getMoreResults()

boolean getMoreResults(int current)

Object getParameter(String key)
Получить текстовый параметр

int getQueryTimeout()

ResultSet1C getResultSet()

int getResultSetConcurrency()

int getResultSetHoldability()

int getResultSetType()

String getText()
Получить текст запроса

int getUpdateCount()

V7 getV7()

SQLWarning getWarnings()

boolean isClosed()

boolean isPoolable()

boolean isWrapperFor(Class<?> iface)

String parse(String textQuery)
Преобразовать текст запроса из нотации j1c в t-sql Если какие параметры не установлены - вызывается исключение приложения

String parseBatch(String textQuery)
Преобразовать текст запроса из нотации j1c в t-sql Если какие параметры не установлены - вызывается исключение приложения

void setCursorName(String name)

void setEscapeProcessing(boolean enable)

void setFetchDirection(int direction)

void setFetchSize(int rows)

void setMaxFieldSize(int max)

void setMaxRows(int max)

void setParameter(String key, Object value)
Установить текстовый параметр запроса.

void setPoolable(boolean poolable)

void setQueryTimeout(int seconds)

void setRPC(boolean modRPC)
Переводит объект в специальный режим выполнения запросов.

void setText(String value)
Установить текст запроса





<T> T

unwrap(Class<T> iface)

Methods inherited from class java.lang.Object
`equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

Method Detail

getV7

public V7 getV7()

close

public void close()
           throws SQLException

Specified by:: close in interface Statement

Throws:: SQLException

setRPC

public void setRPC(boolean modRPC)

Переводит объект в специальный режим выполнения запросов. Когда этот режим включен, выполнение запроса происходит с помощью RPC вызова хранимой процедуры sp_executesql. (Подробнее о назначении этой ХП можно прочитать в BOL (Books Online)). В сущности это - режим парсера, а не режим этого объекта.
Метод допустимо применять только для источника данных Microsoft SQL Server; так как выполнение происходит по средствам вызова хранимой процедуры, в силе все особенности выполнения в теле хранимой процедуры. Например, если создавать временную таблицу, то запрос отработает, но таблица будет удалена сервером сразу после выполнения запроса (батча).

Parameters:: modRPC - Режим RPC. true - режим включен, false - выключен (по умолчанию, режим выключен)

parseBatch

public String parseBatch(String textQuery)

Преобразовать текст запроса из нотации j1c в t-sql Если какие параметры не установлены - вызывается исключение приложения

Parameters:: textQuery - запрос на j1c
Returns:: Запрос на t-sql
See Also:: ExceptionAPI

parse

public String parse(String textQuery)

Parameters:: textQuery - запрос на j1c
Returns:: Запрос на t-sql
See Also:: ExceptionAPI

setParameter

public void setParameter(String key,
                         Object value)

Установить текстовый параметр запроса. В запросе такой параметр предваряется ":". Например:

select * from $Справочник.Номенклатура as спр where спр.id=:Перем

Parameters:: key - Имя параметра в тексте запроса (без ":"); value - Значение параметра.

getParameter

public Object getParameter(String key)

Получить текстовый параметр

Parameters:: key - Имя параметра
Returns:: Значение параметра. Если параметр не установлен - null

getText

public String getText()

Получить текст запроса

Returns:: Текст запроса

setText

public void setText(String value)

Установить текст запроса

Parameters:: value - Текст запроса

executeUpdate

public int executeUpdate()
                  throws SQLException

Выполнить запрос. Используется в конструкциях с INSERT, UPDATE, DELETE Перед вызовом метода необходщимо установить методом setText(String)

Returns:: Количество обработанных строк
Throws:: SQLException

executeUpdate

public int executeUpdate(String sql)
                  throws SQLException

Specified by:: executeUpdate in interface Statement

Throws:: SQLException

execute

public boolean execute()
                throws SQLException

Throws:: SQLException

execute

public boolean execute(String sql)
                throws SQLException

Specified by:: execute in interface Statement

Throws:: SQLException

getResultSet

public ResultSet1C getResultSet()
                         throws SQLException

Specified by:: getResultSet in interface Statement

Throws:: SQLException

getUpdateCount

public int getUpdateCount()
                   throws SQLException

Specified by:: getUpdateCount in interface Statement

Throws:: SQLException

executeQuery

public ResultSet1C executeQuery()
                         throws SQLException

Выполнить запрос. Используется в конструкциях SELECT Перед вызовом метода необходщимо установить методом setText(String)

Returns:: Результат запроса
Throws:: SQLException

executeQuery

public ResultSet1C executeQuery(String sql)
                         throws SQLException

Specified by:: executeQuery in interface Statement

Throws:: SQLException

addBatch

public void addBatch(String sql)
              throws SQLException

Specified by:: addBatch in interface Statement

Throws:: SQLException

cancel

public void cancel()
            throws SQLException

Specified by:: cancel in interface Statement

Throws:: SQLException

clearBatch

public void clearBatch()
                throws SQLException

Specified by:: clearBatch in interface Statement

Throws:: SQLException

clearWarnings

public void clearWarnings()
                   throws SQLException

Specified by:: clearWarnings in interface Statement

Throws:: SQLException

execute

public boolean execute(String sql,
                       int autoGeneratedKeys)
                throws SQLException

Specified by:: execute in interface Statement

Throws:: SQLException

execute

public boolean execute(String sql,
                       int[] columnIndexes)
                throws SQLException

Specified by:: execute in interface Statement

Throws:: SQLException

execute

public boolean execute(String sql,
                       String[] columnNames)
                throws SQLException

Specified by:: execute in interface Statement

Throws:: SQLException

executeBatch

public int[] executeBatch()
                   throws SQLException

Specified by:: executeBatch in interface Statement

Throws:: SQLException

executeUpdate

public int executeUpdate(String sql,
                         int autoGeneratedKeys)
                  throws SQLException

Specified by:: executeUpdate in interface Statement

Throws:: SQLException

executeUpdate

public int executeUpdate(String sql,
                         int[] columnIndexes)
                  throws SQLException

Specified by:: executeUpdate in interface Statement

Throws:: SQLException

executeUpdate

public int executeUpdate(String sql,
                         String[] columnNames)
                  throws SQLException

Specified by:: executeUpdate in interface Statement

Throws:: SQLException

getConnection

public Connection getConnection()
                         throws SQLException

Specified by:: getConnection in interface Statement

Throws:: SQLException

getFetchDirection

public int getFetchDirection()
                      throws SQLException

Specified by:: getFetchDirection in interface Statement

Throws:: SQLException

getFetchSize

public int getFetchSize()
                 throws SQLException

Specified by:: getFetchSize in interface Statement

Throws:: SQLException

getGeneratedKeys

public ResultSet getGeneratedKeys()
                           throws SQLException

Specified by:: getGeneratedKeys in interface Statement

Throws:: SQLException

getMaxFieldSize

public int getMaxFieldSize()
                    throws SQLException

Specified by:: getMaxFieldSize in interface Statement

Throws:: SQLException

getMaxRows

public int getMaxRows()
               throws SQLException

Specified by:: getMaxRows in interface Statement

Throws:: SQLException

getMoreResults

public boolean getMoreResults()
                       throws SQLException

Specified by:: getMoreResults in interface Statement

Throws:: SQLException

getMoreResults

public boolean getMoreResults(int current)
                       throws SQLException

Specified by:: getMoreResults in interface Statement

Throws:: SQLException

getQueryTimeout

public int getQueryTimeout()
                    throws SQLException

Specified by:: getQueryTimeout in interface Statement

Throws:: SQLException

getResultSetConcurrency

public int getResultSetConcurrency()
                            throws SQLException

Specified by:: getResultSetConcurrency in interface Statement

Throws:: SQLException

getResultSetHoldability

public int getResultSetHoldability()
                            throws SQLException

Specified by:: getResultSetHoldability in interface Statement

Throws:: SQLException

getResultSetType

public int getResultSetType()
                     throws SQLException

Specified by:: getResultSetType in interface Statement

Throws:: SQLException

getWarnings

public SQLWarning getWarnings()
                       throws SQLException

Specified by:: getWarnings in interface Statement

Throws:: SQLException

isClosed

public boolean isClosed()
                 throws SQLException

Specified by:: isClosed in interface Statement

Throws:: SQLException

isPoolable

public boolean isPoolable()
                   throws SQLException

Specified by:: isPoolable in interface Statement

Throws:: SQLException

setCursorName

public void setCursorName(String name)
                   throws SQLException

Specified by:: setCursorName in interface Statement

Throws:: SQLException

setEscapeProcessing

public void setEscapeProcessing(boolean enable)
                         throws SQLException

Specified by:: setEscapeProcessing in interface Statement

Throws:: SQLException

setFetchDirection

public void setFetchDirection(int direction)
                       throws SQLException

Specified by:: setFetchDirection in interface Statement

Throws:: SQLException

setFetchSize

public void setFetchSize(int rows)
                  throws SQLException

Specified by:: setFetchSize in interface Statement

Throws:: SQLException

setMaxFieldSize

public void setMaxFieldSize(int max)
                     throws SQLException

Specified by:: setMaxFieldSize in interface Statement

Throws:: SQLException

setMaxRows

public void setMaxRows(int max)
                throws SQLException

Specified by:: setMaxRows in interface Statement

Throws:: SQLException

setPoolable

public void setPoolable(boolean poolable)
                 throws SQLException

Specified by:: setPoolable in interface Statement

Throws:: SQLException

setQueryTimeout

public void setQueryTimeout(int seconds)
                     throws SQLException

Specified by:: setQueryTimeout in interface Statement

Throws:: SQLException

isWrapperFor

public boolean isWrapperFor(Class<?> iface)
                     throws SQLException

Specified by:: isWrapperFor in interface Wrapper

Throws:: SQLException

unwrap

public <T> T unwrap(Class<T> iface)
         throws SQLException

Specified by:: unwrap in interface Wrapper

Throws:: SQLException

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

ru.j1c Class RecordSet

Типизация колонок типами 1С в тексте запроса

Получение имен таблиц

Получение имен полей

Получение внутренних идентификаторов

Правила обозначения модификаторов

Строка: String

Дата: Date

Число: Integer, BigDecimal

Позиция: Position

Агрегатные типы: EnumerationReference, DocumentReference, CatalogReference, AccountReference:

Метаданные: Metadatas.Qualifier

Виртуальные таблицы оперативного учета

Виртуальные таблицы бухгалтерии

Виртуальные значения

getV7

close

setRPC

parseBatch

parse

setParameter

getParameter

getText

setText

executeUpdate

executeUpdate

execute

execute

getResultSet

getUpdateCount

executeQuery

executeQuery

addBatch

cancel

clearBatch

clearWarnings

execute

execute

execute

executeBatch

executeUpdate

executeUpdate

executeUpdate

getConnection

getFetchDirection

getFetchSize

getGeneratedKeys

getMaxFieldSize

getMaxRows

getMoreResults

getMoreResults

getQueryTimeout

getResultSetConcurrency

getResultSetHoldability

getResultSetType

getWarnings

isClosed

isPoolable

setCursorName

setEscapeProcessing

setFetchDirection

setFetchSize

setMaxFieldSize

setMaxRows

setPoolable

setQueryTimeout

isWrapperFor

unwrap

ru.j1c
Class RecordSet

Строка: `String`

Дата: `Date`

Число: `Integer`, `BigDecimal`

Позиция: `Position`

Агрегатные типы: `EnumerationReference`, `DocumentReference`, `CatalogReference`, `AccountReference`:

Метаданные: `Metadatas.Qualifier`