外掛套件

資料轉入外掛套件

對大戶或者是中實戶來說,要每天輸入交易紀錄到獲利知多少軟體是很麻煩的,尤其當每天進出很頻繁的時候,而資料轉入外掛套件可讓您把券商的對帳單資料轉入到獲利知多少,免去還要輸入交易紀錄的麻煩。

目前尚未收錄任何券商的外掛套件,歡迎提供新的外掛套件或合作開發新的外掛套件!

有任何開發資料轉入外掛套件問題或欲提供新套件請寄EMAIL給版主

如何實作所屬券商的資料轉入外掛套件

開發外掛套件的程序很單純,適合實作資料轉入外掛套件的程式語言包含Java、C/C++、Delphi等, 各語言的實作方法如下:
  • Java實作方法

  1. 開發一個myLibrary.jar檔,裡面包含
    META-INFO/MANIFEST.MF檔,而此MANIFEST.MF檔加入一個屬性如下
    Main-Class: myPackage.myClass
    其中,myPackage.myClass是開發者所開發的類別與所在的包裹
  2. 接著撰寫myPackage.myClass類別,此類別必須包含一個方法,此方法的名稱與參數定義必須完全符合,宣告如下

/**
 * 取得最近的交易紀錄,傳回值字串即是獲利知多少資料庫的格式,每筆交易紀錄用換行符號隔開
 *
 * @param pluginHome 外掛套件的工作目錄
 * @param account 登入券商系統所使用的帳號
 * @param password 登入券商系統所使用的密碼
 * @param fromDate 起始日期,格式為yyyy/mm/dd,例如2006/01/02,當此值為null時,代表所有的交易紀錄都須盡可能的傳回
 * @param reservedArgument 保留參數
 * @return 傳回自起始日期(含)以後的所有交易紀錄
 * @throws Exception 當登入失敗或有異常時丟出例外
 */
public static String getRecentTradingRecords(
String pluginHome,
String account, String password, String fromDate,
String reservedArgument )
throws Exception

  1. 建立一個目錄MyDir,把所開發的myLibrary.jar檔放在MyDir裡面,此目錄還要放兩個檔案description.txt與plugin.properties,description.txt裡面寫的是給使用者看的使用說明,而plugin.properties裡面則包含以下屬性:
    name = XXX證券轉入
    category = TRADING_RECORD_IMPORT
    # DLL (for C/C++ or Delphi) or JAR (for Java)
    type = JAR
    library = myLibrary.jar
    version = 1.0
    date = 套件的釋放日期
    sbk_minimum_version = 2.3.2
    developer = 開發者或券商名稱
  2. 此說明所用的myLibrary.jar與myPackage.myClass與MyDir皆只是說明用的名稱,開發者可用自己的名稱
  3. 當開發完成後請把MyDir整個複製到c:\Program Files\StockBookkeeper\Plugin\MyDir,此動作即為安裝程序
  4. 安裝完外掛套件的工作目錄應如下
    StockBookkeeper\Plugin\MyDir
       +myLibrary.jar
       +plugin.properties
       +description.txt
  5. 請參考範例PlugInTest_Java
  • C / C++實作方法

  1. 開發一個myLibrary.dll檔
  2. 在此myLibrary.dll檔內撰寫三個函數,宣告如下

/**
* 取得最近的交易紀錄,傳回值字串即是獲利知多少資料庫的格式,每筆交易紀錄用換行符號隔開
*
* @param pluginHome 外掛套件的工作目錄
* @param account 登入券商系統所使用的帳號
* @param password 登入券商系統所使用的密碼
* @param fromDate 起始日期,格式為yyyy/mm/dd,例如2006/01/02,當此值為null時,代表所有的交易紀錄都須盡可能的傳回
* @param reservedArgument 保留參數
* @return 傳回自起始日期(含)以後的所有交易紀錄
*/
__declspec(dllexport) char *__cdecl GetRecentTradingRecords(char *pluginHome, char *account, char *password, char *fromDate, char *reservedArgument)

/**
* 取得錯誤代碼,0表示成功無誤,其他值則表示有錯誤,
* 當GetRecentTradingRecords(...)函數被呼叫後,
* 會立即呼叫此函數以決定是否失敗
*
* @param pluginHome 外掛套件的工作目錄
* @return 傳回錯誤代碼
*/
__declspec(dllexport) int __cdecl GetErrorCode(char *pluginHome)

/**
* 取得錯誤訊息,
* 當GetErrorCode(...)函數傳回非0的值,
* 則會呼叫此函數以取得錯誤訊息
*
* @param pluginHome 外掛套件的工作目錄
* @return 傳回錯誤訊息
*/
__declspec(dllexport) char *__cdecl GetErrorMessage(char *pluginHome)

  1. 建立一個目錄MyDir,把所開發的myLibrary.dll檔放在MyDir裡面,此目錄還要放兩個檔案description.txt與plugin.properties,description.txt裡面寫的是給使用者看的使用說明,而plugin.properties裡面則包含以下屬性:
    name = XXX證券轉入
    category = TRADING_RECORD_IMPORT
    # DLL (for C/C++ or Delphi) or JAR (for Java)
    type = DLL
    library = myLibrary.dll
    version = 1.0
    date = 套件的釋放日期
    sbk_minimum_version = 2.3.2
    developer = 開發者或券商名稱
  2. 此說明所用的myLibrary.dll與MyDir皆只是說明用的名稱,開發者可用自己的名稱
  3. 當開發完成後請把MyDir整個複製到c:\Program Files\StockBookkeeper\Plugin\MyDir,此動作即為安裝程序
  4. 安裝完外掛套件的工作目錄應如下
    StockBookkeeper\Plugin\MyDir
       +myLibrary.dll
       +plugin.properties
       +description.txt
  5. 請參考範例PlugInTest_C++
  • Delphi實作方法

  1. 開發一個myLibrary.dll檔
  2. 在此myLibrary.dll檔內撰寫三個函數,請注意每個函數的呼叫慣例採用cdecl,宣告如下

/**
* 取得最近的交易紀錄,傳回值字串即是獲利知多少資料庫的格式,每筆交易紀錄用換行符號隔開
*
* @param pluginHome 外掛套件的工作目錄
* @param account 登入券商系統所使用的帳號
* @param password 登入券商系統所使用的密碼
* @param fromDate 起始日期,格式為yyyy/mm/dd,例如2006/01/02,當此值為null時,代表所有的交易紀錄都須盡可能的傳回
* @param reservedArgument 保留參數
* @return 傳回自起始日期(含)以後的所有交易紀錄
*/
Function GetRecentTradingRecords( pluginHome:String, account:String, password:String, fromDate:String, reservedArgument:String ):String;export;cdecl;

/**
* 取得錯誤代碼,0表示成功無誤,其他值則表示有錯誤,
* 當GetRecentTradingRecords(...)函數被呼叫後,
* 會立即呼叫此函數以決定是否失敗
*
* @param pluginHome 外掛套件的工作目錄
* @return 傳回錯誤代碼
*/
Function GetErrorCode(pluginHome:String):Integer;export;cdecl;

/**
* 取得錯誤訊息,
* 當GetErrorCode(...)函數傳回非0的值,
* 則會呼叫此函數以取得錯誤訊息
*
* @param pluginHome 外掛套件的工作目錄
* @return 傳回錯誤訊息
*/
Function GetErrorMessage(pluginHome:String):Integer;export;cdecl;

  1. 建立一個目錄MyDir,把所開發的myLibrary.dll檔放在MyDir裡面,此目錄還要放兩個檔案description.txt與plugin.properties,description.txt裡面寫的是給使用者看的使用說明,而plugin.properties裡面則包含以下屬性:
    name = XXX證券轉入
    category = TRADING_RECORD_IMPORT
    # DLL (for C/C++ or Delphi) or JAR (for Java)
    type = DLL
    library = myLibrary.dll
    version = 1.0
    date = 套件的釋放日期
    sbk_minimum_version = 2.3.2
    developer = 開發者或券商名稱
  2. 此說明所用的myLibrary.dll與MyDir皆只是說明用的名稱,開發者可用自己的名稱
  3. 當開發完成後請把MyDir整個複製到c:\Program Files\StockBookkeeper\Plugin\MyDir,此動作即為安裝程序
  4. 安裝完外掛套件的工作目錄應如下
    StockBookkeeper\Plugin\MyDir
       +myLibrary.dll
       +plugin.properties
       +description.txt