HCM インターフェイス レジストリについて
HCM インターフェイス レジストリには、サービス指向アーキテクチャ (SOA) で利用可能なサービスの全てのインターフェイス仕様が格納されます。HCM インターフェイス レジストリには、サービス プロバイダからの仕様が保存され、関連するサービス コンシューマに提供されます。
画像: レジストリにはサービスのバインドと実行に必要な情報が登録されており、サービス コンシューマはレジストリ内でインターフェイスを検索します。
次の図に示すように、サービス プロバイダはインターフェイスを登録します。サービス コンシューマはレジストリでインターフェイスを検索し、その情報を使用して、コンシューマとプロバイダ間で仕様をバインドして実行します。
サービス コンシューマとは、サービスを必要とするアプリケーション、サービス、あるいはその他のタイプのソフトウェア モジュールです。レジストリでサービスを検索し、通信経由でサービスにバインドしてサービス機能を実行する側になります。サービス コンシューマは、仕様に従った形式でサービスにリクエストを送信し、サービスを実行します。
サービス プロバイダは、コンシューマからのリクエストを受け取って実行するネットワーク対応のエンティティであるサービスです。サービス リクエストを実行するメインフレーム システム、コンポーネント、その他のタイプのソフトウェア システムがこれに該当します。サービス プロバイダは仕様をレジストリにパブリッシュして、サービス コンシューマがアクセスできるようにします。
インターフェイス レジストリを設定して使用するには、次の手順に従います。
レジストリ ウィザード () を使用して、インターフェイス仕様を設定し、インターフェイスを登録します。
プロバイダのアプリケーションにインターフェイスを実装します。
登録済みのインターフェイスを呼び出せるようにコンシューマのアプリケーションを設定します。
インターフェイス仕様の設定
インターフェイス仕様では、サービスのリクエストと応答の形式など、サービスの利用側と提供側であるコンシューマとプロバイダの対話方法を指定します。HCM レジストリ には、HCM の既存のインターフェイス仕様がロードされます。レジストリに新しいインターフェイスを追加するには、最初にサービス間の仕様を定義する必要あります。
サービス間のインターフェイス仕様を定義するには、次の手順に従います。
インターフェイスの詳細 (署名、例外、警告など) を決定します。
プロバイダのオブジェクト ID でインターフェイスを登録します。
インターフェイスのステータスを [アクティブ] に設定します。
注: HCM レジストリのレジストリ ウィザードを使用して、インターフェイスを登録します。
インターフェイスは、以下のいずれかのカテゴリに分類されます。
サービス
同期リクエスト/応答 (サービス)
サービス インターフェイスは、手続き型の呼び出しであり、ローカルとリモートの両方が可能です。
非同期パブリッシュ/サブスクライブ (イベント)
イベントは、メッセージングとインテグレーション ポイントに基づいて、通知 (アウトバウンド) または利用 (インバウンド) が可能です。
sqlView (ビュー)
ビューは読み取り専用で SQL ベースです。
タイプ
タイプは、サービス呼び出しで使用される複合データ タイプです。API でのサービス呼び出しには、以下のタイプがサポートされます。
基本タイプ (ネイティブ PeopleCode データ タイプ)。文字列、日付、数値、ブール値、16 進数、配列などがあります。
複合タイプ。複合タイプのレジストリまたは配列に定義されます。
注: サービス呼び出しでは、ネイティブで全ての基本タイプを使用できますが、複合タイプの定義とレジストリへの登録は、全て明示的に行う必要があります。
例外
例外とは、サービスの実行中に発生する可能性のある致命的なエラーであり、PeopleCode プログラムで特別な処理が必要になります。サービス プロバイダは、発生が想定される例外を特定して、コンシューマ側のコードで処理できるようにする必要があります。
例外を定義して、インターフェイス レジストリに登録します。