Руководство по настройке altAwin:HTML-представления

HTML-представления

В подразделе «HTML-представления» осуществляется создание и настройка пользовательских представлений на языке разметки гипертекста. Готовое HTML-представление выглядит и функционирует как полноценная веб-страница, реализующая возможности современных интерактивных веб-документов с возможностью доступа к инфраструктуре altAwin. Целью создания HTML-представлений стало обеспечение возможности тонкой настройки внешнего вида и поведения пользовательских представлений.

Документ HTML-представления

Вкладка «Общие данные»

На вкладке Общие данные определяются основные настройки для HTML-представления:

• Наименование — название HTML-представления.
• Пиктограмма 16×16, Пиктограмма 32×32 — графические изображения для визуальной идентификации HTML-представления размером 16×16 и 32×32 пикселей соответственно. Используются в качестве иконки формы редактирования и навигационных элементов интерфейса приложения (главное меню, навигационная панели и «быстрый запуск»).
• Раздел — раздел, в котором будет отображаться данное представление. Можно выбрать один из существующих разделов altAwin или оставить поле пустым, в таком случае созданное представление будет отображаться в разделе Расширения.
• Разрешён экспорт дилеру — флаговый переключатель управляет возможностью сохранения данного пользовательского представления при экспорте настроек в удалённый офис. HTML-представления, полученные из основного офиса, будут доступны дилеру только для чтения. В рабочей базе удалённого офиса HTML-представления могут создаваться без ограничений.
• Комментарий.

Вкладка «Источник»

На вкладке источник «Источник» определяется код веб-страницы, лежащей в основе HTML-представления. Внутри каждого HTML-представления встроен браузер, в котором запускается написанный здесь код страницы, который может содержать все элементы, присущие полноценному веб-документу, включая собственно HTML-разметку, сценарии JavaScript, правила оформления на языке CSS а также ссылки на внешние ресурсы, используемые для отображения контента.

Код записывается в окне редактора, обеспечивающего подсветку синтаксиса, предпросмотр и базовые возможности поиска и замены текста.

Вкладка «Ресурсы»

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

Вкладка «Доступ»

На вкладке Доступ производится определение ролей, для которых будет доступно данное HTML-представление.

Взаимодействие с altAwin

Взаимодействие с altAwin осуществляется внутри сценариев JavaScript через соединитель window.external, предоставляющий доступ к объектной модели приложения. В частности, объект

• window.external.Framework предоставляет доступ к ядру altAwin через объект типа IpubFramework;
• window.external.Functions предоставляет доступ к скриптовым функциям altAwin.

Для примера рассмотрим фрагмент сценария, позволяющий получить доступ к документу altAwin по его внутреннему идентификатору (ключу) в базе данных.

var fw = window.external.Framework // ядро altAwin, объект типа IpubFramework
var db = fw.GetService('IpubObjectsDBService') // сервис БД
var session = db.NewSession('')  // транзакция (IomSession)
var person = session.OpenDocument('IdocCounteragentPerson', 0) // документ "Персона"
alert(person.Title) // Администратор

Взаимодействие с пользовательским интерфейсом приложения осуществляется через сервис IpubObjectsUIService.

var fw = window.external.Framework // ядро altAwin, объект типа IpubFramework

var db = fw.GetService('IpubObjectsDBService') // сервис БД
var ui = fw.GetService('IpubObjectsUIService') // сервис UI

let session = db.NewSession('') // транзакция (IomSession)
let customer = session.NewDocument('IdocCustomer', void(0))
customer.Title = 'Привет из браузера'

ui.ShowDocumentModal(customer)

Использование внешних ресурсов

В HTML-представлениях возможно использование произвольных ресурсов (JavaScript, CSS, Изображений) после загрузки их в документ на вкладке "Ресурсы".

Экспорт и импорт представлений

Для возможности переноса между установками altAwin HTML-представления могут быть экспортированы путём сохранения во внешнй файл с расширенем *.awhv и в последующем восстановлены из него при импорте. Экспорт и импорт HTML-представлений осуществляется при помощи соответствующих кнопок панели инструментов представления.