Запуск
Запуск комплекса осуществляется исполнительным файлом Keysystems.Budget.exe :
- по кнопке на рабочем столе ОС Windows «Пуск — Все программы — Кейсистемс — Бюджет-СМАРТ» ;
- с помощью ярлыка на рабочем столе.
Откроется окно регистрации, в котором нужно указать имя пользователя и пароль. По кнопке [Параметры] в окне регистрации отобразятся дополнительные параметры запуска приложения, разбитые на вкладки, которые следует настроить/проверить при первом запуске программы.
В зависимости от разрядности ОС Windows Keysystems.Budget.exe автоматически запускается в нужном режиме: x86 для 32-рязрядной ОС, и x64 для 64-разрядной ОС.
Не следует использовать в ярлыке запуска исполняемый файл Keysystems.Budget_x86.exe - в этом случае корректная работа комплекса не гарантируется. Он используется в редких случаях, после консультации и рекомендации разработчиков ПК "Бюджет-СМАРТ", например когда в 64-разрядной ОС Windows используются сторонние компоненты в режиме x86, не умеющие взаимодействовать с 64-битными приложениями.
Если применяется сервис приложений (см вкладку "Соединение" в окне входа в комплекс), то при запуске осуществляется проверка соответствия версий клиентской части на компьютере пользователя и версия сервиса приложений: при несовпадении версий запуск программы невозможен, о чём будет выведено соответствующее сообщение.
Контроль соответствия версий можно смягчить в файле конфигурации web.config сервиса приложений в параметре:
Значение по умолчанию "true" - обязательное совпадение версий клиента и сервиса приложений.
В заголовке окна выводится: наименование комплекса и либо имя базы (с версией) и имя пользователя либо имя профиля.
Вкладка Регистрация
Профиль - наименование профиля конфигурации соединения. Профили создаются пользователем, позволяют быстро менять настройки соединения (логин, сервер, база, сервис СМАРТ) в случае необходимости работы с одного клиентского приложения с разными серверами, базами.
Для создания нового профиля следует заполнить его наименование в поле "Профиль" окна входа и войти в комплекс. Удаление и редактирование профиля осуществляется по кнопке "Профиль" (справа от поля профиля).
Пользователь - логин в базе данных, с которой будет работать пользователь. По умолчанию, повторный вход под тем же логином невозможен - сообщение "Пользователь уже работает в комплексе" - пока не будет закрыт стандартными средствами (меню "Выход") предыдущий сеанс работы. Если соединение зависло по каким-либо причинам (пользователь не может закрыть соединение с сервером базы данных), администратору следует удалить этого пользователя из пула соединений. Поведение при повторном входа по логину и паролю (без сертификата) можно изменить в настройке "Сбрасывать существующее соединение в пуле при входе в комплекс".
При входе по сертификату повторный вход возможен всегда, но при этом соединение предыдущего сеанса этого пользователя отключается автоматически.
Пароль - пароль пользователя.
СУБД - система управления базами данных - на какой платформе функционирует база данных (MS SQL или Oracle).
Сервер - имя экземпляра сервера СУБД либо IP адрес компьютера, где установлен SQL сервер. Например 192.168.23.11 .
Для указания соединения строго по TCP протоколу имя сервера следует указать в виде: TCP:<имя_SQL_server / IP_адрес>[,port] , где после "TCP:" указывается либо имя экземпляра SQL либо его IP адрес, далее через запятую может указываться порт соединения (необязательный параметр). Например tcp:192.168.23.11 .
Если используется сервис приложений (см вкладку "Соединение"), то к SQL серверу обращается сервис приложений, иначе к SQL серверу обращается непосредственно клиентское приложение пользователя.
При проблемах с соединением с SQL сервером ("Сервер не найден или недоступен") следует проверить/настроить :
- имя SQL Server, указанное в окне входа в комплекс,
- служба "SQL Browser" (Обозреватель SQL) должна быть запущена, настроить на автоматический её запуск.
- включить протокол TCP/IP в настройках сетевых протоколов SQL сервера в программе "SQL Server Configuration Manager" (конфигуратор SQL Server) .
- отключить брандмауэр Windows на SQL сервере или настроить его на разрешение входящих соединений по TCP-порту службы SQL (узнать номер порта можно в свойствах протокола TCP/IP в программе "SQL Server Configuration Manager", см. п.2 ) и на порт UDP 1434 (для работы SQL Browser).
База данных - имя базы данных на соответствующем сервере СУБД.
Вкладка Соединение
Сервер приложений - адрес сервиса "Бюджет-СМАРТ" (серверная часть клиента) на сервере IIS .
Таймаут - время ожидания отклика от сервера приложений, в секундах. Применяется при использовании сервера приложений. При отсутствии ответа в течение этого времени считается, что соединение отсутствует (дальнейшее выполнение программы невозможно). Значение по умолчанию 300 секунд, максимально допустимое 2100.
Прокси-сервер - параметры прокси на стороне клиента (пользователя), если подключение к сервису "Бюджет-СМАРТ" осуществляется через прокси-сервер.
Сертификат - поле для выбора (указания) сертификата входа, если применяется контроль входа по сертификату. Сертификат должен быть установлен в хранилище "Личные" (IE - Свойства - кнопка Сертификаты).
Кэш - кнопка [Очистить] позволяет удалить все справочные данные, которые хранятся локально на компьютере пользователя, в данном случае все необходимые данные подгрузятся заново из базы данных (в начале работы это может привести к замедлению работы пользователя).
КЭШ - это локальное (на компьютере пользователя) хранилище справочных данных, применяется для увеличения производительности комплекса: снижает частоту обращений к SQL серверу. Местоположение базы кэша на компьютере пользователя: <рабочая папка комплекса (Ctrl+H)>\<имя SQL>\<имя базы>\<логин>\dbcache\ .
Кэш автоматически обновляется при устаревании данных, а для самостоятельного его обновления (актуализации) следует использовать кнопку "Обновить" в списках данных.
Вкладка Обновления
Источник обновления - выберите месторасположение файлов обновлений клиентской части комплекса ("Веб-сервис" - специальный сервис на IIS сервере либо "Каталог с файлами" - папка на диске пользователя).
Сервер - адрес сервиса обновлений, если источником указан веб сервис.
Каталог - папка на диске компьютера, в которой выкладываются обновления, если источником указан "Каталоги с файлами"
Таймаут сервера - время ожидания соединения с сервисом обновлений. Рекомендуемое значение 60 секунд.
Автоматически проверять наличие обновлений на сервере - если отмечена данная опция, то при каждом запуске комплекса предварительно осуществляется проверка наличия новых обновлений в соответствии с источником.
Запустить обновление от имени администратора - используется, если пользователь компьютера, работающий в программе, не обладает правами в ОС Windows на внесение изменений в папку C:\Program Files\ (и/или C:\Program Files (x86)). В этом случае в этих полях следует указать пользователя ОС Windows , обладающего нужными правами.
Ссылка "Забыли пароль?" на вкладке Регистрация
По ссылке "Забыли пароль" пользователь может восстановить возможность войти в программу самостоятельно. Необходимые условия:
- Пользователь подключается через сервис приложений (на вкладке "Соединение" включено его применение и указан адрес сервиса).
- В файле конфигурации сервиса приложений appsettings.Production.json указаны логин и пароль учетной записи базы данных (параметры AuthorizationAccountLogin, AuthorizationAccountPassword), от имени которой будет изменен/восстановлен пароль пользователя.
- У пользователя, забывшего пароль, задан email адрес (см меню "Пользователи", вкладка "Исполнитель" поле "Email").
- Заданы параметры исходящей почты:
- SMTP сервер исходящей почты в настройке "Меню Настройки: НАСТРОЙКИ \ Сервер сообщений \ SMTP сервер";
- в меню "Пользователи" существует пользователь с ролью "Менеджер системных сообщений", на вкладке "Исполнитель" которого указаны параметры электронной почты отправителя: Email, Имя входа Email, Пароль Email.
Механизм восстановления пароля
- Выберите ссылку "Забыли пароль?". В открывшемся окне "Изменение забытого пароля" нажмите кнопку [Отправить запрос на изменение пароля].
- Если не выполнен п.2 (логин и пароль в файле конфигурации отсутствуют), то будет выведено сообщение: "Не настроена учетная запись для восстановления пароля. Обратитесь к администратору комплекса".
- Откройте сообщение, присланное на email. Скопируйте ссылку из сообщения и вставьте в поле окна "Изменение забытого пароля".
- В окне "Изменение забытого пароля" нажмите кнопку [Изменить пароль]. Если ссылка верна, система предложит ввести новый пароль.
- Введите новый пароль и сохраните его значение.
Ключи командной строки
При запуске приложения можно указывать ключи командной строки:
/noupdate
Используется в том случае, когда нужно запретить приложению автоматически обновляться при запуске, несмотря на включенную настройку автоматического обновления.
/profile:"<имя_профиля>"
Ключ используется для указания имени профиля, который будет применен при запуске приложения. Это означает, что параметры подключения (имя пользователя, имя сервера, база данных, способ подключения и др.), которые были заданы при создании указанного профиля, будут установлены в соответствующие поля в окне регистрации при запуске приложения.
Пример использования: в окне управления профилями (см. вкладку "Регистрация") выбрать нужный профиль и нажать кнопку «Создать ярлык». На рабочем столе Windows будет создан ярлык, в параметрах которого будет указан данный ключ с выбранным профилем.
Например: Keysystems.Budget.exe /profile:"База 2011 Иванов"
/autorun - автоматически войти в комплекс при запуске приложения. Должен быть отключен выбор доступных комплексов при запуске приложения (Меню Настройки: НАСТРОЙКИ \ Доступ \ Показывать окно выбора комплексов при входе).
/user:<логин> - имя пользователя комплекса.
/passw:<пароль> - пароль пользователя комплекса. Если пароль отсутствует, то после двоеточия ничего не указывать.
Например: Keysystems.Budget.exe /noupdate /user:xadmin /passw:r34!ee6 /autorun
В этом примере для пользователя xadmin должен быть отключен запрос доступных комплексов.
/appdata:<путь>
Данный ключ используется для указания пути, по которому находится рабочий каталог программы со служебными данными (настройки приложения, журнал ошибок, пользовательские закладки и др.). Он может быть использован для работы на одном компьютере нескольких копий (нескольких версий) приложения, настройки которых не должны пересекаться.
Если ключ не указан, служебные данные по умолчанию хранятся в следующих каталогах:
- в Windows XP: C:\Documents and Settings\<Имя пользователя>\Local Settings\Application Data\Кейсистемс\<Имя продукта>\
- в Vista, Windows 7: C:\Users\<Имя пользователя>\appdata\Local\Кейсистемс\<Имя продукта>\
где: <Имя пользователя> - имя пользователя Windows; <Имя продукта> - название комплекса (например, для ПК «Бюджет-СМАРТ» это будет «Бюджет-КС»).
Пример использования ключа в ярлыке запуска: Keysystems.Budget.exe /appdata:"C:\temp\budgetsmart\" .
Для открытия рабочей папки в проводнике следует в окне входа в комплекс нажать Ctrl+H.
/home
Открытие проводника Windows с рабочей папкой программы. При этом: сам комплекс не запускается, и наличие параметра /appdata не учитывается.
/tools
Открывается пустое окно программы, доступно только главное меню. Применяется для использования всевозможных утилит: видеорегистрация, управление базами, панель инструментов разработчика и т.п.
/noeffects
Отключает визуальные эффекты приложения, реализованные стилями Windows, что уменьшает требования к ОЗУ.
Keysystems.Budget.config
Файл конфигурации клиента на компьютере пользователя. Некоторые ключи: