XML 一方向ブリッジの作成

更新日: 2015年8月

このセクションは、BizTalk サービス プロジェクト の XML 一方向ブリッジを作成する手順を示します。XML ブリッジにはさまざまな段階があります。このトピックの内容

  1. BizTalk Services プロジェクトへのブリッジの追加

  2. XML ブリッジで処理される XML メッセージの要求スキーマの入力

  3. デコード段階の構成

  4. 検証段階の構成

  5. 強化段階とそのプロパティの構成

  6. 変換ステージの構成

  7. 強化段階の構成 (変換後)

  8. エンコード段階の構成

  1. BizTalk サービス プロジェクト を作成します。手順については、「Visual Studio プロジェクトの概要」を参照してください。

  2. BizTalk サービス プロジェクト デザイン領域の任意の場所を右クリックし、[プロパティ] をクリックします。BizTalk Service URL に、BizTalk サービス の URL を入力します。

  3. [ツールボックス] から XML 一方向ブリッジ を BizTalk サービス プロジェクト デザイン領域にドラッグ アンド ドロップします。.BridgeConfig ファイルがソリューションに追加されます。

  4. [ブリッジ] を右クリックし、[プロパティ] を選択して、次のプロパティを入力します。

     

    プロパティ名 説明

    関連付けられているプロジェクト アイテム

    読み取り専用:関連付けられている .BridgeConfig ファイルの名前。ファイル名を変更するには、Entity Name プロパティを変更します。

    エンティティ名

    BizTalk サービス プロジェクト デザイン領域上の XML ブリッジの名前。この名前は BizTalk サービス プロジェクト で一意である必要があります。.BridgeConfig ファイルの名前は、ここで入力した値と同じです。

    相対アドレス

    XML ブリッジが Microsoft Azure でホストされている相対アドレス。このアドレスが、手順 2. で入力する BizTalk サービス URL に組み合わされて、ブリッジの完全な URL が作成されます。

    たとえば、BizTalk サービス URL が MyBizTalkService で、ブリッジの相対アドレスが UpdateCustomers である場合、Service Bus 上のエンドポイントの URL は https://MyBizTalkService.biztalk.windows.net/default/UpdateCustomers になります。

    ルート順序テーブル

    ブリッジからメッセージ フローの他のコンポーネントへのメッセージのルーティング順序を入力します。「The Routing Order」を参照してください。

    ランタイム アドレス

    ブリッジがデプロイされるパブリック ランタイム エンドポイント URL。

    プロパティの追跡

    このプロパティを設定して、ブリッジによって追跡されるメッセージ プロパティを定義します。「ブリッジにより処理されるメッセージの追跡」を参照してください。

  5. [保存] をクリックします。

1 つの BizTalk サービス プロジェクトに複数のブリッジと複数のスキーマを含めることができます。処理時の使用と保存が簡単になるように、スキーマをブリッジに関連付けることができます。つまり、特定のブリッジのみが、特定のスキーマまたはスキーマのセットに準拠するメッセージを処理できるように要求することができます。ここでは、この関連付けを作成する手順について説明します。

  1. BizTalk サービス プロジェクト にスキーマを追加します。手順については、「Visual Studio プロジェクトの概要」を参照してください。この手順を繰り返して、BizTalk サービス プロジェクトに必要な数のスキーマを追加します。

  2. [XML 一方向ブリッジ] をダブルクリックして Itinerary Designer を開きます。

    noteメモ
    Itinerary Designer は読み取り専用領域です。Itinerary Designer からステージまたはアクティビティの追加または削除を行うことはできません。

  3. ブリッジ デザイン領域の [メッセージ型] ボックスで、追加アイコン ([追加] アイコン) をクリックし、[メッセージ型ピッカー] を開きます。メッセージ型ピッカーで次のように操作します。

    1. [使用できるメッセージ型] ボックスから、要求メッセージのスキーマを選択します。

    2. 右矢印アイコン (矢印アイコン) を選択し、要求スキーマをブリッジに関連付けます。

    3. [OK] を選択します。選択したスキーマが [メッセージ型] ボックスの下に表示されます。

      追加の操作:

      • 同時に複数のスキーマを追加することはできません。複数のスキーマをブリッジに関連付けるには、この手順を繰り返してください。

      • スキーマとブリッジの関連付けを削除するには、[メッセージ型] ボックスからスキーマを選択し、削除アイコン (削除アイコン) をクリックします。

      • スキーマの関連付けを変更するには、編集ボタン ([編集] アイコン) をクリックしてメッセージ型ピッカーを開きます。

  4. [保存] をクリックします。

デコード段階では、受信したテキスト メッセージが XML メッセージにデコードされ、XML 一方向ブリッジブリッジの検証段階で渡されます。ブリッジの他の段階とは異なり、デコード段階に IsEnabled プロパティはありません。段階の IsEnabled プロパティでは、その段階でブリッジ経由でメッセージを渡す処理を行うかどうかを定義します。デコード段階では、メッセージがデコードされるかどうかは、受信メッセージのコンテンツ タイプによって変わるので、このプロパティは含まれません。ブリッジが ‘text/plain’ コンテンツ タイプのメッセージを受信すると、デコード段階でメッセージがデコードされ、XML メッセージに変換されます。ブリッジ内の各段階では、残りの処理はフラット ファイル メッセージではなく XML メッセージに対して行われます。ただし、異なるコンテンツ タイプのメッセージをブリッジで受信すると、デコード段階はアクティブ化されず、メッセージはそのまま次の段階に渡されます。

デコード段階には、On Enter InspectorOn Exit Inspector という 2 つのプロパティがあります。これらのプロパティを使用して、ブリッジ構成の一環としてカスタム コードを組み込みます。「ブリッジにカスタム コードを組み込む方法」を参照してください。

検証段階で、着信要求メッセージに対してスキーマの検証を実行するかどうか、および検証の警告を例外としてクライアントに伝えることができるかどうかを入力できます。

  1. [ブリッジ] をダブルクリックして、ブリッジの構成デザイン領域を開きます。

  2. [検証] 段階を選択します。[プロパティ] で、IsEnabledTrue または False に設定します。True に設定すると、以前に追加したスキーマに対して着信要求メッセージが検証されます。False の場合、スキーマの検証は実行されず、メッセージはそのまま次の段階に渡されます。

    追加の操作:

  3. [XML の検証] アクティビティを選択します。[プロパティ] で、Report Warnings As Errors プロパティを True または False に設定します。True に設定すると、スキーマに対する XML の検証時に発生したエラーとして、ブリッジ から警告がレポートされ、要求メッセージを送信したクライアントに返信されます。検証の警告は例外および検証の失敗としてスローされます。XML スキーマの検証の警告とエラーについては、「検証とスキーマ オブジェクト モデル」を参照してください。

  4. [保存] をクリックします。

[強化] 段階では、メッセージ ヘッダー (標準またはカスタム) から、BizTalk サービス によって昇格された既定のプロパティから、外部データソース (このリリースでサポートされている唯一の Microsoft Azure SQL データベース テーブル) から、またはメッセージ本文内の要素から派生可能な値であるプロパティを定義して、メッセージを強化できます。これらのプロパティを使用して、メッセージを行先エンドポイントにルーティングするか、メッセージ受信エンティティによってさらに処理することができます。ここでは、次の各アクションを実行するための手順を示します。

  • プロパティにメッセージ ヘッダー値を割り当てる。

  • BizTalk サービス によって昇格された既定のプロパティまたはシステム プロパティを使用する。

  • 外部データ ソースを参照する

  • Xpath を使用してメッセージ本文要素から値を抽出する

[重要]:

  • この段階で入力するプロパティ名は大文字と小文字が区別されません。

  • この段階で入力するプロパティは、ブリッジの構成 を保存しない限り、ルート アクションまたは応答アクション用ではありません。ルートおよび応答の詳細については、「ルート アクションと応答アクション:プロトコルの不一致の処理」を参照してください。

強化段階をオンまたはオフにすることにより、これらの任意のアクションを実行するかどうかを選択できます。

手順:

  1. [XML 一方向ブリッジ] をダブルクリックして Itinerary Designer を開きます。

  2. [強化] 段階を択します。[プロパティ] で、IsEnabled プロパティを True または False に設定します。

    noteメモ
    True で、プロパティが定義されていない場合、ブリッジはブリッジの構成中 (設計時) またはメッセージの処理中 (実行時) のいずれでもエラーをスローしません。

    追加の操作:

  3. [強化] 段階内で、[強化] アクティビティを選択します。[プロパティ] の [プロパティ定義] プロパティに対して参照ボタン (...) を選択し、[プロパティの定義] を開きます。

  4. [プロパティの定義] で、[追加] を選択します。[プロパティの追加] ダイアログ ボックスでは、さまざまなソースからの値を使用して、それらの値をプロパティとしてメッセージに含めることができます。これらのプロパティとその値は後で、プロパティ値に基づいてメッセージを他の送信先にルーティングするなどの他の処理タスクに使用できます (「The Routing Action」を参照してください)。次の表は、さまざまなソースとメッセージにプロパティを追加する方法を示しています。

     

    Source 方法:

    プロパティにメッセージ ヘッダー値を割り当てる

     

    システムによって昇格されたプロパティを使用する

     

    外部データ ソースを参照する

    XPath を使用してメッセージ内の値を抽出する

    To extract values from a message body using xpath

  1. [プロパティの追加] で、次の操作を実行します。

    noteメモ
    この表にはプロパティ割り当て操作のヘッダーに必要なフィールドのみが表示されています。これは、SOAP、HTTP、FTP、SFTP などのメッセージ転送プロトコルを使用して転送されたメッセージに対してのみ該当します。そのため、次の手順は、[種類] ドロップダウン リストで [HTTP]、[SOAP]、[FTP]、[SFTP] を選択した場合にのみ該当します。さらに、[種類] ドロップダウン リストで選択した項目に応じて、必須フィールドが赤で囲まれ、他のフィールドがグレーで表示されます。

     

    セクション フィールド名 説明

    ソース (読み取り元)

    ヘッダー値の抽出元のメッセージ型を指定します。ヘッダー値をプロパティに割り当てる場合、指定できる値は SOAPHTTPFTPSFTPBrokered です。

    SOAP ヘッダーの名前空間 ([種類][SOAP] に設定されている場合のみ)

    カスタム SOAP ヘッダーの名前空間を指定します。たとえば次の例では、MessageType カスタム ヘッダーの名前空間が強調表示されています。

    <s:Header>
       ...
      <MessageType xmlns="http://schemas.microsoft.com/integration/2011/system-properties">http://POAttr.org#PurchaseOrderAttr</MessageType> 
       ...
    </s:Header>
    
    Important重要
    このフィールドは、[識別子] ドロップダウン リストで標準ヘッダーを選択している場合にはグレーで表示されます。カスタム SOAP ヘッダーに対してのみ名前空間を入力する必要がありますが、これは必須プロパティではありません。

    またこのフィールドは、[種類] が HTTPFTPSFTPBrokered に設定されている場合にはグレーで表示されます。

    識別子

    メッセージ ヘッダー プロパティの名前を指定します。このプロパティの値を抽出し、このダイアログ ボックスで定義するプロパティに割り当てます。先ほどの例と同じものを使用する場合、識別子は MessageType になります。

    ここで、カスタム ヘッダーを指定することもできます。FTP および SFTP の場合、ドロップダウン リストには標準の識別子が表示されます。HTTP メッセージ型の場合は、かなりの数の標準ヘッダーがあるため、ドロップダウンにはヘッダーが表示されません。このような場合にはヘッダー名を入力することができます。また、SOAP、HTTP、Brokered メッセージ型の場合は、他のプロパティに割り当てる値のカスタム ヘッダーを表示することもできます。

    詳細については、次の例を参照してください。SOAP メッセージ ヘッダーを例にとると、次のようになります。

    <s:Header>
      ...  
      <PONumber xmlns="http://schemas.microsoft.com/integration/promotedpropertiesinfo">PO1234</PONumber> 
      ...  
    </s:Header>
    

    この例では、PONumber が、値が PO1234 のカスタム SOAP ヘッダーです。そのため、識別子を PONumber に設定した場合、値 PO1234 はここで定義するプロパティに割り当てられます。

    プロパティ (書き込み先)

    プロパティ名

    定義するプロパティの名前を指定します。このプロパティの値は、前に指定したメッセージ ヘッダー プロパティから抽出された値に設定されます。

    先述の同じ例を使用し続けるには、[プロパティ名] を P1、[識別子] を PONumber に設定すると、P1 の値は PO1234 に設定されます。

    データ型

    プロパティのデータ型を指定します。ドロップダウン リストから値を選択できます。

  2. [プロパティの追加] ダイアログ ボックスの [OK] をクリックします。ダイアログ ボックスは、次のようになります。

    プロパティ定義

    この画面キャプチャは何を表しているでしょうか。受信メッセージが、SOAP ヘッダー名が PONumber、ヘッダーの名前空間が http://schemas.microsoft.com/integration/promotedpropertiesinfo である SOAP メッセージの場合、データ型が stringP1 が作成され、ヘッダーの値はこのプロパティに割り当てられます。

  3. プロパティ定義を更新または削除するには、ダイアログ ボックスのプロパティ定義を選択し、[編集] または [削除] をクリックします。[プロパティ定義] ダイアログ ボックスの [OK] をクリックし、[保存] をクリックして、ブリッジの構成 への変更を保存します。

  1. [プロパティの追加] で、次の操作を実行します。

    noteメモ
    この表は、メッセージに対する、システムにより昇格されたプロパティの割り当てに必要なフィールドのみの一覧です。さらに、[種類] ドロップダウン リストで選択した項目に応じて、必須フィールドが赤で囲まれ、他のフィールドがグレーで表示されます。

     

    セクション フィールド名 説明

    ソース (読み取り元)

    システムにより昇格されたプロパティを使用するには、ドロップダウン リストで システム を選択します。

    識別子

    システムにより昇格されたプロパティの名前を指定します。このプロパティの値を抽出し、このダイアログ ボックスで定義するプロパティに割り当てます。

    プロパティ (書き込み先)

    プロパティ名

    定義するプロパティの名前を指定します。このプロパティの値は、前に指定したシステムによって昇格されたプロパティから抽出された値に設定されます。

    データ型

    プロパティのデータ型を指定します。ドロップダウン リストから値を選択できます。

  1. [プロパティの追加] で、次の操作を実行します。

    noteメモ
    この表は、参照操作に必要なフィールドのみの一覧です。そのため、次の手順は、[種類] ドロップダウン リストで [Lookup] を選択した場合にのみ該当します。さらに、[種類] ドロップダウン リストで選択した項目に応じて、必須フィールドが赤で囲まれ、他のフィールドがグレーで表示されます。

    Important重要
    このリリースでは、Microsoft Azure SQL データベース テーブルからのみ参照できます。

     

    セクション フィールド名 説明

    ソース (読み取り元)

    参照操作には、ドロップダウン リストから [参照] を選択します。

    識別子

    ドロップダウン リストから、構成済みプロバイダーを選択します。

    まだプロバイダーを構成していない場合は、プロバイダーを構成します。

    1. [識別子] ドロップダウン リストで [新規に構成] を選択します。

    2. [プロバイダーの構成] ダイアログ ボックスで、次の値を指定します。

       

      フィールド名 説明

      プロバイダー名

      プロバイダーの名前を指定します。

      接続文字列

      Microsoft Azure SQL データベース テーブルに接続するために、有効な接続文字列を指定します。

      テーブル名

      データの参照元となる Microsoft Azure SQL データベース テーブルの名前を指定します。

      クエリ入力列

      Microsoft Azure SQL データベース テーブル内の列名を指定します。その値は、データ参照を行う際の入力クエリとして使用されます。

      クエリ出力列

      Microsoft Azure SQL データベース テーブル内の列名を指定します。その値は、最終的に参照されたプロパティに割り当てられる出力値です。

    3. [OK] をクリックして、プロバイダーの構成を追加します。

    参照プロパティ

    ドロップダウン リストから、既に定義されているプロパティを選択します。このプロパティの値は、先述のプロバイダー構成で指定されているクエリ入力列に渡されます。

    プロパティ (書き込み先)

    プロパティ名

    参照された値を含むプロパティの名前を指定します。このプロパティの値は、先述のプロバイダー構成のクエリ出力列の値から派生します。

    データ型

    プロパティのデータ型を指定します。ドロップダウン リストから値を選択できます。

  2. [プロパティの追加] ダイアログ ボックスの [OK] をクリックします。ダイアログ ボックスは、次のようになります。

    定義の参照

    これらのダイアログ ボックスは何を表しているでしょうか。これはロジックの流れ方です (先ほどと同じ発注例を使用して説明します)。

    • ブリッジ は、MyProvider プロバイダー構成で定義されたテーブル (TempTable) の入力クエリ列 (P_Order) で P1 の値 (PO1234) を参照します。

    • ブリッジ は、PO1234 に対応する値を、TempTable の出力クエリ列 (Cust_Name) から取得します。

    • 出力クエリ列から選択された値は、プロパティ P2 に割り当てられます。たとえば、発注書 PO1234 に対応する顧客名が John の場合、P2 の値は John に設定されます。

    • P2 プロパティのデータ型が string に設定されます。

  3. プロパティ定義を更新または削除するには、ダイアログ ボックスのプロパティ定義を選択し、[編集] または [削除] をクリックします。[プロパティ定義] ダイアログ ボックスの [OK] をクリックし、[保存] をクリックして、ブリッジの構成 への変更を保存します。

  1. [プロパティの追加] で、次の操作を実行します。

    noteメモ
    この表は、抽出 (xpath) 操作に必要なフィールドのみの一覧です。さらに、[種類] ドロップダウン リストで選択した項目に応じて、必須フィールドが赤で囲まれ、他のフィールドがグレーで表示されます。

     

    セクション フィールド名 説明

    ソース (読み取り元)

    ドロップダウン リストで [Xpath] を選択します。

    識別子

    メッセージから要素または属性を抽出するための XPath クエリを指定します。一般的な xpath クエリは次のようになります。

    /*[local-name()='<root_node>' and namespace-uri()='<namespace>']/*[local-name()='<node_name>' and namespace-uri()=<namespace>']/*@[local-name()='<attribute_name>' and namespace-uri()='<namespace>']
    

    メッセージ型

    XPath クエリを使用して抽出する必要がある要素または属性値の取得元メッセージのメッセージ型を指定します。

    ドロップダウン リストには BizTalk サービス プロジェクト に追加したすべてのスキーマが表示されます。抽出する要素があるスキーマを選択します。

    プロパティ (書き込み先)

    プロパティ名

    定義するプロパティの名前を指定します。このプロパティの値は、xpath クエリを使用してメッセージ本文から抽出された値に設定されます。

    データ型

    プロパティのデータ型を指定します。ドロップダウン リストから値を選択できます。

  2. [プロパティの追加] ダイアログ ボックスの [OK] をクリックします。ダイアログ ボックスは、次のようになります。

    Xpath の使用による抽出

    このダイアログ ボックスは何を表しているでしょうか。メッセージ型 (この例では PurchaseOrder) から、ブリッジ が指定した XPath クエリごとに要素から値を抽出し、それをプロパティ P3 に割り当て、プロパティ P3 のデータ型を double に設定します。

  3. プロパティ定義を更新または削除するには、ダイアログ ボックスのプロパティ定義を選択し、[編集] または [削除] をクリックします。[プロパティ定義] ダイアログ ボックスの [OK] をクリックし、[保存] をクリックして、ブリッジの構成 への変更を保存します。

ブリッジの構成 デザイン画面を使用してデザインする際、昇格させるプロパティおよびそのプロパティに割り当てる値を定義できます。ただし、プロパティの昇格と値の割り当ては、実際には、メッセージが Service Bus にデプロイされたブリッジを経由する実行時に行われます。ただし実行時には、さまざまな理由によりプロパティの昇格が失敗するときに、インスタンスが存在する場合があります。これが発生する方法とタイミングを理解するには、次の表を使用します。

 

発生する場合 昇格される内容

デザイン時に指定する SOAP または HTTP ヘッダーは、実行時に ブリッジ に送信される実際のメッセージには存在しません。

設計時に定義したプロパティは実行時に昇格されず、例外がスローされません。

デザイン時に指定する XPATH クエリは、実行時に ブリッジ に送信されるメッセージの要素には対応していません。

設計時に定義したプロパティは実行時に昇格されず、例外がスローされません。

[Lookup] の場合、デザイン時に指定する参照プロパティは、実行時には存在しません (昇格したことがないためです)

参照の結果、値が割り当てられたプロパティは昇格されず、例外もスローされません。

[Lookup] の場合、デザイン時に指定するプロバイダー構成 (接続文字列、テーブル名などを含む) は正しくありません。

実行時に例外がスローされ、昇格されるプロパティはありません。ブリッジの構成 デザイン画面はプロバイダー構成の検証を行わないため、デザイン時には例外はスローされません。

Important重要
デザイン時にはユーザー認証情報のみが検証され、検証が失敗した場合には配置は失敗します。

[Lookup] の場合、デザイン時に指定する参照プロパティの値は、実行時のプロバイダー データ ソース (この場合は Microsoft Azure SQL データベース テーブル) で一致するものはありません。

例外がスローされ、昇格される値はありません。

[Lookup] の場合、デザイン時に指定する参照プロパティの値は、実行時のプロバイダー データ ソース (この場合は Microsoft Azure SQL データベース テーブル) で 1 つ以上のものと一致します。

プロパティは昇格され、データ ソースで一致する値のうち 1 つだけが、昇格したプロパティに値として割り当てられます。

SOAP、HTTP、XPATH、Lookup の場合、デザイン時にプロパティに指定するデータ型は、実行時のプロパティの値のデータ型とは異なります。

型変換が可能なときは常に、型は変換され、プロパティは昇格されます。たとえば、デザイン時にプロパティを string 型で定義するが、実行時にプロパティに割り当てられる値が 30 である場合、そのプロパティの値は "30" (string 型) になります。

型変換ができない場合は例外がスローされ、プロパティは昇格されません。たとえば、デザイン時にプロパティを "double" で定義するが、実行時そのプロパティに値 "John" を割り当てた場合などです。"John" は "double" としてプロパティに保存できないため、例外がスローされ、プロパティは昇格されません。

この段階では、ブリッジで使用する変換を入力できます。この段階を有効または無効にすることもできます。

  1. 変換を BizTalk サービス プロジェクト に追加します。手順については、「Visual Studio プロジェクトの概要」を参照してください。この手順を繰り返して、プロジェクトに必要な数の変換を追加します。

  2. [XML 一方向ブリッジ] をダブルクリックして Itinerary Designer を開きます。

  3. 変換ステージを選択します。[プロパティ] で、IsEnabledTrue または False に設定します。True の場合、受信要求メッセージの変換用に入力した変換がステージに使用されます。False の場合、メッセージ変換は行われず、メッセージはそのまま次のステージに渡されます。

    追加の操作:

  4. 変換ステージで、[XML 変換] アクティビティを選択します。[プロパティ] の [マップ] プロパティで参照ボタン (...) を選択し、[マップの選択] を開きます。

  5. 表示されるマップの一覧から、変換ステージに関連付けるマップを選択し、[OK] を選択します。追加したマップは Itinerary Designer の [選択されたマップ] に表示されます。

    Important重要
    ダイアログ ボックスには、(マップの) ソース スキーマが「要求スキーマの入力」 (このトピックの) で入力した要求メッセージ スキーマに一致するマップのみが表示されます。

    noteメモ
    変換ステージで IsEnabled プロパティが True に設定され、[XML 変換] アクティビティの一部としてマップを指定していない場合、ブリッジを構成しているときや (設計時)、メッセージを処理しているときでも (実行時)、ブリッジからエラーがスローされません。

    マップを追加または削除するには、[マップ] プロパティの参照ボタン (…) をクリックします。

  6. [保存] をクリックします。

変換段階の後で強化段階を構成する手順は、変換段階の前に強化段階を構成する手順と同じです。「強化段階とそのプロパティの構成」 (このトピックの) を参照してください。変換後の強化段階を構成するときは、変換前の強化段階で定義したプロパティを変換後の強化段階でも使用できるようにすることだけを考慮します。そのため、それらのプロパティを保持する場合は、同じ名前でプロパティを作成しないでください。同じ名前で作成すると、新しいプロパティの定義によって、古いプロパティの定義が上書きされます。

変換後の強化段階では、次の 2 つのプロパティもあります。On Enter InspectorOn Exit Inspector です。これらのプロパティを使用して、ブリッジ構成の一環としてカスタム コードを組み込みます。「ブリッジにカスタム コードを組み込む方法」を参照してください。

この段階では、XML メッセージをフラット ファイル メッセージに変換するために使用するフラット ファイル スキーマを入力できます。メッセージは、エンコード段階に到達するまでには既に XML 形式になっています。エンコード段階の構成方法に応じて、メッセージはフラット ファイル形式にエンコードされるか、XML メッセージとして送信されます。

  1. [XML 一方向ブリッジ] をダブルクリックして Itinerary Designer を開きます。

  2. [エンコード] 段階を選択します。[プロパティ] で、IsEnabled プロパティを True または False に設定します。True の場合、この段階では XML メッセージをフラット ファイル メッセージにエンコードするために入力するフラット ファイル スキーマが使用されます。False の場合、エンコードは行われず、XML メッセージがブリッジから送信されます。

    追加の操作:

  3. [エンコード] 段階内で、[フラット ファイルのエンコード] アクティビティを選択します。[プロパティ] で、Flat File Schemas プロパティの参照ボタン ([...]) をクリックして、[フラット ファイル スキーマの選択] ダイアログ ボックスを表示します。

  4. ダイアログ ボックスに表示されたフラット ファイル スキーマの一覧から、XML メッセージをフラット ファイル メッセージにエンコードするために使用するスキーマを選択し、[OK] をクリックします。実行時に、XML メッセージが [フラット ファイルのエンコード] アクティビティに達すると、メッセージ型 (Namespace#Root) が、アクティビティ構成の一部として提供されたフラット ファイル スキーマに対してマップされます。照合すると、XML メッセージをフラット ファイル メッセージに変換する際にそのスキーマが使用されます。変換されたメッセージの HTTP ヘッダーは "text/plain" に設定されています。照合されない場合、処理さた XML はそのままエンコード段階によって送信されます。

    noteメモ
    IsEnabled プロパティが [エンコード] 段階で True に設定されていて、[フラット ファイルのエンコード] アクティビティの一部としてフラット ファイル スキーマを指定しない場合、ブリッジは、ブリッジの構成中 (デザイン時) またはメッセージの処理中 (実行時) にも、エラーをスローしません。

    Flat File Schemas プロパティに対して省略記号ボタン (…) をクリックすることにより、スキーマを追加または削除できます。

  5. [保存] をクリックします。

XML 一方向ブリッジ が構成されました。これで、ブリッジの基幹業務システムへの接続、メッセージのルーティング、ブリッジのデプロイなどを行うことができます。

BizTalk サービス プロジェクトから LOB システムに接続する

BizTalk サービス プロジェクトでのブリッジから宛先へのメッセージのルーティング

BizTalk Services プロジェクトのデプロイおよび更新

関連項目

表示: