Консольные приложения (16): Открытие ASPX-страниц в админке

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

Сейчас мы рассмотрим, как открывать ASPX-страницы прямо в админке.

Вы можете создавать ASPX-страницы на сайте C1 и открывать их в браузере. Например, вы создали страницу HelloWorld.aspx в корневом каталоге сайта и соответственно пользователи могут открыть ее по веб-адресу, напр., http://www.contoso.ru/HelloWorld.aspx.

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



Для этого вы должны использовать XML-элемент CustomUrlAction и минимум указать:

• относительный адрес к этой странице в атрибуте Url, напр., "~/HelloWorld.aspx". (Тильду С1 заменяет на текущий путь к веб-приложению.)
• надпись на кнопке на панели инструментов и названия пункта контекстного меню в атрибуте Label, напр. "Здравствуй, мир!"

<Actions>
  <CustomUrlAction Label="Здравствуй, мир!" Url="~/HelloWorld.aspx" />
</Actions>

Дополнительно вы можете указать такие необязательные (и знакомые вам уже по другим действиям) атрибуты, как:

• Tooltip: Всплывающая подсказка для этого действия. (По умолчанию используется значение атрибута Label.)
• PermissionTypes: Список разрешений на это действие

Кроме того, страница открывается в т.н. "представлении" (view) в правой части административной консоли С1. Для представления заданы значения по умолчанию (тип, надпись, подсказка, иконка). Но вы можете указать свои в соответствующих атрибутах XML-элемента CustomUrlAction.

• ViewType: Тип представления открываемой ASPX-страницы. Может быть:
• genericview (по умолчанию)
• documentview
• pagebrowser
• filedownload
• ViewLabel: Надпись на вкладке представления. По умолчанию используется значение атрибута Label.
• ViewToolTip: Подсказка для вкладки представления. По умолчанию используется значение атрибута Tooltip.
• ViewIcon: Иконка на вкладке представления. По умолчанию используется иконка, соответствующая выбранному типу представления. 

Для примера, вы может установить один из пакетов, который используют XML-элемент CustomUrlAction, напр. Composite.Tools.XmlBasedSiteBackup и изучить его файл определения древовоидной структуры.


Что касается открытия ASPX-страниц - это еще не все. Далее мы рассмотрим, как открывать такие страницы с параметрами, напр., ~/Calendar.aspx?WeekStartsOnMonday=True.

(продолжение следует...)