FIX: 您無法在 BizTalk Server 2004 中您保存檔中存取 MessageBox 資料庫或追蹤訊息的訊息資訊

文章翻譯 文章翻譯
文章編號: 838454 - 檢視此文章適用的產品。
全部展開 | 全部摺疊

在此頁中

徵狀

您可能會發現您想要存取追蹤的郵件在 Microsoft BizTalk MessageBox 資料庫中或在您保存檔中。在 Microsoft BizTalk Server 2004 中未提供能夠列舉清單的郵件以及擷取內容和有關個別訊息的內容資料。

此 Hotfix 會加入新的 MessageArchive 物件。MessageArchive 物件公開能夠透過追蹤的訊息本文在 MessageBox 資料庫中] 或 [自訂封存資料庫中擷取列舉型別。

附註此 Hotfix 會包含在 Microsoft BizTalk Server 2004 Service Pack 1。

解決方案

服務套件資訊

如果要解決這個問題,取得 Microsoft BizTalk Server 2004 的最新的 Service Pack。如需詳細資訊,請按一下下列的文件編號,檢視 「 Microsoft 知識庫 」 中的文件:
888751如何取得最新的 BizTalk Server 2004 Service Pack

Hotfix 資訊

Microsoft 提供支援的 Hotfix。不過,此 Hotfix 旨在修正本文中所述隨問題。只會發生此特定問題的系統套用此 Hotfix。這個 Hotfix 可能會接受額外的測試。因此,如果您不會嚴重影響這個問題,我們建議您等候下一個包含此 Hotfix 的軟體更新。

如果此 Hotfix 可供下載,您可在本知識庫文件的頂端找到「 可用的 Hotfix 下載 」區段。如果本節 Does Not Appear 請連絡[ Microsoft 客戶服務 ] 和 [ 支援 ] 以取得此 Hotfix。

附註如果發生其他問題,或如果需要任何疑難排解,您可能必須建立個別的服務要求。和此 Hotfix 無關的額外支援問題適用一般的支援費用。如需 Microsoft 客戶服務支援部門電話號碼的完整清單或要建立個別的服務要求,請造訪下列 Microsoft 網站:
http://support.microsoft.com/contactus/?ws=support
附註「 下載 Hotfix 」 表單會顯示此 Hotfix 會出現,以供使用的語言。如果您沒有看到您的語言,是因為此 Hotfix 是不適用您的語言。

必要條件

沒有先決條件所需

重新啟動需求

您沒有套用此 Hotfix 之後,重新啟動您的電腦

Hotfix 取代資訊

此 Hotfix 不會取代任何其他的 Hotfix

檔案資訊

此 Hotfix 的英文版在檔案屬性 (或更新版本的檔案屬性) 如下列表格中所列。這些檔案的日期和時間為 Coordinated Universal Time (UTC)。當您檢視檔案資訊時,會將它轉換為當地時間。若要到 UTC 與當地時間差異使用在 [日期及時間中項目控制台中的 [時區] 索引標籤]。
   Date        Time    Version     Size       File name
   --------------------------------------------------------------------------------------
   08-Jul-2004  22:15  3.0.5320.0    144,896  Btshttpreceive.dll
   08-Jul-2004  22:15  3.0.5320.0  1,026,048  Btsmsgcore.dll
   08-Jul-2004  22:53  3.0.5320.0     32,768  Microsoft.biztalk.cachingservice.dll
   08-Jul-2004  22:50  3.0.5320.0    221,184  Microsoft.biztalk.flatfileextension.dll
   08-Jul-2004  22:48  3.0.5320.0    729,088  Microsoft.biztalk.globalpropertyschemas.dll
   08-Jul-2004  22:48  3.0.5320.0     69,632  Microsoft.biztalk.httptransport.dll
   08-Jul-2004  22:42  3.0.5320.0     77,824  Microsoft.biztalk.messageboxom.dll
   08-Jul-2004  22:50  3.0.5320.0     49,152  Microsoft.biztalk.messaging.dll
   08-Jul-2004  22:53  3.0.5320.0    217,088  Microsoft.biztalk.pipeline.dll
   08-Jul-2004  21:46                145,598  Msgboxlogic.sql
   08-Jul-2004  21:46                 12,158  Msgbox_tracking_schema.sql

附註 由於檔案相依性的最新 Hotfix 包含這些檔案也可能包含其他檔案。

狀況說明

Microsoft 已確認<適用於>一節所列之 Microsoft 產品確實有此問題。這個問題已經在 BizTalk Server 2004 Service Pack 1 中獲得修正。

其他相關資訊

封存訊息主體資料的方式

您可以參考 Microsoft.BizTalk.MessageBoxOM.dll 檔案保存在 MessageBox 資料庫中的 [Tracking_Spool1] 和 [Tracking_Spool2] 資料表中的訊息主體資料。要這麼做,請您執行下列步驟:
  1. 參考 Microsoft.BizTalk.MessageBoxOM.dll 檔案。Microsoft.BizTalk.MessageBoxOM.dll 檔案位於全域組件快取 (GAC) 中。您無法新增位於 GAC Microsoft Visual Studio.NET 2003年專案中的元件的參考。若要參照在 Visual Studio.NET 2003年專案中的 [Microsoft.BizTalk.MessageBoxOM.dll 檔案,使用下列方法之一:
    • 方法 1: 從 GAC 抽選 Microsoft.BizTalk.MessageBoxOM.dll 檔案

      從 GAC 解壓縮 Microsoft.BizTalk.MessageBoxOM.dll 檔案,請在命令提示字元執行下列命令。在這個命令 DestinationPath 代表在硬碟上的檔案位置。比方說您可以使用下列命令來擷取 Microsoft.BizTalk.MessageBoxOM.dll 檔案,包含為您的 Visual Studio.NET 2003年專案檔案的資料夾:
      複製 %systemroot%\assembly\GAC\Microsoft.BizTalk.MessageBoxOM\3.0.1.0__31bf3856ad364e35\Microsoft.BizTalk.MessageBoxOM.dll DestinationPath
    • 方法 2: 手動編輯 Visual Studio.NET 2003年專案檔

      若要將參考加入至位於 GAC 中的元件,手動編輯 Visual Studio.NET 2003年專案檔,在文字編輯器中。比方說.csproj 和.btproj 檔案是專案檔案。在專案檔案中加入下列程式碼範例至 參照 項目
      Name = "Microsoft.BizTalk.MessageBoxOM"
      AssemblyName = "Microsoft.BizTalk.MessageBoxOM"
      HintPath = "<SystemRoot>\assembly\GAC\Microsoft.BizTalk.MessageBoxOM\3.0.1.0__31bf3856ad364e35\Microsoft.BizTalk.MessageBoxOM.dll"
  2. 在 Visual Studio.NET 2003年中建立主控台應用程式。然後,在主控台應用程式中新增下列元件的參考:
    • Microsoft.Biztalk.messageboxom.dll

      附註如果您將在步驟 1 中的硬碟上的位置檔案解壓縮,只將參考加入 Microsoft.biztalk.messageboxom.dll 檔案。
    • \Microsoft BizTalk Server 2004\Microsoft.BizTalk.Messaging.dll
    • \Microsoft BizTalk Server 2004\Microsoft.BizTalk.pipeline.dll
    • System.xml
  3. 將程式碼加入至主控台應用程式,讓您封存訊息本文資料。然後,編譯應用程式。比方說使用類似下列的 Microsoft Visual C# 程式碼範例的程式碼
    using System;
    using System.IO;
    using Microsoft.BizTalk.Message.Interop;
    using Microsoft.BizTalk.MessageBoxOM;
    using System.Collections;
    using System.Diagnostics;
    
    namespace ConsoleApplication1
    {
    /// <summary>
    /// Summary description for Class1.
    /// </summary>
    class Class1
    {
    /// <summary>
    /// The main entry point for the application.
    /// </summary>
    [STAThread]
    static void Main(string[] args)
    {
    MessageArchive archive = new MessageArchive();
    archive.ConnectionString = "Persist Security Info=False;Integrated Security=SSPI;database=BizTalkMsgboxDb;server=."
    
    foreach (IBaseMessage msg in archive.Messages)
    {
    int cnt = msg.PartCount;
    UInt64 lSize;
    bool fImplemented;
    msg.GetSize(out lSize, out fImplemented);
    //Trace.WriteLine("Message ID: " + msg.MessageID.ToString());
    //Trace.WriteLine("Message Size: " + lSize.ToString());
    Console.WriteLine("Message ID: " + msg.MessageID.ToString());
    Console.WriteLine("Message Size: " + lSize.ToString());
    String partName;
    IBaseMessagePart part = msg.GetPartByIndex(0, out partName);
    Stream data = part.Data;
    string contentType = part.ContentType;
    string charset = part.Charset;
    
    
    //byte[] arr = new byte[data.Length];
    //data.Read(arr, 0, (int)data.Length);
    //file.Write(arr, 0, (int)data.Length);
    
    FileStream file = new FileStream(@"<full path of where you want to store the tracked messages>\" + msg.MessageID + ".xml", FileMode.Create);
    
    byte[] arr = new byte[1024];
    int bytesRead = 0;
    while ( (bytesRead = data.Read(arr, 0, 1024) ) > 0) 
    {
    file.Write(arr, 0, bytesRead);
    if (bytesRead < 1024)
    break;
    }
    
    file.Close();
    
    }
    
    archive.Dispose(); 
    }
    }
    }
  4. 執行主控台應用程式。您在執行主控台應用程式時主控台應用程式會從 MessageBox 資料庫中非使用中的資料表擷取追蹤的訊息主體資料。非作用中的資料表是 Tracking_Spool1 資料表或 Tracking_Spool2 資料表。 MessageArchive 物件無法存取使用中的資料表。

    預設情況下,Tracking_Spool1 資料表會是作用中的資料表。因此,沒有資料會傳回第一次您執行主控台應用程式。使 Tracking_Spool2 表格使用中的表格,在 SQL Server 中執行 TrackingSpool_Cleanup_BizTalkMsgBoxDb 工作。

    附註預設情況下,TrackingSpool_Cleanup_BizTalkMsgBoxDb 工作已不會啟用。TrackingSpool_Cleanup_BizTalkMsgBoxDb 工作刪除訊息主體資料。

    執行 TrackingSpool_Cleanup_BizTalkMsgBoxDb 工作之後中執行主控台應用程式?封存訊息本文資料 Tracking_Spool1 資料表中。

    附註因為 TrackingSpool_Cleanup_BizTalkMsgBoxDb 作業會從非作用中清除訊息主體資料,您必須執行主控台應用程式,在您再次,執行 TrackingSpool_Cleanup_BizTalkMsgBoxDb 工作之前

    比方說請依照下列步驟執行來封存在 MessageBox 資料庫中的訊息主體資料:
    1. 建立封存訊息主體資料的排程。比方說如果您一次每兩週執行 TrackingSpool_Cleanup_BizTalkMsgBoxDb 工作,就必須兩個星期的資料的追蹤訊息主體資料。
    2. 執行 TrackingSpool_Cleanup_BizTalkMsgBoxDb 工作。執行此工作的第一次 Tracking_Spool2 資料表已標記為使用中的表格。Tracking_Spool2 資料表是空的。沒有資料就遺失。
    3. 執行主控台應用程式?封存訊息本文資料儲存於 Tracking_Spool1 資料表中。
    4. 當您想要再次封存訊息本文資料時,執行 TrackingSpool_Cleanup_BizTalkMsgBoxDb 工作。此工作會清除之處於 Tracking_Spool1 資料表,且會標示為作用中 Tracking_Spool1 資料表資料。
    5. 執行主控台應用程式?封存訊息本文資料儲存於 Tracking_Spool2 資料表中。
    6. 重複步驟 4a 4e 您在步驟 4a 中建立的排程。
    如 TrackingSpool_Cleanup_BizTalkMsgBoxDb 工作的更多有關,按一下 [下面的文件編號,檢視 「 Microsoft 知識庫 」 中的發行項]:
    907661BiztalkMsgBoxDb 資料庫中 Tracking_Spool1 或 Tracking_Spool2 資料表會變得非常大,BizTalk Server 2004 中

MessageArchive 物件介面

MessageArchive 物件會實作下列介面:
    public int CommandTimeout
    • 描述: 與此介面,使用者可以取得並設定在基礎的 SQL 連線相關聯的逾時。
    • 界限條件:在逾時應該多或等於 0。最大逾時將會是一小時。0 表示無限的逾時。
    • 錯誤情況下:無效的值將會產生 ArgumentOutOfRangeException 例外狀況。

    public string ConnectionString
    • 描述: 與此介面使用者可以取得並設定為基礎的封存資料庫連接字串。
    • 界限條件:字串不能是 Null,而且不能是空字串。設定連線一次成功之後,您不能重設連接屬性。
    • 錯誤情況下:Null 字串或零 (0) 的長字串會使 ArgumentException 例外狀況。設定屬性之後已經設定會使 InvalidOperationException 例外狀況。如果字串不是有效的連接,SQL 會產生一個連線的例外狀況。

    public int BatchSize
    • 描述: 與此介面使用者可以取得並設定要從資料庫擷取的資料批次大小。此動作可避免 BizTalk Server 一次使用太多記憶體。預設值為 50。
    • 界限條件:[BatchSize 必須更多或等於 0。0 表示 MessageArchive 物件應該擷取最多到符合的項目最大數目的所有資料 BatchSize。最大 BatchSize 是 1000年,因為它並沒有什麼道理個以上的記憶體中載入。
    • 錯誤情況下:可接受的範圍之外的 BatchSizes 產生 ArgumentOutOfRangeException 例外狀況。

    public int MaxMatches
    • 描述: 與此介面,使用者可以取得並設定為列舉型別擷取的訊息數目上限。這個介面會不同於 BatchSize 介面,因為 MaxMatches 是 MoveNext 方法的列舉型別之前的訊息總數傳回 false。
    • 界限條件:MaxMatches 必須更多或等於 0。數值 0 表示擷取所有的訊息。
    • 錯誤情況下:如果 MaxMatches 值小於 0,就會產生 ArgumentOutOfRangeException 例外狀況。

    public DateTime From
    • 描述: 與此介面使用者可篩選訊息他們會想要擷取根據特定的日期和時間範圍的集。設定這個屬性指示 MessageArchive 物件應該只擷取上或之後指定的日期和時間會發佈的訊息。
    • 界限條件:如果指定 Until 時間,寄時間必須等於或 Until 時間之前。
    • 錯誤情況下:如果自時間晚於 Until 時間,會產生 ArgumentException 例外狀況。

    public DateTime Until
    • 描述: 與此介面使用者可篩選訊息他們會想要擷取根據特定的日期和時間範圍的集。設定這個屬性指示 MessageArchive 物件應該只擷取在或之前指定的時間則會發佈的訊息。
    • 界限條件:如果指定寄時間,Until 時間必須等於或自時間之後。
    • 錯誤情況下:如果 Until 時間是從時間之前,會產生 ArgumentException 例外狀況。

    public IEnumerable Messages
    • 描述: 與此介面使用者可以擷取的介面,它們可以列舉所有郵件。因為沒有 Count 屬性提供,會使用列舉型別。
    • 界限條件:這個介面會接受沒有參數。
    • 錯誤情況下:如果連線尚未還設定,就會產生 InvalidOperationException 例外狀況。其他所有錯誤都 SQL 連線問題所都造成。
    • 訊息列舉型別傳回型別 ArchivedMessage 的物件。這些物件可以轉換成 IBaseMessage 介面。如需 IBaseMessage 有關的詳細資訊,請參閱 Microsoft BizTalk Server 2004 線上說明文件。

所有下列函式或方法不支援的 MessageArchive 物件,且會產生 InvalidOperationException 例外狀況:
  • public void AddPart(string partName, IBaseMessagePart part, [MarshalAs(UnmanagedType.Bool)] bool bBody)
  • public IBaseMessagePart GetPart(string partName)
  • public void RemovePart(string partName)
  • public Exception GetErrorInfo()
  • public void SetErrorInfo(Exception errInfo)
也包含在此 Hotfix 是您可以使用 BizTalk Server 解決方案中的一些新屬性:
  • 從配接器接收訊息和之前,接收管線會開始處理訊息時,會填入 AdapterReceiveCompleteTime 屬性。
  • 配接器啟動傳輸訊息之前,會填入 AdapterTransmitBeginTime 屬性。
  • AdapterTransmitCompleteTime 屬性會填入後配接器已成功傳輸訊息。不支援這個屬性為 [BizTalk 訊息佇列配接器 (MSMQT)。
這些屬性屬於下列命名空間:
http://schemas.microsoft.com/BizTalk/2003/messagetracking-properties
全部的三個屬性具有輸入 VT_DATE (或日期時間)。

如需詳細資訊,請按一下下列的文件編號,檢視 「 Microsoft 知識庫 」 中的文件:
824684用來描述 Microsoft 軟體更新標準術語的說明

屬性

文章編號: 838454 - 上次校閱: 2006年12月29日 - 版次: 4.2
這篇文章中的資訊適用於:
  • Microsoft BizTalk Server 2004 Standard Edition
  • Microsoft BizTalk Server 2004 Partner Edition
  • Microsoft BizTalk Server 2004 Enterprise Edition
  • Microsoft BizTalk Server 2004 Developer Edition
關鍵字:?
kbmt kbautohotfix kbbiztalk2004-2006swept kbbiztalk2004sp1fix kbbiztalk2004presp1fix kbbug kbfix kbhotfixserver kbqfe KB838454 KbMtzh
機器翻譯
重要:本文是以 Microsoft 機器翻譯軟體翻譯而成,而非使用人工翻譯而成。Microsoft 同時提供使用者人工翻譯及機器翻譯兩個版本的文章,讓使用者可以依其使用語言使用知識庫中的所有文章。但是,機器翻譯的文章可能不盡完美。這些文章中也可能出現拼字、語意或文法上的錯誤,就像外國人在使用本國語言時可能發生的錯誤。Microsoft 不為內容的翻譯錯誤或客戶對該內容的使用所產生的任何錯誤或損害負責。Microsoft也同時將不斷地就機器翻譯軟體進行更新。
按一下這裡查看此文章的英文版本:838454
Microsoft及(或)其供應商不就任何在本伺服器上發表的文字資料及其相關圖表資訊的恰當性作任何承諾。所有文字資料及其相關圖表均以「現狀」供應,不負任何擔保責任。Microsoft及(或)其供應商謹此聲明,不負任何對與此資訊有關之擔保責任,包括關於適售性、適用於某一特定用途、權利或不侵權的明示或默示擔保責任。Microsoft及(或)其供應商無論如何不對因或與使用本伺服器上資訊或與資訊的實行有關而引起的契約、過失或其他侵權行為之訴訟中的特別的、間接的、衍生性的損害或任何因使用而喪失所導致的之損害、資料或利潤負任何責任。

提供意見

 

Contact us for more help

Contact us for more help
Connect with Answer Desk for expert help.
Get more support from smallbusiness.support.microsoft.com