Настройка источника данных для компонентов экранной формы

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

Чтобы настроить источник данных для компонентов экранной формы, выполните следующие действия:

1. В проекте выберите файл с расширением mdcontainer, соответствующий экранной форме, для компонентов которой вы хотите настроить источники данных.

2. На боковой панели нажмите значок и в разделе Источники данных нажмите +.

3. В окне Источник данных, которое открывается, на вкладке Общие укажите следующие параметры:

   • Имя (обязательный параметр): введите имя источника данных. Вы можете использовать любые символы.
   • Действие (обязательный параметр): из раскрывающегося списка выберите действие, применимое к этой экранной форме. В списке отображаются все настроенные действия, применимые к этой экранной форме. После того, как действие выбрано, в окне Источник данных отображаются блоки InputModel и OutputModel с контрактами данных.

   Если выходной контракт данных содержит вложенную структуру данных, и вы хотите вернуть данные согласно одному из следующих вариантов:

   • Один элемент контракта данных, например, элемент массива объектов.

     Выполните следующие действия:

     1. В блоке OutputModel в меню Действия выберите Вернуть часть контракта.
     2. В окне Контракт <имя действия, указанное в параметрах источника данных>, которое открывается и отображает полный контракт, укажите элемент, который вы хотите вернуть.
     3. Нажмите Применить.

     В результате в блоке OutputModel отображается имя и тип данных возвращаемого элемента контракта данных.

   • Несколько элементов контракта данных, например, несколько элементов массива объектов.

     Выполните следующие действия:

     1. В блоке OutputModel в меню Действия выберите Изменить контракт.

     2. В окне Контракт <имя действия, указанное в параметрах источника данных>, которое открывается и отображает полный контракт, укажите элементы, которые вы хотите вернуть.

     3. В строке result справа нажмите +.

     4. В раскрывающемся списке типов данных выберите тип данных возвращаемого элемента контракта данных.

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

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

     6. Если вы хотите связать элемент нового контракта с элементом полного контракта, в строке с элементом нового контракта в меню Действия выберите Связь с полем контракта и в открывшемся окне выберите элемент полного контракта.

     Между элементом контракта по умолчнию и элементом нового контракта отображается связь в виде стрелки. 7. Если вы хотите указать значение по умолчанию возвращаемого элемента, в меню Действия выберите Значение по умолчанию и в окне, которое отображается, введите значение и нажмите Применить. 8. По завершении настройки контракта в окне Контракт <имя действия, указанное в параметрах источника данных> нажмите Применить.

     Если вы хотите начать настройку выходного контракта сначала, в окне Контракт <имя действия, указанное в параметрах источника данных> нажмите Сбросить. Параметры контракта в столбце Новый сбрасываются.

   Если вы изменили выходной контракт данных, справа от OutputModel отображается метка new.

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

4. Если вы хотите использовать источник данных для описания обработчиков событий для компонентов экранной формы, на вкладке События нажмите Создать, чтобы добавить одну безымянную запись в список, или нажмите Сгенерировать, чтобы добавить три записи с шаблонными именами Insert, Update, Delete.

   Для каждой записи в списке укажите следующие параметры:

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

5. В окне Источник данных нажмите Добавить.

   Окно Источник данных закрывается.

   Настроенный источник данных отображается на панели настроек в разделе Источники данных.

6. В верхнем правом углу рабочей области нажмите Сохранить.

Измененный файл с расширением mdcontainer сохраняется в файловой системе бэкенд-сервиса DevTools.

Теперь вы можете использовать настроенный источник данных при настройке компонента DataGrid, при присваивании значений свойствам компонентов и определении обработчиков событий компонентов этой экранной формы.