imported>Kirillche: save from wiki docs editor

2023-01-19T12:12:43Z

save from wiki docs editor

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

<noinclude>== Пользовательские представления ==</noinclude>
В подразделе {{ClsMnu|Пользовательские представления}} осуществляется создание и настройка нестандартных представлений документов в дополнение к изначально существующим. При настройке пользовательского представления задаётся содержание и внешний вид записей таблицы, а также устанавливаются правила для работы с ними в интерактивном режиме.

==== Работа с документом «Пользовательское представление» ====
Создание документа осуществляется стандартным способом. В диалоговом окне документа «Пользовательское представление» расположено 6 вкладок:
* Общие данные;
* Запрос;
* Правила;
* Поля;
* Действия;
* Доступ.

===== Вкладка «Общие данные» =====
На вкладке {{ClsMnu|Общие данные}} определяются основные настройки для пользовательского представления:
{{DlgField|Наименование|название пользовательского представления.}}
{{DlgField|Имя соединения|наименование подключения к БД; выбирается из числа настроенных средствами Менеджера конфигурация или задаётся произвольным образом. Если соединение не указано, то для подключения к БД используется основное. Если указанного соединения не существует, то пользовательское представление не будет открываться, хотя останется возможность его редактировать и сохранять.}}
{{DlgField|Описание|текстовое описание (сущность, назначение) пользовательского представления.}}
{{DlgField|Пиктограмма 16×16</span>, <span class="Menu">Пиктограмма 32×32|графические изображения для визуальной идентификации пользовательского представления размером 16×16 и 32×32 пикселей соответственно. Используются в качестве иконки формы редактирования и навигационных элементов интерфейса приложения (главное меню, навигационная панели и «быстрый запуск»).}}
{{DlgField|Раздел|раздел, в котором будет отображаться данное представление. Можно выбрать один из существующих разделов altAwin или оставить поле пустым, в таком случае созданное представление будет отображаться в разделе {{ClsMnu|Пользовательские представления}}.}}
{{DlgField|Доступно дилеру|флаговый переключатель управляет возможностью сохранения данного пользовательского представления при экспорте настроек в удалённый офис. Пользовательские представления, полученные из основного офиса, будут доступны дилеру только для чтения.}}

{{Picture|AwCustomViewCommon.png|title=Окно документа {{ClsMnu|Пользовательское представление}}. Вкладка {{ClsMnu|Общие данные}}|num=4.185|id=1260}}

===== Вкладка «Запрос» =====
На вкладке {{ClsMnu|Запрос}} производится задание SELECT запроса к базе данных, на основании которого будет формироваться таблица представления.

{{Picture|AwCustomViewQuery.png|title=Окно документа {{ClsMnu|Пользовательское представление}}. Вкладка {{ClsMnu|Запрос}}|num=4.186|id=1261}}

В текстовом поле отображается текст SQL-запроса, по результатам которого производится формирование представления в настоящий момент, сюда можно ввести новый текст SQL-запроса при создании нового представления или необходимости изменить заданный. При нажатии на кнопку {{ClsMnu|Применить}} запрос выполняется и, в случае успеха, в нижнем информационно поле отображается статус ''«Запрос выполнен»'', а в таблице в нижней части окна выводятся полученные в результате запроса данные.

====== Использование макросов для подзапросов ======
Для создания сложных запросов, включающих подзапросы с указанными "WHERE" и/или "ORDER BY" используются следующие макросы:
{{ClsKbrd|%WHERECLAUSE%}}, {{ClsKbrd|%WHERECLAUSEVALUE%}}, {{ClsKbrd|%ORDERBYCLAUSE%}}, {{ClsKbrd|%ORDERBYCLAUSEVALUE%}}.

Данные макросы применяются при задании фильтрации/сортировки/группировки данных в ПП:
* %WHERECLAUSE% — врезание в конечный запрос строки вида {{ClsKbrd|"WHERE X{{=}}Y"}}
* %WHERECLAUSEVALUE% — врезание в конечный запрос строки вида {{ClsKbrd|"AND X{{=}}Y"}}
* %ORDERBYCLAUSE% — врезание в конечный запрос строки вида {{ClsKbrd|"ORDER BY "}}
* %ORDERBYCLAUSEVALUE% — врезание в конечный запрос строки вида {{ClsKbrd|", X"}}

К примеру, есть запрос:
<source lang="sql">
SELECT orderid,
orderno || '_suffix' suffixedorderno
FROM orders
</source>

При фильтрации представления, например, по полю name ({{ClsKbrd|name {{=}} 'test'}}) программа сгенерирует запрос вида:

<source lang="sql">
SELECT id,
name
FROM
(SELECT orderid,
orderno
FROM orders
WHERE orderid < 100
AND name = 'test')
</source>

который, соответственно, не выполнится из-за отсутствия поля name в таблице {{ClsMnu|orders}}. Для корректной генерации запроса необходимо его переписать:
<source lang="sql">
SELECT id,
name
FROM
(SELECT orderid,
orderno
FROM orders
WHERE orderid < 100)
%whereclause%
</source>

в результате чего программа будет генерировать правильный запрос вида:
<source lang="sql">
SELECT id,
name
FROM
(SELECT orderid,
orderno
FROM orders
WHERE orderid < 100)
WHERE name = 'test'
</source>

===== Вкладка «Правила» =====
На вкладке {{ClsMnu|Правила}} производится определение правил выполнения типовых действий с элементами, выводимыми в представлении.

{{Picture|AwCustomViewRules.png|title=Окно документа {{ClsMnu|Пользовательское представление}}. Вкладка {{ClsMnu|Правила}}|num=4.187|id=1262}}

На вкладке содержится четыре ссылочных поля, связываемых со скриптами:
{{DlgField|Создание|скрипт, выполняемый при попытке создания записи в пользовательском представлении.}}
{{DlgField|Дублирование|скрипт, выполняемый при дублирования записи в пользовательском представлении. В скрипт передаётся массив выделенных записей SelectedRecords.}}
{{DlgField|Открытие|скрипт, выполняемый при попытке открытия записи в пользовательском представлении.}}
{{DlgField|Удаление|скрипт, выполняемый при попытке удаления записи в пользовательском представлении.}}

При нажатии на кнопку {{ClsMnu|…}} соответствующего поля открывается окно редактора скриптов, где требуется записать код на языке FastScript, который будет выполняться всякий раз при попытке создать, открыть или удалить запись из представления.

{{Picture|AwCustomViewRulesCreate.png|title=Окно задания скрипта на создание записи в пользовательском представлении|num=4.188|id=1262}}

При работе со скриптами внутри документов пользовательских представлений для использования доступна переменная {{ClsMnu|SelectedRecords:Variant}}, в которую передаётся список выделенных элементов представления.

<source lang="pascal">
begin
d := SelectedRecords;
for i := 0 to length(d) — 1 do
begin
r := d[i];
ShowMessage(r.value['COLORID']);
end;
end;
</source>

===== Вкладка «Поля» =====
На вкладке «Поля» задаётся перечень доступных в представлении полей.

{{Picture|AwCustomViewFields.png|title=Окно документа {{ClsMnu|Пользовательское представление}}. Вкладка {{ClsMnu|Поля}}|num=4.189|id=1263}}

В отображаемой на вкладке таблице перечислены все поля, полученные в результате выполнения указанного на вкладке {{ClsMnu|Запрос}} SQL-запроса. Переключатель {{ClsMnu|Видимость}} у каждого поля определяет, будет ли выбранное поле отображаться в представлении. Кнопками в боковой панели инструментов можно изменить порядок следования полей, а также изменить состояние маркера видимости сразу для всех отобранных полей. В колонке {{ClsMnu|Наименование}} задаётся русскоязычное название поля для отображения в представлении, в колонке {{ClsMnu|Источник}} — название поля из результата SQL-запроса, в колонке {{ClsMnu|Поле}} — идентификатор поля представления.

Для запросов, в которых вычисляются значения или переназначаются имена колонок, необходимо указывать источник для них. Например, для запроса:
<syntaxhighlight lang="sql">
SELECT orderid,
orderno || '_suffix' suffixedorderno
FROM orders
</syntaxhighlight>
при создании фильтра по полю suffixedorderno ({{ClsMnu|suffixedorderno like '%1%'}}), программа сгенерирует запрос вида:

<syntaxhighlight lang="sql">
SELECT orderid,
orderno || '_suffix' suffixedorderno
FROM orders
WHERE suffixedorderno LIKE '%1%'
</syntaxhighlight>

в результате выполнения которого sql-сервер вернет ошибку "Column unknown."

Во избежание данной ошибки необходимо для поля suffixedorderno установить значение поля {{ClsMnu|Источник}} равным {{ClsMnu|orderno || '_suffix'}}

это приведёт сгенерированный запрос к виду:

<syntaxhighlight lang="sql">
SELECT orderid,
orderno || '_suffix' suffixedorderno
FROM orders
WHERE orderno || '_suffix' LIKE '%1%'
</syntaxhighlight>

Если среди полей с установленным флагом видимости присутствует поле {{ClsKbrd|DELETED}}, то в представлении в контекстном меню будет доступен пункт {{ClsMnu|Показать удалённые}}, управляющий отображением записей с данным флагом.

===== Вкладка «Действия» =====
На вкладке {{ClsMnu|Действия}} производится определение действий, доступных для вызова пользователем из панели инструментов и контекстного меню пользовательского представления. Порядок следования пунктов контекстного меню и пиктограмм действий определяется их последовательностью в таблице и может быть изменён при помощи соответствующих кнопок панели инструментов вкладки {{ClsMnu|Действия}}.

{{Picture|AwCustomViewActions.png|title=Окно документа {{ClsMnu|Пользовательское представление}}. Вкладка {{ClsMnu|Действия}}|num=4.190|id=1264}}

В основе действий также лежат сценарии Fastscript.

{{Picture|AwCustomViewActionsAddNew.png|title=Окно добавления нового действия для пользовательского представления|num=4.191|id=1351}}

{{DlgField|Идентификатор|уникальный идентификатор определяемого действия;}}
{{DlgField|Наименование|русскоязычное название определяемого действия;}}
{{DlgField|Скрипт|ссылка на сценарий FastScript, определяющий сущность выполняемого действия;}}
{{DlgField|Пиктограмма|миниатюрное графическое изображения для кнопки действия на панели инструментов.}}

===== Вкладка «Доступ» =====
На вкладке {{ClsMnu|Доступ}} производится определение, кому из сотрудников и каким подразделениям будет доступно данное пользовательское представление.

{{Picture|AwCustomViewAccess.png|title=Окно документа {{ClsMnu|Пользовательское представление}}. Вкладка {{ClsMnu|Доступ}}|num=4.192|id=1265}}

Для добавления сотрудника или подразделение в список разрешённых предназначены соответствующие команды панели инструментов вкладки и контекстного меню.

==== Отображение пользовательских представлений ====
Сформированные пользовательские представления отображаются в соответствующем разделе приложения. Раздел {{ClsMnu|Пользовательские представления}} будет виден в том случае, если есть хотя бы одно активное пользовательское представление.

В левой части пользовательского представления отображается дерево фильтров, которое функционально идентично аналогичному дереву фильтров для регулярных представлений и настраивается соответствующим образом. (см. {{pg|Руководство пользователя altAwin:Правила работы с фильтрами}}). В верхней части пользовательского представления отображается поле быстрого фильтра, также работающее аналогично регулярным представлениям.

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

==== Экспорт и импорт пользовательских представлений ====
Существует возможность экспорта документов пользовательских представлений во внешний файл для возможности последующего импорта в другую установку altAwin. Вместе с пользовательскими представлениями дополнительно экспортируются связанные скрипты и пользовательские диалоги. Для экспорта следует воспользоваться кнопкой "Экспорт", расположенной на панели инструментов представления "Пользовательские представления".

Импорт пользовательских представлений осуществляется при помощи кнопки "Экспорт", также расположенной на панели инструментов представления "Пользовательские представления".

{{Info|1= Экспорт и импорт пользовательских представлений доступен под учётной записью администратора}}

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

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

imported>Kirillche: save from wiki docs editor