Uniform Resource Identifier (URI) は、Web サービスなどのリソースを一意に識別します。また、WCF LOB アダプター SDK で開発されたアダプターの場合は、接続するシステムと実行するアクションを一意に識別します。 このセクションでは、アダプターのエンドポイント アドレスとアクションを一意に記述する URI を構築する方法に関する推奨事項を示します。
URI の構造
URI は、次の 3 つのコンポーネントで構成されます。
スキーム名 は URI 文字列の先頭部分であり、名前付け構造の最初のレベルです。例としては、http、urn、contoso などがあります。
階層部分 は、通常は階層構造の情報で構成され、オプションの権限、ホスト名、ポート情報を含めることができます。 例は、
www.microsoft.comやUserName=User@microsoft.com:4099のようになります。クエリ には、疑問符 (?) でマークされたオプションの情報が含まれており、通常はアンパサンド (&) で区切られたキーと値のペアとしてグループ化されます。 たとえば、contoso://microsoft.com/functions?name=Find。
フラグメント は、アダプターで必要になる可能性がある追加の識別情報を格納するために使用されます。 フラグメントはハッシュ (#) で区切られています。たとえば、contoso://microsoft.com/functions?name=Find#public。
URI 構文によって提供されるすべての機能を使用しない場合があります。
URI の設計
アダプター開発者は、ターゲット基幹業務システムに適した URI を考案する必要があります。 URI を設計するときは、一意で意味のあるものにすることが重要です。
一意の URI は、organization内の既存の URI と競合せず、他の企業やインターネット全体で競合しない URI です。 たとえば、現在認識されている、または既に広く使用されている可能性がある "http" や "afs" などのスキーム名を選択すると、要求がアダプターではなく別のシステムにルーティングされる可能性があるため、接続または運用上の問題が発生する可能性があります。
URI 設計のもう 1 つの重要な側面は、アダプターを使用する開発者にとって意味のあるものになることです。 たとえば、医療クレーム処理システム用のアダプターを作成する場合は、会社名、ターゲット要求処理システム名、およびシステム バージョンである northwind.contoso.cps.v1.0:// を含む URI スキームを設計できます。
ターゲット システムへの接続
接続文字列の構文は次のとおりです。
<scheme>://[userinfo "@"]<LOB 接続文字列>
たとえば、次を使用して contoso カタログ注文システム (サンプル 基幹業務アプリケーション) に接続できます。
northwind.contoso.v1.0://<servername>?Catalog=Contoso&Integrated Security=True
また、ユーザー名とパスワード、その他の重要な資格情報を含む、オプションの機関情報を URI に指定することもできます。 ただし、セキュリティ上のリスクが生じることがあります。
注意事項
URI には、ユーザーの資格情報やその他の機密情報を渡さないでください。 この情報は、承認されていないユーザーによって傍受および表示される可能性があります。