Перейти к основному содержимому

Настройка маршрутизации экранной формы

Если вы хотите, чтобы в опубликованном проекте экранная форма была доступна по определенному URL-адресу на странице https://<Platform_instance_URL>/demo/p/<URL_страницы>, вам нужно настроить параметры маршрутизации этой экранной формы.

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

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

Чтобы настроить параметры маршрутизации:

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

  2. В верхней части Редактора Форм, который отображается, нажмите кнопку UG_route_icon.png (Маршрутизация).

  3. В окне Маршрутизация, которое открывается, укажите следующие параметры:

    • Путь (обязательный параметр): укажите часть URL-адреса, который будет отображаться в разработанном приложении в адресной строке после https://<Platform_instance_URL>/demo/p при переходе к разрабатываемой экранной форме, например, /MyProject. Часть URL-адреса может содержать параметры, передаваемые экранной форме. Параметру должен предшествовать символ двоеточия, например, /MyProject/:Id.

    • Псевдоним (обязательный параметр): введите строку, которая ассоциируется с переходом по указанному в параметре Путь адресу, например, MyProject. Значение параметра Псевдоним вы сможете использовать в качестве параметра метода sendCommand() и executeAction() библиотеки FrontendCore, если будете использовать эти методы при написании кода приложения. Псевдоним должен быть уникален в проекте.

      При вводе значения этого параметра руководствуйтесь следующими требованиями:

      • используйте латинские буквы;
      • вводите строку длиной не более 63 символов;
      • не используйте системные имена C#.

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

  4. По завершении настройки маршрутизации в окне Маршрутизация нажмите Применить.

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

Передача параметров экранной форме при переходе между экранными формами