次の方法で共有

ServiceModel メタデータ ユーティリティ ツールを BizTalk Adapter for Siebel eBusiness Applications と一緒に使用する

  • [アーティクル]

ServiceModel メタデータ ユーティリティ ツール (svcutil.exe) を使用して、Microsoft BizTalk Adapter for Siebel eBusiness Applications が公開する操作用の WCF クライアント クラスを生成できます。 svcutil.exe を実行して WCF クライアント クラスを生成した後、生成されたファイルをコードに含め、WCF クライアント クラスのインスタンスを作成して Siebel システムで操作を実行できます。

svcutil.exe を使用するには、資格情報を含む接続 URI を指定する必要があります。 Siebel アダプターは既定で接続 URI の資格情報を無効にするため、Siebel アダプターに既定以外のバインドを使用するように svcutil.exe を構成する必要があります。 既定以外のバインドで他のバインド プロパティを構成することもできます。

次のセクションでは、svcutil.exe を構成する方法と、svcutil.exe を使用して Siebel アダプターを使用して WCF クライアント コードを生成する方法について説明します。

既定以外のバインドの svcutil.exe を構成する

既定以外のバインドを使用するように svcutil.exe を構成するには、svcutil.exe のローカル コピーを作成してから、svcutil.exe.config 構成ファイルのローカル コピーを作成または変更する必要があります。

  1. フォルダーを作成し、svcutil.exe を新しいフォルダーにコピーします。 通常、svcutil.exe は Windows SDK のインストール場所 (具体的には C:\Program Files\Microsoft SDKs\Windows\v6.0\Bin) にあります。

  2. 新しいフォルダーに svcutil.exe.config という名前のファイルを作成します。

  3. バインドとクライアント エンドポイントを svcutil.exe.config ファイルに追加します。 正しい構成が使用されるようにするには、新しいフォルダーから svcutil.exe を実行する必要があります。

    重要

    クライアント エンドポイントの name 属性は、接続 URI で使用されるスキームを指定する必要があります。 この値は、大文字と小文字が区別されます。

    <configuration>
  <system.serviceModel>
    <client>
      <!-- the name should match the required scheme of the Metadata Exchange endpoint
      and the contract should be "IMetadataExchange" -->
      <endpoint name="siebel"
        binding="siebelBinding"
        bindingConfiguration="SiebelBinding"
        contract="IMetadataExchange" />
    </client>
    <bindings>
      <siebelBinding>
        <binding name="SiebelBinding" acceptCredentialsInUri="true" />
      </siebelBinding>
    </bindings>

  </system.serviceModel>

</configuration>

注意

バインド構成では、Siebel アダプターのバインディング プロパティのいずれかを設定できます。

svcutil.exe の既定以外のバインドの構成の詳細については、 の WCF ドキュメントの「カスタム セキュリティで保護されたメタデータ エンドポイント」トピックを参照 https://go.microsoft.com/fwlink/?LinkId=96077してください。

svcutil.exe を使用した WCF クライアント クラスの作成

svcutil.exe を使用して Siebel アダプターの WCF クライアント コードを生成するには、 IMetadataExchange (mex) エンドポイントと、コードの生成に svcutil.exe 操作を指定する接続 URI を指定する必要があります。 接続 URI で Siebel システムの接続資格情報も指定する必要があります。

注意

Siebel アダプターで svcutil.exe を使用する前に、既定以外のバインドを使用するように構成する必要があります。これを行う方法については、「 Siebel アダプターの svcutil.exe の構成」を参照してください。

Siebel アダプター接続 URI では、次の方法で mex エンドポイントとターゲット操作を指定します。

  • query_stringに "wsdl" パラメーターを含める必要があります。 query_stringの最初のパラメーターである場合は、疑問符 (?) の直後に指定されます。 最初のパラメーターでない場合は、アンパサンド (&) を前に付ける必要があります。

  • "wsdl" パラメーターの後に、1 つ以上の "op" パラメーターを指定する必要があります。 各 "op" パラメーターの前にはアンパサンド (&) が付き、ターゲット操作のノード ID を指定します。

    次の 2 つの例は、svcutil.exe を使用してさまざまな操作をターゲットにする方法を示しています。

    次の使用例は、ACCOUNT\ACCOUNT ビジネス オブジェクトに対する挿入操作用の WCF クライアント クラスを作成します。

    .\svcutil "siebel://Username=YourUserName;Password=YourPassword@Siebel_server:1234?SiebelEnterpriseServer=ent_server&SiebelObjectManager=obj_mgr&Language=enu&wsdl&op=http://Microsoft.LobServices.Siebel/2007/03/BusinessObjects/Account/Account/Insert"

    次の使用例は、ACCOUNT\ACCOUNT ビジネス オブジェクトに対して挿入操作と削除操作の両方に対して WCF クライアント クラスを作成します。

    .\svcutil " siebel://Username=YourUserName;Password=YourPassword@Siebel_server:1234?SiebelEnterpriseServer=ent_server&SiebelObjectManager=obj_mgr&Language=enu&wsdl&op=http://Microsoft.LobServices.Siebel/2007/03/BusinessObjects/Account/Account/Insert&op=http://Microsoft.LobServices.Siebel/2007/03/BusinessObjects/Account/Account/Delete"

重要

コマンド ラインには、接続 URI を引用符で囲む必要があります。 それ以外の場合、svcutil.exe は、Siebel アダプターがサポートしていない操作のメタデータの取得を試みます。 このような試行の結果は未定義です。

既定では、svcutil.exe は生成されたコードを output.cs ファイルに配置します。ただし、コマンド ライン スイッチを設定することで、出力ファイルの名前やその他 svcutil.exe 使用する多くのオプションを変更できます。

Svcutil.exe では、操作を検索する機能は提供されません (たとえば、ワイルドカード文字を使用)。 ターゲットにする特定の操作のノード ID を明示的に指定する必要があります。 カテゴリのみを参照するノード ID を指定することはできません。 Siebel アダプターが表示するノード ID の詳細については、「 メタデータ ノード ID」を参照してください。

Add Adapter Service Reference Visual Studio プラグインには、WCF クライアント クラスの生成を大幅に簡略化できる高度な参照機能と検索機能が用意されています。 アダプター サービス参照プラグインの追加の詳細については、「 Siebel ソリューション成果物の WCF クライアントまたは WCF サービス コントラクトを生成する」を参照してください。