パブリック・サービス・レジストリおよび外部サービス・レジストリの管理

[名前] は、サービスを特定します。サービスを特定するその他の属性は、[ドメイン] と [バージョン] です。それぞれのレジストリは、これらの属性の使用方法に関する規則を採用する必要があります。[ドメイン] は通常、サービスのカテゴリを特定し、[バージョン] はバージョン番号を表す文字列です。[ドメイン] と [バージョン] が組み合わさった [名前] は、エントリごとに一意である必要があります。例えば、ドメインが異なるか、バージョンが異なる限り、複数のエントリの名前が同じである可能性があります。

[バージョン] は、サービスのバージョンを特定します。

[ドメイン] は、サービスのカテゴリを指定します。

[ライフサイクルの段階] は、サービスの開発状態を表します。これは、以下のいずれかの値を持つことができます。[概念]、[開発]、[テスト]、[ステージング]、[稼働中]、[廃止]、および [非アクティブ]。

[サービス・プロトコル] は、クライアントがサービスへのアクセスに使用するプロトコルを表します。これは、以下のいずれかの値を持つことができます。[File]、[FTP]、[HL7]、[HTTP]、[REST]、[SOAP]、[SQL]、[X12]、および任意のカスタム値。外部サービス・レジストリでは、Service Protocol によって、ビジネス・オペレーションのプロパティの設定に Endpoint をどのように使用するかが決定されます。サービス・プロトコルとして TCP を明示的に入力することができますが、ドロップダウンの選択肢としては一覧に含まれていません。

[説明] は、サービスの簡単な説明を提供します。

[エンドポイント] は、サービスの場所を指定します。パブリック・サービス・レジストリでは、エンドポイントは通常、ESB 上のビジネス・サービスの URL です。外部サービス・レジストリでは、エンドポイントは、データまたはサービスの場所に関する情報を提供し、ESB ホストのプロパティの設定に使用されます。

外部サービス・レジストリのエンドポイントの形式は、サービス・プロトコルによって異なります。それぞれのタイプのサービス・プロトコルでの Endpoint の使用方法の詳細は、“ESB ホストの構成での外部サービス・レジストリの使用” を参照してください。

[応答スタイル] は、サービスが値を返す方法を表します。これは、以下のいずれかの値を持つことができます。[同期]、[コールバック]、[リモート・デポジット]、または空白の値。

[トピック] では、管理者ページおよびパブリック API からレジストリ・エントリの検索に役立つ検索用語を定義できます。レジストリ・エントリの作成時に値を入力することはできませんが、[詳細] パネルで値を入力することによって追加できます。カンマで区切った用語のリストを入力するか、ドロップダウン・メニューから 1 つ以上のトピックにチェックを付けることによってトピックを指定できます。ドロップダウン・メニューには、レジストリ・エントリに既に定義されているトピックが一覧表示されます。

[スキーマ] は、サービス・メッセージの構造を表します。[スキーマ] には、構造の定義を表すサブフィールドや、構造の定義を含むサブフィールドが含まれます。レジストリ・エントリの作成時にスキーマを指定することはできませんが、[詳細] パネルで値を入力することによってスキーマを追加できます。[スキーマ] には、以下のサブフィールドが含まれます。

• [タイプ] — スキーマの記述に使用するスキーマ定義メカニズムの名前を指定します。WSDL、XSD、HL7、SEF、X12、AST、または EDF を選択することも、その他のスキーマ定義メカニズムの名前を入力することもできます。

• [リファレンス] — スキーマ定義の URL を指定します。

• [備考] — スキーマに関する補足情報を提供します。

• [サムネイル] — スキーマの短いテキスト抜粋を提供します。

• [コンテンツ] — スキーマ定義の完全なテキスト・コンテンツを表します。

[アクション] は、指定した URL と共に使用できる SOAP アクションまたは REST HTTP 要求メソッドを指定します。SOAP アクションは、WSDL で定義されている情報の概要を提供します。レジストリ・エントリの作成時にアクションを追加することはできませんが、[詳細] パネルで [アクション] のプラス記号を選択することによってアクションを追加できます。[アクション] には、以下のサブフィールドが含まれます。

• [名前] — レジストリで対象のアクションの特定に使用する名前を指定します。

• [リファレンス] — アクションまたは Web メソッドの識別子です。

• [動詞] — HTTP 要求メソッドを指定します。通常、これは GET、PUT、POST、または DELETE ですが、任意の HTTP 要求メソッドを入力できます。

• [読み取り専用] — チェックを付けると、呼び出しによってサーバの状態は変更されないことが指定されます。

• [べき等] — チェックを付けると、同じ呼び出しの複数回の実行が、1 回の呼び出しと同じ影響をサーバに与えることが指定されます。

• [説明] — アクションのテキストによる説明を指定します。

• [要求スキーマ] — 受信メッセージ本文の形式を指定します。以下のサブフィールドで構成されます。[タイプ]、[リファレンス]、[備考]、[サムネイル]、および [コンテンツ]。

• [応答スキーマ] — 応答メッセージ本文の形式を指定します。以下のサブフィールドで構成されます。[タイプ]、[リファレンス]、[備考]、[サムネイル]、および [コンテンツ]。

[属性] は、名前と値のペアのリストを指定します。名前と値のペアを使用して、レジストリ・エントリの任意のフィールドを指定できます。レジストリ・エントリの作成時に属性を追加することはできませんが、[詳細] パネルで [属性] の + (プラス記号) を選択することによって属性を追加できます。それぞれの属性は、名前と文字列の値で構成されます。属性を定義すると、値を更新することも、その属性を削除することもできますが、属性の名前を変更することはできません。

[連絡先] は、サービスをサポートまたは使用するユーザまたは組織を指定します。レジストリ・エントリの作成時に連絡先を追加することはできませんが、[詳細] パネルで [連絡先] のプラス記号を選択することによって連絡先を追加できます。[連絡先] には、以下のサブフィールドが含まれます。

• [ID] — そのユーザまたは組織の、名前またはその他の ID を指定します。

• [連絡先タイプ] — 連絡先がサービスの [作成者]、[コンシューマ]、[プロバイダ]、[オペレータ]、[マネージャ]、[スポンサ] のいずれであるかを指定します。

• [ビジネス・パートナー] — Ensemble ビジネス・パートナー・オブジェクトへのリンクを示します。このオブジェクトは、住所や電話番号などの連絡先情報を提供します。パブリック API はビジネス・パートナー名のみを示し、ビジネス・パートナー・オブジェクトからの連絡先情報は含みません。

• [詳細] — 連絡先に関する詳細を指定します。例えば、電話番号、電子メール・アドレス、またはパブリック API からアクセス可能なその他の連絡先情報を入力できます。

• [備考] — そのユーザまたは組織に関する補足情報を指定します。

連絡先を定義すると、[ID] を除くすべてのサブフィールドを更新できます。赤い X を選択することによって、連絡先を削除することもできます。

[ファイル] は、レジストリ・エントリに任意のテキスト・ファイルまたはバイナリ・ファイルを格納する方法を表します。例えば、サービスに関する説明や、大きなサイズのスキーマ定義が含まれるファイルを格納できます。サービスの作成時にファイルを追加することはできませんが、[詳細] パネルで [ファイル] のプラス記号を選択することによってファイルを追加できます。ローカル・システムまたは Ensemble サーバ上にあるファイルを追加できます。[ファイル] には、以下のサブフィールドが含まれます。

• [ファイル名] — ファイルの名前を表します。レジストリ内のファイルの名前を、ローカル・ファイル・システムまたは Ensemble サーバ上の元のファイルの名前と同じにする必要はありません。

• [ファイル拡張子] — ファイルの形式と目的に関する情報を提供します。このフィールドは、ファイル名の最後の部分で設定されます。

• [MIME タイプ] — ファイルにアクセスするために使用するアプリケーションに関する情報を提供します。

• [文字エンコード] — 文字エンコーディングに関する情報を提供します。

• [ファイル・サイズ] — ファイル・サイズを表します。このフィールドは、ファイルの内容から計算されます。

• [コンテンツ] — ファイルの作成時に、このサブフィールドはファイルの内容に設定されます。

このチェックボックスは、対象のサービスに関する情報をレジストリのパブリック API から取得できるかどうかを制御します。[パブリック] が真の場合 (ボックスにチェックが付いている場合)、[必要なロール] の設定に基づいてユーザが表示を許可されているなら、API は対象のサービスに関する情報を返します。[パブリック] が偽の場合、パブリック API から、対象のサービスに関する情報は何も返されません。

[必要なロール] は、レジストリ・エントリへのパブリック API アクセスを提供するロールのリストを指定します。ユーザがレジストリ・エントリに関する情報を取得するには、そのユーザには [必要なロール] のリストに含まれているいずれかのロールが必要です。ユーザは、Ensemble へのログインを通じて、あるいはロールを有した Web アプリケーションを通じて、指定のロールを取得します。これらのロールの定義方法の詳細は、“パブリック・サービス・レジストリに対するロールとユーザの定義” を参照してください。

[インスタンス] は、指定されたエンドポイントでサービスを提供している Ensemble インスタンスを特定します。通常、これは、ESB レジストリおよびサービス・レジストリに使用される Ensemble インスタンスです。Ensemble ビジネス・サービスからエンドポイント・サービスが提供されていない場合、このフィールドは空白のままにします。

[ネームスペース] は、指定されたエンドポイントでサービスを提供している Ensemble ネームスペースを特定します。通常、これは、ESB レジストリおよびサービス・レジストリに使用される Ensemble ネームスペースです。Ensemble ビジネス・サービスからエンドポイント・サービスが提供されていない場合、このフィールドは空白のままにします。

[プロダクション] は、指定されたエンドポイントでサービスを提供している Ensemble プロダクションを特定します。通常、これは ESB Ensemble プロダクションです。Ensemble ビジネス・サービスからエンドポイント・サービスが提供されていない場合、このフィールドは空白のままにします。

[構成名] は、指定されたエンドポイントでサービスを提供している Ensemble 構成項目を特定します。通常、この構成項目は、ESB Ensemble プロダクション内のビジネス・サービスです。Ensemble ビジネス・サービスからエンドポイント・サービスが提供されていない場合、このフィールドは空白のままにします。