Метод 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.