カスタム・ポリシー・レビュー API を使用してポリシーを開発するには、最初にポリシー管理プログラムを作成する必要があります。
カスタム・ポリシーを追加するには、ポリシー管理プログラムにそれぞれのカスタム・ポリシーへの参照を組み込む必要があります。ポリシー管理プログラム・クラスとポリシー実装をセットアップしてから、
ポリシー管理プログラムをリポジトリーに追加します。
始める前に
- ワークスペースをセットアップします。
- お使いのワークスペースの Java™ バージョンがサーバー上の Java バージョンと一致していることを確認します。
例えば、IBM® WebSphere® Application Server バージョン 8.0 では、
Java 6 が使用されます。このポリシーが
Java 7 または 5 でコンパイルされた場合は、このポリシーは機能しません。
- フォルダーに ramclient.zip ファイルを解凍します。
ramclient.zip ファイルには、Rational® Asset Manager Java API に
必要となる .jar ファイルのセットが含まれています。
ramclient.zip ファイルは、デプロイされた Rational Asset Manager サーバー・インスタンスの「拡張」ページで
入手できます。
http://<hostname>:<port>/ram/ramclient.zip (http://<localhost>:<9080>/ram/ramclient.zip など) から直接アクセスすることもできます。
手順
- プロジェクトをセットアップします。
- カスタム・ポリシーの Java プロジェクトを作成します。 SampleGovernor.jar 内に含まれているサンプル・ポリシー管理プログラムとポリシーをプロジェクトにインポートして、変更を加えることで、カスタム・ポリシーを作成することができます。
- プロジェクトを右クリックし、「インポート」を選択して、プロジェクトの /src サブディレクトリーにサンプル・ポリシー管理プログラムをインポートします。
- 「アーカイブ・ファイル」を選択し、「次へ」をクリックします。
- 「参照」をクリックして、SampleGovernor アーカイブ・ファイルを選択します。
- 「完了」をクリックします。 内容が新規プロジェクトに追加されます。
- ramclient.jar ファイルに対する依存関係をビルド・パスに追加します。
- プロジェクトを右クリックし、を選択します。
- ramclient.zip ファイルを解凍した場所にナビゲートし、ramclient.jar ファイルを選択します。
- ポリシーを作成します。
- ポリシーは、独自に新規作成することも、提供されているポリシー (MyPolicy など) を拡張して作成することもできます。提供されているポリシー・ファイル内のメソッドを使用することや、メソッドを変更することができます。例えば、
test() メソッドでは、独自のガバナンス・モデルからの特定のアセット・タイプ詳細のセットを基準として、アセット・ポリシー・テスト合格とするかどうかを決定することができます。
カスタム・ポリシーの作成に使用できる API について詳しくは、『カスタム・ポリシーで使用する API』を参照してください。
注: ポリシーをマップに格納しておき、
ID を指定してポリシーを取り出すことができます。例えば、private Map
policies; です。 マップからポリシーを取り出すには、getPolicies().get(id) メソッドにポリシー ID を入力します。
- 管理プログラム・クラスに、新しい各ポリシーへの参照を追加します。
管理プログラム・クラスには、ポリシー管理プログラム内のそれぞれのカスタム・ポリシーへの参照を含める必要があります。 例えば、MyPolicy の場合は、次の行を
MyGovernor クラス (MyGovernor.java 内) に追加します。
//My XML Policy
Policy policy = new MyPolicy(this);
policies.put(policy.getID(), policy);
Rational Asset Manager Java API を使用すると、現在のアセットおよび
その他のアセットをカスタム・ポリシーの中で操作することができます。 この Java API の使用方法の例については、Rational Asset Manager Java API の使用を参照してください。例と、使用できる API に関する追加情報が jazz.net 上のカスタム・ポリシー wiki ページにあります。
- ポリシーをインストールします。 カスタム・ポリシーをパッケージするために、
プロジェクトを .jar ファイルとしてエクスポートしてから、このファイルを
新規ポリシー拡張として追加します。
- プロジェクトを .jar ファイルとしてエクスポートします。
ポリシーをアップロードするときに、
複数の .jar ファイル (他の任意の
必要な .jar ファイルや、ポリシー .jar ファイルなど) を 1 つの .zip ファイルとして
組み込むことができます。
- リポジトリー管理者としてログインします。
- 「管理」ページで、「カスタム拡張」をクリックします。
- 新しいポリシー拡張を追加します。
- ポリシー管理プログラムの完全修飾クラス名 (パッケージおよびクラス) を入力します。
- ステップ 4a でエクスポートした .jar ファイルを参照して選択します。お使いのポリシーは、ライフサイクルまたはポリシーのプロセスで使用できます。
管理プログラムを追加する方法について詳しくは、
『外部ポリシー管理プログラムの定義』を参照してください。
次のタスク
ポリシーをテストしてデバッグします。手順については、
ポリシーのテストとデバッグを参照してください。