SAP へのポート バインド ファイルを使用して物理ポート バインドを構成する

アダプター サービス BizTalk プロジェクト アドインを使用して、スキーマ ファイル以外の SAP 成果物のメタデータを生成すると、アダプター サービス アドインを使用すると、ポート バインド ファイルも生成されます。 このバインド ファイルを BizTalk アプリケーションにインポートして、物理送受信ポートを作成できます。 SAP アダプター バインドを再利用するには、バインド ファイルをインポートする手順が含まれます。 このバインド ファイルをインポートする場合は、物理送受信ポートを手動で作成する必要はありません。

ポート バインド ファイルを使用してポートを作成すると、常に双方向の送受信ポートが作成されます。 一方向ポートを作成する場合は、「 SAP アダプターへの物理ポート バインドを手動で構成する」の手順を使用して手動で作成できます。 または、このトピックに記載されている回避策に従って、ポート バインド ファイルを変更して一方向ポートを作成することもできます。

アダプター サービス アドインを使用して生成されたバインド ファイルに関して理解しておく必要があるいくつかの重要なポイントを次に示します。

• ファイルは、特定の名前付け規則で作成されます。 送信操作のメタデータ (つまり、SAP システムにメッセージを送信する) を生成した場合、ファイルの名前は WcfSendPort_SAPBinding_Custom.bindinginfo.xml。

  受信操作のメタデータ (SAP システムからメッセージを受信する) を生成した場合、ファイルの名前は WcfReceivePort_SAPBinding_Custom.bindinginfo.xml。

• ファイルには、メタデータが生成された操作に基づいて、バインド構成、バインドの種類、エンドポイント URI、およびポート アクションに関する情報が含まれています。 このバインド ファイルをインポートしてポートを作成すると、物理ポートの構成に必要なすべての関連情報がポートに自動的に設定されます。

  重要

  既定では、送信ポートのアクションは、メタデータを生成する操作名にマップされます。 たとえば、RFC_CUSTOMER_GETのメタデータを生成する場合、ポートのアクションは に <Operation Name="RFC_CUSTOMER_GET" Action="http://Microsoft.LobServices.Sap/2007/03/Rfc/RFC_CUSTOMER_GET " />設定されます。 ただし、BizTalk オーケストレーションで作成した論理送信ポートの操作名が同じでない場合があります。 論理ポート (BizTalk オーケストレーション内) と物理送信ポート (BizTalk Server管理コンソール) の操作名が同じであることを確認する必要があります。 そうでない場合は、送信ポートを介して SAP システムにメッセージを送信中にエラーが発生します。

• SAP システムに接続するには、ポートの資格情報のみを指定する必要があります。 バインド ファイルは接続に使用するユーザー名を保持しますが、セキュリティ上の理由から、バインド ファイルにはパスワードが含まれていません。

ポート バインド ファイルの使用に関する主な考慮事項

• バインド ファイルをインポートすると、バインド ファイル内の BizTalk アプリケーション名が、バインド ファイルのインポート先のアプリケーション名と一致しないことを示すダイアログ メッセージが表示されることがあります。 このメッセージは無視して続行しても問題ありません。

• バインド ファイルには、ポートと受信場所の名前も含まれています。 バインド ファイルをインポートする BizTalk アプリケーションが、同じ BizTalk アプリケーション内の既存のポートと同じ名前のポートまたは受信場所を作成すると、エラーが発生します。 ポートまたは受信場所の一意の名前を指定するには、バインド ファイルを手動で編集する必要があります。

• バインド ファイルには、接続 URI に関する情報も含まれています。 バインド ファイルが、同じ BizTalk アプリケーション内の既存の受信場所と同じ受信 URI を持つ受信場所を作成すると、エラーが発生します。 バインド ファイルを手動で編集して、一意の URI を指定する必要があります。

• 既定では、ポート バインド ファイルには常に双方向ポート (送受信) の定義が含まれます。 このファイルを BizTalk アプリケーションにインポートすると、双方向の送受信ポートが作成されます。 ただし、一方向の送受信ポートを持つオーケストレーションがある場合があります。 そのため、このようなオーケストレーションを構成し、バインド ファイルをインポートして作成されたポートを使用すると、そのポートは一覧で使用できません。 これは、オーケストレーションの一部として作成した論理ポートが一方向ポートであり、オーケストレーションで作成された物理ポートが双方向ポートであるために発生します。 このような場合は、バインド ファイルを編集して、次の変更を行うことができます。

  フィールド	方法
  ポート バインド ファイルを編集して一方向の送信ポートを構成するには	1. 次の抜粋では、 IsTwoWay プロパティの値を false に変更 します。 最初は、これは true に設定 されています。 <SendPort Name="port_name" IsStatic="true" IsTwoWay="false" BindingOption="0"> 2. 次の抜粋をコメントアウトします。 <ReceivePipeline Name="Microsoft.BizTalk.DefaultPipelines.XMLReceive" FullyQualifiedName="Microsoft.BizTalk.DefaultPipelines.XMLReceive, Microsoft.BizTalk.DefaultPipelines, Version=3.0.1.0, Culture=neutral, PublicKeyToken=token" Type="1" TrackingOption="None" Description=""/> <ReceivePipelineData xsi:nil="true" />
  ポート バインド ファイルを編集して一方向の受信ポートを構成するには	1. 次の抜粋では、 IsTwoWay プロパティの値を false に変更 します。 最初は、これは true に設定 されています。 <ReceivePort Name="port_name" IsTwoWay="false" BindingOption="1"> 2. 次の抜粋をコメントアウトします。 <SendPipeline Name="Microsoft.BizTalk.DefaultPipelines.XMLTransmit" FullyQualifiedName="Microsoft.BizTalk.DefaultPipelines.XMLTransmit, Microsoft.BizTalk.DefaultPipelines, Version=3.0.1.0, Culture=neutral, PublicKeyToken=token" Type="2" TrackingOption="None" Description="" /> <SendPipelineData xsi:nil="true" /> <SendPipelineData xsi:nil="true" />

アダプター サービス アドインを使用して生成されたポート バインド ファイルを使用した WCF-SAP ポートの構成

アダプター サービスアドインを使用すると、BizTalk Server管理コンソールでインポートできるポート バインド ファイルも作成されます。 同じポート バインド ファイルを使用して、管理コンソールで BizTalk WCF-SAP ポートBizTalk Server作成することもできます。 ただし、WCF-SAP ポートを作成する前に、次のタスクを実行してポート バインド ファイルを変更する必要があります。

1. テキスト エディターでポート バインド ファイルを開きます。

2. "WCF-Custom" を検索し、管理コンソールで WCF-SAP アダプターを追加した名前BizTalk Server置き換えます。 たとえば、WCF-SAP アダプターを "SAPAdapter" として追加した場合は、"WCF-Custom" を "SAPAdapter" に置き換えます。

3. "ConfigurationClsid" 属性を検索し、属性の既存の値を "A5F15999-8879-472d-8C62-3B5EA9406504" に置き換えます。

4. バインド ファイルを保存して閉じます。

5. 管理コンソールでバインド ファイルBizTalk Serverインポートします。 SAP アダプター バインドを再利用する手順の 一覧を示します。

参照

SAP アプリケーションを作成するための構成要素