Справка по системе Платформа ELMA BPM
×
Меню

Свойства контекстной переменной в операции "Задача"

Свойства контекстной переменной в операции Задача отличаются от тех свойств, что доступны на вкладке Контекст в карточке процесса. Чтобы получить доступ к этим свойствам, необходимо на вкладке Форма (контекст) в настройках операции Задача выбрать нужную переменную и выполнить одно из следующих действий:

Вкладка "Общие"

Рис. 1. Свойства контекстной переменной. Вкладка "Общие"
Имя свойства – название контекстной переменной процесса, которое задается при ее создании. В данном окне она редактированию не подлежит. Имя контекстной переменной можно изменить в карточке процесса на вкладке Контекст при редактировании контекстной переменной процесса.
Название на форме – название контекстной переменной, которое будет отображаться на форме задачи в веб-приложении. По умолчанию совпадает со значением поля Имя свойства, но здесь его можно изменить.
Это название не зависит от имени свойства контекстной переменной. То есть при изменении значения поля Имя свойства контекстной переменной содержимое поля Название на форме не изменяется.
Описание – подробная информация о контекстной переменной и ее назначении в рамках текущей задачи. Это описание не зависит от описания контекстной переменной процесса, задаваемого на вкладке Контекст при редактировании контекстной переменной процесса.
Всплывающая подсказка – текстовое поле для введения подсказки, которая будет отображаться на форме задачи рядом с указателем мыши при наведении курсора на данное поле.
Флажок Обязательная для заполнения позволяет запретить исполнителю не заполнять значение переменной на форме задачи в веб-приложении. Выход из задачи будет невозможен до тех пор, пока не задано значение переменой.
Флажок Только для чтения запрещает редактирование переменной на форме задачи в веб-приложении.
Для строковых полей с типом данных Текст и Строка на вкладке Общие отобразится дополнительное поле Заполнитель. В данном поле необходимо ввести текст, который будет отображаться серым цветом на форме задачи в текущем строковом поле.
Быстрое редактирование свойства при установке данного флажка в веб-приложении на форме задачи (рис. 2) будет доступно быстрое редактирование настраиваемого свойства (т.е. редактирование данного свойства записи блока доступно сразу же после загрузки страницы). Данный параметр доступен только при редактировании свойств блока (для свойств вложенных блоков данный параметр недоступен). Следует отметить, что при установленном флажке Только для чтения, свойство будет недоступно для редактирования.
Рис. 2. Отображение свойства блока в веб-приложении

Вкладка "Свойства блока"

Данная вкладка отображается только для свойства контекстной переменной типа "Блок".
На данной вкладке осуществляется настройка отображения свойств блока на форме задачи (рис. 3).
Рис. 3. Свойство контекстной переменной типа "Блок". Вкладка "Свойства блока"
Данная вкладка практически полностью аналогична вкладке Форма (контекст) операции Задача. Отличие заключается в отсутствии кнопки Добавить.

Вкладка "Вложенные свойства"

Эта вкладка доступна только для переменных, в качестве типа которых задан объект системы ELMA.
По умолчанию для каждого объекта в системе настроена форма отображения в веб-приложении. На данной вкладке можно изменить эту форму.
Настройка свойств объекта производится аналогично настройке формы задачи на вкладке Форма (контекст) за исключением нескольких моментов. Для свойств объекта на данной вкладке нельзя:
Эти параметры задаются для всех объектов одного типа в карточке объекта.
Флажками Обязательно и Только для чтения можно указать обязательность заполнения соответствующих свойств объекта на форме задачи или запрещать их редактирование.
Рис. 4. Свойства контекстной переменной. Вкладка "Вложенные свойства"

Вкладка "Дополнительные"

На данной вкладке (рис. 5) можно выбрать один из предложенных вариантов отображения свойства, а также при необходимости указать сценарий, который будет запускаться при изменении значения контекстной переменной в веб-приложении. Следует отметить, что блок Скрывать, если не заполнено будет отображен только в том случае, если для данного свойства на вкладке Общие установлен флажок Только для чтения. Для добавления сценария нажмите кнопку Указать сценарий (рис. 5).
Рис. 5. Указать сценарий
В появившемся интерфейсе выберите сценарий (рис. 6):
- выбрать один из уже существующих сценариев.
Если нужного сценария нет, с помощью кнопки Создать можно добавить новый сценарий.
Кнопка Перейти позволяет открыть выбранный сценарий на вкладке Сценарии в карточке процесса, где его можно просмотреть или отредактировать.
Рис. 6. Выбор сценария
В случае, если осуществляется настройка свойства типа "Блок", на данной вкладке будет отображено 2 дополнительных параметра (рис. 7).
Рис. 7. Свойство контекстной переменной типа "Блок". Вкладка "Дополнительные"
Сценарий при загрузке формы блока сценарий, который будет выполнен при загрузке формы блока.
Префикс для таблицы блока данная настройка необходима для сохранения установленных настроек блока. В случае, если на другой форме задачи данного процесса необходимо использовать текущие настройки, необходимо указать тот же префикс. При создании префикса могут быть использованы только латинские символы, цифры и подчеркивания.

Вкладка "Системные"

На данной вкладке можно задать параметры переменной, используемые в сценариях или при создании новых модулей, а также задать форму .NET Razor, используемую для отображения переменной (рис. 8).
Рис. 8. Свойства контекстной переменной. Вкладка "Системные"
Имя элемента – уникальное название переменной на английском языке.
Уникальный идентификатор – уникальный идентификатор элемента. Он генерируется автоматически при создании элемента и не может быть изменен.
Форма Razor – если вас не устраивает стандартное отображение переменной, ее отображение можно запрограммировать в форме .NET Razor. Для редактирования формы необходимо нажать на кнопку Редактировать, после чего откроется диалоговое окно Выбор представления (рис. 9), в котором необходимо выбрать требуемое представление и нажать на кнопку ОК.
Рис. 9. Выбор представления
В данном диалоговом окне отражается путь представления и его название, которое генерируется автоматически при создании представления. Данное имя можно изменить. После нажатия на кнопку ОК выбранное представление будет открыто на вкладке Формы (рис. 10).
Рис. 10. Просмотр кода на форме Razor
На данной вкладке необходимо выбрать представление для редактирования и нажать на кнопку Изменить.
По умолчанию выпадающий список содержит следующие представления:
При нажатии на кнопку Изменить появляется возможность редактирования файла шаблона формы .NET Razor (рис. 11).
Рис. 11. Редактирование кода на форме Razor
Для сохранения внесенных изменений необходимо воспользоваться кнопкой Сохранить, расположенной в верхнем меню вкладки.
Кроме того, всегда есть возможность сбросить все изменения и вернуться к представлению по умолчанию, нажав на кнопку Использовать представления по умолчанию.
При нажатии на кнопку Показать представление по умолчанию открывается диалоговое окно с исходным представлением, представленное на рис. 12.
Рис. 12. Форма Razor. Представление по умолчанию
Файл шаблона
Шаблоны создаются на языке разметки .NET Razor. Файл шаблона должен иметь расширение cshtml. Изменять файл шаблона можно как описанным выше способом, так и с использованием внешнего редактора, например, Microsoft Visual Studio.
При создании файла шаблона в Microsoft Visual Studio его нужно разместить в каталоге с конфигурацией. Рекомендуется использовать следующую структуру папок для размещения файла шаблона свойства пользовательской задачи:
В папке с конфигурацией создать структуру папок:
WebApplication
Modules
EleWise.ELMA.BPM.Web.Tasks
Views
Task
Properties
В папке Properties разместить файл шаблона.
Таким образом, рекомендуется создавать следующий путь к файлу шаблона .NET Razor для свойств пользовательских задач:
{Папка с конфигурацией}/WebApplication/Modules/EleWise.ELMA.BPM.Web.Tasks/Views/Task/Properties/{Название файла шаблона}.cshtml
где {Название файла шаблона}.cshtml – название Вашего файла, содержащего файл шаблона.

Вкладка "Отображение"

Вкладка Отображение (рис. 13) содержит настройки отображения свойства в веб-интерфейсе.
Рис. 13. Свойства контекстной переменной. Вкладка "Отображение"
Скрывать на основной форме – при установке данного флажка данное свойство не будет отображаться на основной, редактируемой в данный момент, форме.
Скрывать на всплывающих окнах – при установке данного флажка данное свойство будет скрыто в том случае, если форма была задана для всплывающего окна.
См. также: