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

с использованием атрибута simple = true для qp:placeholder:

<qp:placeholder calls="News" simple="true" runat="server" />

с помощью метода ShowObjectSimple:

ShowObjectSimple("News", this);

При этом передача данных в такой объект работать не будет.

Передача данных между итерациями Publishing Container

Если для вывода данных объекта «Publishing Container» используется сгенерированный по умолчанию Repeater, то записывать значение для следующей итерации в Value лучше всего в обработчике события OnItemDataBound, а использовать в логике для формирования текущего вывода – в обработчике события OnItemCreated.

Использование Values

При использовании Values в качестве составных частей фильтров объекта «Publishing Container» рекомендуется использовать метод NumValue или StrValue. Первый подходит для числовых параметров: если на входе не число, то он возвращает значение 0, тем самым гарантируя числовой результат. Второй метод подходит для строковых параметров: он удваивает апострофы (в отличие от метода Value, который их удаляет). Рекомендованные способы применения методов в фильтрах:

"[content_item_id] = " + NumValue("id")

"[Name] = '" + StrValue("name") + "'"

Аккуратная работа с апострофами необходима, чтобы избежать возможности SQL-инъекции. Если нужно получить значение из коллекции Values в неизменном виде (без удалений и замен апострофов, преобразования к числу), то следует использовать метод DirtyValue. Он может быть полезен при передаче фильтра целиком через коллекцию Values. В этом случае при формировании фильтра необходимо удостовериться в невозможности SQL-инъекции. Добавить новое значение можно с помощью метода AddValue.

Прямая работа с коллекцией Values не рекомендуется.

Механизм переопределения объектов

Переопределение объектов играет ключевую роль при создании сайта на объектах QP. Под переопределением объекта шаблона на уровне страницы понимается создание на уровне страницы объекта с тем же именем. Таким образом, когда будет вызван объект с этим названием (форматы вызова O и OF), то будет загружен объект шаблона, а не страницы. При создании объекта страницы не нужно вводить совпадающее имя, достаточно просто выбрать требуемый родительский объект.

Связь между родительским и дочерним объектом проявляется только на уровне вызовов, никакой другой связи (например, на уровне классов) нет. Единственное ограничение, накладываемое механизмом вызова объектов – имена родительского и дочернего объектов должны совпадать.

Из объекта страницы с помощью форматов вызова TOF и TO можно вызвать объект шаблона с тем же именем и таким образом реализовать сценарий «доопределения» объекта шаблона.

Формат

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

Свойства формата

Название	Описание
Название формата (Format Name)	Алфавитно-цифровое имя формата. Является уникальным в пределах объекта. Используется в ГПИ.
Название формата. NET (.NET Format Name)	Имя формата. Используется для создания. NET-класса. Если значение поля «Название формата» содержит только английские буквы, цифры и пробелы, то значение данного свойства будет сгенерировано автоматически. Для ASP-сборки свойство отсутствует.
Описание (Description)	Текст для описания объекта.
Язык. NET (.NET Language)	Выбор языка для разработки Code Behind для элемента управления данного формата. Доступны: C# (используется по умолчанию), . Для ASP-сборки свойство отсутствует.
Presentation	Содержимое поля используется для генерации пользовательского элемента управления форматом.
Code Behind

Поиск по коду для объектов

В ГПИ существует возможность выполнить поиск по коду для объектов QP. ГПИ доступен в контекстном меню для сайта.

Поиск ведётся с помощью LIKE-синтаксиса SQL по:

Code Behind и Presentation шаблонов (если область поиска это допускает), Code Behind и Presentation форматов, полям объектов «Publishing Container», которые содержат динамические значения:

«Фильтр» (Filter), «Номер первой отображаемой записи» (First article number), «Показывать все» (Show All), «Выражение динамической сортировки» (Dynamic order expression), «Значения по умолчанию» (Default Values).

Прочее Библиотека сайта

Библиотека сайта позволяет работать с файлами из определённой директории в файловой системе. Библиотека сайта предназначена для размещения файлов, общих для всего сайта или нескольких контентов. Взаимодействие пользователя с Библиотекой осуществляется с использованием ГПИ бекэнда.

Открыть ГПИ библиотеки сайта можно с помощью команды «Библиотека» контекстного меню, вызванного для сайта.

Библиотека контента

По функциональности совпадает с Библиотекой сайта. Открыть ГПИ библиотеки можно с помощью команды «Библиотека» контекстного меню, вызванного для определенного контента.

Особенности:

содержит только файлы, используемые в одном определённом контенте; права доступа на директории Библиотеки наследуются от контента.

Кэширование

Кэширование вывода

Реализуется с помощью директивы OutputCache для Presentation на странице свойств формата. В этом случае используется кэширование вывода на уровне пользовательских элементов управления. Необходимо учитывать, что в случае получения данных из кэша Code Behind выполняться не будет, что может быть неприемлемо.

Обычный синтаксис:

<%@ OutputCache Duration="100" VaryByParam="location;count" %>

Замечания:

Для объектов шаблона желательно использовать параметр «Shared» (позволяет уменьшить нагрузку на память сервера). Крайне не рекомендуется использование VaryByParam="*" из-за вероятных проблем с производительностью.

Кэширование данных

Реализуется в зависимости от того, как осуществляется доступ к данным.

Publishing Container

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

QP Cache API

Доступен в виде методов класса DBConnector. Используется для кэширования:

результатов SQL-запросов, коллекций объектов LINQ to SQL, произвольных объектов. Блокировка сущностей

Блокировка экземпляра сущности пользователем бекэнда – это запрет на изменение данного экземпляра другими пользователями. Заблокированный экземпляр может разблокировать:

пользователь, выполнивший блокировку; пользователь, входящий в группу пользователей «Администраторы»; пользователь, входящий в группу пользователей с включённой настройкой «Члены группы могут разблокировать сущности».

Блокировка используется для следующих сущностей:

«Сайт», «Статья», «Шаблон», «Объект», «Формат», «Страница».

Блокировка устанавливается автоматически после входа пользователя на страницу изменения свойств сущности. По окончании редактирования блокировка автоматически снимается. У пользователя имеется возможность указать, что блокировка должна существовать постоянно.

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

работа веб-приложения была завершена в аварийном режиме, окно браузера было закрыто.

Для объекта раздельно блокируются:

общие свойства (для всех типов объектов), свойства, специфичные для объекта «Publishing Container».

Механизм автозамены URL

Механизм позволяет избежать обязательных изменений содержимого БД при изменении домена веб-сайта. В БД в значения полей типов «Строка», «Текстовое окно» и «Визуальный редактор» сохраняется не URL, а заполнитель (placeholder), который при выводе на веб-сайт заменяется на значение, автоматически формируемое на основании текущих свойств сайта.

Правила работы:

Название операции	Исходное значение	Итоговое значение
Сохранение в БД	http://DNS/URI загрузки	Заполнитель <%=upload_url%>.
http://DNS/Виртуальный путь в Live	Заполнитель <%=site_url%>.
http://Stage DNS/Виртуальный путь в Stage
Вывод данных на веб-сайт	<%=upload_url%>	Значение «Виртуальный путь» из группы свойств «Расположение загруженных файлов» сайта. При активном свойстве «Использовать абсолютный виртуальный путь» к результату добавляется значение свойства «Префикс виртуального пути».
<%=site_url%>	Зависит от режима работы веб-сайта. Значение «Виртуальный путь» из группы свойств сайта: «Расположение страниц в Основном режиме», «Расположение страниц в Тестовом режиме». Если в конфигурационном файле веб-сайта (web. config) задано UseAbsoluteSiteUrl = 1, то к результату добавляется: http://DNS http://Stage DNS

Обратная замена заполнителей на URI происходит только при:

вызове методов QP8 API:
Field (для вывода данных с использованием объекта «Publishing Container»), FormatField (замена в произвольной строке);
использовании классов LINQ to SQL.

Механизм изменения форм в ГПИ бекэнда

Существует возможность добавления собственных функциональных возможностей в форму создания и изменения статей. Примеры возможных вариантов:

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

В свойствах сайта для подключения собственных скриптов используется свойство «Скрипт для формы контента». Заданные скрипты будут добавлены в форму для текущего сайта.