Инструкция по установке доработки телефонного справочника и портлета

Описание

В период совместной работы по переходу с 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»

 

Аналогично выполнены настройки для свойства «Изображение».