產品功能

提供轉檔元件，可用程式串接該元件，打入自定義的查詢語法，來取用CMoney財經資料庫的資源。

環境需求

• Windows XP 或 Windows Server  2008 以上作業系統
• 如果以Office VBA來串接元件，Office版本須為32位元。

產品限制

• 查詢返回筆數 <= 60萬筆

產品項目

安裝與註冊流程

1. 請下載安裝檔到本機。
2. 請以系統管理員執行該安裝檔，並且按下[安裝]。
   
3. 安裝程式會將元件放到系統資料夾底下，並且進行註冊，執行後會自動關閉。

手動註冊流程

有時候可能因為權限或環境問題，安裝檔無法註冊元件成功時，請參照以下流程處理。

regsvr32 cmadox.dll

regsvr32 C:\Windows\SysWOW64\cmadox.dll

1. 請將安裝檔解壓縮，解壓縮後的資料夾內應該會有cmadox.dll或cmadox5.dll。
2. 請先查詢您的電腦OS位元
3. 參照上表，找到您的系統資料夾路徑。
4. 將1得到的.dll檔，放到系統資料夾路徑下。
5. 以系統管理員身分開啟cmd(或左下角>搜尋>輸入"執行">會跳出一個執行視窗)
   
6. 在命令行中(或執行的藍框中)輸入對應的cmd指令，並且執行。

Windows Server 主機 註冊特別事項

如果您的OS環境為Windows Server，請對COM+進行註冊。

請參照COM+操作文件[點我連結]

COM+元件註冊後，請將專案透過進階設定將[啟用32位元應用程式]選擇為TRUE(Adox元件不支援建置目標64位元的專案)

產品使用

輸入

可用TLS1.2協定來查詢資料。 

動態連結代號

• 可以使用<CM 與 > 標籤，來決定要設定的動態連結代號。
• 標籤內用逗號來分隔參數<CM參數1,參數2>

資料表前後請留空白,若表格名稱內含有中括號,則表格名稱請不要再用中括號包住

輸出

返回ADODB.RecordSet型態的資料集合

其他屬性

.ErrorMessage：取得錯誤訊息

錯誤訊息與Log紀錄

當元件未預期執行時，可以到↓查看是否有Log紀錄，再提交給CMoney人員。

C:\Program Files (x86)\CMoney\CMAdox_LOG\

C:\Program Files\CMoney\CMAdox_LOG\

C:\Users\user1\AppData\Roaming\

*user1是當前登入帳戶名稱

以程式串接ADOX元件

C#串接說明

開發環境引用元件

1. 開啟程式開發介面(以下以Vistual Studio舉例)，並開啟您要開發或維運的專案
2. 專案參考設定：
   專案 > 參考 > 加入參考 > COM頁籤 > 選擇CMADODB或CMADODB5 > 確定
   * PS 選擇清單中可能有很多個相同的項目一起出現，擇一勾選就可以，它會一起勾。
   
   

撰寫程式碼以使用元件

[Adox]

/// <summary>
/// 查詢指定SQL命令並返回資料表
/// </summary>
/// <param name="sqlCommandText">SQL命令</param>
/// <returns>查詢結果</returns>
public DataTable Execute(string sqlCommandText)
{
ADODB.Recordset recordset = new ADODB.Recordset();
CMADODB.CMConnection conn = new CMADODB.CMConnection();

try
{
using (System.Data.OleDb.OleDbDataAdapter adapter = new System.Data.OleDb.OleDbDataAdapter())
{
DataTable dt = new DataTable();

recordset = conn.CMExecute("5", sqlCommandText);

if (!string.IsNullOrEmpty(conn.ErrorMessage))
{
throw new Exception(conn.ErrorMessage);
}

if (recordset != null && recordset.RecordCount > 0)
{

adapter.Fill(dt, recordset);
return dt;
}
else
{
throw new Exception("查無資料");
}
}
}
catch (Exception ex)
{
throw new Exception($"查詢例外：{ex}");
}
finally
{
if (recordset != null)
{
if (recordset.State != 0)
{
recordset.Close();
}
recordset = null;
}
conn = null;
}
}

[Adox5]

/// <summary>
/// 查詢指定SQL命令並返回資料表
/// </summary>
/// <param name="sqlCommandText">SQL命令</param>
/// <returns>查詢結果</returns>
public DataTable Execute(string sqlCommandText)
{
ADODB.Recordset recordset = new ADODB.Recordset();
CMADODB5.CMConnection conn = new CMADODB5.CMConnection();
try
{
using (System.Data.OleDb.OleDbDataAdapter adapter = new System.Data.OleDb.OleDbDataAdapter())
{
DataTable dt = new DataTable();

recordset = conn.CMExecuteOLEDB("5", "伺服器IP", "伺服器Port", sqlCommandText);

if (!string.IsNullOrEmpty(conn.ErrorMessage))
{
throw new Exception(conn.ErrorMessage);
}

if (recordset != null && recordset.RecordCount > 0)
{
adapter.Fill(dt, recordset);
return dt;
}
else
{
throw new Exception("查無資料");
}
}
}
catch (Exception ex)
{
throw new Exception($"查詢例外：{ex}");
}
finally
{
if (recordset!=null)
{
if (recordset.State != 0)
{
recordset.Close();
}
recordset = null;
}
conn = null;
}
}

範例測試程式

本方案架構說明

DemoAdox(5).slu

└-- DemoForm.csproj：作為客戶端應用程式，示範外部程式如何去呼叫DemoLib內的類別。

└-- DemoLib.csproj：作為底層，內部主要是包裝adox(5)的查詢以及ADODB.Recordset轉換為DataTable。

常見Q&A

Q: 擷取元件 (CLSID 為 {FA04616C-9B80-4D61-8228-5BC1963E07CB}) 的 COM Class Factory 失敗，因為發生下列錯誤: 80040154 類別未登錄 (發生例外狀況於 HRESULT: 0x80040154 (REGDB_E_CLASSNOTREG))

A: 請先嘗試手動註冊流程

Q: 我寫的程式在開發端測試運行沒有問題，但是佈署到IIS或其他主機時，就會出錯。

A: 請先確認遠端目的主機，也有進行元件註冊流程。

Q: 我還是有問題

A: 請聯絡CMoney，並提供Log檔。如果方便，亦請提供串接程式碼(可先自行移除商業邏輯)，並告知使用的語言和運行環境。