Использование параметров

Использование параметров

Настройка параметров запросов

Плагин SaveToDB автоматически определяет параметры хранимых процедур баз данных, процедур OData и http-запросов в стандартном формате.

Плагин также позволяет в визуальном режиме настроить и изменять поля WHERE для таблиц и представлений.

Для остальных типов запросов параметры можно настроить за счет форматных вставок в тексте запросе.

Текст запросов таких типов указывается в полях TABLE_CODE списка запросов, HANDLER_CODE обработчиков событий и SELECT_CODE объектов запроса списка значений.

Форматы настройки параметров:

Тип запросаКод типаФормат параметраПримеры
SQL-код Microsoft SQL Server,
Microsoft SQL Server Compact, SQLite
CODE@Parameter[=DefaultValue]SELECT * FROM Sales.Contacts WHERE Name = @Name
SELECT * FROM Sales.Contacts WHERE Name = @Name=ABC
SQL-код Oracle Database,
IBM DB2, MySQL, MariaDB, PostgreSQL, NuoDB
CODE:Parameter[=DefaultValue]SELECT * FROM SALES.CONTACTS WHERE NAME = :Name
SELECT * FROM SALES.CONTACTS WHERE NAME = :Name=ABC
http-запросHTTPПо стандарту httphttp://www.google.com/finance/historical?q=GOOG
http-запросHTTP{Parameter[=DefaultValue]}http://www.google.com/finance/historical?q={Symbol=GOOG}
https://www.google.com/search?as_q={Query}
Запрос к тестовому файлуTEXT{Parameter[=DefaultValue]}{FileName};CodePage=1251
{FileName};CodePage={CodePage=1251}
Макрос ExcelMACRO{Parameter[=DefaultValue]}SayHello {Name=World}
Sheet1.SayHello {FirstName}, {LastName}
Команда Windows Shell или CMDCMD{Parameter[=DefaultValue]}{FileName}
notepad.exe {FileName}
dir {Mask=*.*}
cmd /c dir {Mask=*.*}
cmd /k dir *.*
mailto:{Email}&subject=Thanks for the connection&body=Hello {FirstName},%0A

Примечание: при указании значения по умолчанию до и после знака "=" не должно быть пробелов.

Настройка списка значений параметров

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

См. Настройка списков значений параметров.

Источники значений параметров запросов

Значения параметров выполняемых процедур и запросов могут формироваться несколькими способами:

Источник значенияОбласть действияКомментарий
Одноименная колонка таблицыВсе типы запросовИспользуется имя колонки объекта до перевода наименования
Одноименный параметр на лентеВсе типы запросовНа ленте отображаются параметры запроса активной таблицы на листе Excel.
Параметры синхронизируются с именованными ячейками Excel.
Параметры с предопределенными именами (см. ниже) не выводятся на ленту.
Одноименная именованная ячейка ExcelВсе типы запросовЗначение именованной ячейки Excel
Одноименный параметр запроса активной таблицыВсе типы запросовНапример, обработчики событий запроса EXEC dbo.uspCustomers @ManagerID=101
могут использовать значение параметра ManagerID
WorkbookName, workbook_nameВсе типы запросовИмя активной книги не включая каталог
WorkbookPath, workbook_pathВсе типы запросовКаталог активной рабочей книги. Значение является пустым для новой книги.
SheetName, sheet_nameВсе типы запросовИмя активного листа
DataLanguage, data_languageВсе типы запросовЗначение содержит код языка данных, выбранного в настройках плагина
TableName, table_nameОбработчики событийИмя объекта запроса
EventName, event_nameОбработчики событийЗначения определяются типами из колонки EVENT_NAME таблицы 2
ColumnName, column_nameОбработчики событийИмя активной колонки
CellValue, cell_valueОбработчики событийЗначение активной ячейки. Используется текстовый тип для параметра, и преобразовывайте в нужный тип в SQL-коде.
CellAddress, cell_addressОбработчики событийАдрес активной ячейки.
CellFormula, cell_formulaОбработчики событийФормула активной ячейки в формате Range.Formula.
ChangedCellCount, changed_cell_countОбработчик событий ChangeКоличество измененных ячеек.
ChangedCellIndex, changed_cell_indexОбработчик событий ChangeНомер запроса в группе запросов обработки изменений.
TransactionID, transaction_idВсе типы запросовGUID группы операций.
TransactionStartTime, transaction_start_timeВсе типы запросовВремя UTC группы операций.
WindowsUserName, windows_user_nameВсе типы запросовИмя пользователя Windows.
SaveToDbVersion, savetodb_versionВсе типы запросовВерсия плагина SaveToDB.
MergeDate, merge_dateСохранение слияниемДата и время формирования запроса слияния данных. Позволяет определить наличие данных в последнем слиянии.

Примечание: источники указаны в порядке убывания приоритета, значение колонки таблицы имеет наиболее высокий приоритет.

Этот веб-сайт использует куки. Продолжая использовать веб-сайт, Вы принимаете условия Cookie Policy.