Книга: Технологии интеграции "1С:Предприятия 8.3""
Назад: Общая информация
Дальше: Управление внешними источниками данных

Редактирование функций

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

Чтобы загрузить список функций из внешней базы данных, нужно в окне редактирования свойств внешнего источника на закладке Функции нажать кнопку Добавить и выбрать пункт Выбрать из списка функций внешнего источника данных в конструкторе функций внешнего источника данных (рис. 2.7).

Рис. 2.7. Загрузка списка функций из внешнего источника данных

Затем нужно указать строку соединения с внешней базой данных, воспользовавшись окном Подключение к источнику данных (см. рис. 2.4).

После того как подключение к внешней базе успешно выполнено, будет открыт список с перечнем процедур и функций подключенного источника данных. Из этого списка можно выбрать необходимые функции, на основе которых платформа создаст соответствующую структуру объектов, описывающих текущий источник данных (рис. 2.8).

Рис. 2.8. Конструктор функций внешнего источника данных

В конструкторе можно указать, под каким именем функция будет создана в конфигурации «1С:Предприятия».

После настройки указанных параметров, отметки нужных функций и процедур и нажатия кнопки Готово произойдет загрузка функций внешнего источника данных в конфигурацию.

подробнее

Более подробно загрузка функций из внешнего источника данных будет показана в разделе «».

Помимо этого список функций внешнего источника данных можно полностью заполнить вручную в конфигураторе. То есть функции можно создать обычным образом, как подчиненные внешнему источнику объекты конфигурации, и установить их свойства.

При ручном заполнении списка функций особое внимание нужно обратить на свойство Выражение в источнике данных. Значение этого свойства должно содержать в себе выражение, которое будет использоваться в реальном запросе к базе данных при использовании функции. В данном свойстве можно не только указать обращение к реальной функции или сохраненной процедуре базы данных, но и написать выражение на языке СУБД внешнего источника данных.

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

Можно также добавить функцию внешнего источника данных, которая отсутствует в реальной базе данных. Эта функция должна быть написана на языке используемой СУБД. При этом рекомендуется выражение, помещенное в свойство Выражение в источнике данных, заключать в круглые скобки, чтобы избежать различных побочных эффектов во время исполнения реального запроса.

Если свойство Возвращает значение установлено в значение Истина, то в этом случае также необходимо указать, какого типа значение будет возвращаться данной функцией или выражением.

Если функция принимает параметры, то формальные параметры функций внешнего источника данных описываются как &n, где n – номер параметра. Нумерация параметров начинается с 1. Например, функция, принимающая два параметра, описывается следующим образом: dbo.uspGetWhereUsedProductID(&1, &2).

Назад: Общая информация
Дальше: Управление внешними источниками данных