Добавление web-приложения

В этой статье рассмотрим, как настроить сервер, чтобы можно было взаимодействовать с web-приложением через браузер.

Процесс добавления web-приложения будет рассматриваться относительно учебного проекта, с которым познакомились в статье Учебный проект.

План

Этап 1. Подготовка бинарников и форм

1. В папке с развернутой серверной частью создать папку \Web, в которой будут храниться бинарники для web-приложения. Например, D:\WorkflowEngine\Template\Web

2. Скопировать бинарники из папки WebBin архива в созданную папку \Web.

3. В папке \Template\Projects\1. Template разархивированного учебного проекта создать папку \WebForms, в которой будут храниться xml-файлы форм web-мобильного приложения. Например, D:\WT\Projects\Template\Projects\1. Template\WebForms

4. Скопировать содержимое папки WebForms из архива в созданную папку \WebForms.

5. В папке \Template\Projects\1. Template разархивированного учебного проекта создать папку \Web, в которой будет храниться razor-приложение для сборки исполнительного файла клиентского приложения. Например, D:\WT\Projects\Template\Projects\1. Template\WebForms

6. Скопировать содержимое папки WebApp из архива в созданную папку \Web.

Этап 2. Настройка конфига

В файл конфигурации D:\WorkflowEngine\Template\Web\appsettings.json внести правки:

• В поле ServerUrl проверить, совпадает ли указанный адрес с тем, на котором запущена серверная часть WT-приложения. При несовпадении указать верный путь.

• В поле HostUrl указать адрес и порт, на котором будет запущено web-приложение.

• В поле XmlFolder проверить, совпадает ли указанный путь до папки WebForms с тем, по которому располагается папка с xml-файлами форм web-приложения. По умолчанию это папка \1. Template\WebForms. При несовпадении указать верный путь.

• В полях AnonymousUserName и AnonymousPassword прописать WS_GUEST и 123 соответственно. В базе данных в таблице public.user для пользователя WS_GUEST проверить хэш пароля.

Далее подробнее рассмотрим каждый пункт плана.

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

Архив

Скачайте архив с бинарниками и xml-файлами форм:

234KB

WorkflowMobileForms.zip

archive

Open

Архив содержит две папки:

• WebBin - папка с бинарниками для web-приложений;

• WebForms - папка с xml-файлами форм;

• WebApp - папка с исходными файлами Razor-приложения для сборки исполняемых файлов web-приложения.

Подготовка бинарников и форм

В папке, в которую развернули серверную часть, например, D:\WorkflowEngine\Template, создадим папку Web для бинарников web-приложения. В новую папку D:\WorkflowEngine\Template\Web скопируем файлы из папки WebBin архива.

В папке \Template\Projects\1. Template разархивированного учебного проекта создадим папку \WebForms, в которой будут храниться xml-файлы форм web-приложения. Например, D:\WT\Projects\Template\Projects\1. Template\WebForms. Скопируем содержимое папки WebForms из архива в созданную папку WebForms.

В папке \Template\Projects\1. Template разархивированного учебного проекта создадим папку \Web, в которой будет храниться razor-приложение для сборки исполнительного файла web-приложения. Например, D:\WT\Projects\Template\Projects\1. Template\Web. Скопируем содержимое папки WebApp из архива в созданную папку Web.

Настройка конфига

Чтобы мобильное приложение могло взаимодействовать с серверной частью WorkflowEngine, нужно показать серверу, в каких папках лежат бинарники и xml-файлы форм. Зная пути до папок, сервер сможет отдавать файлы мобильным приложениям для скачивания на устройство.

В файл конфигурации web-приложения D:\WorkflowEngine\Template\Web\appsettings.json внесем правки:

"ServerUrl": "http://localhost:49707",
"HostUrl": "http://localhost:49708",
"XmlFolder": "D:\\WT\\Projects\\Template\\Projects\\1. Template\\WebForms",

• В поле ServerUrl указывается IP-адрес (или доменное имя) и порт серверной части WT-приложения, к которой будет обращаться web-приложение. Этот адрес указывали в файле D:\WorkflowEngine\Template\hosting.json в поле server.urls

• В поле HostUrl указывается IP-адрес (или доменное имя) и порт, на котором будет запущено web-приложения и доступно для работы в браузере.

• В поле XmlFolder указывается путь до папки WebForms с xml-файлами форм web-приложения.

• В полях AnonymousUserName и AnonymousPassword прописать WS_GUEST и 123 соответственно. В базе данных в таблице public.user для пользователя WS_GUEST проверить хэш пароля.

Если необходимо для пользователя WS_GUEST изменить пароль в базе данных, выполним запрос:

CREATE EXTENSION pgcrypto;

UPDATE public.user
SET user_password = encode(digest('new_password', 'sha512'), 'hex') 
WHERE user_name = 'WS_GUEST';

DROP EXTENSION pgcrypto;

Этот же пароль необходимо указать и в файле конфига.