Варианты установки¶

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

Вариант	Когда подходит
Десктоп	Программа стоит на компьютере пользователя и сама работает с базой. Удобно для одного рабочего места и для небольшой сети, если база вынесена на Microsoft SQL Server или PostgreSQL.
Хост	На одном компьютере работает сервер приложения, к нему подключаются клиенты.
Клиент	Рабочее место, которое подключается к уже установленному хосту.
Портабельная версия	Папка без установщика: флешка или перенос программы вместе с базой на другой компьютер.

Требования к Windows и СУБД — на странице Системные требования.

Десктопная версия¶

Установщик «Каяла: Торговое место» ставит программу, которая и интерфейс, и работу с базой выполняет на этом же компьютере. Обновление ставится отдельно на каждый компьютер, где запущена программа. Если рабочих мест несколько и база общая, смотрите Установка и настройка Microsoft SQL Server Express и Добавление базы данных.

Установка¶

Скачайте установщик «Каяла: Торговое место» на странице загрузки.
Запустите его. Если нажимать только «Далее», программа встанет с параметрами по умолчанию в C:\Program Files\Каяла-софт\Торговое место.
Если на компьютере нет .NET Framework 4.8, установщик поставит его сам.

На рабочем столе и в меню «Пуск» (группа «Каяла-софт») появятся ярлыки «Торговое место» и «Торговое место 32 бита». Второй нужен, когда драйвер устройства работает только в 32-разрядном процессе.

В состав установки входит демонстрационная база.

Первый запуск с базой SQLite¶

SQLite — самый простой способ начать работу. После установки запустите «Торговое место».

В начальном окне доступны две базы: «Торговое место» и «Торговое место (Демо) (SQLite)». Демонстрационная база выбрана сразу, чтобы можно было посмотреть программу на уже заполненных данных.
Если выбор не менять и нажать «ОК», откроется демонстрационная база. Программа попросит выбрать пользователя и ввести пароль. У пользователей демонстрационной базы паролей нет, поле пароля оставьте пустым.
Если выбрать «Торговое место», программа предложит создать новую базу. После создания выберите пользователя «Администратор». В новой базе он один, пароль у него не задан.

Дальше можно перейти к разделу Быстрый старт.

Первый запуск с базой LocalDB¶

LocalDB имеет смысл, если позже база переедет на Microsoft SQL Server: это локальный вариант той же СУБД. Установка программы до первого запуска совпадает с вариантом SQLite. Затем поставьте LocalDB: на странице Загрузка Microsoft SQL Server 2014 Express выберите LocalDB 64BIT\SqlLocalDB.msi для 64-разрядной Windows или LocalDB 32BIT\SqlLocalDB.msi для 32-разрядной. Установщик LocalDB проходит кнопкой «Далее».

В программе создайте новую базу, как описано в Добавление базы данных. Окно регистрации для LocalDB выглядит так:

Вместо KayalaTradePoint можно указать название предприятия латиницей, без пробелов.

После сохранения базу можно выбрать в начальном окне. Программа предложит создать её, затем войти пользователем «Администратор» без пароля. Дальше — Быстрый старт.

Хост¶

Установщик «Каяла Хост: Торговое место» ставит сервер приложения. Интерфейс на этом компьютере не обязателен: с хостом работают клиенты по сети. Каталог по умолчанию — C:\Program Files\Каяла-софт\Хост Торговое место. Ярлык «Торговое место хост» появляется в меню «Пуск», группа «Каяла-софт».

Если на компьютере нет ASP.NET Core Runtime 10, установщик поставит его сам.

Первый запуск¶

Запустите «Торговое место хост».
На этом же компьютере откройте в браузере http://localhost:5680/admin.
Пока файла настроек нет, на странице стоят значения по умолчанию: база SQLite, порт HTTP 5680, порт gRPC 5601. Укажите базу, нажмите «Сохранить», затем «Старт». Порты можно не менять. Запуск хоста не требует прав администратора Windows.
Кнопки «Проверить БД» и «Создать БД» проверяют подключение и создают базу, если её ещё нет.

Чтобы к хосту подключались компьютеры в сети, включите «Удалённые клиенты» и снова сохраните настройки. Хост начнёт принимать подключения не только с этого компьютера и откроет свои порты в брандмауэре Windows.

Чтобы хост работал без открытого окна, зарегистрируйте его службой Windows. В каталоге установки от имени администратора выполните:

Kayala.Host.Service.exe install

Удаление службы:

Kayala.Host.Service.exe uninstall

Клиент¶

Установщик «Каяла Хост Клиент: Торговое место» ставит рабочее место, которое подключается к хосту. Свою базу клиент не хранит. Каталог по умолчанию — C:\Program Files\Каяла-софт\Хост Клиент Торговое место. Ярлыки «Торговое место клиент» и «Торговое место клиент 32 бита» появляются на рабочем столе и в меню «Пуск». 32-разрядный ярлык нужен для драйверов устройств, которые работают только в 32-разрядном процессе. Сканеры, весы и кассы настраиваются на клиенте.

Если на компьютере нет .NET Framework 4.8, установщик поставит его сам.

Хост к этому моменту уже должен быть запущен, а для клиентов с других компьютеров у него включены «Удалённые клиенты».

Подключение к хосту¶

Запустите «Торговое место клиент».
В начальном окне добавьте подключение. Укажите имя, которое будет видно в списке, адрес компьютера с хостом и порт gRPC 5601. Если клиент стоит на том же компьютере, что и хост, адрес — localhost.
На вкладке сети можно найти хост в локальной сети и подставить его адрес двойным щелчком.
Устройства рабочего места задаются на закладке устройств этого же окна. Подробнее — в Настройка устройств.

После сохранения выберите подключение и войдите пользователем, который заведён в базе хоста.

Портабельная версия¶

Портабельная версия — это архив без установщика. Она рассчитана на одного пользователя: программу и базу можно держать на флешке или внешнем диске и открывать на разных компьютерах. На компьютере уже должен быть .NET Framework 4.8: архив его не ставит.

Скачайте архив Portable на странице загрузки.
Распакуйте его в отдельную папку или на съёмный диск. Вся папка и есть установка.
Запустите Components\Kayala.Start.exe. Если нужны 32-разрядные драйверы устройств, запустите Components\Kayala.Start.x86.exe.

Демонстрационная база лежит в каталоге Databases. Свою базу SQLite тоже удобно хранить в этой папке: тогда при переносе на другой компьютер копируется весь каталог установки. Как зарегистрировать базу, описано в Добавление базы данных.

Портабельные хост и клиент¶

Хост и клиент без установщика поставляются отдельным архивом. После распаковки хост запускается из каталога Host, клиент — из каталога Client. Подключение хоста к базе хранится в Host.setting, адрес хоста у клиента — в Client.setting. На компьютере хоста нужен ASP.NET Core Runtime 10, на компьютере клиента — .NET Framework 4.8.

Первый запуск хоста и подключение клиента совпадают с разделами Хост и Клиент. Как перенести настройки при обновлении архива, описано в Обновление программы.