使用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://postgres.tw/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://:5432/posper User adrian Password: adrian
使用這些引數，PostgreSQL 資料庫伺服器位於本地主機，監聽 5432 埠，幷包含一個名為 posper 的空資料庫。使用者 adrian 具有連線到此資料庫的許可權。
使用 POSper 與 MySQL 的方法與 PostgreSQL 非常相似，您必須執行一個 MySQL 伺服器並安裝 MySQL Connector/J。要下載 MySQL 伺服器和 MySQL Connector/J，請訪問以下連結 https://dev.mysql.com.tw/downloads/。要安裝 MySQL，請訪問以下連結 https://dev.mysql.com.tw/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://mysql.com.tw/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://: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://: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.mysql.com.tw/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。它現在將為您填充資料庫，您就可以開始使用了。