Инструкция по установке доработки телефонного справочника и портлета
Описание
В период совместной работы по переходу с ELMA 2.5 на ELMA 3 был сделан ряд доработок. В данном документе приведен перечень доработок, которые были сделаны индивидуально для ОАО «ЕЭСК». Их особенности, в том числе расположение, и рекомендации по обновлению.
Данный документ необходимо использовать администратору системы ELMA ОАО «ЕЭСК» и, при привлечении к работам, сотрудниками ООО «ЭЛМА».
Размещение доработок
Специфика работы с доработками при обновлении состоит в том, что при обновлении все измененные файлы переписываются новыми. Это сделано во избежание ошибок при обновлении.
Для исключения изменения страниц на стандартные при обновлении системы все измененные страницы необходимо дублировать с полным путем в папке С:\ELMA3-Standart\UserConfig\WebApplication.
Пример: Для того чтобы в задачах согласования раздел «Дополнительно» по умолчанию был свернут мы изменили файл C:\ELMA3-Standart\Web\Modules\EleWise.ELMA.Documents.Docflow.Web\
Views\Shared\Approvement\EditForm.cshtml.
Этот файл при обновлении будут заменен стандартным, чтобы доработка не пропала при обновлении в папке C:\ELMA3-Standart\UserConfig\WebApplication\дублируем этот файл.
Полный путь будет выглядеть следующим образом: C:\ELMA3-Standart\UserConfig\WebApplication\Modules\EleWise.ELMA.Documents.Docflow.Web\Views\Shared\Approvement\EditForm.cshtml.
Перечень доработок
Небольшая легенда: Razor – доработана разметка и код C#; JavaScript – для изменения страницы использовался JavaScript; Символ «~» - путь C:\ELMA3-Standart\UserConfig\WebApplication\
| Описание | Решение |
| В задачах согласования по умолчанию раздел «Дополнительно» должен быть свернут | Изменена форма страницы. Razor. ~\Modules\EleWise.ELMA.Documents.Docflow.Web\Views\Shared\Approvement\EditForm.cshtml |
| В задачах согласования по умолчанию должен быть таб «Документ» | Изменена форма страницы. JavaScript. ~\Modules\EleWise.ELMA.Documents.Docflow.Web\Route\Approvement.cshtml ~\Modules\EleWise.ELMA.Documents.Docflow.Web\Views\Approvement\Execute.cshtml |
| При регистрации документа в дате регистрации не должно быть времени | Новый объект «LastCharYear» со сценарием для «урезания» даты. |
| Исключить во всех документах возможность «Отправить на регистрацию» и «Обсуждение документа» | Изменена форма страницы. Razor. ~\Modules\EleWise.ELMA.Documents.Web\Views\Document\View.cshtml |
| Сделать по умолчанию неактивными кнопки внизу документа «комментарии, вопросы, вложения, действия» | Изменена форма страницы. Razor. В объекте Договор на форме просмотра добавлена ссылка на новую форму. ~\Modules\EleWise.ELMA.Documents.Web\Views\Document\addButtonPanel.cshtml ~\Modules\EleWise.ELMA.Documents.Web\Views\Shared\ViewItems\DocumentCommentsHistoryPanelViewItem.cshtml |
| В типе документа договор сделать кнопки в впадающем списке "отправить". Для запуска процессов | Изменена форма страницы. Razor. В объекте Договор на форме просмотра добавлена ссылка на новую форму. ~\Modules\EleWise.ELMA.Documents.Web\Views\Document\addButtonPanel.cshtml ~\Modules\EleWise.ELMA.Documents.Web\Views\Shared\ViewItems\DocumentCommentsHistoryPanelViewItem.cshtml |
| При регистрации всех документов сделать недоступным выбор даты регистрации | Изменена форма страницы. Razor. ~\Modules\EleWise.ELMA.Documents.Docflow.Web\Views\Shared\RegistrationCard\EditFormFieldsNoHiddens.cshtml |
| Поле «Сделать текущей» должно быть обязательным полем для добавления новой версии. Не само прикрепление версии обязательно для всех документов, а именно «флажок» стоять по умолчанию | Изменена форма страницы. Razor. JavaScript ~\Modules\EleWise.ELMA.Documents.Docflow.Web\Views\Shared\DocumentItemVersionAddForm.cshtml ~\WebApplication\Modules\EleWise.ELMA.Documents.Web\Views\DocumentVersion\EditForm.cshtml |
| Удалить со стандартных форм документа кнопку ЭлмаАгента | Изменена форма страницы. Razor. ~\Modules\EleWise.ELMA.Documents.Web\Views\Document\addButtonPanel.cshtml ~\Modules\EleWise.ELMA.Documents.Docflow.Web\Views\Route\Approvement.cshtml ~\Modules\EleWise.ELMA.Documents.Docflow.Web\Views\Route\Acquaintance.cshtml |
| При ошибке о нехватке прав доступа к документу должны отображаться только пользователи в группе «Администраторы» | Изменена форма страницы. Razor. ~\Modules\EleWise.ELMA.BPM.Web.Common\Views\Shared\Entity\AccessDenided.cshtml |
| При создании задачи с вложением «Документ» пользователем, имеющим права доступа «чтение» на документ, необходимо чтобы давались права доступа «чтение» на документ исполнителю задачи | Новый объект «Лстнр выдача прав на документ» со сценарием для отслеживания события. Изменена форма страницы. Razor. ~/Modules/EleWise.ELMA.Documents.Web/Views/AddPermissionToDocument.cshtml ~/Modules/EleWise.ELMA.BPM.Web.Security/Views/PermissionManagment/EntityAddPermission.cshtml |
| Когда исполнитель какой-либо пользовательской задачи создает подзадачу, то необходимо выдавать права на просмотр этой подзадачи автору самой главной родительской задачи | Новый объект «Лстнр» со сценарием для отслеживания события. |
| Портлет «Инвест. программа» | Портлет. C:\ELMA3-Standart\Web\Modules\EleWise.ELMA.ImportantDocumentsAndLinks.Web |
| При регистрации всех документов сделать недоступным выбор даты регистрации. Если дело регистрации содержит «от определенной даты», то можно выбирать дату регистрации | Изменена форма страницы. Razor. ~\Modules\EleWise.ELMA.Documents.Docflow.Web\Views\Shared\RegistrationCard\EditFormFieldsNoHiddens.cshtml |
| Изменить форму просмотра задачи и выходить ссылку на родительскую задачу | Изменена форма страницы. Razor. ~/Modules/EleWise.ELMA.BPM.Web/Tasks/Views/Task/GeneralInfo.cshtml |
| Убрать возможность в задачах согласования скачать текущую версия со вкладки "Согласование" | Изменена форма страницы. Razor. ~/Modules/EleWise.ELMA.BPM.Web/Tasks/Views/Shared/Task/AttachmentsForCopiedPanel.cshtml |
| Всегда должно быть развернуто меню копирования вложения из подзадач при исполнении | Изменена форма страницы. Razor. ~/Modules/EleWise.ELMA.Docflow.Web/Views/Approvement/ResolverTable.cshtml |
| Переназначение простых задач при замещении | Новый объект «Листенер замещения обычных задач» со сценарием для отслеживания события. |
| Доработка "Исполнение задач" | Доработан веб-модуль. Изменена форма страницы. Razor. Путь до модуля ~/Modules/EleWise.ELMA.TasksExtension.Web ~/Modules/EleWise.ELMA.BPM.Web.Tasks/Views/Task/Execute.cshtml C:\ELMA3-Standart\UserConfig\Notifications\Tasks.Task.xml (Шаблон оповещения) Доработано, кнопка «Сделано» - дополнительные условия. |
| Доработка портлета "Задачи" | Изменена форма страницы. Razor. ~\Modules \EleWise.ELMA.BPM.Web.Tasks\Views\AllTasks\Info.cshtml ~\Modules\EleWise.ELMA.BPM.Web.Tasks\Views\AllTasks\MyTasksPortletGrid.cshtml |
| Доработка телефонного справочника | Объект «Телефонный справочник» со сценариями |
| Разработка портлета для поиска в телефонном справочнике | Файл PortletForPhoneCatalogEESC.1.0.0.7.elma3. |
| Контактная информация о пользователе: ссылка на телефонный справочник | Расширена объектная модель User Изменены формы: ~\Modules\EleWise.ELMA.BPM.Web.Security\Views\User\Views\ContactInfo.cshtml ~\Modules\EleWise.ELMA.BPM.Web.Security\Views\User\Editors\ContactInfoEditor.cshtml |
Копия доработок
На сервере 10.1.12.106 в папке «D:\Резервная копия доработок ELMA» сохранена резервная копия всех индивидуальных доработок. Папка содержит: портлет, папку WebApplication и файл Tasks.Task.xml из Notifications.
Обновление системы
При обновлении системы все доработки, размещенные в папке C:\ELMA3-Standart\UserConfig\WebApplication\, не изменяются на стандартные.
Портлеты, также, остаются неизменным и для его работы действий не требуется.
Единственным дополнительным действием при обновлении является копирование файла C:\ELMA3-Standart\UserConfig\Notifications\Tasks.Task.xml. Обновление его затрагивает и обновляет на стандартный. Необходимо выполнить следующие действия с ним после обновления:
· Взять файл из резервной копии
· Открыть файл, заменить версию в заголовке version на текущую, пример: <Notifications description="Оповещения о задачах" version="3.7.1.32269">
· Подменить файл в папке C:\ELMA3-Standart\UserConfig\Notifications\
Инструкция по установке доработки телефонного справочника и портлета
Перенос портлета
В архиве с инструкцией приложен файл PortletForPhoneCatalogEESC.1.0.0.7.elma3.
Это компонент с портлетом для телефонного справочника. Для того чтобы установить его, нужно зайти в дизайнер и в нижней части окна выбрать пункт Импорт конфигурации.
Появится окно «Импорт конфигурации». В нем нужно указать путь к приложенному файлу. Вид окна представлен на рисунке 1.
Рисунок 1 – Вид окна импорта конфигурации
Далее следовать инструкциям. В ходе импорта будет выполнен перезапуск сервера. После обновления конфигурации нужно зайти в веб-часть приложения. Выбираем пункт меню «Администратирование» и на загруженной странице выбираем пункт «компоненты». Устанавливаем модуль с названием «Портлет для телефонного справочника ЕЭСК». После установки можно добавлять портлет на страницу. Расположение страницы с компонентами отображено на рисунке 2.
Рисунок 2 – Расположение страницы с компонентами
Перенос справочника
При переносе справочника нужно обратить внимание на несколько моментов.
Нужно скопировать код с вкладки «Дополнительный код» справочника (рисунок 3).
Рисунок 3 – Вид вкладки дополнительный код
В свойствах справочника появилось дополнительное поле, отвечающее за email. Одно из них с именем свойства «Email», оно имеет тип «строка» и используется конкретно для ввода данных. Второе поле имеет имя «VisibleEmail», для этого поля используется тип «html разметка». Вид окна «Свойства» показан на рисунке 4.
Рисунок 4 – вид окна «Свойства»
На рисунке 5 представлен вид вкладки «Дополнительно» свойства с именем «Email». Нужно убрать галочку с пункта «Форма просмотра», потому как для отображения будет использоваться «VisibleEmail».
Рисунок 5 – настройки «Email»
На рисунке 6 представлен вид вкладки «Дополнительно» свойства «VisibleEmail». Здесь мы убираем галочки с пунктов «Форма создания» и «Форма редактирования». Ставим галочку «Форма просмотра» и выбираем пункт «Показывать» в Списке. Так же выбираем Тип вычисляемого значения «Сценарий на C#». И копируем текст сценария, здесь вызывается один из методов класса, присутствущего на вкладке «Дополнительный код».
Рисунок 6 – свойства «VisibleEmail»
Аналогично выполнены настройки для свойства «Изображение».