ステップ 1:BizTalk Server にドキュメントを送信する単体テストの作成

[アーティクル]
07/21/2023

BizTalk Serverなどのコンピューターアプリケーションサーバーは、ユーザーに代わって特定のタスクを実行するように設計されています。これらのタスクは、アプリケーションサーバーが認識するプロトコルを介して、アプリケーションサーバーが認識する標準に準拠するメッセージとしてアプリケーションサーバーに送信されるクライアント要求として開始されます。たとえば、クライアントは、SMTP プロトコルを使用してインターネット電子メールメッセージを電子メールサーバーに送信することで、電子メールの処理を開始できます。同様に、Web サーバーはクライアント HTML または ASP 要求を処理し、データベースサーバーはクライアント SQL 要求を処理し、BizTalk Serverは多数の業界標準プロトコルを使用して複数の業界標準標準に準拠して書式設定されたクライアントメッセージを処理できます。アプリケーション・サーバーのワークロード容量は、通常、アプリケーション・サーバーが特定の期間内に処理できるメッセージの数によって測定されます。 BizTalk Serverのワークロード容量は、同様に、"1 秒あたりに受信されたドキュメント数"、"1 秒あたりに処理されたドキュメント"、"1 秒あたりに完了したオーケストレーション" の平均数 (忙しい稼働日や稼働日など) として測定されます。 Visual Studio 2010 ロードテスト機能では、サーバーアプリケーションに同時にアクセスする最大数百人のユーザーのロードプロファイルをシミュレートできます。このロードテスト機能は、選択した主要業績評価指標のリアルタイムメトリックと、将来の分析のためにこれらのメトリックをデータベースに格納する機能を提供します。このドキュメントでは、単体テストの作成方法、ロードテストの作成方法、BizTalk Server アプリケーションの最大持続可能スループット (MST) を決定するために必要なパフォーマンスカウンターデータをキャプチャするようにロードテストを構成する方法など、BizTalk Server アプリケーションのロードテストを目的とした Visual Studio テストプロジェクトの使用について説明します。

ドキュメントをBizTalk Serverに送信する Visual Studio 単体テストの作成

Visual Studio 単体テストでは、単体テストのサポートを提供するいくつかのクラスを提供する Microsoft.VisualStudio.TestTools.UnitTesting (https://go.microsoft.com/fwlink/?LinkID=132293) 名前空間を参照します。特に重要なのは、 UnitTesting (https://go.microsoft.com/fwlink/?LinkID=132293) 名前空間には、単体テストに提供される情報を格納する Microsoft.VisualStudio.TestTools.UnitTesting.TestContext (https://go.microsoft.com/fwlink/?LinkID=208233) クラスと、テストメソッドを定義するために Microsoft.VisualStudio.TestTools.UnitTesting.TestMethodAttribute (https://go.microsoft.com/fwlink/?LinkID=208235) クラスが使用されます。 BizTalk Serverロードテストの目的で、Test メソッドは、読み込むメッセージと、メッセージの送信先となるエンドポイント/URL を指定する必要があります。エンドポイント/URL は、対応する BizTalk 受信場所が作成されたときに、BizTalk Serverへのメッセージエントリポイントとして機能します。

図を示すために、このトピックのサンプルコードでは、System.ServiceModel.ChannelFactory(TChannel)https://go.microsoft.com/fwlink/?LinkID=208238 クラスを使用して WCF net.tcp エンドポイントを使用し、BizTalk WCF-Custom 受信アダプターによって監視されるサービスエンドポイントにメッセージを送信するテストメソッドについて説明します。テストメッセージのサービスエンドポイントは、テストプロジェクトのアプリケーション構成 (app.config) ファイルで定義されます。

Visual Studio 単体テストの詳細については、「単体テストの構造 (https://go.microsoft.com/fwlink/?LinkID=208232)」を参照してください。

以下のセクションの手順に従って、単体テストを使用してテストプロジェクトを作成し、1 つ以上のBizTalk Server コンピューターにドキュメントを送信します。これらの手順は、Visual Studio 2010 Ultimate Edition を使用して完了しました。

Visual Studio 2010 テストプロジェクトのオプションを設定する

Visual Studio 2010 Ultimate Edition を起動します。 [ スタート] ボタンをクリックし、[ すべてのプログラム] をポイントし、[ Microsoft Visual Studio 2010 ] をポイントして、[ Microsoft Visual Studio 2010] をクリックします。
Visual Studio 2010 で、[ ツール ] をクリックし、[ オプション ] をクリックして [ オプション] ダイアログボックスを表示します。
クリックしてTest Tools展開し、[テストプロジェクト] をクリックして、新しいテストプロジェクトを作成するためのオプションを表示します。
既定の テストプロジェクト言語: を Visual C# テストプロジェクトに設定します。
[新しい各テストプロジェクトに追加されるファイルを選択する] オプションの下で、既定では [Visual C# テストプロジェクト] を選択し、単体テストを除く Visual C# テストプロジェクトのすべてのテストの種類をオフにします。
[OK] をクリックして、 [オプション] ダイアログボックスを閉じます。

テストプロジェクトを使用して新しい Visual Studio 2010 ソリューションを作成する

フォルダー C:\Projects を Visual Studio 2010 Ultimate コンピューターに作成します。
Visual Studio 2010 で [ ファイル] をクリックし、[ 新規作成] をポイントし、[ プロジェクト ] をクリックして [ 新しいプロジェクト ] ダイアログボックスを表示します。
[ インストールされているテンプレート ] で、[ Visual C#] をクリックして展開し、[ テスト] をクリックします。
[ 新しいプロジェクト ] ダイアログボックスの下部で、次のオプションを指定します。
- 名前:BTSLoad
- Location:C:\Projects\
- ソリューション名:LoadTest
[ソリューションのディレクトリを作成する] オプションがオンになっていることを確認し、[OK] をクリック します。
BTSLoad プロジェクトにフォルダーを追加します。このフォルダーには、BizTalk Serverに送信されるテストメッセージが含まれます。ソリューションエクスプローラーで、BTSLoad プロジェクトを右クリックし、[追加] をポイントして、[新しいフォルダー] をクリックします。テキスト NewFolder1 が強調表示されたフォルダーアイコンが BTSLoad プロジェクトの下に表示され、「 TestMessages 」と入力して強調表示されたテキストを変更し、 Enter キーを押してフォルダー C:\Projects\LoadTest\BTSLoad\TestMessages を作成します。

テストプロジェクトのコードを更新し、アプリケーション構成ファイルをテストプロジェクトに追加する

ソリューションエクスプローラークリックして UnitTest1.cs を選択し、既存のコードを次のサンプルコードリストに置き換えます。

#region Using Directives
using System;
using System.IO;
using System.Diagnostics;
using System.Text;
using System.Configuration;
using System.Collections.Generic;
using System.Linq;
using System.Xml;
using System.ServiceModel;
using System.ServiceModel.Channels;
using Microsoft.VisualStudio.TestTools.UnitTesting;
#endregion

namespace Microsoft.BizTalk.Samples
{
    [TestClass]
    public class BTSLoadTest
    {
        #region Constants
        private const int MaxBufferSize = 2097152;
        private const string Source = "BTS Load Test";
        private const string Star = "*";
        private const string TestMessageFolderParameter = "testMessageFolder";
        private const string TestMessageFolderDefault = @"C:\Projects\LoadTest\BTSLoad\TestMessages";
        private const string TestMessageFolderFormat = @"Test Message Folder = {0}";
        private const string TestXmlDocument = "testxmldocument.xml";
        #endregion

        #region Private Instance Fields
        private TestContext testContextInstance;
        #endregion

        #region Private ThreadStatic Fields
        [ThreadStatic]
        private static ChannelFactory<IRequestChannel> channelFactory;
        [ThreadStatic]
        private static IRequestChannel channel = null;
        [ThreadStatic]
        private static byte[] buffer = null;
        #endregion

        #region Private Static Fields
        private static string testMessageFolder = null;
        #endregion

        #region Public Instance Constructor
        public BTSLoadTest()
        {
        }
        #endregion

        #region Public Static Constructor
        static BTSLoadTest()
        {
            try
            {
                testMessageFolder = ConfigurationManager.AppSettings[TestMessageFolderParameter];
                if (string.IsNullOrEmpty(testMessageFolder))
                {
                    testMessageFolder = TestMessageFolderDefault;
                }
            }
            catch (Exception ex)
            {
                Trace.WriteLine(ex.Message);
                EventLog.WriteEntry(Source, ex.Message, EventLogEntryType.Error);
            }
        }
        #endregion

        #region Public Properties
        /// <summary>
        ///Gets or sets the test context which provides
        ///information about and functionality for the current test run.
        ///</summary>
        public TestContext TestContext
        {
            get
            {
                return testContextInstance;
            }
            set
            {
                testContextInstance = value;
            }
        }
        #endregion

        #region Test Methods

        [TestMethod]
        public void BTSMessaging()
        {
            InvokeBizTalkReceiveLocation("BTSMessagingEP",
                                           testMessageFolder,
                                           TestXmlDocument,
                                           MessageVersion.Default,
                                           SessionMode.Allowed);
        }

        [TestMethod]
        public void BTSMessaging2()
        {
            InvokeBizTalkReceiveLocation("BTSMessagingEP2",
                                           testMessageFolder,
                                           TestXmlDocument,
                                           MessageVersion.Default,
                                           SessionMode.Allowed);
        }

        [TestMethod]
        public void BTSOrchestration()
        {
            InvokeBizTalkReceiveLocation("BTSOrchestrationEP",
                                           testMessageFolder,
                                           TestXmlDocument,
                                           MessageVersion.Default,
                                           SessionMode.Allowed);
        }
        #endregion

        #region Helper Methods
        public void InvokeBizTalkReceiveLocation(string endpointConfigurationName,
                                           string requestMessageFolder,
                                           string requestMessageName,
                                           MessageVersion messageVersion,
                                           SessionMode sessionMode)
        {
            XmlTextReader xmlTextReader = null;
            Message requestMessage = null;
            Message responseMessage = null;

            try
            {
                if (channel == null || channel.State != CommunicationState.Opened)
                {
                    channelFactory = new ChannelFactory<IRequestChannel>(endpointConfigurationName);
                    channelFactory.Endpoint.Contract.SessionMode = sessionMode;
                    channel = channelFactory.CreateChannel();
                }
                if (buffer == null)
                {
                    string path = Path.Combine(requestMessageFolder, requestMessageName);

                    string message;
                    using (StreamReader reader = new StreamReader(File.Open(path, FileMode.Open, FileAccess.Read, FileShare.Read)))
                    {
                        message = reader.ReadToEnd();
                    }
                    buffer = Encoding.UTF8.GetBytes(message);
                }
                MemoryStream stream = new MemoryStream(buffer);
                xmlTextReader = new XmlTextReader(stream);
                requestMessage = Message.CreateMessage(messageVersion, Star, xmlTextReader);
                TestContext.BeginTimer(requestMessageName);
                responseMessage = channel.Request(requestMessage);
            }
            catch (FaultException ex)
            {
                HandleException(ex);
                throw;
            }
            catch (CommunicationException ex)
            {
                HandleException(ex);
                throw;
            }
            catch (TimeoutException ex)
            {
                HandleException(ex);
                throw;
            }
            catch (Exception ex)
            {
                HandleException(ex);
                throw;
            }
            finally
            {
                TestContext.EndTimer(requestMessageName);
                CloseObjects(xmlTextReader,
                             requestMessage,
                             responseMessage);
            }
        }

        private void HandleException(Exception ex)
        {
            try
            {
                Trace.WriteLine(ex.Message);
                EventLog.WriteEntry(Source, ex.Message, EventLogEntryType.Error);
            }
            catch (Exception)
            {
            }
        }

        private void CloseObjects(XmlTextReader xmlTextReader,
                           Message requestMessage,
                           Message responseMessage)
        {
            try
            {
                if (xmlTextReader != null)
                {
                    xmlTextReader.Close();
                }
                if (requestMessage != null)
                {
                    requestMessage.Close();
                }
                if (responseMessage != null)
                {
                    responseMessage.Close();
                }
            }
            catch (Exception)
            {
            }
        }

        #endregion
    }
}

アプリケーション構成ファイルをテストプロジェクトに追加します。

ソリューションエクスプローラーで、BTSLoad プロジェクトを右クリックし、[追加] をポイントし、[新しい項目] をクリックします。
[ 新しい項目の追加 ] ダイアログボックスの [ インストールされているテンプレート] で、[ 全般] をクリックします。
表示される項目の一覧で、[ アプリケーション構成ファイル ] をクリックし、[ 追加] をクリックします。

ソリューションエクスプローラー app.config ファイルを選択し、app.config ファイルの内容を次のサンプルコードリストに置き換えます。

重要

このファイルで定義されているクライアントエンドポイントごとに、BizTalk Server Computer は、ロードテストを実行するBizTalk Server コンピューターの実際の名前のプレースホルダーです。


<configuration>
  <system.serviceModel>
    <!-- Bindings used by client endpoints -->
    <bindings>
      <netTcpBinding>
        <binding name="netTcpBinding" closeTimeout="01:10:00" openTimeout="01:10:00" receiveTimeout="01:10:00" sendTimeout="01:10:00" transactionFlow="false" transferMode="Buffered" transactionProtocol="OleTransactions" hostNameComparisonMode="StrongWildcard" listenBacklog="100" maxBufferPoolSize="1048576" maxBufferSize="10485760" maxConnections="400" maxReceivedMessageSize="10485760">
          <readerQuotas maxDepth="32" maxStringContentLength="8192" maxArrayLength="16384" maxBytesPerRead="4096" maxNameTableCharCount="16384" />
          <reliableSession ordered="true" inactivityTimeout="00:10:00" enabled="false" />
          <security mode="None">
            <transport clientCredentialType="Windows" protectionLevel="EncryptAndSign" />
            <message clientCredentialType="Windows" />
          </security>
        </binding>
      </netTcpBinding>
    </bindings>
    <client>
      <!-- Client endpoints used to exchange messages with WCF Receive Locations -->

      <!-- BTSMessagingEP -->
      <endpoint address="net.tcp://BizTalk Server Computer:8123/btsloadtest" binding="netTcpBinding" bindingConfiguration="netTcpBinding" contract="System.ServiceModel.Channels.IRequestChannel" name="BTSMessagingEP" />
      <endpoint address="net.tcp://BizTalk Server Computer:8123/btsloadtest" binding="netTcpBinding" bindingConfiguration="netTcpBinding" contract="System.ServiceModel.Channels.IRequestChannel" name="BTSMessagingEP" />

      <!-- BTSOrchestrationEP -->
      <endpoint address="net.tcp://BizTalk Server Computer:8122/btsloadtest" binding="netTcpBinding" bindingConfiguration="netTcpBinding" contract="System.ServiceModel.Channels.IRequestChannel" name="BTSOrchestrationEP" />
    </client>
  </system.serviceModel>
  <appSettings>
    <!-- Folder containing test messages -->
    <add key="testMessageFolder" value="C:\Projects\LoadTest\BTSLoad\TestMessages" />
    <add key="ClientSettingsProvider.ServiceUri" value="" />
  </appSettings>
</configuration>

Visual Studio 2010 の [ ファイル ] メニューをクリックし、[ すべて保存] をクリックします。

プロジェクトにテストメッセージを追加する

この例では、BizTalk Server受信場所と送信ポートはパススルーパイプラインを使用するように構成され、ドキュメントの検証は実行されません。プロジェクトにテストメッセージを追加するには、次の手順に従います。

メモ帳を起動します。 [スタート] をクリックし、[実行] をクリックし、[実行] ダイアログボックスに「メモ帳」と入力します。

次のテキストをメモ帳にコピーし、"C:\Projects\LoadTest\BTSLoad\TestMessages\TestXmlDocument.xml" として保存します

<BTSLoadTest xmlns="http://Microsoft.BizTalk.Samples.BTSLoadTest">
<MessageText>
This is sample message text. This is sample message text. This is sample message text. This is sample message text.
This is sample message text. This is sample message text. This is sample message text. This is sample message text.
This is sample message text. This is sample message text. This is sample message text. This is sample message text.
This is sample message text. This is sample message text. This is sample message text. This is sample message text.
This is sample message text. This is sample message text. This is sample message text. This is sample message text.
This is sample message text. This is sample message text. This is sample message text. This is sample message text.
This is sample message text. This is sample message text. This is sample message text. This is sample message text.
This is sample message text. This is sample message text. This is sample message text. This is sample message text.
This is sample message text. This is sample message text. This is sample message text. This is sample message text.
This is sample message text. This is sample message text. This is sample message text. This is sample message text.
This is sample message text. This is sample message text. This is sample message text. This is sample message text.
This is sample message text. This is sample message text. This is sample message text. This is sample message text.
This is sample message text. This is sample message text. This is sample message text. This is sample message text.
This is sample message text. This is sample message text. This is sample message text. This is sample message text.
This is sample message text. This is sample message text. This is sample message text. This is sample message text.
</MessageText>
</BTSLoadTest>

メモ帳を閉じます。

重要

ロードテストに複数のロードテストエージェントコンピューターを使用する場合は、すべてのロードテストエージェントコンピューターで同じファイル名を使用して、このファイルを同じパスに保存する必要があります。

プロジェクトに必要な参照を追加し、テストプロジェクトをビルドする

ソリューションエクスプローラーで、BTSLoad プロジェクトの References フォルダーを右クリックし、[参照の追加] をクリックします。
[参照の追加] ダイアログボックスで、[ .NET ] タブをクリックし、Ctrl + クリックキーボード/マウスの組み合わせを使用して、次の .NET 名前空間を同時に選択します。
- System.Configuration
- System.Runtime.Serialization
- System.ServiceModel.Channels
- System.ServiceModel
- System.Web.Extensions
- System.Xml
名前空間を選択した後、[ OK] を クリックして、これらのアセンブリを BTSLoad Test プロジェクトへの参照として追加します。
BTSLoad プロジェクトを右クリックし、[ビルド] をクリックしてプロジェクトを BTSLoad アセンブリにコンパイルします。

次の方法で共有

ステップ 1:BizTalk Server にドキュメントを送信する単体テストの作成

ドキュメントをBizTalk Serverに送信する Visual Studio 単体テストの作成

Visual Studio 2010 テストプロジェクトのオプションを設定する

テストプロジェクトを使用して新しい Visual Studio 2010 ソリューションを作成する

テストプロジェクトのコードを更新し、アプリケーション構成ファイルをテストプロジェクトに追加する

プロジェクトにテストメッセージを追加する

プロジェクトに必要な参照を追加し、テストプロジェクトをビルドする

フィードバック

その他のリソース

次の方法で共有

ステップ 1:BizTalk Server にドキュメントを送信する単体テストの作成

ドキュメントをBizTalk Serverに送信する Visual Studio 単体テストの作成

Visual Studio 2010 テスト プロジェクト のオプションを設定する

テスト プロジェクトを使用して新しい Visual Studio 2010 ソリューションを作成する

テスト プロジェクトのコードを更新し、アプリケーション構成ファイルをテスト プロジェクトに追加する

プロジェクトにテスト メッセージを追加する

プロジェクトに必要な参照を追加し、テスト プロジェクトをビルドする

フィードバック

その他のリソース

Visual Studio 2010 テストプロジェクトのオプションを設定する

テストプロジェクトを使用して新しい Visual Studio 2010 ソリューションを作成する

テストプロジェクトのコードを更新し、アプリケーション構成ファイルをテストプロジェクトに追加する

プロジェクトにテストメッセージを追加する

プロジェクトに必要な参照を追加し、テストプロジェクトをビルドする