Программный продукт «QP8.Framework» (стр. 18 )

<app_var app_var_name="security_GID_varname_VB">Session("qp_GID")</app_var>

<app_var app_var_name="security_UID_varname_CSharp">Session["qp_UID"]</app_var>

<app_var app_var_name="security_GID_varname_CSharp">Session["qp_GID"]</app_var>

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

Session["qp_UID"] = Quantumart. QPublishing. Permissions. AuthenticateUser(username, password);

Альтернативный вариант – сохранить в переменной Session[“qp_GID”] идентификатор группы и выставить Session[“qp_UID”] в NULL. Тогда QP будет использовать правила доступа для группы. Список групп для пользователя можно получить с помощью метода GetRootGroupsForUser.

Если посетители веб-сайта имеют право создать нового пользователя, то следует использовать метод AddUser.

Quantumart. QPublishing. Permissions. AddUser(username, password, First_Name, Last_Name, Email);

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

Quantumart. QPublishing. Permissions. AddUserToGroup(int userId, int groupId);

Для нахождения нужной группы следует использовать метод GetGroupInfo:

DataTable dt = GetGroupInfo(group_name); //group_name is a string
int group_id = dt. Rows[0]("group_id");

QP позволяет назначать права на статьи пользователям и группам. Это полезно при наличии на веб-сайте содержимого, создаваемого пользователями. В таком случае пользователю можно предоставить возможность самому указать, каким пользователям (группам) дать доступ к собственным данным.

QP также поддерживает вложенные группы, где дочерняя группа наследует права родительской, таким образом косвенно влияя на права пользователей. Существуют методы, позволяющие устанавливать отношения между группами.

В QP8 API имеются методы для работы с режимом интегрированных прав доступа:

AddUserToItemPermission, AddGroupToItemPermission, GetPermissionLevels, AddChildGroupToParentGroup.

Сортировка

Название	Описание
Return Articles	Возможные значения: Sequentially, Randomly.
Порядок по умолчанию (Default Sorting)	Позволяет задать одно или несколько правил сортировки: указать поле контента, по которому должна выполняться сортировка; задать направление сортировки.
Динамический порядок (Use Dynamic Sorting)	Переключатель между динамической и статической сортировкой. По умолчанию выключен, что соответствует статической сортировке. Статическая сортировка задается набором элементов управления «Порядок по умолчанию». При установленном флаге объект «Publishing Container» будет использовать «Выражение динамической сортировки», которое обычно передается через механизм Values. По умолчанию выполняется сортировка по возрастанию значения служебного свойства CONTENT_ITEM_ID. Примечание: для поля, по которому осуществляется сортировка, рекомендуется создавать индекс.
Выражение динамической сортировки (Dynamic Sorting Expression)	Правило для динамической сортировки.

Постраничный вывод

Название	Описание
Selection is starting	Возможные значения: «From the first article» (по умолчанию), «From the article with the specified number». Примечание: если значение должно быть динамическим, то следует передавать его через механизм Values и использовать метод NumValue.
Selection includes	Возможные значения: «All articles» (по умолчанию), «Specified Number Of Articles». Примечание: значение может быть динамическим (передавать с использованием механизма Values). Следует использовать метод NumValue. В сочетании с динамической опцией «Номер первой отображаемой записи» (First article number) реализует постраничный вывод.

Кэширование

Название	Описание
Разрешить кэширование данных (Enable Data Caching)	Разрешает кэширование набора данных, возвращаемых объектом «Publishing Container». Ключ кэширования формируется на основе идентификатора формата и предложения WHERE SQL-запроса. Таким образом, для одного объекта «Publishing Container» может существовать несколько записей в кэше. Интервал кэширования определяется значением опции «Длительность (мин)» (Duration (min)). Устаревание кэша – абсолютное (по истечении интервала кэширования запись удаляется из кэша вне зависимости от частоты обращений к ней).
Возвращать дату последней модификации (Return Last Modified)	Выводит самую последнюю дату изменения из дат в наборе возвращаемых статей. Используется для формирования HTTP-заголовка Last-Modified и настраивается на уровне страницы.

Свойства объекта типа «Publishing Form»

Название	Описание
Контент (Content)	Контент, в который должны будут добавляться данные.
Генерировать код для создания/удаления статей (Generate code for updating/appending articles)	По умолчанию опция отключена. В этом случае предполагается, что Разработчик сам напишет требуемый код.
Перейти после заполнения формы на страницу (Submission response page)	Выбор страницы, на которую будет осуществлён автоматический переход после успешной отправки формы на сервер.
Язык. NET (.NET Language)	Язык, который требуется использоваться при автоматической генерации формата.

При создании объекта типа «Publishing Form» среди объектов текущего шаблона генерируется объект _Check_Content_Article_Form_Script типа JavaScript, в который вставляется универсальный скрипт проверки для объектов типа «Publishing Form». Операция используется только для первого объекта «Publishing Form», созданного в пределах шаблона.

Сборка объекта

Сборка требуемого набора объектов осуществляется кнопкой «Собрать» (Assemble).

Вызовы объектов

Объекты могут быть вызваны из страницы или других объектов. В ASP объект представляет собой функцию, в – пользовательский элемент управления.

Способы вызова объектов различаются в зависимости от типа сборки и места вызова:

Presentation:

<qp:placeholder calls="CSS" runat="server"/>

Code Behind:

ShowObject("CSS", this);

ASP:

<%=Object("CSS")%>

Поддерживаются следующие форматы вызова:

Название	Описание
O	ObjectName. Наиболее распространённый формат вызова. Сначала ищется объект страницы с таким именем, затем объект шаблона. Если объект не найден, то выдается ошибка. В случае успеха загружается формат по умолчанию.
OF	ObjectName. FormatName. Аналогичен формату TO, есть возможность явно выбрать загружаемый формат.
TO	TemplateName. ObjectName. Позволяет вызывать объекты других шаблонов, в случае успеха вызывается формат по умолчанию.
TOF	TemplateName. ObjectName. FormatName. Аналогичен формату TO, есть возможность явно выбрать загружаемый формат.

Поддерживаются рекурсивные вызовы. По умолчанию глубина рекурсии ограничена 32 уровнями.

Примечание: не рекомендуется вызывать объект рекурсивно из Presentation.

Presentation

Вызов объекта из Presentation:

<qp:placeholder calls="[template_name.]object_name[.format_name]" runat="server"/>

<qp:placeholder calls="[template_name.]object_name[.format_name]" simple="true" runat="server"/>

По умолчанию используется модифицированная последовательность событий QP. Для использования оригинальной последовательности событий следует использовать вызов с параметром simple=“true”.

Code Behind

Вызовы осуществляются с помощью методов классов QPage и QUserControl.

Механизм Values (передача данных между объектами)

В QP для передачи данных между объектами можно использовать механизм Values. Values – это коллекция уровня страницы. Срок жизни коллекции Values – текущий запрос (не сохраняется в сессии, не передается между запросами). Данные в коллекцию Values попадают из следующих основных источников:

HttpRequest. QueryString (для ASP – Request. QueryString), HttpRequest. Form (для ASP – Request. Form), Вызов метода AddValue из пользовательского кода.

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

Передача данных от родительского объекта к дочернему

Рассмотрим дерево элементов управления некоторой страницы . При статической загрузке элементов управления событие Init распространяется в обратном порядке (от листьев к корню), поэтому передача данных в этом случае невозможна. Поэтому QP использует динамическую загрузку вместе с собственной последовательностью событий Init. Стоит отметить, что при загрузке объекта через Presentation используется элемент управления qp:placeholder и предполагается, что он должен загружаться статически, но фактически он представляет собой оболочку, которая, в свою очередь, динамически загружает нужный элемент управления. Так как сама оболочка загружается статически, то невозможна передача данных из родительского объекта в дочерний, который вызван через qp:placeholder. У данной реализации есть побочный эффект: из-за использования собственной последовательности событий Init перестаёт правильно работать назначение элементам управления клиентских идентификаторов, а, следовательно, потом страница не может корректно восстановить ViewState. Это приводит к тому, что при использовании серверных элементов управления внутри элементов управления QP первые могут сохранить свое состояние. Решение этой проблемы – заключение такого элемента управления или группы элементов управления в отдельный объект шаблона (страницы), который должен быть вызван одним из следующих способов: