понедельник, 25 июля 2011 г.

Консольные приложения (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.

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

Комментариев нет:

Отправить комментарий