Клиентское приложение

ClientIcon48 Настройки клиентского приложения ClientIcon16 ClientLoader.exe устанавливаются в файле ClientLoader.exe.config в секции userSetting.Ultima.ClientProperties.Settings:

<userSettings>

 <Ultima.Client.Properties.Settings>

         <setting name="AuthMethod" serializeAs="String">

                 <value>Interactive</value>

         </setting>

         <setting name="Login" serializeAs="String">

                 <value>root</value>

         </setting>

         <setting name="Password" serializeAs="String">

                 <value>n/a</value>

         </setting>

         <setting name="AutomaticServerSelection" serializeAs="String">

                 <value>False</value>

         </setting>

         <setting name="ModuleCacheFolderName" serializeAs="String">

                 <value>ClientModules</value>

         </setting>

         <setting name="MapCacheFolder" serializeAs="String">

                 <value>MapCache</value>

         </setting>

         <setting name="ClientApplicationID" serializeAs="String">

                 <value>1</value>

         </setting>

         <setting name="UpdateModules" serializeAs="String">

                 <value>True</value>

         </setting>

         <setting name="DuplexProtocol" serializeAs="String">

                 <value>True</value>

         </setting>

         <setting name="ThreadingAlerts" serializeAs="String">

                 <value>True</value>

         </setting>

         <setting name="ScreenDpiCheckEnabled" serializeAs="String">

                 <value>True</value>

         </setting>

         <setting name="StartupCommands" serializeAs="String">

                 <value />

         </setting>

         <setting name="ServerAddresses" serializeAs="Xml">

                 <value>

                         <ArrayOfServerAddress

                         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

                         xmlns:xsd="http://www.w3.org/2001/XMLSchema">

                                 <ServerAddress>

                                         <Host>localhost</Host>

                                         <Port>8192</Port>

                                         <DuplexProtocol>true</DuplexProtocol>

                                         <Quality>1</Quality>

                                 </ServerAddress>

                         </ArrayOfServerAddress>

                 </value>

         </setting>

 </Ultima.Client.Properties.Settings>

</userSettings>

AuthMethod — выбирает метод авторизации пользователя при запуске приложения, имеет следующие значения:

interactive — графический интерфейс ввода логина/пароля;

automatic — полностью автоматический вход.

Login — логин, под которым осуществляется автоматический вход в приложение.

Password — пароль для автоматического входа.

AutomaticServerSelection — определяет возможность выбора пользователем при запуске приложения сервера приложений:

true — пользователь не имеет возможности выбирать сервер приложений самостоятельно;

false — пользователь имеет возможность выбирать сервер приложений самостоятельно.

ModuleCacheFolderName — папка, в которой сохраняются модули клиентского приложения.

MapCacheFolder — папка, используемая для хранения кэша карт.

ClientApplicationID — код клиентского приложения (перечень клиентских приложений хранится в базе данных). Стандартное клиентское приложение Windows Forms на базе модулей имеет код 1. Примерами других приложений могут быть терминал печати накладных, монитор выдачи и т. п. Для обычной разработки клиентских модулей эту настройку менять не нужно.

UpdateModules — загрузка модулей клиентского приложения, имеет следующие значения:

true — при запуске клиентского приложения его модули загружаются с сервера приложений и сохраняются в папку, заданную параметром ModuleCacheFolderName;

false — модули загружаются локально из папки, заданной параметром ModuleCacheFolderName.

DuplexProtocol — канал связи с сервером приложений, должен быть таким же, что и для сервера приложений, имеет следующие значения:

true — используется дуплексный канал (рекомендуемое значение);

false — используется стандартный канал .NET Remoting.

ThreadingAlerts — выдавать предупреждения при выполнении в клиентском приложении синхронных вызовов удаленных методов. Настройка полезна в первую очередь прикладным разработчикам и пользователям, работающим с тестовой версией конфигурации:

true — выдавать предупреждения;

false — не выдавать предупреждения.

ScreenDpiCheckEnabled —проверка DPI экрана при старте приложения.

true — проверять настройки системы и прекращать работу при неподдерживаемых значениях DPI;

false — пропустить проверку.

StartupCommands — список команд, выполняемых при старте клиентского приложения (GUID-ы команд модулей, перечисленные через запятую). В качестве команды, выполняемой при старте системы, может использоваться, к примеру, наиболее часто используемый журнал документов (или несколько таких журналов), окно приветствия или совет дня.

ServerAddresses — перечень серверов приложений, с которыми может работать клиентское приложение. Задается массивом ArrayOfServerAddress, который включает один или более элементов ServerAddress, имеющих следующие параметры:

Host – IP-адрес сервера приложений;

Port – порт сервера приложений;

DuplexProtocolканал связи с сервером приложений, аналогично описанному выше;

Quality – вес, согласно которому вычисляется вероятность подключения клиентского модуля именно к этому серверу приложений, если их в массиве ArrayOfServerAddress более одного. Вероятность равна отношению веса данного сервера к сумме весов всех серверов вместе взятых.
Например, в массиве прописано три сервера приложений, у первых двух из которых параметр Quality равен "1", а у третьего "2". В этом случае клиентский модуль при подключении к серверу приложений с вероятностью 25% выберет один из двух первых серверов и с вероятностью 50% последний.

35_settings

Для настройки компьютера, предназначенного для функционирования клиентского приложения, необходимо выполнить следующие действия:

установить на компьютер операционную систему семейства Windows;

установить платформу .NET Framework версии не ниже 4.6;

скопировать дистрибутив Client;

отредактировать файл конфигурации ClientLoader.exe.config.

запуск клиентского приложения настоятельно рекомендуется осуществлять через утилиту обновления ClientUpdater.exe.