Веб-доступ системы DIRECTUM является веб-приложением, в котором клиентом выступает проводник веб-доступа, а веб-сервером – сервер веб-доступа.
Один экземпляр веб-доступа может иметь несколько веб-модулей. Все доступные веб-модули можно найти в проводнике веб-доступа. Подробнее см. раздел «Список веб-модулей».
В дополнение к точкам конфигурирования, существует возможность выполнения программного кода как на стороне сервера, так и на стороне веб-браузера. Таким образом, чтобы реализовать специфические требования, достаточно модифицировать веб-модули, не требуется изменять код платформы веб-доступа.
Клиент веб-доступа можно модифицировать под нужды организации, разрабатывая свои веб-модули или изменяя существующие.
Алгоритм разработки веб-модуля:
1. | Развернуть сервер веб-доступа. Порядок действий см. в документе «Инструкция по установке системы», в главе «Установка системы DIRECTUM», раздел «Серверная часть веб-доступа». |
В результате:
• | добавится папка с файлами сервера веб-доступа. По умолчанию C:\Inetpub\wwwroot\DIRECTUMWebAccess\; |
• | в структуре IIS добавится новый веб-сайт «Сервер веб-доступа к DIRECTUM» и пул приложений для созданного узла. |
2. | Установить стандартные шаблоны разработки: |
a) | В папке %PROGRAMFILES(x86)%\DIRECTUM Company\WebDevTools\WebModuleTemplates запустить файл install.bat. Откроется окно для ввода командной строки. |
Папка, помимо установочного файла, содержит:
• | папку «Visual Basic» – шаблоны для проектов, созданных на языке Visual Basic; |
• | папку «Visual C#» – шаблоны для проектов, созданных на языке С#. |
b) | Ввести значение y и нажать на клавишу ENTER. |
В результате при создании новых проектов в программе Microsoft Visual Studio будут доступны стандартные шаблоны разработки.
Файлы веб-модуля будут созданы автоматически.
Примечание
Вместо создания проекта в Microsoft Visual Studio, можно скопировать файлы стандартного веб-модуля и редактировать их в любом текстовом редакторе. Для удобства рекомендуется работать в Visual Studio.
4. | Разработать логику веб-модуля. При этом можно использовать: |
• | XML-файл для изменения настроек по умолчанию. Например, ограничить права доступа на компоненты, настроить состав дерева папок и закладок боковой панели проводника веб-доступа и т.д. |
При появлении новых элементов (кнопок, закладок и т.п.) или изменении названий существующих, добавляйте и переопределяйте строки в файлах локализации;
• | библиотеки для реализации сложной логики работы веб-доступа: |
• | JavaScript-библиотека для реализации логики отдельных действий веб-модуля. Например, прописать вычисления, выполняемые при нажатии на кнопку ленты справочника; |
• | Dll-библиотека. Например, применить фильтрацию для записей справочника или значений выпадающего списка. |
Если нужно связать платформу IS-Builder и веб-доступ, т.е. получить внешние данные, используйте веб-сервисы.
Для запроса параметров отчетов, сценариев, действий, фильтрации справочников в системе могут использоваться прикладные диалоги. Обеспечьте работоспособность таких компонент в веб-доступе с помощью вызова диалогов.
Примечание
Примеры разработки веб-модулей см. в статье на DIRECTUM Club.
При разработке пользуйтесь:
• | серверной объектной моделью веб-доступа. Она предоставляет интерфейс программирования приложений для работы с объектами системы DIRECTUM на платформе Microsoft .NET. По умолчанию файлы объектной модели расположены в папке %PROGRAMFILES(x86)%\DIRECTUM Company\WebDevTools\WebAccess.API. |
Руководство по серверной объектной модели веб-доступа содержит описание пространств имен WebAccess.API, WebAccess.API.Exceptions, WebAccess.API.Ports, их классов, делегатов, интерфейсов, перечислений, а также примеры использования;
• | клиентской объектной моделью веб-доступа. Она предоставляет средства для управления элементами страниц веб-доступа и доступа к данным DIRECTUM на JavaScript при помощи пространств имен и классов. |
Руководство по клиентской объектной модели веб-доступа можно использовать для решения прикладных задач, таких как создание и открытие документа, запуск мастеров действий, отправка задачи по типовому маршруту и т.п.
5. | Если были созданы библиотеки, необходимо прописать их включение в xml-файле: |
• | JavaScript-библиотеку – в атрибуте jsfile элемента Extension, если библиотека необходима для всех объектов, или в атрибуте customcardformclass секции Cards для карточки объекта; |
• | Dll-библиотеку – в атрибуте class элемента Extension указать полное имя сборки. |
7. | Протестировать и отладить работу веб-модуля. В том числе, в разных браузерах, потому что браузеры немного по-разному воспринимают код JavaScript. |
Если необходимо, внести изменения в файлы веб-модуля и снова опубликовать.
8. | Перезапустить группу приложений веб-доступа или службу IIS. |
В результате новый веб-модуль появится в списке веб-модулей проводника веб-доступа.