БИФИТ Касса Desktop подключение к PostgreSQL: различия между версиями

Материал из Касса
Перейти к навигации Перейти к поиску
 
(не показано 70 промежуточных версий 3 участников)
Строка 1: Строка 1:
= Начало работы =


= Что такое PostgresSQL =
Для начала работы с PostgreSQL, необходимо <b>[https://kassa.bifit.com/retail/#%D0%B2%D1%81%D0%B5 скачать]</b> последнюю версию Desktop приложения '''Касса Розница 3.x''' и установить на компьютер.
 
 
Далее войдите в приложение и авторизуйтесь. После авторизации, данные из вашего Личного кабинета БИФИТ Бизнес загрузятся на ваш компьютер и сформируется локальная база данных (БД).
 
= Установка PostgreSQL на ПК =


PostgreSQL (произносится как post-gress-QL) — это система управления реляционными базами данных (СУБД) с открытым исходным кодом, разработанная всемирной командой добровольцев.
PostgreSQL (произносится как post-gress-QL) — это система управления реляционными базами данных (СУБД) с открытым исходным кодом, разработанная всемирной командой добровольцев.




= Как развернуть PostgresSQL =
Для установки PostgreSQL перейдите на сайт <b>[https://www.postgresql.org/download/ PostgreSQL]</b> и скачайте последнюю версию дистрибутива для Windows. После загрузки запустите инсталлятор.
 
 
В процессе установки установите:
*PostgreSQL Server – сам сервер СУБД
*PgAdmin 4 – визуальный редактор SQL
*Stack Builder – дополнительные инструменты для разработки (возможно вам они понадобятся в будущем)
*Command Line Tools – инструменты командной строки
 
 
Установите пароль для пользователя postgres (он создается по умолчанию и имеет права суперпользователя).
 
 
По умолчание СУБД на порту 5432, который нужно будет добавить в исключения в правилах фаерволла.
 
 
На этом установка PostgreSQL завершена.
 
 
= Подключение PostgreSQL к Касса Розница =
 
'''В приложении Касса Розница перейдите в Настройки - База данных'''.
 
Выберете '''Тип базы данных''' PostgreSQL (серверная БД).
 
Логин и Пароль по умолчанию имеют значение '''postgres'''( если при установке PostgreSQL меняли имя пользователя/пароль по умолчанию, то введите ранее установленные ваши имя пользователя/пароль).
 
Нажмите '''Сохранить'''.
 
Нажмите '''Перезагрузить'''.
[[Файл:Desktop bd.jpg|thumb|650px]]<br clear="all"/>
После перезагрузки при успешном переходе на Серверную БД откроется Экран регистрации пользователя.
[[Файл:Login.jpg|thumb|650px]]<br clear="all"/>
 
Введите логин/пароль учетной записи в Бифит Касса.
 
Произведите первоначальные настройки подключаемого оборудования в приложении.
 
= Настройка PostgreSQL в приложении Desktop в ручном режиме(не требуется если выполнено Подключение PostgreSQL к Касса Розница)  =
 
 
После установки Касса Розница 3.х на ПК, конфигурационную информацию (а так же логи) Вы сможете найти в директории C:\ProgramData\BIFIT\retail. При типовой установке в этой директории отсутствует папка config. При типовой установке приложение использует в работе файловую БД в качестве локального хранилища данных. В случае, если требуется подключить PostgresQL БД для локального хранения данных выполните следующие действия:
 
# Создайте в C:\ProgramData\BIFIT\retail папку '''config'''.
# Создайте в папку '''config''' файл конфигурации БД '''db.properties'''. Запишите в него информацию (см.пример ниже).<br>
 
 
Пример содержания файла '''db.properties''':
 
driver=org.postgresql.Driver<br>
url=jdbc:postgresql://localhost/desktop<br>
user= "Имя пользователя" (указанное при установке PostgreSQL) <br>
password= "Пароль для подключения" (указанный при установке PostgreSQL)<br>


Скачайте установщик с официального сайта [https://www.postgresql.org/download/ PostgresSQL], запустите его как любой другой исполняемый файл.  
{{ Note |'''''Примечание'''''<br>
* Название базы данных необходимо указать в поле url после указания Localhost, через слэш.
* В нашем примере '''desktop''' это название БД, которую необходимо предварительно создать в PostgresQL, используя утилиту pgAdmin. Касса Розница самостоятельно наполнит БД нужными таблицами и значениями по умолчанию.
|1000}}


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


По умолчанию PostgreSQL создает суперпользователя с именем postgres (воспринимайте его как учетную запись администратора сервера базы данных).


Во время установки нужно будет указать пароль для суперпользователя (root).
Зайдите в приложение '''PgAdmin 4''', авторизуйтесь в программе, указав пароль, назначенный при установке PostgreSQL. Далее нажмите на вкладку '''Servers''', введите пароль, назначенный при установке PostgreSQL.
Правой кнопкой мыши нажмите на вкладку '''''DataBases''''', во всплывающей вкладке нажмите '''''Create''''', далее выберите '''''Database'''''.. . Во всплывающем окне введите название базы данных, укажите пользователя ''postgres'', нажмите кнопку '''''Save'''''.  


Позже можно создавать других пользователей и назначать им отдельные доступы и роли.
[[Файл:databasecreate.png|thumb|650px]]<br clear="all"/>


Чтобы запустить сервер разработки на локальном компьютере или localhost, необходимо назначить ему порт.
Пример содержания файла '''db.properties''' для создание БД ''desktop'':
driver=org.postgresql.Driver
url=jdbc:postgresql://localhost/desktop
user=postgres
password=12345


Порт по умолчанию - 5432. Если установка PostgreSQL происходит впервые, то порт скорее всего свободен. Если окажется, что этот порт уже занят другим экземпляром PostgreSQL, можно указать другое значение, например 5433. Настройка для Windows завершена.
[[Файл:User.png|thumb|650px]]<br clear="all"/>


= Настройка PostgresSQL для Касса Розница =
При создании БД в таблице '''Server activity''' можно ознакомиться с активными пользователями, в настоящий момент. В нашем примере активный пользователь ''postgres''.


Если устанавливать программу на диск C, то сама она будет лежать C:\ProgramFiles\BIFIT Kassa. Вся инфа, необходимая для работы приложения (логи, конфиги, кэш) находятся в директории C:\ProgramData\BIFIT\retail. По умолчанию в этой директории нет папки конфигов, в приложении берётся стандартная конфигурация и создается своя локальная БД. Если нужно, чтобы БД была общей на несколько устройств, как раз для этого кассу-розницу к постгре подключают, нужно создать в C:\ProgramData\BIFIT\retail папку config. В нее нужно поместить файл db.properties. В нем должна быть вся необходимая инфа о подключении.
Пример: driver=org.postgresql.Driver<br>
url=jdbc:postgresql://localhost/desktop<br>
user=desktop<br>
password=qwerty123<br>


Дополнение: Программа по умолчанию ставится в C:\Program Files, выбрать можно любое место, но в пути не должно быть символов кириллицы.
{{ Note |'''''Примечание'''''<br>
*Программа по умолчанию ставится в C:\Program Files, выбрать можно любое место, но в пути не должно быть символов кириллицы.<br>
*При начале работы с приложением, укажите текущий прокси в настройках приложения для корректного подключения к базе. |800}}

Текущая версия на 14:51, 30 сентября 2024

Начало работы

Для начала работы с PostgreSQL, необходимо скачать последнюю версию Desktop приложения Касса Розница 3.x и установить на компьютер.


Далее войдите в приложение и авторизуйтесь. После авторизации, данные из вашего Личного кабинета БИФИТ Бизнес загрузятся на ваш компьютер и сформируется локальная база данных (БД).

Установка PostgreSQL на ПК

PostgreSQL (произносится как post-gress-QL) — это система управления реляционными базами данных (СУБД) с открытым исходным кодом, разработанная всемирной командой добровольцев.


Для установки PostgreSQL перейдите на сайт PostgreSQL и скачайте последнюю версию дистрибутива для Windows. После загрузки запустите инсталлятор.


В процессе установки установите:

  • PostgreSQL Server – сам сервер СУБД
  • PgAdmin 4 – визуальный редактор SQL
  • Stack Builder – дополнительные инструменты для разработки (возможно вам они понадобятся в будущем)
  • Command Line Tools – инструменты командной строки


Установите пароль для пользователя postgres (он создается по умолчанию и имеет права суперпользователя).


По умолчание СУБД на порту 5432, который нужно будет добавить в исключения в правилах фаерволла.


На этом установка PostgreSQL завершена.


Подключение PostgreSQL к Касса Розница

В приложении Касса Розница перейдите в Настройки - База данных.

Выберете Тип базы данных PostgreSQL (серверная БД).

Логин и Пароль по умолчанию имеют значение postgres( если при установке PostgreSQL меняли имя пользователя/пароль по умолчанию, то введите ранее установленные ваши имя пользователя/пароль).

Нажмите Сохранить.

Нажмите Перезагрузить.

Desktop bd.jpg


После перезагрузки при успешном переходе на Серверную БД откроется Экран регистрации пользователя.

Login.jpg


Введите логин/пароль учетной записи в Бифит Касса.

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

Настройка PostgreSQL в приложении Desktop в ручном режиме(не требуется если выполнено Подключение PostgreSQL к Касса Розница)

После установки Касса Розница 3.х на ПК, конфигурационную информацию (а так же логи) Вы сможете найти в директории C:\ProgramData\BIFIT\retail. При типовой установке в этой директории отсутствует папка config. При типовой установке приложение использует в работе файловую БД в качестве локального хранилища данных. В случае, если требуется подключить PostgresQL БД для локального хранения данных выполните следующие действия:

  1. Создайте в C:\ProgramData\BIFIT\retail папку config.
  2. Создайте в папку config файл конфигурации БД db.properties. Запишите в него информацию (см.пример ниже).


Пример содержания файла db.properties:

driver=org.postgresql.Driver
url=jdbc:postgresql://localhost/desktop
user= "Имя пользователя" (указанное при установке PostgreSQL)
password= "Пароль для подключения" (указанный при установке PostgreSQL)

Note.svg Примечание

  • Название базы данных необходимо указать в поле url после указания Localhost, через слэш.
  • В нашем примере desktop это название БД, которую необходимо предварительно создать в PostgresQL, используя утилиту pgAdmin. Касса Розница самостоятельно наполнит БД нужными таблицами и значениями по умолчанию.


Зайдите в приложение PgAdmin 4, авторизуйтесь в программе, указав пароль, назначенный при установке PostgreSQL. Далее нажмите на вкладку Servers, введите пароль, назначенный при установке PostgreSQL. Правой кнопкой мыши нажмите на вкладку DataBases, во всплывающей вкладке нажмите Create, далее выберите Database.. . Во всплывающем окне введите название базы данных, укажите пользователя postgres, нажмите кнопку Save.

Databasecreate.png


Пример содержания файла db.properties для создание БД desktop:

driver=org.postgresql.Driver
url=jdbc:postgresql://localhost/desktop
user=postgres
password=12345
User.png


При создании БД в таблице Server activity можно ознакомиться с активными пользователями, в настоящий момент. В нашем примере активный пользователь postgres.


Note.svg Примечание

  • Программа по умолчанию ставится в C:\Program Files, выбрать можно любое место, но в пути не должно быть символов кириллицы.
  • При начале работы с приложением, укажите текущий прокси в настройках приложения для корректного подключения к базе.