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

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

Вы можете настроить источники данных после настройки применимых к экранной форме действий.

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

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

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

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

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

   После того, как действие выбрано, в окне Источник данных отображаются блоки InputModel и OutputModel с контрактами данных.

4. Если при вызове действия, указанного в настройках этого источника данных, вы хотите задать определенное значение элемента входного контракта данных, в меню (Действия) в строке с именем элемента входного контракта данных выберите Значение по умолчанию, в окне Значение укажите значение, соответствующее типу данных этого элемента, и нажмите Применить.

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

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

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

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

   • возврат части элементов выходного контракта данных;
   • изменение имен элементов выходного контракта данных;
   • преобразование типов элементов выходного контракта даных;
   • настройка значений свойств компонентов, имеющих в качестве входных данных иерархическую структуру, например, DataGrid или Tree;

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

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

      Если вы хотите вернуть один элемент контракта, в меню (Действия) вы можете выбрать Вернуть часть контракта и затем выбрать нужный вам элемент.

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

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

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

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

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

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

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

      Между элементом контракта по умолчнию и элементом нового контракта отображается связь в виде стрелки.

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

   8. По завершении настройки контракта в окне Контракт <имя действия, указанное в параметрах источника данных> нажмите Применить.

      Окно Контракт <имя действия, указанное в параметрах источника данных> закрывается и справа от OutputModel отображается метка new.

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

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

6. Если вы хотите выполнить дополнительные действия на экранной форме (например, в обработчике события компонента) и в режиме Low-code привязать статус, результат и/или текст ошибки выполнения действия к компоненту экранной формы, на вкладке События нажмите одну из следующих кнопок:

   • Создать, чтобы добавить одну безымянную запись в список;
   • Сгенерировать, чтобы добавить три записи с шаблонными именами Insert, Update, Delete.

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

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

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

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

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

8. Вверху справа нажмите Сохранить.

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

Связанные статьи

Отображение данных в области компонента Tree