Siebel システム接続 URI を作成する
Microsoft BizTalk Adapter for Siebel eBusiness Applications 接続 URI には、アダプターが Siebel システムへの接続を確立するために使用するプロパティが含まれています。
このトピックでは、Siebel 接続 URI に関する情報を提供し、さまざまなプログラミング シナリオで接続 URI を指定する方法を説明する他のトピックへのリンクも提供します。
Siebel アダプターの接続 URI
一般的な WCF エンドポイント アドレス URI は、次のように表されます。
scheme://userinfoparams@hostinfoparams?query_string
エンドポイント アドレス URI には、次のコンポーネントが含まれています。
scheme はスキーム名です。
userinfoparams は、エンドポイントによるユーザー認証に必要なパラメーターの名前と値のコレクションです。
hostinfoparams は、ホストへの接続を確立するために必要な情報です。たとえば、パスです。
query_stringは、疑問符 (?) で区切られたパラメーターの省略可能な名前と値のコレクションです。
Siebel 接続 URI はこの一般的な形式に従い、次のように実装されます。
siebel://Username=[USER_NAME];Password=[PASSWORD]@[SERVER]:[PORT]?SiebelObjectManager=[SIEBEL_OBJECT_MANAGER_NAME]&SiebelEnterpriseServer=[SERVER_NAME]&Language=[LANGUAGE]&Transport=[TRANSPORT]&Encryption=[ENCRYPTION]&Compression=[COMPRESSION]&SiebelServer=[SIEBEL_SERVER_NAME]&SiebelRepository=[SIEBEL_REPOSITORY_NAME]
次のセクションでは、Siebel 接続 URI の各コンポーネントに実装されるプロパティについて説明します。
Siebel 接続 URI のスキーム
Siebel 接続 URI のスキームは "siebel" です。
Siebel 接続 URI のユーザー情報
既定では、接続 URI に Siebel システム資格情報が指定されている場合、Siebel アダプターは例外をスローします。 これは、これらの資格情報がプレーン テキストとして表され、固有のセキュリティ リスクが発生するためです。 AcceptCredentialsInUri バインド プロパティを設定して、接続 URI に資格情報を含めることができるかどうかを制御できます。 AcceptCredentialsInUri プロパティが false の場合、接続 URI に資格情報が含まれている場合、Siebel アダプターは例外をスローします。プロパティが true の場合、例外はスローされません。
重要
文字列に資格情報をプレーン テキストとして渡すことによる固有のセキュリティ リスクがあるため、接続 URI に Siebel システム資格情報を指定しないことをお勧めします。
接続 URI で指定せずに Siebel システム資格情報を指定するには、いくつかの方法があります。
コードでは、適切なオブジェクトに ClientCredentials プロパティを設定できます。
[アダプター サービス参照の追加] プラグインまたは [アダプター サービスアドインの使用] を使用する場合は、[アダプターの構成] ダイアログ ボックスの [セキュリティ] タブを選択して資格情報を入力できます。
BizTalk Server ソリューションで送信ポートまたは受信場所のバインドを指定する場合は、適切なダイアログ ボックスの [セキュリティ] タブを選択して資格情報を入力できます。
Siebel 接続 URI のユーザー情報 (userinfoparams) は、ユーザー認証に必要なパラメーターの名前と値のコレクションとして表されます。 次の表で、これらのパラメーターについて説明します。
| プロパティ | 説明 |
|---|---|
| ユーザー名 | Siebel システムのユーザー名。この値では大文字と小文字が区別されます。 接続 URI でユーザー名とパスワードを指定するには、 AcceptCredentialsInUri バインド プロパティを true に設定する必要があります。 メモ： Siebel アダプターは、Siebel システムで接続を開いたときにユーザー名に入力した値の大文字と小文字を保持します。 |
| パスワード | Siebel システムのユーザーのパスワード。この値では大文字と小文字が区別されます。 接続 URI でユーザー名とパスワードを指定するには、 AcceptCredentialsInUri バインド プロパティを true に設定する必要があります。 メモ： Siebel アダプターは、Siebel システムで接続を開いたときにパスワードに入力した値の大文字と小文字を保持します。 |
Siebel 接続 URI のホスト情報
Siebel ホスト情報 (hostinfoparams) は、Siebel システムのアドレスを [SERVER]:[PORT] の形式で指定します。 Siebel サーバーのバージョンに応じて、Siebel ホスト情報は異なる値を取ります。
Siebel バージョン 7.5 以前の場合、ホスト情報パラメーターは、Siebel ゲートウェイ サーバーがインストールされているコンピューターの名前と Siebel ゲートウェイポート番号を受け取ります。
Siebel バージョン 7.7 以降の場合、ホスト情報パラメーターは、Siebel サーバーがインストールされているコンピューターの名前と、Siebel 接続ブローカーのポート番号を受け取ります。
重要
アダプター サービス参照の追加 Visual Studio プラグインまたはアダプター サービス BizTalk プロジェクト アドインを使用して Siebel システムに接続する場合は、"SiebelGateway" 接続プロパティのホスト情報を指定する必要があります。
Siebel 接続 URI のクエリ情報
Siebel 接続 URI のクエリ情報 (query_string) は、追加の接続プロパティを指定するために使用されます。
| プロパティ | 説明 |
|---|---|
| SiebelObjectManager | エンタープライズ サーバー上の Siebel オブジェクト マネージャーの名前。 このパラメーターは必須です。 |
| SiebelEnterpriseServer | Siebel Enterprise Server の名前。 このパラメーターは必須です。 |
| 言語 | オブジェクト マネージャーの言語。 このパラメーターは省略可能です。 指定しない場合、Siebel アダプターは既定値 (enu) を提供します。 |
| トランスポート | トランスポート。tcpip のみがサポートされています。 このパラメーターは省略可能です。 指定しない場合、Siebel システムは既定値 (tcpip) を提供します。 |
| 暗号化 | Siebel アダプターと Siebel システム間で使用する暗号化の種類。 サポートされている値は none、mscrypto、rsa です。 このパラメーターは省略可能です。 指定しない場合、Siebel システムは既定値 (なし) を提供します。 |
| 圧縮 | Siebel アダプターと Siebel システム間で使用する圧縮アルゴリズム。 サポートされている値は none または zlib です。 このパラメーターは省略可能です。 指定しない場合、Siebel システムは既定値 (zlib) を提供します。 |
| SiebelServer | Siebel サーバー。 すべての Siebel 7.5 サーバー接続 (7.5.2、7.5.3 など) に必要です。それ以外の場合は、このパラメーターを設定しないでください。 |
| SiebelRepository | Siebel リポジトリ。 サーバーに複数のリポジトリが存在する場合は必須です。それ以外の場合は省略可能。 メモ： サーバーに複数のリポジトリが存在する場合は、SiebelRepository パラメーターでターゲット リポジトリを指定する必要があります。 |
クエリ情報で設定されている Siebel パラメーターの詳細については、Siebel のドキュメントを参照してください。
接続 URI での予約文字の使用
Siebel アダプターでは、パラメーター値の特殊文字を含む接続 URI の指定はサポートされていません。 接続パラメーターの値に特殊文字が含まれている場合は、次のいずれかの操作を行ってください。
[アダプター サービス参照プラグインの追加] または [アダプター サービス アドインの使用] を使用して Visual Studio で URI を指定する場合は、[ URI のプロパティ ] タブで、つまりエスケープ文字を使用せずにそのまま指定する必要があります。 [ URI の構成 ] フィールドで URI を直接指定し、接続パラメーターに予約文字が含まれている場合は、適切なエスケープ文字を使用して接続パラメーターを指定する必要があります。
BizTalk Server管理コンソールで送受信ポートを作成するときに URI を指定し、接続パラメーターに予約文字が含まれている場合は、適切なエスケープ文字を使用して接続パラメーターを指定する必要があります。
接続 URI を使用して Siebel システムに接続する
Siebel 接続 URI の例を次に示します。
siebel://Username=YourUserName;Password=YourPassword@Siebel_server:1234?SiebelObjectManager=obj_mgr&SiebelEnterpriseServer=entserver&Language=enu
Note
このサンプル URI には、Siebel システム資格情報が含まれています。資格情報を含む接続 URI を使用するには、 AcceptCredentialsInUri バインド プロパティを true に設定する必要があります。
次の場合に、Siebel システムへの接続を確立する方法 (接続プロパティの設定を含む) について説明します。
アダプター サービス BizTalk プロジェクト アドインまたはアダプター サービス参照の追加 Visual Studio プラグインを使用します。 「Visual Studio での Siebel 操作のメタデータの取得」を参照してください。
BizTalk Server ソリューションで送信ポートまたは受信ポート (場所) を構成する方法については、「Siebel アダプターへの物理ポート バインドを手動で構成する」を参照してください。
プログラミング ソリューションで WCF チャネル モデルを使用する方法については、「 Siebel を使用してチャネルを作成する」を参照してください。
プログラミング ソリューションで WCF サービス モデルを使用する方法については、「 Siebel システム用に WCF クライアントを構成する」を参照してください。
WCF ServiceModel メタデータ ユーティリティ ツール (svcutil.exe) を使用する方法については、「 BizTalk Adapter for Siebel eBusiness Applications での ServiceModel メタデータ ユーティリティ ツールの使用」を参照してください。
参照
Siebel システムへの接続の作成
Siebel アプリケーションの開発
WCF チャネル モデルを使用して Siebel アプリケーションを開発する3
WCF サービス モデルを使用して SQL アプリケーションを開発する