Itinerary Designer を拡張する

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

Itinerary Designerは、Microsoft Visual Studio 用のビジュアルドメイン固有言語 (DSL) です。これにより、Microsoft BizTalk ESB Toolkit で使用するスケジュールのグラフィカルモデリングが可能になります。デザイナーは、開発者が新しい機能や新しい構成オプションを有効にするためにカスタム拡張機能を記述できるさまざまな拡張ポイントを公開します。

カスタムスケジュールエクスポーターの作成

Itinerary Designerのアーキテクチャでは、データをシリアル化して保持するカスタムモデルエクスポーターを作成できます。

メッセージングサービス用のカスタムエクステンダーの作成

Itinerary Designerのアーキテクチャでは、Messaging Services で使用するプロパティバッグにプロパティを追加するために使用できる、Itinerary Service モデル要素のカスタムエクステンダーを作成できます。

このようなエクステンダーを作成する方法のサンプルについては、「Designer機能拡張サンプルのインストールと実行」を参照してください。

Orchestration-Based スケジュールサービスのカスタムエクステンダーの作成

Itinerary Designerのアーキテクチャでは、オーケストレーションベースの旅程サービスで使用するためにプロパティをプロパティバッグに追加するために使用できる、Itinerary Service モデル要素のカスタムエクステンダーを作成できます。

このようなエクステンダーを作成する方法のサンプルについては、「Designer機能拡張サンプルのインストールと実行」を参照してください。

カスタムリゾルバーエクステンダーの作成

Itinerary Designerのアーキテクチャでは、カスタムリゾルバーの構成用のカスタムエクステンダーを作成できます。これらのエクステンダーは、リゾルバー接続文字列で名前と値のペアを構成するためのグラフィカルインターフェイスを提供します。このインターフェイスは、特定のリゾルバーエクステンダークラスのプロパティにマップされます。

このようなエクステンダーを作成する方法のサンプルについては、「Designer機能拡張サンプルのインストールと実行」を参照してください。

カスタムアダプタープロパティ用のマニフェストファイルの作成

カスタムアダプタープロバイダーを作成する場合は、エンドポイント構成プロパティを表示するリゾルバーエクステンダーに対して、アダプタープロバイダーのデザイナーサポートも提供する必要があります。デザイナーのサポートを有効にするには、アダプタープロバイダーマニフェストファイルを作成する必要があります。

アダプタープロバイダーマニフェストファイルは、特定のアダプタープロバイダーに関連付けられているプロパティ、その型、説明、およびそれらが見つかるアセンブリを定義します。これらのマニフェストファイルは、一意の名前 (FTPPropertyManifest.xml など) を持つ Itinerary Designer バイナリ (Microsoft.Practices.Itineary.DslPackage.dll など) と同じフォルダーに配置する必要があります。

アダプタープロバイダーマニフェストファイルの参照インスタンスを次に示します。カスタムマニフェストファイルも同様に構造化する必要があります。

<?xml version="1.0" encoding="utf-8" ?>  
<adapterPropertyManifest adapterName="FTP">  
     <aliases>  
          <alias name="globalPropertySchemas" value="Microsoft.BizTalk.GlobalPropertySchemas, Version=3.0.1.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" />  
     </aliases>  
     <properties>  
          <property name="UserName" type="FTP.UserName" description="The user name for the connection." encrypted="true" assembly="globalPropertySchemas" />  
          <property name="Password" type="FTP.Password" description="The password for the conection." encrypted="true" assembly="globalPropertySchemas" />  
          <property name="MaxConnections" type="FTP.MaxConnections" description="The maximun number of connections." assembly="globalPropertySchemas" />  
          <property name="EventArgs" type="System.EventArgs" assembly="mscorlib, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />  
     </properties>  
</adapterPropertyManifest>

カスタムフィルターエクステンダーの作成

Itinerary Designerのアーキテクチャでは、カスタムフィルターの構成用のカスタムエクステンダーを作成できます。これらのエクステンダーは、フィルター接続文字列で名前と値のペアを構成するためのグラフィカルインターフェイスを提供します。このインターフェイスは、特定のフィルターエクステンダークラスのプロパティにマップされます。

/Samples/Designer 機能拡張サンプル/エクステンダー.Itinerary.OrchestrationSample/Extenders.Itinerary.OrchestrationSample/Extenders.Itinerary.OrchestrationSample
/Samples/Designer 機能拡張サンプル/エクステンダー.Resolvers.ResolverSample/Extenders.Resolvers.ResolverSample

カスタム検証規則の作成

Itinerary Designerによって導入された最後の重要な拡張機能は、ドメイン固有言語 (DSL) に関して、モデル検証規則を指定して実装できる検証メカニズムです。メカニズムは DSL 検証フレームワークに "フック" し、ユーザーがモデルのショートカットメニューで [検証 ] または [ すべて検証 ] をクリックするとアクティブになります。これにより、DSL フレームワークの DslCommandSet オブジェクトが呼び出され、次に、Itinerary Designerで検証エンジンが呼び出されます。

ValidationEngine クラスは、エンタープライズライブラリ検証アプリケーションブロックを使用してモデル要素の検証を実行し、検証エラーを Microsoft Visual Studio IDE の [エラー一覧] ウィンドウに記録します。モデル内の要素の種類ごとに実行する必要がある検証は、エンタープライズライブラリ構成ファイルで定義されます。ファイルは Ruleset.config という名前で、すべての Itinerary Designer バイナリが配置されているバイナリフォルダーにあります。次の例は、構成ファイルのフラグメントであり、 UddiResolver エクステンダーの 2 つの検証規則 (名前付き検証コントロール) が含まれています。1 つは ServerUrl プロパティ用、1 つは ServiceKey プロパティ用です。

<!--   
UddiResolver  
-->  
<type assemblyName="Microsoft.Practices.Services.Extenders.Resolvers.UDDI"  
 name="Microsoft.Practices.Services.Extenders.Resolvers.UDDI.UddiResolver">  
<ruleset name="Menu">  
<properties>  
<property name="ServerUrl">  
<validator type="Microsoft.Practices.Modeling.Validation.NotEmptyStringValidator, Microsoft.Practices.Modeling.Validation"  
          messageTemplate="The '{1}' property value should not be empty or null."  
          name="UddiResolver.ServerUrl not null validator"/>  
</property>  
<property name="ServiceKey">  
<validator type="Microsoft.Practices.Modeling.Validation.NotEmptyStringValidator, Microsoft.Practices.Modeling.Validation"  
          messageTemplate="The '{1}' property value should not be empty or null."  
          name="UddiResolver.ServiceKey not null validator"/>  
</property>  
</properties>  
</ruleset>  
</type>

各ルールは、ルールを実装する検証コントロールを識別します。 Itinerary Designerには、バリデータークラスの大規模なセットが付属しています。これらはすべて、Designer バイナリフォルダーの Microsoft.Practices.Modeling.Validation プロジェクトにあります。

この検証メカニズムを使用した最終的な結果は、Itinerary Designerユーザーは、指定されたルールと検証コントロールを変更するか、独自のルールと検証コントロールを追加することによって、モデルの検証方法を変更できることです。これは、次の 2 つの手順を実行することで、DSL を開いたり、変更したり、再構築したり、再デプロイしたりすることなく行うことができます。

検証クラスを作成し、 Microsoft.Practices.Modeling.Validation.dll ライブラリがあるバイナリフォルダー内のライブラリに配置します。
Rules.config ファイルにエントリを追加して、検証コントロールを適用するモデル要素クラスのプロパティを定義します。

次の方法で共有

Itinerary Designer を拡張する

フィードバック

その他のリソース