Руководтсво администратора/разработчика

Документация

Язык быстрой разработки

@-функции

Дополнительные функции, доступные как в Buildbox Studio, так и в HTML-шаблонах. Используются для доступа к внешним параметрам запроса (из URL), системных данных (дата, время, данные пользователя) и других операций.


Синтаксис

Как использовать @-функции в формах

@-функции - это обычные функции, которые принимают параметры и производят вычисления. Написание не чувствительно к регистру, поэтому @Time(Now) и @time(now) идентичны.

Параметрами может служить значение, параметр (при использовании в шаблоне), так и другая @-функция.

Если параметром является строка, то параметр должен быть заключен в одиночные кавычки (').

Пример простого использования в Buildbox Studio

@FieldSrc(title,null)
>> null

Если значение не найдено.

Пример использования вложенной @-функции:

@SplitIndex(@Time(Now),'-',1,'разделение не возможно')

Пример использования внутри HTML-шаблона

Для использования @-функций в шаблонизаторе используется фунция dogparse, она вызывает обработку @-фукнции внутри HTML-шаблона

{{dogparse @FieldSrc(title,null) $.Request $Data}}
>> 2019-12-21T14-21-11Z-bc800b


@Rand

Выводит случайное числовое значение в интервале 0-999999


@Time

Работа со временем


@Path

Получаем значения системных полей объекта


@URL

получаем данные из URL-запроса

@URL(имя_параметра_URL, значение по-умолчанию)


@Obj

Получение значения параметров текущего объекта

@Obj(параметр, значение по-умолчанию) - значения параметров текущего объекта


@FieldValue

Получение выбранное/введенное значение аттрибутов текущего запроса

@FieldValue(id-поля на форме запроса) - получаем выбранное/введенное значение аттрибутов текущего запроса
 


@FieldSrc

Получение src-значения выбранного значения аттрибутов текущего запроса (только для полей-выбора)

Функция @FieldSrc получаем src-значение выбранного значения аттрибутов текущего запроса. Внимание! Только для полей-выбора (связь и множественная связь)

Формат

@FieldSrc id_field valuedefault
  • id_field - id (идентификатор) поля, значение которого мы хотим получить (из формы ввода или из контекста данных);
  • valuedefault - значение по-умолчанию, которое будет возвращено, в случае пустого значения функции.


@User

Получаем значение состояния текущего пользователя

@User(параметр, значение по-умолчанию)


@Role

Вывод данных о текущей роли пользователя

Позволяет получить доступ к данным роли пользователя