手順 1: Siebel ビジネス コンポーネント操作を WCF Service として公開する
完了までの時間: 10 分
目的： WCF アダプター サービス開発ウィザードを使用して、インターネット インフォメーション サービス (IIS) や Windows プロセス アクティブ化サービス (WAS) などのホスト環境でホストできる WCF サービスを生成できます。 このトピックでは、ウィザードを使用して WCF サービス ファイルを生成する方法について説明します。
前提条件
ウィザードを実行する前に、次のコマンドをインストールします。
Microsoft Windows Communication Foundation (WCF) 基幹業務 (LOB) アダプター SDK の場合は、[ 完了 ] オプションまたは [カスタム ] オプション (このオプション内の [ツール ] を選択)。 これにより、WCF アダプター サービス開発ウィザード用の Visual Studio テンプレートがインストールされます。
Microsoft BizTalk Adapter 用 Siebel eBusiness Applications
必要な Siebel クライアント。
これらの前提条件の詳細については、「BizTalk アダプター パックのインストール ガイド」を参照してください。 インストール ガイドは通常、インストール ドライブ>:\Program Files\Microsoft BizTalk Adapter Pack\Documents に<インストールされます。
Siebel ビジネス コンポーネントを WCF サービスとして発行する
Visual Studio を起動し、プロジェクトを作成します。
[ 新しいプロジェクト ] ダイアログ ボックスの [ プロジェクトの種類 ] ウィンドウで、[ Visual C#] を選択します。 [テンプレート] ウィンドウ で 、[ WCF アダプター サービス] を選択します。
または、[ プロジェクトの種類 ] ウィンドウで [ Visual C#] を展開し、[ Web] を選択します。 [テンプレート] ウィンドウ で 、[ WCF アダプター サービス] を選択します。
Note
Web 開発コンポーネントを使用して Visual Studio をインストールした場合は、 WCF アダプター サービス テンプレートも [新しい Web サイト ] オプションから使用できます。
ソリューションの名前と場所を指定し、[OK] をクリック します。 WCF アダプター サービス開発ウィザードが起動します。
[ようこそ] ページで [次へ] をクリックします。
[操作の選択] ページで、Siebel システムに接続する接続文字列を指定します。 そのためには次を行います。
[ バインドの選択 ] ボックスの一覧 で、[siebelBinding] をクリックし、[ 構成] をクリックします。
[ アダプターの構成 ] ダイアログ ボックスで、[ セキュリティ ] タブをクリックします。
[ クライアント資格情報の種類 ] ボックスの一覧で [ ユーザー名] を選択し、Siebel システムに接続するユーザー名とパスワードを指定します。
[ URI のプロパティ ] タブをクリックし、接続パラメーターの値を指定します。 Siebel アダプターの接続 URI の詳細については、「 Siebel システム接続 URI の作成」を参照してください。
Note
接続パラメーターに予約文字 (XML 特殊文字など) が含まれている場合は、[ URI のプロパティ ] タブでそのまま指定する必要があります。つまり、エスケープ文字は使用しません。 ただし、[ URI の構成 ] フィールドで URI を直接指定し、接続パラメーターに予約文字が含まれている場合は、適切なエスケープ文字を使用して接続パラメーターを指定する必要があります。
[ バインドのプロパティ ] タブをクリックし、ターゲットにする操作に必要なバインド プロパティ (ある場合) の値を指定します。
バインド プロパティの詳細については、「 BizTalk Adapter for Siebel Binding Properties」を参照してください。
[ OK] をクリックし、[ 接続] をクリックします。 接続が確立されると、接続の状態が [接続済み] と表示されます。
[操作の選択] ページの [ コントラクトの種類の選択 ] の一覧で、[ クライアント (送信操作)] をクリックします。
[ カテゴリの選択 ] ボックスで、[Siebel Business Objects] ノードを展開して、Siebel リポジトリ内のビジネス オブジェクトの一覧を表示します。 この例では、次の操作を行います。
[アカウント] ビジネス オブジェクトを展開し、[アカウント] ビジネス コンポーネントをクリックします。
[ 利用可能なカテゴリと操作 ] ボックスで、[ クエリ ] 操作を選択し、[ 追加] をクリックします。 選択した操作が [ 追加されたカテゴリと操作 ] ボックスに一覧表示されます。
を選択します
[操作の選択] ページで、[ 次へ] をクリックします。
[サービスとエンドポイントの動作の構成] ページで、サービスとエンドポイントの動作を構成する値を指定します。
[ サービス動作の構成 ] ボックスで、次の値を指定します。
プロパティの場合 値を指定する EnableMetadataExchange メタデータ交換エンドポイントを作成するには、これを True に 設定します。 これを True に設定すると、WS-Metadata Exchange (MEX) や HTTP/GET 要求などの標準化されたプロトコルを使用してサービス メタデータを使用できるようになります。
既定値は False です。IncludeExceptionDetailsinFault デバッグ目的でクライアントに返される SOAP エラーの詳細にマネージド例外情報を含めるには、これを True に 設定します。 既定値は False です。 名前 サービス動作構成の名前。 UseServiceCertificate WCF のメッセージ レベル セキュリティ モードを使用するかどうかを指定します。 既定値は True です。
このチュートリアルでは、これを False に設定する必要があります。FindValue X.509 証明書ストアで検索する値を指定する文字列。
メモ：UseServiceCertificate が True に設定されている場合にのみ、このプロパティの値を指定します。StoreLocation サービスがクライアントの証明書の検証に使用できる証明書ストアの場所を示す 値です。
メモ：UseServiceCertificate が True に設定されている場合にのみ、このプロパティの値を指定します。StoreName 開く X.509 証明書ストアの名前。
メモ：UseServiceCertificate が True に設定されている場合にのみ、このプロパティの値を指定します。X509FindType 実行する X.509 検索の種類。
メモ：UseServiceCertificate が True に設定されている場合にのみ、このプロパティの値を指定します。Note
証明書と関連するプロパティの詳細については、「 X509ClientCertificateCredentialsElement プロパティ」を参照してください。
[ エンドポイント動作の構成 ] ボックスで、次の値を指定します。
プロパティの場合 値を指定する 認証の種類 - WCF サービスの使用中にクライアントがユーザー名とパスワードを指定できるようにするには、これを ClientCredentialUserNamePassword に設定します。
- クライアントが HTTP ヘッダーの一部としてユーザー名とパスワードを指定できるようにするには、これを HTTPUserNamePassword に設定します。
- 最初にクライアントが ClientCredential インターフェイスを介して資格情報を指定できるようにするには、これを [自動] に設定します。 これが失敗した場合、クライアントは HTTP ヘッダーの一部として資格情報を渡すことができます。
既定値は Auto です。Microsoft Office SharePoint Server で WCF サービスを使用するには、これを HTTPUserNamePassword に設定する必要があります。名前 エンドポイント動作構成の名前を指定します。 UsernameHeader ユーザー名ヘッダーの名前。 この例では、 MyUserHeader を指定します。 HTTP ヘッダーの詳細については、 の「カスタム HTTP ヘッダーと SOAP ヘッダーのサポート」 https://go.microsoft.com/fwlink/?LinkId=106692を参照してください。
メモ：認証の種類が HTTPUserNamePassword に設定されている場合は、このプロパティの値を指定する必要があります。 [認証の種類] が [自動] に設定されている場合、このプロパティは省略可能です。PasswordHeader パスワード ヘッダーの名前。 この例では、 MyPassHeader を指定します。 HTTP ヘッダーの詳細については、 の「カスタム HTTP ヘッダーと SOAP ヘッダーのサポート」 https://go.microsoft.com/fwlink/?LinkId=106692を参照してください。
メモ：認証の種類が HTTPUserNamePassword に設定されている場合は、このプロパティの値を指定する必要があります。 [認証の種類] が [自動] に設定されている場合、このプロパティは省略可能です。次の図は、指定した値を持つ [サービスとエンドポイントの動作の構成] ページを示しています。
![[サービスとエンドポイントの動作の構成] ページ](../adapter-sap/media/0a286b0c-7f0d-46c5-9b56-29bef3a1deea.gif "0a286b0c-7f0d-46c5-9b56-29bef3a1deea")
[サービスとエンドポイントの動作の構成] ページで、[ 次へ] をクリックします。
[サービス エンドポイントのバインドとアドレスの構成] ページの [構成するコントラクトの選択 ] ボックスに、[操作の選択] ページで操作を選択した Siebel ビジネス コンポーネントのコントラクトが一覧表示されます。 選択したコントラクト ボックスの下の [操作] には、成果物ごとに選択した操作が [操作の選択] ページに表示されます。
[ コントラクトのアドレスとバインドを構成する ] ボックスで、次の値を指定します。
プロパティの場合 値を指定する バインド構成 ウィザードでは、基本的な HTTP バインドのみがサポートされます。 そのため、バインド構成フィールドは System.ServiceModel.Configuration.BasicHttpBindingElement に自動的に設定されます。
省略記号ボタン (...) をクリックして、HTTP バインドのプロパティを変更します。 セキュリティで保護された通信チャネルを使用するには、常に Mode プロパティを Transport に設定する必要があります。 ウィザードは、 Mode プロパティの既定値を トランスポートとして設定します。
公開されている他のバインディングの詳細については、「 BasicHttpBindingElement クラス」を参照してください。エンドポイント名 コントラクトのエンドポイント名を指定します。 このページの他のフィールドは、前のページで指定した値に基づいて自動的に設定されます。
[Apply] をクリックします。 [構成するコントラクトの選択] ボックスに表示されるすべての コントラクト に対して、この手順を実行します。
Note
このページで値を指定しない場合は、すべてのコントラクトで既定値が受け入れられます。
次の図は、指定した値を持つ [サービス エンドポイント のバインドとアドレスの構成] ページを示しています。
の構成[サービス エンドポイントのバインドとアドレスの構成] ページで、[ 次へ] をクリックします。 [概要] ページには、選択した Siebel ビジネス コンポーネントのコントラクトのツリー構造と、その下で各ビジネス コンポーネントに対して選択された操作が一覧表示されます。
概要を確認し、[完了] をクリック します。
ウィザードは WCF サービスを作成し、次のファイルを Visual Studio プロジェクトに追加します。
.svc ファイル。 これは WCF サービス ファイルです。 ウィザードでは、コントラクトごとに 1 つのファイルが生成されます。
Web.config ファイル。
サービス コード (.cs ファイル)。
WCF サービスを発行します。
インターネット インフォメーション サービス (IIS) で SSL が有効になっていることを確認します。 「SSL を設定する方法」を参照してください。
ソリューション エクスプローラーでプロジェクトを右クリックし、[発行] をクリックします。
[ Web の発行 ] ダイアログ ボックスで、WCF サービスの URL を指定します。 次に例を示します。
https://<computer_name>/Siebel_Account/[ コピー ] ボックスで、[ すべてのプロジェクト ファイル] をクリックします。
[発行] をクリックします。
WCF サービスが正常に発行されたことを確認します。
IIS Microsoft 管理コンソールを起動します。 [ スタート] ボタンをクリックし、[ 管理ツール] をポイントして、[ インターネット インフォメーション サービス] をクリックします。
サービスを発行したノードに移動します。 Siebel_Account サービスの場合は、[インターネット インフォメーション サービス><] [コンピューター名>>] [Web サイト] [既定の Web サイト>>Siebel_Account] の順に移動します。
右側のウィンドウで、BusinessObjects_Account_Account_Operation.svc ファイルを右クリックし、[ 参照] をクリックします。
Web ページには、WSDL を取得するための URL が表示されます。 svcutil コマンドを使用してメタデータの取得をテストすることもできます。 たとえば、Siebel_Account サービスのメタデータを取得するコマンドは次のとおりです。
svcutil.exe https://localhost/Siebel_Account/BusinessObjects_Account_Account_Operation.svc?wsdl
次の手順
これで、Siebel ビジネス コンポーネント用の WCF サービスが作成されました。 ビジネス Data Catalog定義エディターを使用して、Siebel ビジネス コンポーネント操作用のアプリケーション定義ファイルを作成します。 手順については、「 手順 2: Siebel Business Component Operations 用のアプリケーション定義ファイルを作成する」 を参照してください。 アプリケーション定義ファイルは、LOB データが格納される場所と、それが格納される形式を識別します。