Формы. Как выводить и обрабатывать данные на форме из внешнего источника через API

Форма может показывать данные из внешнего источника. 

Форма может при нажатии на Сохранить передавать данные формы по API и получать ответ.

При изменении поля данные можно вызывать внешние источники по API и выдавать данные на форму. 

Чтобы реализовать подобное, сделайте следующее: 

1. Укажите источники данных в параметрах формы GetItem API, SaveItem API и CheckField API. Можно указывать несколько источников через запятую. 

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

2. Создайте исходящие запросы API, которые были указаны в настройках формы. В их параметры в процедуру request будут передаваться следующие параметры: 

• GetItem - передается itemID
• SaveItem - передаются все параметры формы
• CheckField - передаются itemID, field (измененное поле) и value (значение этого поля)

3. В процедурах GetItem, SaveItem или CheckField извлеките данные из коллекции @parameters (Key,Value2). Key - код запроса API. 

CREATE PROCEDURE [dbo].[fm_tst-remoteform_getItem]
    @itemID int,
	@username nvarchar(256),
    @parameters ExtendedDictionaryParameter readonly

AS
BEGIN
	declare @text nvarchar(max)
    select @text = Value2 from @parameters where [Key]='falconUpdates'

	select @text text
END

Создание запросов API описано в - Falcon Space. Создание сервиса API (входящие и исходящие запросы API)

Значение, попадающее в Value2 - это поле Response из процедуры обработки ответа - response соответствующего запроса API. 

В поле Response может быть как полный, необработанный ответ запроса API, так и итоговые результаты парсинга ответ.

4. Используйте полученные значения в этих процедурах

В GetItem можно проинициализировать поля формы

В SaveItem выполнить некое действие по API (например передать поля формы и вывести результат). 

В CheckField - можно по измененным полям извлекать из внешнего источника какие-то данные, например цены.

Примечание

Учитывайте, что код вызова API должен быть меньше 32 символов. 

В API метод request передается параметр caller  - в нем указывается вызывающий объект в виде table-{code} (если это таблица) или form-{code} (если это форма).