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

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


= Как развернуть PostgresSQL =
= Установка PostgreSQL на ПК =


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




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




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


= Настройка PostgresSQL для Касса Розница =


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


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


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


Если нужно, чтобы БД была общей на несколько устройств, нужно создать в C:\ProgramData\BIFIT\retail папку config. В нее нужно поместить файл '''db.properties'''. В нем должна быть вся необходимая информация о подключении.<br>  
Логин и Пароль по умолчанию имеют значение '''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>  




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


{{ Note |'''''Примечание'''''<br>
{{ Note |'''''Примечание'''''<br>
*Название базы данных необходимо указать в поле url после указания Localhost, через слэш.|800}}
* Название базы данных необходимо указать в поле url после указания Localhost, через слэш.
* В нашем примере '''desktop''' это название БД, которую необходимо предварительно создать в PostgresQL, используя утилиту pgAdmin. Касса Розница самостоятельно наполнит БД нужными таблицами и значениями по умолчанию.
|1000}}






Зайдите в приложение PgAdmin 4, авторизуйтесь в программе, указав пароль, назначенный при установке PostgresSQL. Далее нажмите на вкладку '''Servers''', введите пароль, назначенный при установке PostgresSQL.
Зайдите в приложение '''PgAdmin 4''', авторизуйтесь в программе, указав пароль, назначенный при установке PostgreSQL. Далее нажмите на вкладку '''Servers''', введите пароль, назначенный при установке PostgreSQL.
Правой кнопкой мыши нажмите на вкладку '''''DataBases''''', во всплывающей вкладке нажмите '''''Create''''', далее выберите '''''Database'''''.. . Во всплывающем окне введите название базы данных, укажите пользователя ''postgres'', нажмите кнопку '''''Save'''''.  
Правой кнопкой мыши нажмите на вкладку '''''DataBases''''', во всплывающей вкладке нажмите '''''Create''''', далее выберите '''''Database'''''.. . Во всплывающем окне введите название базы данных, укажите пользователя ''postgres'', нажмите кнопку '''''Save'''''.  
[[Файл:databasecreate.png|thumb|650px]]<br clear="all"/>
Пример содержания файла '''db.properties''' для создание БД ''desktop'':
driver=org.postgresql.Driver
url=jdbc:postgresql://localhost/desktop
user=postgres
password=12345
[[Файл:User.png|thumb|650px]]<br clear="all"/>
При создании БД в таблице '''Server activity''' можно ознакомиться с активными пользователями, в настоящий момент. В нашем примере активный пользователь ''postgres''.


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