Справка
Массивы
Массивы
Если в массиве содержится всего один объект, то можно обращаться напрямую к этому объекту, минуя его выбор через оператор [.first] или [.last].
Количество
Результат: Значение (текст, числа, дата)
Выдаёт количество элементов в массиве без учёта вложенных элементов.
Для получения количества с учётом вложенных элементов, используйте команду [Количество (учитывая дочерние элементы)]
Для получения количества с учётом вложенных элементов, используйте команду [Количество (учитывая дочерние элементы)]
Активные элементы подтаблицы
Аргументы:
- подтаблица
(название подтаблицы, обязательно к заполнению, записываетя через точку)
Результат: Массивы
Выдаёт массив всех подэлементов текущих объектов.
Например, попробуем получить перечень всех статей в категориях:
[cex.cat.rows.st.articles]
В данном примере можно также использовать метод [st] таблицы: [cex.cat.st.articles]
А теперь попробуем получить все статьи некоторых категорий:
Вначале выберем категории, помеченные нужным тегом
[tag=cex.tag.get('Интересное')]
Cделать это можно двумя способами:
1ый: [cats=cex.cat.gets($tag)]
2ой: [cats=$tag.linked]
(см. подробнее методы [linked] и [Выдать элементы по значению поля])
Далее, чтобы получить перечень статей этих категорий, напишем нашу команду:
[$cats.st.articles]
А теперь попробуем получить комментарии этих статей:
[$cats.st.articles.st.comments]
Например, попробуем получить перечень всех статей в категориях:
[cex.cat.rows.st.articles]
В данном примере можно также использовать метод [st] таблицы: [cex.cat.st.articles]
А теперь попробуем получить все статьи некоторых категорий:
Вначале выберем категории, помеченные нужным тегом
[tag=cex.tag.get('Интересное')]
Cделать это можно двумя способами:
1ый: [cats=cex.cat.gets($tag)]
2ой: [cats=$tag.linked]
(см. подробнее методы [linked] и [Выдать элементы по значению поля])
Далее, чтобы получить перечень статей этих категорий, напишем нашу команду:
[$cats.st.articles]
А теперь попробуем получить комментарии этих статей:
[$cats.st.articles.st.comments]
Элементы подтаблицы, доступные для пользователя
Аргументы:
- подтаблица
(название подтаблицы, обязательно к заполнению, записываетя через точку)
Аналог метода [Активные элементы подтаблицы], но выдаёт только элементы, доступные для обзора текущему пользователю (согласно политике доступов).
Элементы подтаблицы (быстрый доступ)
Аргументы:
- подтаблица
(специальный, обязательно к заполнению, записываетя через точку)
Результат: Массивы
Быстрая выборка элементов подтаблицы.
Пример: [$category.st_simple.articles]
Используется в том случае, когда основное требование к выборке - её скорость и минимальный объём потребляемой ОЗУ.
Пример: [$category.st_simple.articles]
Используется в том случае, когда основное требование к выборке - её скорость и минимальный объём потребляемой ОЗУ.
Выдать сортированные объекты подтаблицы
Аргументы:
- подтаблица
(название подтаблицы, обязательно к заполнению, записываетя через точку)
- поле сортировки (по возрастанию)
(Название одной из переменной (из всех таблиц системы), обязательно к заполнению)
- начальный элемент
(строка/число)
- количество
(строка/число)
Псевдонимы: stdesc
Результат: Массивы
Аналог метода [Активные элементы подтаблицы]
Выдаёт указанный диапазон элементов подтаблиц сортированных в определённом порядке.
[stasc] - отсортировать по возрастанию
[stdesc] - отсортировать по убыванию
Первый аргумент позволяет определить переменную, по которому производится сортировка.
Второй аргумент определяет количество пропущенных элементов, которые не войдут в итоговую выборку.
Третий аргумент определяет количество элементов в выборке.
Например:
[$cat.stdesc.articles('date',35,10)]
В данном случае произойдёт сортировка всех статей по переменной "Дата" по убыванию. А далее, будет выданы элементы с 35 по 44 (т.е. 10 элементов, начиная с 35).
Выдаёт указанный диапазон элементов подтаблиц сортированных в определённом порядке.
[stasc] - отсортировать по возрастанию
[stdesc] - отсортировать по убыванию
Первый аргумент позволяет определить переменную, по которому производится сортировка.
Второй аргумент определяет количество пропущенных элементов, которые не войдут в итоговую выборку.
Третий аргумент определяет количество элементов в выборке.
Например:
[$cat.stdesc.articles('date',35,10)]
В данном случае произойдёт сортировка всех статей по переменной "Дата" по убыванию. А далее, будет выданы элементы с 35 по 44 (т.е. 10 элементов, начиная с 35).
Следующий элемент, идущий за выбранным
Аргументы:
- элемент
(объект, обязательно к заполнению)
Результат: Объект
Выдаёт следующий элемент, который располагается в массиве сразу после указанного.
Например, у нас есть набор статей $articles:
[art=$articles.get('Интересная статья')]
[$articles.next($art)]
Выдаст следующую статью, идушую сразу за "Интересной статьёй".
Например, у нас есть набор статей $articles:
[art=$articles.get('Интересная статья')]
[$articles.next($art)]
Выдаст следующую статью, идушую сразу за "Интересной статьёй".
Выдать элемент по порядковому номеру
Аргументы:
- позиция
(строка/число, обязательно к заполнению)
Результат: Значение (текст, числа, дата)
Выдаёт элемент из массива по его позиции
([pos] у объекта, настраивается в административном кабинете)
([pos] у объекта, настраивается в административном кабинете)
Массив родителей элементов
Результат: Массивы
Возвращает массив родителей текущих элементов, исключающий дубли.
Элементы, которыми владеет текущий пользователь
Результат: Массивы
Выдаёт из исходного массива только те элементы, владельцем которых является текущий пользователь.
Массив значений полей
Аргументы:
- поле
(название переменной таблицы, обязательно к заполнению)
Результат: Массивы
Возвращает массив, состоящий из указанных переменных исходного массива.
Например, [$articles.sc.title] выдаст массив всех заголовков исходных статей.
Оператор работает только если в исходном массиве все объекты одного типа.
Для обработки разнотипового массива используйте оператор Массив значений полей (из разных таблиц)
Например, [$articles.sc.title] выдаст массив всех заголовков исходных статей.
Оператор работает только если в исходном массиве все объекты одного типа.
Для обработки разнотипового массива используйте оператор Массив значений полей (из разных таблиц)
Массив значений полей (из разных таблиц)
Аргументы:
- поле
(название переменной таблицы, обязательно к заполнению)
Аналог Массив значений полей, но разрешает использовать в качестве исходного массива объекты из разных таблиц (но при этом у них должна присутствовать указанная переменная).
Например:
[($articles+$pages).sc_mixed.title]
Выдаст массив заголовков всех страниц и статей.
Например:
[($articles+$pages).sc_mixed.title]
Выдаст массив заголовков всех страниц и статей.
Обрезка
Аргументы:
- количество
(строка/число, обязательно к заполнению)
Результат: Массивы
Возвращает указанное количество элементов из массива.
Удалить элемент по индексу
Аргументы:
- Индекс элемента
(строка/число, обязательно к заполнению)
Результат: Массивы
Удаляет элемент массива с указанным индексом
Оставить по одному элементу для каждого родителя (оставляет первый элемент)
Результат: Массивы
Оставляет только те элементы, чьи родители различаются.
Например, у нас есть массив статей из всех категорий (который можно получить с помощью команды [Активные элементы подтаблицы], например: [arts=cex.category.st.articles]).
Мы можем оставить по одной статье из каждой категории, с помощью нашего метода:
[$arts.one_for_each_owner]
Будет выбран первый попавшийся элемент для каждого родителя. Для выборки последнего элемента используйте команду [one_for_each_owner2]
Например, у нас есть массив статей из всех категорий (который можно получить с помощью команды [Активные элементы подтаблицы], например: [arts=cex.category.st.articles]).
Мы можем оставить по одной статье из каждой категории, с помощью нашего метода:
[$arts.one_for_each_owner]
Будет выбран первый попавшийся элемент для каждого родителя. Для выборки последнего элемента используйте команду [one_for_each_owner2]
Сложить все элементы массива
Результат: Значение (текст, числа, дата)
Складывает все элементы массива, при условии, что массив состоит из чисел.
Удалить элемент по порядковому номеру
Код: [del_num]
Аргументы:
- Номер элемента (первый элемент имеет номер 0)
(строка/число, обязательно к заполнению)
Результат: Массивы
Удалить повторяющиеся элементы
Аргументы:
- проверочное поле
(название переменной таблицы)
Результат: Массивы
Удаляет одинаковые элементы из исходного массива.
Если исходный массив состоит из объектов, то возможно указание переменной, по которым будет происходить сверка объектов.
Например, [$articles.deldouble('title')] вернёт только те статьи, у которых различаются заголовки.
Данный метод оставляет самый первый элемент из повторяющихся. Если необходимо оставлять последний элемент, используйте метод [Удалить повторяющиеся элементы (с конца)]
Если исходный массив состоит из объектов, то возможно указание переменной, по которым будет происходить сверка объектов.
Например, [$articles.deldouble('title')] вернёт только те статьи, у которых различаются заголовки.
Данный метод оставляет самый первый элемент из повторяющихся. Если необходимо оставлять последний элемент, используйте метод [Удалить повторяющиеся элементы (с конца)]
Поменять местами ключи и значения
Результат: Массивы
Меняет местами ключи и значения массива. Аналог array_flip для PHP.
Объеденить элементы
Аргументы:
- разделитель
(строка/число, обязательно к заполнению)
Псевдонимы: imp
Результат: Значение (текст, числа, дата)
Объединяет массив строк, вставляя между ними указанный разделитель.
Добавить элемент в массив
Код: [push]
Аргументы:
- новый элемент
(любой, обязательно к заполнению)
Результат: Массивы
Выдать элемент по значению поля
Результат: Объект
Выдаёт объект из массива, который имеет переменную с указанным значением.
Если переменная не указана, то производит поиск по всем переменным объекта.
Например, получим статью с заголовком "Интересная" - [$articles.get('title','Интересная')]
А теперь получим сотрудников, у которых хотя бы одно поле соответствует значению "Иван" - [$employers.get('Иван')]
Для получения множества значений, используйте оператор [gets]
Если переменная не указана, то производит поиск по всем переменным объекта.
Например, получим статью с заголовком "Интересная" - [$articles.get('title','Интересная')]
А теперь получим сотрудников, у которых хотя бы одно поле соответствует значению "Иван" - [$employers.get('Иван')]
Для получения множества значений, используйте оператор [gets]
Фильтр по условию
Аргументы:
- условия
(условие, обязательно к заполнению)
Результат: Массивы
Выдаёт те элементы массива, которые соответствуют условию. Если исходный массив содержит подобъекты, то фильтрует также и их.
В условии можно использовать оператор [cur], который будет означать текущий перебираемый элемент массива.
Например, отфильтруем статьи:
[cex.articles.rows .sel(cur.title=='Интересная' && cur.tags.get('новости') || cur.owner.title=='Авторские статьи')]
В условии можно использовать оператор [cur], который будет означать текущий перебираемый элемент массива.
Например, отфильтруем статьи:
[cex.articles.rows .sel(cur.title=='Интересная' && cur.tags.get('новости') || cur.owner.title=='Авторские статьи')]
Выдать элементы по значению поля
Результат: Массивы
Аналог метода [get], но выдаёт множество значений, совпадающих с условием.
Выбрать объекты
Аргументы:
- Игнорировать родителя
(логический, флаг ignore_owner)
- Проверять доступы
(логический, флаг check_auth)
- Подтаблица
(название подтаблицы)
- Условия поиска
(строка/число)
Возможные значения:
- : Нет;
- ignore_ex : Игнорировать экземпляр таблицы;
- ignore_module : Игнорировать модуль;
- Какие объекты возвращать
(строка/число)
Возможные значения:
- : Активные;
- disabled : Не активные;
- all : Все;
- Дополнительные условия
(строка/число)
Возможные значения:
- : Нет;
- return_owners : Вернуть родителей найденных объектов;
Результат: Массивы
Аналог метода таблицы [FIND]. Но производит поиск только между элементами исходного массива.
Выдать количество объектов
Аргументы:
- Игнорировать родителя
(логический, флаг ignore_owner)
- Подтаблица
(название подтаблицы)
- Условия поиска
(строка/число)
Возможные значения:
- : Нет;
- ignore_ex : Игнорировать экземпляр таблицы;
- ignore_module : Игнорировать модуль;
- Какие объекты возвращать
(строка/число)
Возможные значения:
- : Активные;
- disabled : Не активные;
- all : Все;
- Дополнительные условия
(строка/число)
Возможные значения:
- : Нет;
- return_owners : Вернуть родителей найденных объектов;
Результат: Значение (текст, числа, дата)
Аналог метода таблицы [FIND_COUNT]. Но производит поиск только между элементами исходного массива.
Выдать указатель на SQL запрос
Аргументы:
- Игнорировать родителя
(логический, флаг ignore_owner)
- Проверять доступы
(логический, флаг check_auth)
- Подтаблица
(название подтаблицы)
- Условия поиска
(строка/число)
Возможные значения:
- : Нет;
- ignore_ex : Игнорировать экземпляр таблицы;
- ignore_module : Игнорировать модуль;
- Какие объекты возвращать
(строка/число)
Возможные значения:
- : Активные;
- disabled : Не активные;
- all : Все;
- Дополнительные условия
(строка/число)
Возможные значения:
- : Нет;
- return_owners : Вернуть родителей найденных объектов;
Аналог метода таблицы [FIND_POINTER]. Но производит поиск только между элементами исходного массива.
Поиск по индексируемым полям
Аргументы:
- искомая фраза
(строка/число, обязательно к заполнению)
- строгость поиска
(строка/число)
Возможные значения:
- strict : Строгий;
- regular : Обычный;
- easy : Облегчённый;
- поля поиска
(массив названий переменных таблицы)
Результат: Массивы
Производит поиск морфологический по индексируемым переменным указанных объектов. Результаты группируются в соответствии с релевантностью запроса (соответствия поискового запроса данным объекта).
В аргументах можно указать строгость поиска (strict, regular и easy), а также указать переменные, которыми будет ограничен поиск.
Для качественного отображения найденной информации можно использовать оператор [highlight] и [highlight_only]. Первый выдаст куски текста, связанные с запросом, а вторая только подсветит их в общем тексте.
В аргументах можно указать строгость поиска (strict, regular и easy), а также указать переменные, которыми будет ограничен поиск.
Для качественного отображения найденной информации можно использовать оператор [highlight] и [highlight_only]. Первый выдаст куски текста, связанные с запросом, а вторая только подсветит их в общем тексте.
Линейный фильтр
Аргументы:
- условия
(условие, обязательно к заполнению)
Результат: Массивы
Аналог оператора [Фильтр по условию], но проводит поиск без учёта вложенных объектов.
Линейный фильтр по дереву
Аргументы:
- условия
(условие, обязательно к заполнению)
Результат: Массивы
Аналог оператора [Фильтр по условию], но перед поиском формирует из дерева объектов единый массив и далее работает с ним как с линейным.
Если использовать обычный [sel], то в его результаты не подойдут вложенные объекты, чьи родители не соответствуют условиям. Для таких случаев следует использовать команду [lsel].
Если использовать обычный [sel], то в его результаты не подойдут вложенные объекты, чьи родители не соответствуют условиям. Для таких случаев следует использовать команду [lsel].
Случайная сортировка
Аргументы:
- количество элементов в результате
(строка/число)
Результат: Массивы
Сортирует массив случайным образом. Если указан аргумент, то ограничивает итоговый массив этим значением.
Например: [cex.articles.rows.rand(5)]
выдаст 5 случайных статей
Например: [cex.articles.rows.rand(5)]
выдаст 5 случайных статей
В приведённом примере выгодней использовать оператор [Выбрать объекты], чтобы не загружать оперативную память сервера.
Это будет выглядеть так:
[cex.articles.find.sort(rand).limit(5)]
Это будет выглядеть так:
[cex.articles.find.sort(rand).limit(5)]
Сортировать по выражению
Аргументы:
- выражение
(команда, обязательно к заполнению)
Результат: Массивы
Перебирает массив и для каждого его элемента выполняет аргумент сортировки.
Затем сортирует исходный массив согласно полученным значениям.
В выражении сортировки можно использовать метод [cur] (или [value], если исходный массив не состоит из объектов), который будет означать текущий объект
Например, давайте отсортируем статьи по дате и заголовку:
[$articles.sort(cur.date++cur.title)]
А теперь отсортируем статьи по дате добавления:
[$articles.sort(cur.creation_date.day3)]
А теперь по имени автора:
[$articles.sort(cur.user.name)]
Затем сортирует исходный массив согласно полученным значениям.
В выражении сортировки можно использовать метод [cur] (или [value], если исходный массив не состоит из объектов), который будет означать текущий объект
Например, давайте отсортируем статьи по дате и заголовку:
[$articles.sort(cur.date++cur.title)]
А теперь отсортируем статьи по дате добавления:
[$articles.sort(cur.creation_date.day3)]
А теперь по имени автора:
[$articles.sort(cur.user.name)]
Сортировка
Аргументы:
- поля сортировки
(массив названий переменных таблицы)
Псевдонимы: order
Результат: Массивы
Сортирует массив согласно указанным в аргументе переменным. Можно указать несколько переменных через запятую.
Например: [$articles.asc('title,date')]
Обратите внимание на то, что перечисление переменных в этом операторе происходит внутри кавычек.
Вместо названия переменной можно использовать следующие значения:
id - идентификатор объекта
pos - позиция в кабинете администратора
owner - объект-родитель
user - основной пользователь-владелец объекта
Для обратной сортировки можно использовать метод [Обратная сортировка].
Например: [$articles.asc('title,date')]
Обратите внимание на то, что перечисление переменных в этом операторе происходит внутри кавычек.
Вместо названия переменной можно использовать следующие значения:
id - идентификатор объекта
pos - позиция в кабинете администратора
owner - объект-родитель
user - основной пользователь-владелец объекта
Для обратной сортировки можно использовать метод [Обратная сортировка].
Обратная сортировка
Аргументы:
- поля сортировки
(массив названий переменных таблицы)
Результат: Массивы
Метод, аналогичный [Сортировка], но выполняющий сортировку по убыванию (в обратном порядке).
Обратная сортировка по ключам
Результат: Массивы
Сортирует массив по его ключам в обратном порядке
Функции
Исполняет функцию.
В качестве главной переменной функции назначается результат выполнения предыдущей цепочки операторов.
Более подробно смотрите в [_function]
В качестве главной переменной функции назначается результат выполнения предыдущей цепочки операторов.
Более подробно смотрите в [_function]
Компоненты
Исполняет компонент.
В качестве главной переменной компонента назначается результат выполнения предыдущей цепочки операторов.
Более подробно смотрите в [_function]
В качестве главной переменной компонента назначается результат выполнения предыдущей цепочки операторов.
Более подробно смотрите в [_function]
Отображения
Исполняет отображение.
В качестве главной переменной отображения назначается результат выполнения предыдущей цепочки операторов.
Более подробно смотрите в [_function]
В качестве главной переменной отображения назначается результат выполнения предыдущей цепочки операторов.
Более подробно смотрите в [_function]
Формы
Исполняет форму.
В качестве главной переменной формы назначается результат выполнения предыдущей цепочки операторов.
Более подробно смотрите в [_function]
В качестве главной переменной формы назначается результат выполнения предыдущей цепочки операторов.
Более подробно смотрите в [_function]
Части
Исполняет часть из текущего модуля.
В качестве главной переменной части назначается результат выполнения предыдущей цепочки операторов.
Более подробно смотрите в [_function]
В качестве главной переменной части назначается результат выполнения предыдущей цепочки операторов.
Более подробно смотрите в [_function]
Подгрузка
Результат: Массивы
Загрузить в оперативную память сервера из БД указанные поля.
Данная операция осуществляется автоматически для оператора [tree] следующим образом. При первой и второй итерациях цикла определяются используемые переменные, после чего происходит автоматическая подгрузка аналогичных переменных для всех остальных объектов.
В качестве аргументов может быть перечисление переменных, а также [*] (все поля) и [sub:name] (подгрузить все подобъекты из указанной подтаблицы).
Если указана подгрузка объектов из подтаблиц, то результатом функции будет являться массив, состоящий из этих подобъектов. Если вместо [sub] указать [sub2], то результатом будет исходный массив.
Пример подготовки переменных, на статьях в категориях:
[cex.category.rows
.prepare('title','sub:articles')
.prepare('title','anons')]
Первая [prepare] подготовит заголовки категорий и массив всех статей, а вторая будет работать уже над массивом всех статей и подготовит заголовки и анонсы всех статей.
Данная операция осуществляется автоматически для оператора [tree] следующим образом. При первой и второй итерациях цикла определяются используемые переменные, после чего происходит автоматическая подгрузка аналогичных переменных для всех остальных объектов.
В качестве аргументов может быть перечисление переменных, а также [*] (все поля) и [sub:name] (подгрузить все подобъекты из указанной подтаблицы).
Если указана подгрузка объектов из подтаблиц, то результатом функции будет являться массив, состоящий из этих подобъектов. Если вместо [sub] указать [sub2], то результатом будет исходный массив.
Пример подготовки переменных, на статьях в категориях:
[cex.category.rows
.prepare('title','sub:articles')
.prepare('title','anons')]
Первая [prepare] подготовит заголовки категорий и массив всех статей, а вторая будет работать уже над массивом всех статей и подготовит заголовки и анонсы всех статей.
Исполнить оператор
Аргументы:
- оператор
(команда, обязательно к заполнению)
Результат: различный
Оператор, аналогичный оператору [with] в обработчиках значений.
Позволяет исполнить оператор, в котором будет существовать команда [value], означающая текущий массив.
Например:
[$array.with(value.count)]
будет аналогична
[$array.count]
Следует использовать для сохранения цепочек в сложных ситуациях.
Позволяет исполнить оператор, в котором будет существовать команда [value], означающая текущий массив.
Например:
[$array.with(value.count)]
будет аналогична
[$array.count]
Следует использовать для сохранения цепочек в сложных ситуациях.
Применение оператора ко всем элементам массива
Аргументы:
- оператор
(команда, обязательно к заполнению)
Псевдонимы: tree, each
Результат: Значение (текст, числа, дата)
Применяет указанный оператор ко всем элементам массива.
Если массив состоит из объектов, то в операторе можно использовать команду [cur], означающую текущий перебираемый объект.
Если массив не состоит из объектов, то следует вместо [cur] использовать команду [value].
Если оператор возвращает текст, то команда [walk] вернёт результат, полученную путём сложения всех текстов.
Если массив состоит из объектов, то в операторе можно использовать команду [cur], означающую текущий перебираемый объект.
Если массив не состоит из объектов, то следует вместо [cur] использовать команду [value].
Если оператор возвращает текст, то команда [walk] вернёт результат, полученную путём сложения всех текстов.
Составить новый массив, применяя указанный оператор
Аргументы:
- оператор
(команда, обязательно к заполнению)
Результат: Массивы
Применяет указанный оператор ко всем элементам массива. Из результатов работы оператора составляет новый массив и возвращает его.
Читать далее про "Модуль"
