imported>Kirillche: save from wiki docs editor

2019-03-11T14:20:16Z

save from wiki docs editor

Новая страница

<noinclude>=== HTML-представления===</noinclude>
В подразделе «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 по его внутреннему идентификатору (ключу) в базе данных.
<syntaxhighlight lang="javascript">
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) // Администратор
</syntaxhighlight>

Взаимодействие с пользовательским интерфейсом приложения осуществляется через сервис IpubObjectsUIService.
<syntaxhighlight lang="javascript">
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)
</syntaxhighlight>

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

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

<noinclude>{{Навигация|Пользовательские представления|Раздел «Расширения»|Пользовательские диалоги}}</noinclude>

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

imported>Kirillche: save from wiki docs editor