Метод GetRowsByTemplate позволяет получить данные, используя SQL-шаблон. Для использования шаблона необходимо, чтобы он был создан в веб-интерфейсе платформы. Шаблон может содержать любой валидный SQL-запрос, который возвращает записи (SELECT-запрос). Возможно создавать запросы с параметрами.

1. Сигнатура метода

rows = GetRowsByTemplate(template, parameters)

Параметры метода

Параметр Тип Описание
template string Обязательный. Имя шаблона
parameters
array of Param objects Необязательный. Массив объектов, определяющих параметры шаблона. Можно не указывать, если в шаблоне нет параметров.
rows
array of rows Возвращает значение. Массив записей. Каждая запись - это массив пар “ключ => значение” (“имя столбца => значение столбца”). Имя столбца - строка (string). Тип значения столбца зависит от типа базы данных. Массив будет пустым, если в таблице нет данных.

Строки могут быть перечислены через проход массива, например, выведены в виде HTML. Смотрите примеры для дополнительной информации.

Параметры объекта Param

Параметр Тип Описание
Name string Имя параметра.
Value
object Значение параметра. Значение зависит от типа параметра.

ЗАМЕЧАНИЕ: обычно объекты Param создаются при использовании конструктора. Смотрите примеры.

2. Использование метода GetRowsByTemplate

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

GetRowsByTemplate('MyTemplate', new [] {new Param('numberParam', 123), new Param('textParam', 'abc')})

Этот метод возвращает такой же результат, что и метод GetRows. Строки таблицы можно обходить в цикле, получать доступ к строкам и столбцам по индексу и т.д. Для более детальной информации смотрите документацию по методу GetRows.