Функция языка запросов тип
Работа с типами в запросах
Значения типа Тип в запросах 1С могут использоваться при наложении условий, в сравнениях, упорядочивании и группировках. Для работы с типами предусмотрено несколько механизмов, которые покрывают все потребности разработчика. Рассмотрим их.
Функция ТИПЗНАЧЕНИЯ
Функция ТИПЗНАЧЕНИЯ имеет единственный параметр, куда передается значение, для которого требуется определить тип. Функция возвращает значения типа Тип. Чаще всего функция используется совместно с литералом ТИП в условиях запроса.
Рассмотрим примеры использования. Вывод в результат запроса типа Регистратора:
ТИПЗНАЧЕНИЯ( Закупки.Регистратор ) КАК ТипРегистратора
РегистрНакопления.Закупки КАК Закупки
Использование функции ТИПЗНАЧЕНИЯ в операции сравнения:
Закупки.Регистратор КАК Регистратор
РегистрНакопления.Закупки КАК Закупки
ТИПЗНАЧЕНИЯ( Закупки.Регистратор ) = ТИП( Документ.ПриобретениеТоваровУслуг )
Литерал ТИП
В литерал ТИП передается имя примитивного типа или таблицы ссылочного типа. Результатом конструкции будет значение типа Тип.
Примеры имен типов:
ТИП(Строка)
ТИП(Число)
ТИП( Перечисление.СтавкиНДС )
ТИП( Справочник.Номенклатура )
ТИП( Документ.ПриобретениеТоваровУслуг )
ТИП( ПланСчетов.Хозрасчетный )
ТИП( ПланОбмена.Полный )
Использование в запросе:
КОГДА ТИПЗНАЧЕНИЯ( Закупки.Регистратор ) = ТИП( Документ.ПриобретениеТоваровУслуг )
ТОГДА «Приобретение товаров»
КОНЕЦ КАК ТипИсточника
РегистрНакопления.Закупки КАК Закупки
Оператор ССЫЛКА
Оператор позволяет проверить, является ли значение выражения, указанного справа от него, ссылкой на таблицу, указанную слева. Результат оператора — значение типа Булево.
Закупки.Регистратор КАК Регистратор
РегистрНакопления.Закупки КАК Закупки
Закупки.Регистратор ССЫЛКА Документ.ПриобретениеТоваровУслуг
Для ссылочных таблиц оператор ССЫЛКА является эквивалентом сравнения
Остались вопросы?
Спросите в комментариях к статье.
3 комментария
Скажите, пжст, для оптимальной производительности что лучше использовать:
ТипЗначения() ИЛИ «Регистартор Ссылка Документ…»?
Если ТИП(Реквизит) вернул «Описание типов», как узнать языком запросов какой там тип допустим?
ТИП(Реквизит) возвращает не описание типов, а тип «Тип» (как в запросах, так и в коде). При написании запроса программист знает к какой таблице он обращается и какие типы допустимы в реквизитах выборки; для реквизитов с составным типом данных можно использовать условия Реквизит ССЫЛКА ИмяТипа или ТИПЗНАЧЕНИЯ(Реквизит) = ТИП(ИмяТипа). Примеры запросов можно посмотреть в статье.
ТИПЗНАЧЕНИЯ, ССЫЛКА, ТИП в запросах 1С 8.3 на примерах
В запросах 1С 8.3 существует две конструкции, которые позволяют работать с типами данных:
Несколько примеров
Предположим, что в нашей конфигурации существует документ «ПродажаТоваров».
Состав реквизитов следующий:
То есть покупки у нас может совершать, как сотрудник, так и сторонний покупатель.
Пример №1 — Получаем тип поля в результате запроса
Сделаем запрос к документу «ПродажаТоваров», в котором выберем все документы продажи где можно будет увидеть наименование покупателя, а с помощью функции ТИПЗНАЧЕНИЯ() в отдельной колонке определим тип покупателя.
ВЫБРАТЬ
ПродажаТоваров.Ссылка КАК ДокументПродажи,
ПродажаТоваров.Покупатель КАК Покупатель,
ТИПЗНАЧЕНИЯ(ПродажаТоваров.Покупатель) КАК ТипПокупателя
ИЗ
Документ.ПродажаТоваров КАК ПродажаТоваров
Результат запроса может выглядеть так:
Пример №2 — Отбор с помощью функций ССЫЛКА и ТИП(…)
Функцию ТИПЗНАЧЕНИЯ() удобно применять совместно с функцией ТИП( ), для проверки на соответствие определённому типу значения. Немного модифицируя запрос из примера №1, выведем записи только с теми документами, в которых тип покупателя сотрудник. Для наглядности оставим поле «ТипПокупателя».
ВЫБРАТЬ
ПродажаТоваров.Ссылка КАК ДокументПродажи,
ПродажаТоваров.Покупатель КАК Покупатель,
ТИПЗНАЧЕНИЯ(ПродажаТоваров.Покупатель) КАК ТипПокупателя
ИЗ
Документ.ПродажаТоваров КАК ПродажаТоваров
ГДЕ
ТИПЗНАЧЕНИЯ(Покупатель) = ТИП(Справочник.Сотрудники)
Стоит отметить, что аналогом такой связки ( ТИПЗНАЧЕНИЯ() + ТИП() ), исключительно для ссылочных типов данных, может служить оператор ССЫЛКА.
Тогда текст запроса мог бы выглядеть так:
ВЫБРАТЬ
ПродажаТоваров.Ссылка КАК ДокументПродажи,
ПродажаТоваров.Покупатель КАК Покупатель,
ТИПЗНАЧЕНИЯ(ПродажаТоваров.Покупатель) КАК ТипПокупателя
ИЗ
Документ.ПродажаТоваров КАК ПродажаТоваров
ГДЕ
Покупатель ССЫЛКА Справочник.Сотрудники
Пример №3 — Использование в конструкции ВЫБОР … КОГДА … КОНЕЦ
Также функция ТИПЗНАЧЕНИЯ() часто находит своё применение в конструкциях условного оператора «ВЫБОР».
Синтаксис оператора «ВЫБОР»:
Допустим, в нашей информационной базе предусмотрена система скидок в зависимости от типа покупателя. Если покупатель сотрудник делаем скидку 10%.
Используя связку, функция ТИПЗНАЧЕНИЯ() и условный оператор «ВЫБОР», можем рассчитать в запросе сумму со скидкой в отдельном поле.
Текст запроса может выглядеть так:
ВЫБРАТЬ
ПродажаТоваров.Ссылка КАК Ссылка,
ПродажаТоваров.Покупатель КАК Покупатель,
ПродажаТоваров.СуммаДокумента КАК СуммаДокумента,
ВЫБОР
КОГДА ТИПЗНАЧЕНИЯ(ПродажаТоваров.Покупатель) = ТИП(Справочник.Сотрудники)
ТОГДА ПродажаТоваров.СуммаДокумента — ПродажаТоваров.СуммаДокумента * 0.1
ИНАЧЕ ПродажаТоваров.СуммаДокумента
КОНЕЦ КАК СуммаСоСкидкой
ИЗ
Документ.ПродажаТоваров КАК ПродажаТоваров
К сожалению, мы физически не можем проконсультировать бесплатно всех желающих, но наша команда будет рада оказать услуги по внедрению и обслуживанию 1С. Более подробно о наших услугах можно узнать на странице Услуги 1С или просто позвоните по телефону +7 (499) 350 29 00. Мы работаем в Москве и области.
Функция языка запросов тип
Войдите как ученик, чтобы получить доступ к материалам школы
Язык запросов 1С 8.3 для начинающих программистов: функции и операторы для работы с типами (ТИПЗНАЧЕНИЯ, ТИП, ССЫЛКА, ЕСТЬNULL, ВЫРАЗИТЬ)
Автор уроков и преподаватель школы: Владимир Милькин
В языке запросов существует целый класс функций и операторов для работы с типами реквизитов. Давайте рассмотрим их.
Функция ТИПЗНАЧЕНИЯ
Эта функция принимает один параметр (значение) и возвращает его тип. Для описанного на картинке (выше) реквизита Вкус справочника Еда вернётся следующее:
Если мы запросим тип поля Наименование, то, как и ожидается, получим Строка:
А теперь давайте рассмотрим реквизит ОтличительныйПризнак у справочника Города:
Если мы попытаемся заполнить значение такого реквизита в режиме 1С:Предприятие, то система спросит нас, какого типа будет вводимое значение:
И только после нашего выбора позволит ввести значение выбранного типа.
Таким образом, элементы справочника одного вида (Справочник.Города) смогут хранить в одном и том же реквизите (ОтличительныйПризнак) значения разных типов (Строка, Цвета или Вкусы).
Вы можете убедиться в этом сами пощёлкав по элементам справочника Города в режиме 1С:Предприятие. Вы читаете ознакомительную версию урока, полноценные уроки находятся здесь.
Здесь значение отличительного признака является элементом справочника Вкусы:
А здесь вообще элементом справочника Цвета:
Вот какие возможности открывает перед нами составной тип данных!
Интересно, как поведёт себя функция ТИПЗНАЧЕНИЯ на реквизите ОтличительныйПризнак, имеющий составной тип данных:
Это уже очень интересно. Давайте разбираться с каждой строкой в отдельности.
Тип значения отличительного признака для элемента Россия равен NULL. Мы впервые сталкиваемся с этим типом. Значения данного типа используются исключительно для определения отсутствующего значения при работе с базой данных.
Так и есть, ведь элемент Россия является группой, а не обычным элементом справочника Города, поэтому у него отсутствует поле ОтличительныйПризнак. А тип у отсутствующего значения, как мы прочитали выше, всегда равен NULL.
Тип значения отличительного признака для Перми равен Вкусы. Так и есть, ведь значение отличительного признака забитое в базе для города Пермь является ссылкой на элемент справочника Вкусы.
Для Красноярска тип признака равен Цвета, потому что значение выбранное в базе является ссылкой на элемент справочника Цвета.
Для Воронежа тип признака равен Строка, потому что значение введенное в базе является обычной строкой.
Индия снова группа, поэтому значение отсутствует. А тип у отсутствующего значения, как мы помним, равен NULL.
Далее всё аналогично, кроме Сан-Паулу. Это не группа, а обычный элемент справочника (город), но тип его значения пустой. Как так?
С НЕОПРЕДЕЛЕНО мы также сталкиваемся впервые.
Значение НЕОПРЕДЕЛЕНО применяется, когда необходимо использовать пустое значение, не принадлежащее ни к одному другому типу. Это как раз наша ситуация.
А тип для значения, которое не принадлежит ни к одному из типов, как вы уже наверное догадались отсутствует.
Функция ТИП
Результатом данной конструкции будет значение типа Тип для указанного типа.
Давайте рассмотрим применение данной конструкции и всё сразу станет на свои места.
Пусть нам требуется отобрать все записи справочника Города, у которых составной реквизит ОтличительныйПризнак имеет значение типа СТРОКА:
Теперь давайте отберём все записи, у которых значения реквизита ОтличительныйПризнак являются ссылками на элементы справочника Цвета (таблица Справочник.Цвета):
Отступление
Как вы помните, некоторые элементы справочника Города не имеют реквизита ОтличительныйПризнак. Функция ТИПЗНАЧЕНИЯ для таких элементов выдаёт NULL.
Как можно сделать отбор таких элементов в запросе? Для этого предусмотрен специальный логический оператор ЕСТЬ NULL (не путать с функцией ЕСТЬNULL, которую мы рассмотрим ниже). Вы читаете ознакомительную версию урока, полноценные уроки находятся здесь.
Вот пример его использования:
Но есть и такие элементы (Сан-Паулу), у которых реквизит ОтличительныйПризнак (составного типа) просто не заполнен и равен специальному значению НЕОПРЕДЕЛЕНО.
Чтобы отобрать такие записи следует использовать другую конструкцию:
Но сравнение с НЕОПРЕДЕЛЕНО для определения пустых (не заполненных) реквизитов будет работать только для составных типов.
Кстати, у логического оператора ЕСТЬ NULL форма отрицания выглядит следующим образом:
Логический оператор ССЫЛКА
К примеру, давайте выберем из справочника Города только те записи, у которых значение составного реквизита ОтличительныйПризнак являются ссылкой на элемент справочника Вкусы:
Как вы помните, эту же задачу мы могли бы решить используя ТИПЗНАЧЕНИЯ и ТИП:
Функция ЕСТЬNULL
Функция предназначена для замены значения NULL на другое значение.
Мы помним, что значение NULL возвращается в том случае, если запрашиваемый реквизит (поле, свойство) не существует.
Как например, реквизит ОтличительныйПризнак для групп справочника Города:
Функция ЕСТЬNULL поможет нам вывести другое значение в том случае, если это значение равно NULL. Вы читаете ознакомительную версию урока, полноценные уроки находятся здесь. Пусть в данном случае это будет строка «Такого реквизита нет!»:
Получается, что если первый параметр функции ЕСТЬNULL не равен NULL, то возвращается он. Если же он равен NULL, то возвращается второй параметр.
Функция ВЫРАЗИТЬ
Как мы помним, составные поля могут быть одного из нескольких типов, указанных в конфигураторе.
Для поля ОтличительныйПризнак такими допустимыми типами являются СТРОКА, Справочник.Цвета и Справочник.Вкусы.
Иногда возникает необходимость привести значения составного поля к какому-либо определенному типу.
Давайте приведём все значения поля ОтличительныйПризнак к типу Справочник.Цвета:
В результате, все значения элементов, которые имели тип Справочник.Цвета, остались заполненными и оказались приведенными к указанному типу. Все значения других типов (СТРОКА, Справочник.Вкусы) теперь стали равны NULL. В этом состоит особенность приведения типа при помощи функции ВЫРАЗИТЬ.
Приводить тип можно или к примитивному типу (БУЛЕВО, ЧИСЛО, СТРОКА, ДАТА) или к ссылочному типу. Вы читаете ознакомительную версию урока, полноценные уроки находятся здесь. Но тип, к которому делается приведение, обязательно должен входить в список типов для данного составного поля, иначе система выдаст ошибку.
Все функции и конструкции языка запросов 1С 8.2 и 1с 8.3
В этой статье мы хотим обсудить с Вами все функции языка запросов 1с, а также конструкции языка запросов. Чем же отличается функция от конструкции? Функция вызывается со скобками и возможными параметрами в них, а конструкция пишется без скобок. Безусловно все конструкции и функции языка запросов 1с делают процесс получения данных гибким и многофункциональным. Данные функции и конструкции применимы к полям запроса, а некоторые также применимы в условиях.
Функции языка запросов 1с
Поскольку понятное описание функций языка запросов 1с встречается намного реже, чем описание конструкций, мы решили начать рассматривать именно функции. Теперь давайте разберем каждую по отдельности, описав ее назначение, синтаксис и пример использования, итак:
Синтаксис: ВЫБОР КОГДА ТОГДА ИНАЧЕ КОНЕЦ
Синтаксис: ВЫРАЗИТЬ(НазваниеПоля КАК НазваниеТипа)
Еще есть вариант использования функции ВЫРАЗИТЬ в полях смешанных типах, где такие встречаются? Самый простой пример это «Регистратор» у любого регистра. Так зачем нам может понадобиться уточнять тип в регистраторе? Давайте рассмотрим ситуацию когда мы из регистратора выбираем поле «Номер», из какой таблицы будет выбран номер? Правильный ответ из всех! Поэтому чтобы наш запрос работал быстро следует указывать явный тип с помощью функции ВЫРАЗИТЬ
Также отметим что тип NULL желательно ВСЕГДА заменять на какое-то значение, т.к. сравнение с типом NULL всегда дает ЛОЖЬ даже если вы сравниваете NULL с NULL. Чаще всего значения NULL образуются в результате соединения таблиц (все виды соединений кроме внутреннего).
Конструкции в языке запросов 1с
Выше мы рассмотрели с Вами функции языка запросов 1с, теперь пришло время рассмотреть конструкции в языке запросов 1с, они не менее важны и полезны, приступаем.
Синтаксис: В( ), В ИЕРАРХИИ( )
Варианты шаблона строки:
Синтаксис: РАЗРЕШЕННЫЕ пишется после ключевого слова ВЫБРАТЬ
Синтаксис: РАЗЛИЧНЫЕ пишется после ключевого слова ВЫБРАТЬ
Также Конструкция РАЗЛИЧНЫЕ может использоваться с оператором РАЗРЕШЕННЫЕ и другими операторами.
Синтаксис: ДЛЯ ИЗМЕНЕНИЯ
Синтаксис: УПОРЯДОЧИТЬ ПО АВТОУПОРЯДОЧИВАНИЕ
Синтаксис: ИНДЕКСИРОВАТЬ ПО
Синтаксис: ИТОГИ ПО
На рисунке обведены группировки которые образовались в ходе выполнения запроса, самая верхняя относится к секции ОБЩИЕ, а вторая к полю ДоговорКонтрагентаВидДоговора.
Функции языка запросов 1С 8.3
Функции ПРЕДСТАВЛЕНИЕ и ПРЕДСТАВЛЕНИЕССЫЛКИ
У реквизитов ссылочного типа есть виртуальное поле Представление, которое можно использовать в запросах. Оно позволяет получить основное представление ссылки, которое было настроено в конфигураторе:
Также можно использовать функцию ПРЕДСТАВЛЕНИЕ. Данная функция тоже получает основное представление ссылки. Если в нее передать не ссылку, а примитивный тип, то независимо от типа в результате будет получена строка.
Отличие виртуальное поля Представление от функции ПРЕДСТАВЛЕНИЕ в том, что функция ПРЕДСТАВЛЕНИЕ всегда вернет строку, даже если ей передать NULL, а в поле Представление может быть NULL, например, если ссылка была составного типа и текущий тип является примитивным.
Также есть функция ПРЕДСТАВЛЕНИЕССЫЛКИ. Она отличается от функции ПРЕДСТАВЛЕНИЕ только тем, что для ссылочного типа вернет строку, а для примитивного типа — значение того же типа. То есть для значения типа число тип результат будет число, для даты — дата, а для ссылки всегда строка.
Функция ЗНАЧЕНИЕ
Функция ЗНАЧЕНИЕ позволяет обращаться в тексте запроса к предопределенным данным, к перечислениям, к пустым ссылкам, к некоторым системным перечислениям:
Функцию ЗНАЧЕНИЕ можно использовать как в полях выборки, так и в предложении ГДЕ.
Функции работы с датами
В запросе можно от даты получить ее часть: секунду, минуту, час, день, неделю, месяц, квартал, год. А также день года и день недели:
В качестве параметра была передана дата 11.04.2021 11:20:50.
С помощью функций НАЧАЛОПЕРИОДА и КОНЕЦПЕРИОДА можно получить начало и конец минуты, часа, дня, недели, декады, месяца, квартала, полугодия, года:
Параметром также была передана дата 11.04.2021 11:20:50.
С помощью функции ДОБАВИТЬКДАТЕ можно добавлять к дате и вычитать из даты различные ее части: секунду, минуту, час, день, неделю, декаду, месяц, квартал, полугодие и год:
Параметром все также передавалась дата 11.04.2021.
Также можно использовать функцию РАЗНОСТЬДАТ для того чтобы получить разность между двумя датами. Разность может быть получена в секундах, минутах, часах, днях, месяцах, кварталах и годах. Вторым параметром передается дата из которой вычитаем, первым — которую вычитаем:
Дата1 = 11.04.2021, Дата2 = 01.05.2021.
Если второй параметр будет меньше первого, то результат будет отрицательным:
Дата1 = 11.04.2021, Дата2 = 01.05.2020.
Функция ПОДСТРОКА
Функция ПОДСТРОКА позволяет вырезать из строки какую-то часть. Первым параметром указывается сама строка. Вторым символ, начиная с которого нужно взять строку. Третьим количество символов. Например, если параметром передать строку «Подстрока в запросе» в следующий запрос:
То получим такой результат:
Если длина строки больше 1024 символов (например, реквизит неограниченной длины), то на нее нельзя накладывать условия в предложении ГДЕ (можно только через ПОДОБНО) и нельзя группировать по такому полю. Если попытаться это сделать, то будет ошибка «Неверные параметры в операции сравнения. Нельзя сравнивать поля
неограниченной длины и поля несовместимых типов.» или «Недопустимое поле для группировки ИмяПоля».
Чтобы обойти это ограничение можно использовать функцию ПОДСТРОКА, например: