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

Материал из Касса
Перейти к навигации Перейти к поиску
 
(не показано 45 промежуточных версий 2 участников)
Строка 3: Строка 3:
Для начала работы с PostgreSQL, необходимо <b>[https://kassa.bifit.com/retail/#%D0%B2%D1%81%D0%B5 скачать]</b> последнюю версию Desktop приложения '''Касса Розница 3.x''' и установить на компьютер.
Для начала работы с PostgreSQL, необходимо <b>[https://kassa.bifit.com/retail/#%D0%B2%D1%81%D0%B5 скачать]</b> последнюю версию Desktop приложения '''Касса Розница 3.x''' и установить на компьютер.


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


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


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




= Как развернуть PostgresSQL =
Для установки PostgreSQL перейдите на сайт <b>[https://www.postgresql.org/download/ PostgreSQL]</b> и скачайте последнюю версию дистрибутива для Windows. После загрузки запустите инсталлятор.


Для установки PostgreSQL перейдите на сайт <b>[https://www.postgresql.org/download/ PostgresSQL]</b> и скачайте последнюю версию дистрибутива для Windows. После загрузки запустите инсталлятор.


 
В процессе установки установите:
В процессе установки установите галочки на пунктах:
*PostgreSQL Server – сам сервер СУБД
*PostgreSQL Server – сам сервер СУБД
*PgAdmin 4 – визуальный редактор SQL
*PgAdmin 4 – визуальный редактор SQL
Строка 30: Строка 29:
На этом установка PostgreSQL завершена.
На этом установка PostgreSQL завершена.


= Настройка PostgresSQL для Касса Розница =
= Подключение PostgreSQL к Касса Розница =


Если устанавливать программу на диск C, то она будет лежать C:\ProgramFiles\BIFIT Kassa. Вся информация, необходимая для работы приложения (логи, конфиги, кэш) находятся в директории C:\ProgramData\BIFIT\retail. По умолчанию в этой директории нет папки config, в приложении берётся стандартная конфигурация и создается своя локальная база данных (БД). Если нужно, чтобы БД была общей на несколько устройств,  нужно создать в C:\ProgramData\BIFIT\retail папку config. В нее нужно поместить файл db.properties. В нем должна быть вся необходимая информация о подключении.<br>


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


Пример содержания файла db.properties:
  driver=org.postgresql.Driver<br>
  driver=org.postgresql.Driver<br>
  url=jdbc:postgresql://localhost/desktop<br>
  url=jdbc:postgresql://localhost/desktop<br>
  user= "Имя пользователя"<br>
  user= "Имя пользователя" (указанное при установке PostgreSQL) <br>
  password="Пароль для подключения"<br>
  password= "Пароль для подключения" (указанный при установке PostgreSQL)<br>
 
{{ Note |'''''Примечание'''''<br>
* Название базы данных необходимо указать в поле url после указания Localhost, через слэш.
* В нашем примере '''desktop''' это название БД, которую необходимо предварительно создать в PostgresQL, используя утилиту pgAdmin. Касса Розница самостоятельно наполнит БД нужными таблицами и значениями по умолчанию.
|1000}}
 
 
 
Зайдите в приложение '''PgAdmin 4''', авторизуйтесь в программе, указав пароль, назначенный при установке PostgreSQL. Далее нажмите на вкладку '''Servers''', введите пароль, назначенный при установке PostgreSQL.
Правой кнопкой мыши нажмите на вкладку '''''DataBases''''', во всплывающей вкладке нажмите '''''Create''''', далее выберите '''''Database'''''.. . Во всплывающем окне введите название базы данных, укажите пользователя ''postgres'', нажмите кнопку '''''Save'''''.


Чтобы разрешить сетевой доступ к вашему экземпляру PostgreSQL с других компьютеров, вам нужно создать правила в файерволе. Вы можете создать правило через командную строку или PowerShell.
[[Файл:databasecreate.png|thumb|650px]]<br clear="all"/>


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


netsh advfirewall firewall add rule name="Postgre Port" dir=in action=allow protocol=TCP localport=5432
[[Файл:User.png|thumb|650px]]<br clear="all"/>


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




Текущая версия на 13:32, 22 ноября 2022

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

Для начала работы с 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 к Касса Розница

После установки Касса Розница 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, выбрать можно любое место, но в пути не должно быть символов кириллицы.
  • При начале работы с приложением, укажите текущий прокси в настройках приложения для корректного подключения к базе.

Источник — http://kassa.bifit.com/wiki/index.php?title=БИФИТ_Касса_Desktop_подключение_к_PostgreSQL&oldid=39509