使用POSper/安装指南
POSper是一个用Java开发的应用程序，要执行它，您需要来自Sun Microsystems的版本1.6或更高版本的Java运行时环境。要安装Java运行时环境，请按照链接http://java.com/en/download/index.jsp中的说明进行操作。
如果您要使用串行或USB设备（如打印机或钱箱），则还必须从http://rxtx.qbang.org下载RXTX 2.1.7。除了RXTX安装说明中提到的内容外，您系统的RXTX库可以放在POSper安装目录中。这是一种在升级Java版本时保留RXTX库的安全方法。RXTXserial.jar文件已存在于libs中。
从Sourceforge下载POSper二进制包的最新版本[1]。将文件解压缩到一个空文件夹中。
请参考您解压POSper到的目录中的readme.txt文件。按照说明操作。
首次运行POSper时，系统会提示您输入一个密码，允许您创建新的数据库。此密码始终为“setup”，无法更改。它仅出于安全原因存在，以避免在数据库或网络错误的情况下覆盖现有数据库。如果数据库已存在，切勿输入此密码。
1. 将POSper解压缩到您的文件夹后，找到名为“posper.exe”的文件（它在程序窗口中看起来像一个齿轮）。右键单击它并选择“创建快捷方式”。然后将该快捷方式拖到您的桌面上。
2. 您刚刚粘贴到桌面上的快捷方式是您双击以打开程序的图标。在继续双击它之前，请运行配置程序config.exe，它允许您选择除默认HSQL数据库之外的其他数据库 - 请参阅readme.txt。
3. 按照下面“设置程序：通用”中的说明操作
0. 这些说明假设您正在使用Nautilus。
1. 将POSper解压缩到您的文件夹后，找到名为“posper”的文件。它看起来像一张上面带有灰色齿轮的纸。
2. 右键单击它并选择“创建链接”。
3. 将此链接拖放到您的桌面上，您现在可以双击它来运行POSper。在继续双击它之前，请运行配置程序config.exe，它允许您选择除默认HSQL数据库之外的其他数据库 - 请参阅readme.txt。
4. 按照下面“设置程序：通用”中的说明操作
首先确保您正在运行最新版本的Java。它可以从Apple开发者网站获取。
0. 将POSper文件夹解压缩到您的应用程序目录中。readme.txt中引用Linux的说明也适用于MAC OS X。
1. 要配置POSper，请双击“config”并按照说明操作。
2. 下次要使用POSper时，双击文件“posper”。您可以通过将此文件拖到停靠栏来创建快捷方式。
重要提示：在继续执行“设置程序：通用”中描述的设置之前，您需要决定使用哪个数据库系统，并完成以下配置步骤。
POSper使用Hibernate来存储应用程序数据，包括但不限于产品、销售和用户。Hibernate支持各种数据库系统，例如HSQLDB[2]、PostgreSQL[3]和MySQL[4]。
强烈建议对于生产系统使用PostgreSQL或MySQL等生产级数据库！
要配置数据库，请转到POSper中的配置面板或在Windows中运行文件“config.exe”或在Linux中运行“config”。
数据库配置部分位于“数据库”部分的顶部。
驱动程序库：是数据库引擎供应商提供的包含JDBC驱动程序的文件，该驱动程序允许Java程序与数据库通信。
驱动程序类：是实现JDBC驱动程序的Java类名。此名称也由数据库引擎供应商定义。
URL：是使用JDBC来定位JDBC、驱动程序和数据库的连接字符串。
用户：数据库用户的名称。
密码：数据库用户的密码。
POSper的默认配置使用HSQLDB进行数据存储。HSQLDB库与POSper的二进制包一起分发，如果您想使用此数据库，则不必担心数据库配置。
HSQLDB是一个简单的SQL关系数据库引擎，可能不如其他数据库引擎高效。
要使用 POSper 与 PostgreSQL，您必须运行一个 PostgreSQL 服务器并安装 PostgreSQL 的 JDBC 驱动程序。要下载服务器和 JDBC 驱动程序，请访问以下链接 https://postgresql.ac.cn/download.html。安装并运行数据库服务器后，您需要为 POSper 创建一个空数据库，并创建一个具有连接到该数据库权限的数据库用户。有关此过程的更多帮助，请参考 PostgreSQL 文档[5]。
PostgreSQL 的 JDBC 驱动程序文件名为“postgresql-<version_number>.jdbc3.jar”，类名为“org.postgresql.Driver”。
使用 PostgreSQL 作为数据库引擎的数据库配置示例如下：
Driver library: postgresql-8.0.309.jdbc3.jar Driver class: org.postgresql.Driver URL: jdbc:postgresql://127.0.0.1:5432/posper User adrian Password: adrian
使用这些参数，PostgreSQL 数据库服务器位于本地主机，监听 5432 端口，并包含一个名为 posper 的空数据库。用户 adrian 具有连接到此数据库的权限。
使用 POSper 与 MySQL 的方法与 PostgreSQL 非常相似，您必须运行一个 MySQL 服务器并安装 MySQL Connector/J。要下载 MySQL 服务器和 MySQL Connector/J，请访问以下链接 https://dev.mysqlserver.cn/downloads/。要安装 MySQL，请访问以下链接 https://dev.mysqlserver.cn/doc/。安装数据库服务器后，您必须为 POSper 创建一个空数据库，并创建一个具有连接到该数据库权限的数据库用户。有关此过程的更多帮助，请参考 MySQL 文档[6]。
建议您与 MySQL 服务器一起下载 MySQL 工具。如果您不熟悉 MySQL 命令行，则 MySQL Administrator 工具非常有助于创建空架构和设置用户。
请注意，Oracle 已宣布 MySQL 工具已停止维护，并将其替换为 MySQL WorkbBench。虽然 WorkBench 是一个很棒的程序，但它缺少 MySQLAdministrator 的一些功能：计划备份和在一个事务中备份 InnoDB 数据库的功能仅在商业版本中可用（遗憾的是）。
MySQL Connector/J 包含 POSper 连接到 MySQL 数据库服务器所需的 JDBC 驱动程序。驱动程序库文件名为“mysql-connector-java-<version_number>-bin.jar”，驱动程序类名为“com.mysql.jdbc.Driver”。要获取此包，请访问：https://mysqlserver.cn/products/connector/j/
下载 MySQL Connector/J 包后，解压缩其内容并将其放置在 POSper 所在的同一文件夹中。为了方便起见，连接器 mysql-connector-java-5.0.8-bin.jar 已包含在 POSper 发行版中，您可以将其与 MySQL 5.0 或更高版本一起使用。
使用 MySQL 作为数据库引擎的数据库配置示例如下：
Driver library: mysql-connector-java-5.0.8-bin.jar Driver class: com.mysql.jdbc.Driver URL: jdbc:mysql://127.0.0.1:3306/posper User: adrian Password: adrian
使用这些参数，MySQL 数据库服务器位于本地主机，监听 3306 端口，并包含一个名为 posper 的空数据库。用户 adrian 必须具有连接到此数据库的权限。
设置 MySQL 数据库以使用 utf8 字符集
utf8 用于许多阿拉伯语、东亚和亚洲环境。
因此，例如，如果您想输入汉字，则需要重新配置 POSper 和 MySQL。
然后，您可以在 POSper 中输入西文字符和 utf8 字符编码。
步骤（适用于 LINUX 系统）
数据库设置和配置（在运行 Posper 之前）
- 登录到您的 MySQL 查询浏览器并配置
CREATE DATABASE posperdb CHARACTER SET utf8 COLLATE utf8_bin;
然后使用该数据库
USE posperdb;
不要忘记检查此操作是否成功。
- 查找 MySQL 配置文件 my.conf，它可能位于 /etc/mysql/ 目录下。
并以 root 身份编辑 my.conf，编辑 [mysqld] 部分后的内容。
[mysqld]
default-character-set=utf8
- 在 POSper 数据库配置中编辑 url
jdbc:mysql://127.0.0.1:3306/posperdb?useUnicode=true&characterEncoding=utf8
已在 POSper 1.0-851、Ubuntu 10.04 32 位和 64 位桌面版、Java 1.6.0_22 上测试。
我使用过并发现有用的参考来源
- http://wiki.openbravo.com/wiki/OpenbravoPOS_FAQ#Right-to-left_language_support_.28Arabic_and_Hebrew.29
- http://confluence.atlassian.com/display/DOC/Configuring+Database+Character+Encoding
- https://dev.mysqlserver.cn/doc/refman/5.1/en/sql-syntax-server-administration.html
1. 您将看到启动画面，其中状态栏会显示启动过程中的每个步骤。
2. 然后您将看到“POSper”的启动屏幕。现在点击“管理”。
3. 您现在应该看到您的销售窗口。屏幕左侧有一些菜单供您选择。在“管理”下，点击“库存”，然后点击“税费”。默认情况下，提供“无税”和一个 5% 的示例税费。
4. 如果您需要添加更多税费，请点击新建按钮（显示为纸上的星形，从右侧数第三个）。然后选择一个唯一的 ID，为税费命名，并选择一个百分比。
5. 完成添加所有所需的税费后，点击保存按钮（软盘，从右侧数第一个按钮）。
6. 现在返回“管理”下，并再次点击“库存”。
7. 现在点击“类别”按钮。
8. 您将进入一个与税费屏幕非常相似的屏幕。在这里，您可以对食品进行分类。在“ID”下，它始终需要一个数字。我建议将每个类别设置为 100 的增量。例如，我将在“ID”中输入“100”，然后在“类别”下输入“可乐罐”。然后下一个为“200”，并输入“小零食”。确定您希望如何对食品进行分类，然后创建您的类别。您还可以为每个类别添加图片。请确保在每个类别之后保存。
9. 创建完所有类别后，您需要输入您的产品。“管理”，然后“库存”，然后“产品”。
10. 同样，每个项目都必须有其自己的唯一编号。例如，对于“健怡百事可乐”，输入一个类似 101 的参考号，对于“美露黄”，输入一个类似 102 的参考号。
11. 对于“进货价”，请尝试确定每个项目的成本是多少，如果您不知道，请在销售价格以下输入某个数字。无论哪种方式，您都需要输入一个数字才能使程序正常运行。（例如，对于 20 盎司的可乐瓶，一箱 24 瓶的价格为 15.05 美元。因此，我将 15.05 美元除以 24 并得到 0.627，然后在“进货价”中输入“0.627”（您可以输入任意位数的小数，程序会自动处理）。
12. 对于“售价”，输入您打算出售该项目的金额。因此，对于可乐，该数字将为“1.00”。它会立即为您填写两个框。现在在“税费”旁边，选择相应的税费（例如“无税”），并在“类别”中选择您希望该项目所在的类别，例如“可乐瓶”。
13. 要保存产品，请点击带有花朵的图标。
14. 对您要添加的每个产品重复步骤 12 到 15。
15. 在管理面板中点击“维护”，然后点击“用户”。请注意，POSper 提供了 4 个默认用户： “访客”、“管理员”、“经理”和“员工”（每个用户都具有与其名称一致的权限）。如果您想自定义所有四个角色，可以删除这些默认用户，或者您可以保留部分或全部默认用户不变。
16. 要添加新用户，请点击带有花朵的图标。在“名称”下输入名称，然后选择其角色。如果希望用户处于活动状态，请确保选中可见复选框。如果未选中，它们将不会显示在登录菜单中。角色为新用户提供权限。访客只能进行销售。员工可以拥有密码，并且可以执行销售、退款和付款操作。经理可以执行所有这些操作，还可以访问报表。管理员可以访问系统中的所有功能。
17. 设置现已完成，系统已准备好使用！
注意：完成上述所有步骤后，运行 POSper。它现在将为您填充数据库，您就可以开始使用了。