Настройка элементов управления

Элемент, добавленный в карточку, может быть настроен или как поле, или как свойство. По умолчанию, добавленный в карточку элемент, является свойством.

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

Данные всех свойств хранятся в разделе Свойства, который представляет собой таблицу атрибутов выбранного элемента. Работа со свойствами осуществляется через элементы управления карточки, обращающиеся к разделу Свойства. Это неэффективно из-за относительно невысокой производительности и затруднений, возникающих при настройке запроса атрибутивного поиска и представления.

Данные поля хранятся в самом поле. Для поля элементы управления, размещенные на карточке в режиме настройки, привязываются не к разделу Свойства, а непосредственно к полю. Чтобы выполнить привязку, установите атрибуты Источник данных и Поле данных. В качестве источника данных выберите раздел карточки, а в качестве поля — нужное поле из выбранного раздела. После этого, элемент управления будет читать и сохранять данные в указанное поле. Таким образом, атрибутивный поиск по данному полю не будет отличаться от стандартного поиска системы Docsvision.

Атрибуты (свойства) категории Внешний вид, а также атрибуты Видимость, Только для чтения и Обязательное настраиваются для каждой разметки. Все остальные атрибуты имеют одинаковое значение для всех разметок одного типа карточки.

Во всех элементах, предполагающих выбор значений из справочников, доступен быстрый поиск по подстроке.

Чтобы настроить элемент управления:

  1. Выполните любое из действий:

    • Дважды щелкните левой клавишей мыши по элементу в области Разметки.

    • Щелкните правой кнопкой мыши по нужному элементу на панели Структура разметки и выберите пункт Свойства, чтобы открыть окно свойств элемента.

      Окно свойств элемента управления
      Рисунок 1. Окно свойств элемента управления

  2. Заполните свойства элемента.

  3. Чтобы раскрыть полный список свойств элемента, в описанном выше окне нажмите на ссылку Больше.

    Атрибуты сгруппированы по категориям. Часть атрибутов общая для всех элементов управления, для некоторых элементов можно настроить также специфические атрибуты.

    Окно расширенных свойств элемента управления
    Рисунок 2. Окно расширенных свойств элемента управления

  4. Заполните свойства элемента.

  5. Добавьте собственный скрипт для элемента разметки:

    1. Перейдите на вкладку События.

      Окно событий элемента управления
      Рисунок 3. Окно событий элемента управления

    2. Выберите строку события, для которого настраивается обработчик.

    3. Нажмите кнопку … в строке с названием обработчика.

    4. Реализуйте метод-обработчик (будет добавлен автоматически) на языке C# или VB .Net (зависит от языка, выбранного для скрипта данного вида карточек).

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

    5. Сохраните настройки скрипта карточки.

  6. После завершения настройки данного элемента управления или разметки, сохраните настройки разметки.

    Заранее настроенные (стандартные) элементы управления в карточках документов и заданий могут быть удалены из разметки. В таком случае они появляются в списке доступных элементов области Панель инструментов после повторного открытия "Конструктора разметок", или после повторного выбора вида карточки.

Выбрать источник данных

Источник данных для элемента можно выбрать как в первоначальной малой форме свойств, так и в большой форме (после нажатия на Больше…​).

Источником данных может выступать раздел или элемент метаданных простого ("плоского") типа (обозначен в конструкторе как Struct), либо типа Коллекция значений (обозначен в конструкторе как Table).

В секциях типа Table и Tree запрещается создавать поля метаданных с именем section (вне зависимости от регистра), т.к. данное имя зарезервировано системой.

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

Большинство элементов карточки используют в качестве источника метаданные простого типа:

  • Карточка Документ:

    • Основная информация.

    • Системные свойства.

    • Хранение.

    • Отправители.

  • Карточка Задание:

    • Системные свойства.

    • Настройки.

    • Задание.

    • Настройки завершения.

    • Настройки вида подчиненного задания.

    • Настройки создания подчиненного задания.

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

Пользователь может создать для карточки новые секции и поля — расширенные метаданные.

Настроить текстовую метку

Для каждого элемента, имеющего большую форму свойств, можно настраивать расположение текстовой метки.

Настроить метку можно задав следующие Общие свойства элементов управления:

Настроить доступность элемента

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

Настройка доступа к управлению элементом производится в атрибутах элемента, в свойстве Имя, Операция редактирования раздела Данные.

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

Настроить видимость элемента

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

Настройка видимости определяется свойством Видимость, который содержится в группе Поведение Общих свойств элементов управления. Свойство имеется у всех элементов, предоставляющих расширенную форму свойств.

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

Настроить очередность обхода полей карточки по кнопке Tab

Пользователь может настроить собственную очередность обхода карточки по кнопке Tab.

Чтобы настроить последовательность, в группе Поведение Общих свойств элементов управления предусмотрены свойства:

Чтобы включить возможность перехода по Tab, необходимо в свойстве Переходить по Tab выбрать значение Да.

Порядковый номер поля задаётся в свойстве Порядок обхода. Номер вводится пользователем вручную. Уникальность введённого номера системой не отслеживается, т.е. пользователь может нескольким полям проставить один и тот же номер. Например, если трем полям задать номер 5 переход к данным полям произойдет после поля с номером 4, но в произвольном порядке.

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

Для карточки Задание базовым полям назначены номера порядка обхода с шагом 10, т.е. 10, 20, 30 и т.д. Чтобы задать очередность обхода для пользовательских полей, им следует задавать номера, отличные от базовых (11, 25 и т.п.).

Написание скрипта для элемента

Пользователь может написать собственные скрипты для каждого элемента, добавленного в разметку.

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

  1. Откройте окно свойств элемента.

  2. Перейдите на вкладку События.

    Просмотр списка событий элемента
    Рисунок 4. Просмотр списка событий элемента

  3. Нажмите на кнопку Три точки, расположенную в правой части поля.

    Будет открыто окно редактирования скрипта.

    Окно редактора скриптов
    Рисунок 5. Окно редактора скриптов

  4. Измените текст скрипта элемента, либо добавьте собственный скрипт.

    Работа в окне редактирования скрипта выполняется аналогична работе с Конструктором скриптов.

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

    Кнопка Конструктор позволяет открыть на чтение Конструктор скриптов. Допускается возможность копирования кода.

    Также окно содержит область для подключения к скрипту дополнительных сборок.