Oracle® Fusion Middleware

Oracle Enterprise Repository構成ガイド

11gリリース1 (11.1.1.7)

E59381-01(原本部品番号:E16580-14)

2013年10月

サービス指向アーキテクチャ(SOA)のガバナンス・イニシアチブをサポートするための、Oracle Enterprise Repositoryの構成およびカスタマイズのタスクを示す管理者向けのドキュメント。

Oracle Fusion Middleware Oracle Enterprise Repository構成ガイド、11gリリース1 (11.1.1.7)

E59381-01

Copyright © 2008, 2013, Oracle and/or its affiliates. All rights reserved.

原本著者: Oracle Corporation

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます。誤りを見つけた場合は、オラクル社までご連絡ください。

このソフトウェアまたは関連ドキュメントを、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供する場合は、次の通知が適用されます。

U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007). Oracle America, Inc., 500 Oracle Parkway, Redwood City, CA 94065.

このソフトウェアもしくはハードウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアもしくはハードウェアは、危険が伴うアプリケーション(人的傷害を発生させる可能性があるアプリケーションを含む)への用途を目的として開発されていません。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用する際、安全に使用するために、適切な安全装置、バックアップ、冗長性(redundancy)、その他の対策を講じることは使用者の責任となります。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、オラクル社およびその関連会社は一切の責任を負いかねます。

OracleはOracle Corporationおよびその関連企業の登録商標です。その他の名称は、それぞれの所有者の商標または登録商標です。

このソフトウェアおよびドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても、一切の責任を負いかねます。

目次

タイトルおよび著作権情報

はじめに

- 対象読者

- ドキュメントのアクセシビリティについて

- 関連ドキュメント

- 表記規則

リリース11.1.1.7用のこのガイドでの新しい情報

1 基本構成

- 1.1 概要

- 1.2 部門

- 1.2.1 新規部門の作成

- 1.2.2 部門情報の編集

- 1.3 ユーザー

- 1.3.1 新規ユーザーの作成

- 1.3.2 ユーザー情報の表示

- 1.3.3 ユーザー検索

- 1.3.4 ユーザーのクローニング

- 1.3.5 ユーザー情報の編集

- 1.4 プロジェクト

- 1.4.1 プロジェクト詳細の表示

- 1.4.2 プロジェクトの作成

- 1.4.3 プロジェクトの編集

- 1.4.4 ユーザー/使用方法の再割当て

- 1.4.5 プロジェクトの検索

- 1.4.6 プロジェクトのクローズ

- 1.4.7 リレーションシップのプロジェクトへの追加

- 1.5 ロール

- 1.5.1 ユーザー・ロールの説明

- 1.5.2 新規ロールの作成

- 1.5.3 ロールの編集

- 1.5.4 ロールの削除

- 1.6 アクセス設定

- 1.6.1 ロールへの権限の付与

- 1.6.2 権限の編集

- 1.6.3 ユーザー権限の検証

- 1.6.4 セキュリティに関する考慮事項

- 1.6.4.1 アクセス設定およびアセット・エディタ

- 1.6.4.2 権限

- 1.7 セッション

- 1.7.1 セッションの表示

- 1.7.2 単一セッションの削除

- 1.7.3 複数のセッションの削除

- 1.8 タイプ

- 1.8.1 タイプの表示

2 Oracle Enterprise Repositoryのカスタマイズ

- 2.1 概要

- 2.1.1 Oracle Enterprise Repositoryホームページへのアクセス

- 2.1.2 Oracle Enterprise Repositoryホームページのカスタマイズ

- 2.2 Oracle Enterprise Repositoryの外観の変更

- 2.2.1 最初に行うCSSの変更

- 2.2.2 スキンのカスタマイズ

- 2.2.2.1 スキンの選択

- 2.2.2.2 スキンの作成

- 2.2.2.3 イメージ

- 2.2.2.4 作成したカスタム・スキンのアクティブ化

- 2.2.2.5 Oracle提供のカスタム・スキンのOracle Enterprise Repositoryへのインストール

- 2.2.2.6 ディレクトリ構造の使用

- 2.3 ロール/部門ベースのホームページ表示

- 2.3.1 インストール

- 2.4 Oracle Enterprise Repositoryソリューション・パックのインストール

3 外部認証ツールを使用するためのOracle Enterprise Repositoryの構成

- 3.1 概要

- 3.1.1 LDAP/Active Directory

- 3.1.2 LDAP統合システム・プロパティの有効化

- 3.1.3 LDAP/Active Directoryプロパティの変更

- 3.1.4 セキュリティに関する考慮事項

- 3.1.4.1 サンプル・ユース・ケースのシナリオ

- 3.1.5 LDAPプロパティの例

- 3.2 eTrust Single Sign-On

- 3.2.1 概要

- 3.2.2 シングル・サインオン認証で使用するOracle Enterprise Repositoryの構成

- 3.2.2.1 シングル・サインオン統合システム・プロパティの有効化

- 3.2.2.2 Oracle Enterprise RepositoryのSSO統合およびBasic認証の使用

- 3.2.2.3 アプリケーション・プロパティ・ファイルの手動による変更

- 3.2.3 拡張オプション

- 3.2.3.1 新規ユーザーのデフォルト・ロールの作成と割当て

- 3.2.3.2 新規ユーザーの作成と未承認ユーザーの許可

- 3.2.3.3 未承認/新規ユーザー・ログインの有効化

- 3.2.3.4 新規ユーザー通知

- 3.2.3.5 部門の同期

- 3.2.3.6 ロールの同期

- 3.2.3.7 デバッグ・ロギングの有効化

- 3.3 コンテナ管理の設定

- 3.3.1 概要

- 3.3.2 コンテナ管理認証を使用するOracle Enterprise Repositoryの構成

- 3.3.3 コンテナ認証を許可するためのWebアプリケーションのWeb.xmlファイルの変更

4 拡張ロールベース・アクセス制御の構成

- 4.1 概要

- 4.2 セキュリティに関する考慮事項

- 4.2.1 アクセス設定およびアセット・エディタ

- 4.2.2 カスタム・アクセス設定の有効化

- 4.3 基本的な概念

- 4.3.1 ロール

- 4.3.2 アクセス設定

- 4.4 アクセス定義

- 4.5 プロセスの概要

- 4.6 権限の付与および拒否

- 4.6.1 特定のアセットに対するアクセス権の付与または拒否

- 4.6.1.1 前提条件

- 4.6.1.2 アセットCASの作成

- 4.6.2 アセット内の特定のダウンロード可能ファイルに対するアクセス権の付与または拒否

- 4.6.2.1 前提条件

- 4.6.2.2 ファイルCASの作成

- 4.7 既存のロールのアクセス設定の構成

- 4.7.1 ユーザー・ロールおよびデフォルトの権限

- 4.7.2 アクセスのオプション

- 4.7.2.1 オプションI: CASを使用した特定のアセットに対するアクセスの許可または拒否

- 4.7.2.2 オプションII: CASを使用した特定のファイルおよびアセットに対するアクセスの許可または拒否

- 4.8 ロールベース・アクセス制御のユースケース

- 4.8.1 ユースケース1: 顧客および取引パートナにWebサービスを公開する

- 4.8.1.1 メリット

- 4.8.1.2 概要

- 4.8.1.3 解決策

- 4.8.2 ユースケース2: アウトソーシング先の環境で知的財産を管理する

- 4.8.2.1 メリット

- 4.8.2.2 概要

- 4.8.2.3 解決策

- 4.8.3 ユースケース3: フェデレーテッド・リポジトリを確立する

- 4.8.3.1 メリット

- 4.8.3.2 概要

- 4.8.3.3 解決策

- 4.8.4 ユースケース4: アセット・ライフサイクルを管理する

- 4.8.4.1 メリット

- 4.8.4.2 概要

- 4.8.4.3 ユースケースの解決策の構成

- 4.8.4.4 アセット・ライフサイクル管理の解決策の検証テスト

- 4.8.5 ユースケース5: ソース・コード・ファイルへのアクセスをアセット生成チームに限定する

- 4.8.5.1 メリット

- 4.8.5.2 概要

- 4.8.5.3 解決策

- 4.8.6 ユースケース6: 参照専用のリポジトリ・アクセス権を特定のグループに付与する

- 4.8.6.1 メリット

- 4.8.6.2 概要

- 4.8.6.3 解決策

- 4.8.6.4 検証テスト

5 診断およびパスワードの暗号化

- 5.1 Oracle Enterprise Repositoryの「診断」ページへのアクセス

- 5.2 暗号化パスワードの生成

- 5.2.1 Oracle Enterprise Repositoryのデプロイメントで使用される暗号化パスワード

- 5.2.2 その他のパスワード

- 5.3 構成ファイルのパスワードの暗号化

- 5.3.1 ハーベスタ構成ファイル

- 5.3.2 交換ユーティリティ構成ファイル

- 5.3.3 ワークフロー構成ファイル

6 設計時および実行時環境における自動収集の構成と使用

- 6.1 ハーベスタを使用する前に

- 6.1.1 前提条件

- 6.1.2 ハーベスタの機能

- 6.1.3 アーティファクト/製品のバージョン・マトリクス

- 6.2 ハーベスタの構成

- 6.2.1 ハーベスタの入手

- 6.2.2 コマンド行用のハーベスタの構成

- 6.2.2.1 コマンド行用のリポジトリ接続情報の設定

- 6.2.2.2 コマンド行用の収集対象のアーティファクトの選択

- 6.2.3 統合開発環境でのハーベスタの使用

- 6.2.4 repository.submit Antタスクを使用したハーベスタの呼出し

- 6.2.4.1 repository.submit Antタスクのパラメータの指定

- 6.2.4.2 ネストした要素としてのパラメータの指定

- 6.2.4.3 Antからのハーベスタの実行

- 6.2.4.4 サード・パーティ・タスクの使用

- 6.2.5 WLSTからのハーベスタの呼出し

- 6.2.6 ランタイム収集の詳細

- 6.2.6.1 Oracle SOA Suiteサーバーからの収集

- 6.2.6.2 WebLogic ServerからのWebサービスの収集

- 6.2.6.3 Oracle Service BusからのWebサービスの収集

- 6.2.7 オプションのハーベスタ構成の実行

- 6.2.7.1 Oracle Metadata ServiceのURL

- 6.2.7.2 クラスパスのURL

- 6.2.8 ハーベスタのロギングの構成

- 6.2.9 ハーベスタでのトランザクション処理

- 6.2.10 拡張構成

- 6.3 アーティファクトの収集

- 6.3.1 アーティファクトの収集

- 6.3.1.1 BPEL

- 6.3.1.2 WSDL

- 6.3.1.3 XSD

- 6.3.1.4 XSL

- 6.3.1.5 Oracle SOA Suiteの収集

- 6.3.1.6 JCAアダプタ

- 6.3.1.7 Oracle BSE (WSDL/SOAP)を介したアプリケーション

- 6.3.1.8 プロキシ・サービスまたはビジネス・サービス

- 6.3.1.9 Oracle Service Bus (OSB)プロジェクト

- 6.3.1.10 BPMN

- 6.3.2 Oracle Business Process Analysisプロジェクトの収集

- 6.3.3 Oracle Business Process Management 11gプロジェクトの収集

- 6.3.4 Oracle Service Bus 11gアセットの収集

- 6.3.5 Oracle Service Bus 10gアセットの収集

- 6.3.6 JDeveloperからのSOAプロジェクトの収集

- 6.3.7 JDeveloperからのデプロイ済コンポジットの収集

- 6.3.8 JDeveloperアプリケーションとOracle Enterprise Repositoryプロジェクトとの関連付け

- 6.3.9 JdeveloperからのOracle Enterprise RepositoryのWSDLサービスの使用

- 6.3.10 重複アーティファクトの検出

- 6.3.11 収集されたアーティファクトのダウンロード

- 6.3.12 収集されたアセットの検索

- 6.3.12.1 使用方法の使用

- 6.3.12.2 メタデータの使用

- 6.3.13 ハーベスタ内で作成されたアセットのプレビュー

- 6.3.14 ベスト・プラクティス

- 6.3.14.1 収集用として推奨される権限

- 6.3.14.2 推奨されないネームスペース・パラメータのオーバーライド

- 6.3.14.3 WSDLファイル内のネームスペース

- 6.3.14.4 完了した作業の収集

- 6.3.14.5 XSDの収集およびメンテナンス・リリース

- 6.3.14.6 アセットのライフサイクル全体でのメタデータの収集

- 6.3.14.7 WSDLアーティファクトのダウンロード

- 6.3.14.8 リタイアしたエンドポイントの収集

- 6.3.14.9 SOAプロジェクトの収集

- 6.3.14.10 Oracle JDeveloper 11gからの収集

- 6.3.14.11 ハーベスタ・フォルダ内のファイルの収集

- 6.3.14.12 同じコンピュータでのハーベスタおよびExchange Utilityの実行

- 6.3.14.13 コンポジット・サービスWSDLの収集

- 6.3.15 既知の問題

- 6.3.15.1 システム内にアセット・タイプが必要

- 6.3.15.2 アセット・タイプの2つのバージョン

- 6.3.15.3 収集したアセット内でハーベスタ固有のメタデータ・エントリは削除しない

- 6.3.15.4 サポートされるリモート・サーバーのタイプ

- 6.3.15.5 不正な暗号化パスワードの使用

- 6.3.15.6 リポジトリ内のビュー・オプション

7 メトリックの構成

- 7.1 概要

- 7.1.1 メトリック要素

- 7.1.2 「再利用可能メトリックの追加」タブ

- 7.2 アセット・タイプの要素の有効化

- 7.3 データベースに対する問合せの実行

- 7.3.1 dbqueries

8 電子メール通知および配信リストの構成

- 8.1 概要

- 8.1.1 電子メール通知および電子メール配信リストの使用

- 8.2 電子メール通知の設定

- 8.3 電子メール配信リストの管理

- 8.3.1 配信リストの更新

- 8.3.2 リスト・メンバーに電子メールのコピーが送信される場合

- 8.4 電子メール・テンプレートの使用

- 8.4.1 電子メール・テンプレートの表示

- 8.4.2 電子メール・テンプレートの編集

9 Oracle Enterprise Repositoryエクスプレス・ワークフローの構成

- 9.1 Oracle Enterprise Repositoryエクスプレス・ワークフローの概要

- 9.2エクスプレス・ワークフローの構成

- 9.2.1 手順1: OERエクスプレス・ワークフローSOAコンポジット・アプリケーションのインストール

- 9.2.2 手順2: デプロイ済SCAへイベントを配信するOERイベント・マネージャの構成

- 9.2.2.1 Webサービスのエンドポイント構成

- 9.2.2.2 イベント・マネージャの有効化

- 9.2.3 手順3:エクスプレス・ワークフローの定義および構成

- 9.3 サンプル・ワークフローの実行

- 9.4 サンプル・ワークフローの変更

- 9.4.1エクスプレス・ワークフロー構成ファイルの変更

- 9.4.1.1 プロジェクトの作成

- 9.4.1.2 承認フロー

- 9.4.1.3 イベント/アクション間のマッピング

10 Oracle Service Registryとメタデータを交換するためのOracle Enterprise Repositoryの構成

- 10.1 Oracle Registry Repository Exchange Utilityを使用する前に

- 10.1.1 Oracle Registry Repository Exchange Utilityとは

- 10.1.1.1 有効なメタデータ・エンティティ

- 10.1.1.2 前提条件

- 10.1.2 ユースケース例

- 10.2 Oracle Registry Repository Exchange Utilityの構成

- 10.2.1 Oracle Registry Repository Exchange Utilityのインストールおよび構成

- 10.2.1.1 Oracle Registry Repository Exchange Utilityのインストール

- 10.2.1.2 アセット・タイプ名を使用した構成

- 10.2.2 Oracle Service Registryのインストール

- 10.2.3 Oracle Registry Repository Exchange Utilityの構成ファイルの構成

- 10.2.3.1 リポジトリ接続情報の設定

- 10.2.3.2 レジストリ接続情報の設定

- 10.2.3.3 リポジトリ問合せの設定

- 10.2.3.4 宛先レジストリの設定

- 10.2.3.5 レジストリ問合せの設定

- 10.2.3.6 ソース・レジストリの設定

- 10.2.4 UDDIマッピング・ファイル内のOracle Enterprise Repositoryカテゴリ分けの構成

- 10.2.5 tModelKey UDDI設定の構成

- 10.2.6 Oracle Registry Repository Exchange Utilityのプロパティ・ファイルの理解

- 10.2.7 XUのサポート

- 10.2.7.1 手動で作成されたサービスに対するXUのサポート

- 10.2.7.2 Oracle Service Busから収集された非WSDLサービスに対するXUのサポート

- 10.2.7.3 非収集またはカスタム・アセット・タイプおよびリレーションシップを公開するためのXUの構成

- 10.3 Oracle Enterprise Repository Exchange Utilityの使用

- 10.3.1 Oracle Registry Repository Exchange Utilityの実行

- 10.3.1.1 ワークフローを使用したOracle Registry Repository Exchange Utilityの起動

- 10.3.2 交換されるメタデータの同期方法

- 10.3.2.1 Oracle Enterprise RepositoryからOracle Service Registryに公開されるメタデータの同期

- 10.3.2.2 Oracle Service RegistryからOracle Enterprise Repositoryに移動するメタデータの同期

- 10.3.3 Oracle Enterprise Repository内のOracle Service Registryの交換されるメタデータの検索

- 10.3.4 Oracle Registry Repository Exchange Utilityのログ・ファイルの確認

- 10.3.5 既知の問題

- 10.3.5.1 Oracle Service Registryサービスの再同期

- 10.3.5.2 サービスのOracle Service Registryへの公開

- 10.3.5.3 不適切なバージョンのJavaの実行

11 プリスクリプティブな再利用の構成

- 11.1 概要

- 11.2 コンプライアンス・テンプレート・タイプの作成

- 11.3 コンプライアンス・テンプレートの作成

- 11.4 コンプライアンス・テンプレートのプロジェクトへの適用

- 11.5 コンプライアンス・テンプレートに関連付けられているアセット(規定のアセット)の使用

- 11.6 プロジェクト・コンプライアンス・レポートの実行

12 進行中のアセットの構成

- 12.1 概要

- 12.2 進行中のアセットの表示

- 12.3 進行中のアセットの有効化

- 12.3.1 デフォルトのアセット・ステータスの設定

- 12.4 進行中のアセットの無効化

- 12.5 IDEによる進行中のアセットの表示の有効化

13 使用状況の自動検出の構成

- 13.1 概要

- 13.2 SFIDの有効化

- 13.3 タイプへのSFID要素の追加

- 13.4 アセットへのSFIDの追加

- 13.4.1 SFIDファイルの更新

- 13.4.2 SFIDファイルの削除

- 13.5 SFIDツール・キット

- 13.5.1 インストールおよび構成

- 13.5.1.1 認識されないSFIDの収集の有効化

- 13.5.1.2 オブジェクト・モデル

- 13.5.1.3 サンプル・ディレクトリ・クローラの説明

- 13.6 SFIDマネージャ

- 13.6.1 SFIDマネージャの有効化

- 13.6.2 SFIDマネージャの使用

- 13.7 プログラムによるSFIDの計算

- 13.8 SFIDの制限事項

14 ポリシー管理の構成

- 14.1 概要

- 14.2 ポリシー管理機能のアクティブ化

- 14.3 ポリシー・タイプの作成

- 14.4 ポリシー・タイプへのポリシー・アサーション要素の追加

- 14.5 ポリシーの作成

- 14.6 適用対象アセット・ポリシー要素のタイプへの追加

- 14.7 アセットへのポリシーの適用

- 14.8 ポリシー・ステータスの表示

- 14.9 ポリシー・アサーションの検証

- 14.10 Oracle Enterprise Repositoryポリシー・レポートの実行

15 契約管理の構成

- 15.1 概要

- 15.1.1 前提条件

- 15.2 契約管理ソリューション・パックのインポート

- 15.3 サービス・プロバイダ向けの手順

- 15.3.1 契約の作成

- 15.3.2 契約の編集

- 15.3.3 リレーションシップの作成

- 15.3.3.1 使用条件

- 15.4 サービス・コンシューマ向けの手順

16 BI Publisherによるレポートの構成

- 16.1 Oracle Enterprise Repository事前構成BI Publisherコンテンツのデプロイ

- 16.1.1 Oracle Enterprise RepositoryによるBI Publisherの構成

- 16.2 セキュリティ・モデル

- 16.2.1 管理者ユーザー

- 16.2.2 OERユーザーおよびOER_REPORTSロール

- 16.2.3 レポート・フッターのローカル・タイム・ゾーンの設定

- 16.3 Oracle Enterprise Repository JDBCデータ・ソースの構成

- 16.4 BI Publisherサーバーの構成 - キャッシュ有効期限

- 16.5 レポートを有効化するためのOracle Enterprise Repositoryシステム設定の構成

17 システム設定の概要

- 17.1 システム設定へのアクセス

- 17.2 システム設定の検索

- 17.3 システム設定プロパティの有効化

- 17.4 データベースへの設定の移動

- 17.5 Oracle Enterprise Repositoryのシステム設定

- 17.5.1 機能設定

- 17.5.1.1 一般的なユーザー・インタフェース

- 17.5.1.2 検索

- 17.5.1.3 PDFを介したアセット詳細の出力

- 17.5.1.4 プロジェクトおよびナビゲータ

- 17.5.1.5 進行中のアセット

- 17.5.1.6 ポリシー管理

- 17.5.1.7 通知

- 17.5.1.8 アクセス制御

- 17.5.1.9 Software File Identification (SFID)

- 17.5.1.10 使用 - ダウンロード

- 17.5.1.11 カスタム・リンク

- 17.5.1.12 レポート

- 17.5.1.13 その他

- 17.5.2 サーバー設定

- 17.5.2.1 一般

- 17.5.2.2 サーバー・リソース

- 17.5.2.3 電子メール

- 17.5.2.4 アップロード領域

- 17.5.2.5 監査

- 17.5.2.6 キャッシュ

- 17.5.3 エンタープライズ認証設定

- 17.5.3.1 一般

- 17.5.3.2 認証トークン

- 17.5.3.3 パスワード設定

- 17.5.3.4 プラグイン・ログイン設定

- 17.5.3.5 LDAPおよびアクティブ・ディレクトリ設定

- 17.5.3.6 シングル・サインオン(SSO)設定

- 17.5.3.7 コンテナ・ログイン設定

- 17.5.3.8 Cookieログイン設定

- 17.5.3.9 ゲスト・ログイン設定

- 17.5.4 オープンAPI設定

- 17.5.4.1 オープンAPI

- 17.5.5 外部統合設定

- 17.5.5.1 UDDI

- 17.5.5.2 ファイル・ストア

- 17.5.5.3 Rational ClearCase

- 17.5.5.4 イベンティング

- 17.5.6 インポート/エクスポートおよびイントロスペクション設定

- 17.5.6.1 インポート/エクスポート

- 17.5.6.2 WSDLおよびXSD

- 17.6 既知の問題

A Oracle Enterprise Repositoryワークフローの構成

- A.1 Oracle Enterprise Repositoryワークフローの概要

- A.2 Oracle Enterprise Repository自動ワークフローの概要

- A.2.1 ソフトウェア・コンポーネント

- A.2.2 自動ワークフロー

- A.2.3 イベント管理ツール

- A.2.3.1 Webベースのプロセス・アドミニストレータ

- A.2.3.2 ログ・ビューア

- A.2.3.3 電子メール通知テンプレート

- A.2.3.4 ワークフロー構成ツール

- A.2.3.5 新規構成ファイルの生成

- A.2.3.6 既存の構成ファイルのリフレッシュ

- A.2.3.7 構成ファイルのパスワードの暗号化

- A.3 Oracle Enterprise RepositoryワークフローのOracle BPM 10.3へのインストール

- A.3.1 要件

- A.3.2 手順1: Oracle BPM 10.3.2のインストール

- A.3.3 手順2: Oracle Enterprise Repositoryワークフロー・インストーラの解凍

- A.3.4 手順3: build.propertiesファイルの構成

- A.3.5 手順4: setenvファイルの構成

- A.3.6 手順5: workflow.xmlファイルの生成(再生成)

- A.3.7 手順6: workflow.xmlファイルの編集

- A.3.8 手順7: workflow.xmlファイルの暗号化

- A.3.9 手順8: JDBC jarのコピー

- A.3.10 手順9: 権限の検証

- A.3.11 手順10: 設定スクリプトの実行

- A.3.12 手順11: 設定スクリプトの検証

- A.4 Oracle Enterprise Repositoryイベント・マネージャの構成

- A.4.1 Oracle Enterprise Repositoryイベント・マネージャとは

- A.4.2 イベント・マネージャの構成

- A.4.3 アセット・イベントのトリガー

- A.4.4 イベント・マネージャのシステム設定の構成

- A.4.4.1 イベント・マネージャの有効化

- A.4.4.2 オプションのイベント・マネージャ設定の構成

- A.4.5 サブスクリプション・マネージャの構成

- A.4.5.1 Webサービス・エンドポイントの構成

- A.4.5.2 イベントをフィルタ処理するための式の設定

- A.4.6イベント・マネージャ・イベントのロギングの構成

- A.5 Oracle Business Process Managementプロセスの管理

- A.5.1 概要

- A.5.2 Oracle Business Process Management Webアプリケーションの管理

- A.5.2.1 Oracle Business Process Management管理センターの起動

- A.5.2.2 Oracle Business Process Managementプロセス・エンジンの起動

- A.5.2.3 Oracle Business Process Managementの参加者の定義

- A.5.3 Oracle Business Process Management自動ワークフロー・エンジンのチューニング

- A.5.3.1 拡張プロパティ

- A.5.3.2 データベース・ランタイム・プロパティ

- A.5.3.3 メモリーおよび実行スレッド・プロパティ

- A.5.4 フェイルオーバー用のスタンドアロン・プロセス・エンジンの構成

- A.5.5 Oracle Business Process Managementログ・ビューアの使用

- A.5.5.1 Oracle Enterprise Repositoryフローのイベント・ログ・メッセージのフィルタ処理

- A.6 自動ワークフローの構成

- A.6.1 自動ワークフローの概要

- A.6.2 ワークフロー構成ファイルの作成およびカスタマイズ

- A.6.2.1 Oracle Enterprise Repository接続およびレジストラの定義

- A.6.2.2 レジストラ・ユーザーのパスワードの暗号化

- A.6.3 アセット・イベントのフローへのワイヤリング

- A.6.4 自動アセット登録フロー

- A.6.4.1 コミュニティ・フローの構成

- A.6.4.2 自動受入れおよび自動登録フローの構成

- A.6.5 複数層自動割当てフロー

- A.6.5.1 ユースケース

- A.6.5.2 タブ承認のための<alerid>の使用

- A.6.5.3 複数層タブ承認のためのコミュニティの設定

- A.6.5.4 複数層タブ承認のためのアセット・タイプの設定

- A.6.6 メタデータ変更フロー

- A.6.6.1 ユースケース

- A.6.6.2 メタデータ変更フローの構成

- A.6.7 時間ベースのエスカレーション・フロー

- A.6.7.1 未発行のアセットの追跡

- A.6.7.2 未受入れのアセットの追跡

- A.6.7.3 未承認のアセットの追跡

- A.6.7.4 未登録のアセットの追跡

- A.6.8 有効期限の検証フロー

- A.6.8.1 アセット有効期限の警告の通知

- A.6.8.2 有効期限後のアセットの登録の解除

- A.6.8.3 有効期限後の非アクティブ化

- A.6.8.4 有効期限後のアセットの削除

- A.6.9 電子メール通知テンプレートのカスタマイズ

- A.6.10 電子メール通知のユースケース

- A.6.11 既知の問題

- A.7 Oracle Enterprise Repository用のJMSサーバーの構成

- A.7.1 イベント・マネージャ用のJMSの概要

- A.7.2 外部JMSサーバー用の接続プロパティの構成

- A.7.2.1 外部JMSサーバーの有効化および構成

- A.7.2.2 JMSメッセージ・ヘッダーのプロパティの構成

- A.7.2.3 その他のJMSプロパティ

- A.7.2.4 外部JMS Jarファイルの構成

- A.7.3 データベースを使用するための組込みActiveMQ JMSサーバーの構成

- A.7.3.1 Webサービス・エンドポイント用のJMS永続サブスクライバの構成

- A.7.4 Oracle Enterprise Repositoryクラスタ内のJMSサーバーの構成

- A.7.4.1 JMSクラスタリング・モードの有効化

- A.7.4.2 クラスタリング用の組込みJMSサーバーの構成

- A.7.4.3 クラスタリング用の外部JMSサーバーの構成

- A.7.5 WebSphere 6.1.0.5でのJMSプロバイダの構成

- A.8 イベントのモニタリングおよび管理

- A.8.1 概要

- A.8.2 イベントのモニタリング

- A.8.2.1 前提条件

- A.8.2.2 使用方法

- A.8.3 格納されたイベントのクリーンアップ

- A.8.3.1 前提条件

- A.8.3.2 使用方法

- A.8.3.3 イベントのクリーンアップの例

- A.8.4 ワークフローの構成

- A.8.4.1 ワークフロー構成ファイルのリフレッシュ

- A.8.5 パスワードの暗号化

- A.9 Webサービス・エンドポイントのイベント・マネージャの拡張

- A.9.1 概要

- A.9.2 Webサービス・エンドポイントの開発

- A.9.3 Webサービスの操作

- A.9.3.1 使用可能なWebサービスの操作

- A.9.3.2 Webサービスの操作の選択

- A.9.3.3 通知サービス・プラグインの開発

- A.9.4 互換性のない契約を持つエンドポイントの開発

- A.9.5 OBPM 11gでのカスタム・ワークフローの作成

- A.10 OERワークフローの操作

- A.10.1 自動ワークフローを使用した自動アセット登録

- A.10.2 発行の受入れ

- A.10.3 アセットの登録

- A.10.4 タブ承認プロセスの完了

- A.10.5 監査ログ、レビューおよびノート

- A.11 自動ワークフローを使用する前に

- A.11.1 Oracle Enterprise Repositoryイベント・マネージャの構成の手順

- A.11.2 ユースケース

- A.11.3 Oracle Business Process Managementプロセス・エンジンの構成および実行手順

- A.11.3.1 ユースケース

- A.11.3.2 発行イベントを処理するための自動ワークフローの構成

- A.11.4 アセット発行イベントのトリガー

- A.12 「コミュニティ・フロー」ユースケース

B その他の構成

- B.1 Oracle Enterprise Repositoryヘルプ・システムのカスタマイズ

- B.1.1 ヘルプ・ファイルのダウンロード

- B.1.2 カスタム・ヘルプURLプロパティの構成

- B.2 発行アップロード・ディレクトリの作成および構成

- B.2.1 アセット・アップロードのシステム設定

- B.2.2 アーティファクト・ストアの作成および構成

- B.2.3 新しいアーティファクト・ストアの選択

- B.3 アセット監査ログの作成

- B.4 プラグインおよびアダプタ

- B.5 Oracle Enterprise Repositoryデフォルト・アーティファクト・ストアの統合

- B.6 PDFへのエクスポート機能で使用されるXSLTテンプレートの管理

- B.6.1 Oracle Enterprise Repositoryで使用されるXSL:FOテンプレートの管理

- B.7 UTF-8/Unicode文字のサポート

- B.8 アセット・タイプのインベントリ

- B.8.1 ベース・データ・パック

- B.8.2 ハーベスタ・ソリューション・パック

- B.9 データ・ルール

- B.9.1 アセット・タイプ要素のフラグ

- B.9.2 過去に収集されたデータ

- B.9.3 要素の格納

- B.9.4 アセット・タイプに必須となる要素

- B.9.5 機能に関連付けられた要素

- B.9.6 アセット・タイプ・カタログの説明

- B.10 ハーベスタのプロパティ

索引

はじめに

『Oracle Fusion Middleware Oracle Enterprise Repository構成ガイド』には、ガバナンス・イニシアチブをサポートするOracle Enterprise Repositoryの各種機能を構成するために必要な情報が記載されています。

このガイドでは、部門、ユーザー、プロジェクト、ロール、基本アクセス設定などの設定に関する基本構成情報について説明します。また、外部認証のためのOracle Enterprise Repositoryの構成、ロールベースのアクセス制御の詳細設定、設計時および実行時環境からの収集Oracle Enterprise Repositoryの構成、Oracle Enterprise Repositoryの自動ワークフローおよび通知の調整、Oracle Service Registryとメタデータを交換するためのOracle Enterprise Repositoryの構成、プリスクリプティブな再利用、進行中のアセット、使用状況の自動検出、ポリシー管理など、詳細なトピックについても説明します。

また、このガイドでは、Oracle Enterprise Repositoryのすべてのシステム設定の概要、および組織で使用する設定を記録できるワークブックについても説明します。

対象読者

このドキュメントは、ガバナンス・イニシアチブを実行するユーザーを対象としています。これらのユーザーが、ガバナンスの実務を決定し、その実務をOracle Enterprise Repositoryで提供される機能にマップします。

ドキュメントのアクセシビリティについて

Oracleのアクセシビリティについての詳細情報は、Oracle Accessibility ProgramのWebサイト(http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc)を参照してください。

Oracle Supportへのアクセス

Oracleサポート・サービスでは、My Oracle Supportを通して電子支援サービスを提供しています。詳細情報は(http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info) か、聴覚に障害のあるお客様は (http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs)を参照してください。

関連ドキュメント

詳細は、Oracle Enterprise Repository 11gリリース1ドキュメント・セットの次のドキュメントを参照してください。

- OTNでのOracle Enterprise Repository - Oracle Technology Network (OTN)でのOracle Enterprise Repositoryのホームページは、次のとおりです。
http://www.oracle.com/technetwork/middleware/repository/overview/index-100687.html

- SOAブログ - 次の場所にある最新のSOAブログを常にチェックしてください。
http://blogs.oracle.com/governance

表記規則

このマニュアルでは次の表記規則を使用します。

規則

意味

太字

太字は、操作に関連するGraphical User Interface要素、または本文中で定義されている用語および用語集に記載されている用語を示します。

イタリック体

イタリックは、ユーザーが特定の値を指定するプレースホルダ変数を示します。

固定幅フォント

固定幅フォントは、段落内のコマンド、URL、サンプル内のコード、画面に表示されるテキスト、または入力するテキストを示します。

リリース11.1.1.7用のこのガイドでの新しい情報

このガイドは、リリース11.1.1.7用に更新されました。次の表に、追加または変更された項を示します。

既知の問題のリスト(リリース・ノート)は、「Known Issues for Oracle SOA Products and Oracle AIA Foundation Pack」(http://www.oracle.com/technetwork/middleware/docs/soa-aiafp-knownissuesindex-364630.html)を参照してください。

内容

変更内容

第1章

1.8項

「タイプ」および「タイプの表示」の項を追加

第6章

6.2.4.2項

「登録ステータスおよびカテゴリ分け」を追加

6.2.6.1項

「Clusterクラスタ内のSOA Suiteコンポジットの収集」を追加

6.3.4項

「Oracle Service Bus 11gアセットの収集」を追加

第9章

「Oracle Enterprise Repositoryエクスプレス・ワークフローの構成」の章と差し替え。「Oracle Enterprise Repository Workflowの構成」を付録Aに移動。

第15章

「契約管理ソリューション・パック」の章を追加

第16章

すべての項

OER/BIレポートの10gサポート情報を削除

16.1.1項

BI Publisher 11gサポートの項を追加Oracle Enterprise Repository 11.1.1.xによるBI Publisher 11gの構成

付録A

「Oracle Enterprise Repository Workflowの構成」の付録を追加。

1 基本構成

この章では、Oracle Enterprise Repositoryの構成方法の基本を、用語およびOracle Enterprise Repository管理者の一般的なタスクを紹介しながら説明します。

この章には、次のセクションがあります。

- 1.1項「概要」

- 1.2項「部門」

- 1.3項「ユーザー」

- 1.4項「プロジェクト」

- 1.5項「ロール」

- 1.6項「アクセス設定」

- 1.7項「セッション」

- 1.8項「タイプ」

1.1 概要

Oracle Enterprise Repositoryでは、すべてのユーザーにロールが割り当てられます。ロールは各ユーザーがOracle Enterprise Repositoryで実行できる機能を定義します。ユーザーがOracle Enterprise Repositoryでアセットに関連付けられたファイルにアクセスするには、そのユーザーがプロジェクトに割り当てられている必要があります。

プロジェクトは、Oracle Enterprise Repositoryのメトリックを収集する主な手段です。Oracle Enterprise Repositoryは、プロジェクトで作成されるアセットと、プロジェクトで使用されるアセットを追跡します。Oracle Enterprise Repositoryユーザーは、プロジェクトに割り当てられます。ユーザーが新しいアセットを発行すると、プロジェクトの作成が求められます。同様に、ユーザーがアセットを再利用する場合、アセットが再利用されるプロジェクトが表示されます。ユーザーおよびプロジェクトの両方が部門に割り当てられます。組織が特定の部門で再利用可能なアセットの作成および使用を追跡できるため、これはレポートの観点からは便利です。

図1-1は、ユーザー、ロール、プロジェクト、アセット、および部門のリレーションシップを説明しています。

図1-1 リレーションシップ図

1.2 部門

ユーザーおよびプロジェクトを作成する前に部門を設定または作成する必要があります。この項には次のトピックが含まれます:

- 1.2.1項「新規部門の作成」

- 1.2.2項「部門情報の編集」

1.2.1 新規部門の作成

新規部門を作成するには、Oracle Enterprise Repositoryの「管理」画面で次の手順を実行します。

1. 左側のパネルで「部門」をクリックします。

2. 「新規作成」をクリックします。「新規部門の作成」ダイアログが表示されます。

3. 各テキスト・ボックスに適切な情報を入力します。

図1-2 「新規部門の作成」ダイアログ

4. 終了したら、「保存」をクリックします。

1.2.2 部門情報の編集

部門情報を編集するには、Oracle Enterprise Repositoryの「管理」画面で次の手順を実行します。

1. 左側のパネルで「部門」をクリックします。

2. すべてをリストをクリックするか、特定の部門を検索します。

3. 右側のパネルのリストから編集する部門を選択します。部門の詳細が表示されます。

4. 部門の詳細で「編集」をクリックします。「部門の編集」ダイアログが表示されます。

5. 必要に応じてテキスト・ボックスを更新します。

6. 終了したら、「保存」をクリックします。

1.3 ユーザー

この節では、以下のトピックについて説明します。

- 1.3.1項「新規ユーザーの作成」

- 1.3.2項「ユーザー情報の表示」

- 1.3.3項「ユーザー検索」

- 1.3.4項「ユーザーのクローニング」

- 1.3.5項「ユーザー情報の編集」

1.3.1 新規ユーザーの作成

この手順は、Oracle Enterprise Repositoryの「管理」画面で実行します。

1. 左側のパネルで「ユーザー」をクリックします。

2. 「ユーザー」セクションで「新規作成」をクリックします。「新規ユーザーの作成」ダイアログが表示されます。

3. 図1-3に示すように、「概要」セクションの各テキスト・ボックスに適切な情報を入力します。

図1-3 「概要」セクション

4. 「ステータス」リストで「アクティブ」を選択します。

5. 図1-4に示すように、「ロール」セクションで、「>>」ボタンおよび「<<」ボタンを使用して「使用可能なロール」列から「選択したロール」列にアイテムを移動することによって、新規ユーザーにロールを割り当てます。(「ユーザー」ロールはすべての新規ユーザーのデフォルト・ロールです。)

図1-4 「ロール」セクション

6. 図1-5に示すように、「部門」セクションで、「>>」ボタンおよび「<<」ボタンを使用して「使用可能な部門」列から「選択した部門」列にアイテムを移動することによって、新規ユーザーに部門を割り当てます。

図1-5 「部門」セクション

7. 終了したら、「保存」をクリックします。

1.3.2 ユーザー情報の表示

この手順は、Oracle Enterprise Repositoryの「管理」画面で実行します。

1. 「ユーザー」セクションで、「検索」またはすべてをリストを使用して、表示するユーザーを探します。
図1-6に示すように、ユーザーのリストがメイン・ペインに表示されます。

図1-6 ユーザーのリスト

2. リストからユーザーを選択します。ユーザーの情報が下部ペインに表示されます。

3. 検索結果の非表示と表示ボタンをクリックして、ユーザーの詳細を展開し、メイン・ペインに入力します。

4. 図1-6の最初のボタンをクリックして、ユーザーの詳細のタブ・ビューを切り替えます。

図1-7 「ユーザーの詳細」ページ

5. 図1-7の最初のボタンをクリックして、ユーザーの詳細の標準ビューに戻ります。

6. 図1-7の2番目および3番目のボタンをクリックして、ユーザーのリストをスクロールします。

1.3.3 ユーザー検索

この手順は、Oracle Enterprise Repositoryの「管理」画面で実行します。

1. 「名前」テキスト・ボックスに適切なテキストを入力します。

2. 「部門」、「ロール」、および「ステータス」の各リストを必要に応じて使用して、検索対象を絞り込みます。

3. 「検索」ボタンをクリックします。検索結果がメイン・ペインの上部フレームにリストされます。

1.3.4 ユーザーのクローニング

ユーザーのクローニングを使用すると、管理者はユーザー・アカウントを迅速に複製できます。

この手順は、Oracle Enterprise Repositoryの「管理」画面で実行します。

1. 「ユーザー」セクションで、「検索」または「すべてをリスト」を使用して、クローニングするユーザーを探します。

2. ユーザーの詳細で、「クローン」ボタンをクリックします。
「ユーザーのクローニング」ダイアログが表示されます。「概要」セクションは空白ですが、「ロール」セクションおよび「部門」セクションには、クローニング元のユーザーの情報が複製されています。

3. 「概要」セクションの各テキスト・ボックスに適切な情報を入力します。

4. 必要に応じて、「>>」ボタンおよび「<<」ボタンを使用してアイテムを「使用可能」列と「選択済」列の間で移動することによって、「ロール」セクションおよび「部門」セクションの情報を編集します。

5. 終了したら、「保存」をクリックします。

1.3.5 ユーザー情報の編集

この手順は、Oracle Enterprise Repositoryの「管理」画面で実行します。

1. 「ユーザー」セクションで、「検索」または「すべてをリスト」を使用して、編集するユーザーを探します。ユーザーのリストがメイン・ペインに表示されます。

2. リストからユーザーを選択します。ユーザーの情報が下部ペインに表示されます。

3. ユーザーの詳細で、「編集」ボタンをクリックします。「ユーザーの編集」ダイアログが表示されます(「新規ユーザーの作成」ダイアログおよび「ユーザーのクローニング」ダイアログと同じ)。

4. 「概要」セクション、「ロール」セクションおよび「部門」セクションで、必要に応じて変更を行います。

5. 終了したら、「保存」をクリックします。

1.4 プロジェクト

プロジェクトは、Oracle Enterprise Repositoryのメトリックを収集する主な手段です。Oracle Enterprise Repositoryは、プロジェクトで作成されるアセットと、プロジェクトで使用されるアセットを追跡します。Oracle Enterprise Repositoryユーザーは、プロジェクトに割り当てられます。ユーザーが新しいアセットを発行すると、プロジェクトの作成が求められます。同様に、ユーザーがアセットを再利用する場合、アセットが再利用されるプロジェクトが表示されます。これにより、Oracle Enterprise Repositoryは、プロジェクトごとの再利用節約に関するレポートを生成できます。また、Oracle Enterprise Repositoryは、アセット作成チームによって設けられた節約に関するレポートを作成できます。プロジェクトも階層状になっているため、組織は、たとえば多くのプロジェクトが生じる可能性のあるプログラムを設定できます。

プロジェクトはより高度なガバナンス・プラクティスを適用および強制できる概念です。Oracle Enterprise Repositoryコンプライアンス・テンプレート(通常は、アーキテクチャ設計図やプロジェクト・プロファイルの形式を取る)は、プロジェクトに適用できます。

Oracle Enterprise Repositoryの「プロジェクト」ページでは、プロジェクトを作成および管理するためのツールにアクセスできます。

- 第1.4.1項「プロジェクト詳細の表示」

- 第1.4.2項「プロジェクトの作成」

- 1.4.3項「プロジェクトの編集」

- 1.4.4項「ユーザー/使用方法の再割当て」

- 第1.4.5項「プロジェクトの検索」

- 1.4.6項「プロジェクトのクローズ」

- 1.4.7項「リレーションシップのプロジェクトへの追加」

1.4.1 プロジェクト詳細の表示

プロジェクト情報は、一連のポートレットまたはタブとして表示できます。

概要

プロジェクトの説明などがあり、割り当てられた部署、開始日、設定時間およびプロジェクト・ステータスを示します。

コンプライアンス・テンプレート

プロジェクトに割り当てられたコンプライアンス・テンプレートを表示します。

図1-8 コンプライアンス・テンプレート・タブ

使用されるアセット

プロジェクトで使用されている(または使用が検討されている)アセットがリストされます。

図1-9 「使用されるアセット」タブ

リストされているアセットの横にある「ズーム」アイコンをクリックして、そのレポートされたアセット価値を表示します。

- プロジェクト・メンバーは、アセット使用の詳細を表示できます。

- プロジェクト・リーダーは、レポートされたアセット価値を表示および編集できます。

図1-10 アセットのレポートされたアセット価値

レポートされたアセット価値は、そのプロジェクトでアセットを再利用することによる節約時間を表します。この値は、予測値、コンシューマ値、またはプロジェクト・リーダーによって決められる完全に新しい値のいずれかから導出されます。この値を設定できるのはプロジェクト・リーダーのみです。

作成済アセット

プロジェクトで作成されたすべてのアセットをリストします。

図1-11 作成済アセット・タブ

ユーザー

プロジェクトに関連付けられたすべてのユーザーと、プロジェクトでの各ユーザーのロール(リーダーおよびメンバー)をリストします。プロジェクト・リーダーは、レポートされたアセット価値の値を、プロジェクトで使用されるアセットに割り当てることができます。

図1-12 「ユーザー」タブ

関連プロジェクト

有効な場合、関連プロジェクトをリストし、親および子関係でのリレーションシップを定義します。

1.4.2 プロジェクトの作成

この手順は、「プロジェクト」画面で実行されます。

1. 左側のパネルで「新規作成」をクリックします。「新規プロジェクトの作成」ダイアログが表示されます。

図1-13 Create New Project

2. 「名前」テキスト・ボックス、「説明」テキスト・ボックスおよび推定開発時間テキスト・ボックスに適切な情報を入力します。

3. 「...」ボタンをクリックしてカレンダーを開き、「開始日」を選択します。

4. 「部門」リストで部門を選択します。

5. 「ステータス」リストで適切なステータスを選択します。「オープン」または「クローズ」のどちらかを選択できます。ステータスが「オープン」の場合、プロジェクトはまだ変更される可能性があります。ステータスが「クローズ」の場合、プロジェクトは閉じており、以降変更されることはありません。

6. 必要な場合は、新規ユーザーへの自動割当てを選択します。

7. 「ユーザー」セクションで「編集」をクリックします。図1-14に示すように、「ユーザーの追加/削除」ダイアログが表示されます。

図1-14 「ユーザーの追加/削除」ダイアログ

8. 「検索結果」セクションで、「検索」またはすべてのユーザーをリストを使用して、ユーザーのリストを表示します。「部門」リストを使用して検索結果をフィルタ処理します。

9. 「>>」アイコンおよび「<<」アイコンを使用して、「検索結果」セクション、プロジェクト・リーダー・セクション、および「選択したユーザー」セクション間でユーザーを移動します。

10. 「OK」をクリックします。割り当てられたプロジェクト・リーダーおよびプロジェクト・メンバーが、「新規プロジェクトの作成」ダイアログが表示されると「ユーザー」セクションに表示されます。

図1-15 「ユーザー」ダイアログ

11. 「保存」をクリックします。「新規プロジェクトの作成」ダイアログが閉じ新しいプロジェクトの詳細が「プロジェクト」ページに表示されます。

図1-16 「概要」タブ

1.4.3 プロジェクトの編集

この手順は、「プロジェクト」ページで実行されます。

1. 「検索」または他の方法で、編集するプロジェクトを探します。

2. プロジェクトの詳細で「編集」をクリックします。

3. 必要に応じてプロジェクト情報を編集します。(1.4.2項「プロジェクトの作成」を参照してください。)

1.4.4 ユーザー/使用方法の再割当て

この手順は、「プロジェクト」ページで実行されます。

1. 「ユーザー」タブを選択します。

図1-17 「ユーザー」タブ

2. ユーザー/使用方法の再割当てをクリックします。「再割当」ダイアログが表示されます。

3. オプションを使用して適切なアクションを選択します。

4. 新規プロジェクトの選択をクリックします。「プロジェクトの検索」ダイアログが表示されます。

図1-18 プロジェクトの検索

5. 「検索」または「すべてのプロジェクトをリスト」を使用して、プロジェクトのリストを表示します。

6. ユーザーまたは使用方法(あるいはその両方)の再割当て先となるプロジェクトを選択します。

7. 「OK」をクリックします。

8. 「次」をクリックします。「再割当てユーザーの選択」ダイアログが表示されます。

図1-19 ユーザーの再割当て

9. 「>>」アイコンおよび「<<」アイコンを使用して、ユーザーをプロジェクト・リーダーまたはプロジェクト・メンバー(あるいはその両方)に割り当てます。

10. 「次」をクリックします。確認メッセージが表示されます。

11. 「完了」をクリックします。

1.4.5 プロジェクトの検索

この手順は、「プロジェクト」ページで実行されます。

1. 「名前」テキスト・ボックスにキーワードまたは検索語を入力します。

2. 必要に応じて、「部門」リストと「ステータス」リストを使用して、検索をフィルタ処理します。

3. 「検索」をクリックします。検索結果がメイン・ペインにリストされます。

1.4.6 プロジェクトのクローズ

この手順は、「プロジェクト」ページで実行されます。

1. 閉じるプロジェクトを選択します。プロジェクトの詳細が下部のフレームに表示されます。

2. 「編集」をクリックします。「プロジェクトの編集」ダイアログが表示されます。

3. 図1-20に示すように、「プロジェクトの編集」ダイアログの「概要」セクションで、「ステータス」リストから「クローズ」を選択します。

図1-20 「プロジェクトの編集」ダイアログ

4. 「保存」をクリックします。プロジェクトがアセットを使用している場合は、図1-21のような使用ステータス更新ダイアログが表示されます。使用されているアセットがこのダイアログにリストされ、それぞれに対して「ステータス」リストが表示されます。

図1-21 ステータスの更新

5. 必要に応じて、使用されている各アセットのステータスを更新します。

注意:

プロジェクト・リーダーに割り当てられた固有のロールおよび権限に応じて、プロジェクトで使用されている特定のアセットがリストに表示されない場合があります。このような場合には、ATTENTIONメッセージが使用ステータス更新ダイアログに表示されます。注意: ATTENTIONメッセージの下にリストされているプロジェクト・メンバーのみがアセットを拒否できます。拒否しない場合は、「OK」を使用ステータス更新ダイアログでクリックし、表示されていないアセットのステータスを「デプロイ済」に設定します。

6. 使用ステータス更新ポップアップが閉じると、ビューは「プロジェクトの編集」ダイアログに戻ります。

7. 「保存」をクリックします。プロジェクトが閉じます。

1.4.7 リレーションシップのプロジェクトへの追加

プロジェクト・リレーションシップ機能を使用すると、プロジェクト間の関連を親子関係を基準としてマッピングできます。

この手順は、「プロジェクト」ページで実行されます。

1. 図1-22に示すように、「プロジェクト」ページですべてをリストをクリックします。

図1-22 「プロジェクト」ページ

図1-23のようなプロジェクトのリストがメイン・ペインの最上部に表示されます。

図1-23 プロジェクトのリスト

2. 編集するプロジェクトを選択します。図1-24のようなプロジェクトの詳細ペインがメイン・ペインの下部に表示されます。

図1-24 プロジェクトの詳細ペイン

3. プロジェクトの詳細ペインで「編集」をクリックします。図1-25のような「プロジェクトの編集」ダイアログが表示されます。

図1-25 「プロジェクトの編集」ダイアログ

4. 「プロジェクトの編集」ダイアログの関連プロジェクト・セクションで、「編集」をクリックします。図1-26のような「プロジェクトの追加/削除」ダイアログが表示されます。

図1-26 プロジェクトの追加/削除

5. すべてのプロジェクトをリストをクリックします。使用可能なプロジェクト・ウィンドウにリストが表示されます。

6. 追加するプロジェクトを選択し、「>>」アイコンを使用して、親プロジェクトまたは子プロジェクトのカテゴリ・ウィンドウに適宜移動します。選択したウィンドウにプロジェクトが表示されます。

7. 「OK」をクリックして、「プロジェクトの追加/削除」ダイアログを閉じます。図1-27に示すように、「プロジェクトの編集」ダイアログの関連プロジェクト・セクションに、新しいプロジェクト・リレーションシップが対応するリストとして表示されます。

図1-27 関連プロジェクト・セクション

8. 「OK」をクリックして「プロジェクトの編集」ダイアログを閉じます。図1-28に示すように、「アセット詳細」の関連プロジェクト・セクションに、新しいプロジェクト・リレーションシップが表示されます。

図1-28 関連プロジェクト・セクション

プロジェクト・リレーションシップはOracle Enterprise Repository Navigatorにも表示されます。

1.5 ロール

管理者は「Oracle Enterprise Repository」メニュー・バーで「ロール」リンクをクリックして、組織の各種機能にアクセスするロールを設定できます。Oracle Enterprise Repositoryのアクセス設定は各ロールに対して確立され、各ユーザーには組織内の職務に応じて特定のロールが割り当てられます。

管理ロールを割り当てられたユーザーは、Oracle Enterprise Repositoryのすべての機能に制限なしでアクセスできます。デフォルトでは、新規インストールまたは前のバージョンからの移行時に、管理者として識別されたユーザー・アカウントに管理ロールが割り当てられ、そのユーザー・アカウントで初期インストールおよび構成を行います。管理者権限の割当てはオリジナルのOracle Enterprise Repository*ユーザー・アカウントのみに制限し、アカウントを追加しないことを強くお薦めします。Oracle Enterprise Repositoryで確立されている各種のデフォルト・ロールは様々な権限を提供しており、すべてのOracle Enterprise Repositoryユーザーの職務および責務に対応します。これらのロールは、組織の特定のニーズに応じてカスタマイズできます。

- 第1.5.1項「ユーザー・ロールの説明」

- 1.5.2項「新規ロールの作成」

- 第1.5.3項「ロールの編集」

- 1.5.4項「ロールの削除」

1.5.1 ユーザー・ロールの説明

次に、Oracle Enterprise Repositoryに付属の各種デフォルト・ロールを列挙します。「管理」タブにアクセスできるユーザーは、組織のニーズに応じてロール名を変更できます。これらのロールに対して付与される権限は、「アクセス設定」セクションで変更できます。

- ユーザー
Oracle Enterprise Repositoryのユーザー名とパスワードを持つ人は誰でもユーザーと見なされます。このロールは、ユーザーの作成時、新しいユーザーのデフォルト・ロールとして割り当てることができます。すべてのOracle Enterprise Repositoryユーザーは、次の操作を行うことができます。

- 企業の再利用イニシアチブに関するニュースの表示

- アセットの検索、評価、および使用/ダウンロード

- プロジェクトの表示

- レポートの生成

- レジストラへのアセットの発行

- アクセス管理者
アクセス管理者は、すべてのOracle Enterprise Repositoryユーザーを作成し、そのユーザーに権限を割り当てます。アクセス管理者は、「管理」タブの機能に精通している必要があります。アクセス管理者は、通常、次の操作を行うことができます。

- ユーザーと権限の作成、表示および編集

- レポートの生成

- 上級発行者
上級発行者ロールは、通常、アセットのビルダーおよびハーベスタに割り当てられます。アセットのビルダーは、アセットの内容ベースの構築に焦点を当てます。ビルダーは、組織全体のアセットのニーズと個々のプロジェクトのニーズに対応します。ハーベスタは将来のアセット再利用のために導入後のプロジェクトを検証します。上級発行者は、通常、次の操作を行うことができます。

- アセットの検索、評価、および使用/ダウンロード

- プロジェクトの表示

- レポートの生成

- レジストラへのアセットの発行

- アセット登録前のアセット・メタデータの編集

- レジストラ
レジストラは、任意のアセットの受入れまたは拒否を担当します。対処する機能に応じて、複数の人がリポジトリ・レジストラとしての役割を果たす場合があります。レジストラは、通常、次の操作を行うことができます。

- アセットの検索、評価、および使用/ダウンロード

- プロジェクトの表示

- レポートの生成

- レジストラへのアセットの発行

- アセット登録前のアセット・メタデータの編集

- 登録プロセスのアセットの受入れ

- タブの承認

- アセットの登録

- アクセス設定の編集

- レジストラ管理者
レジストラ管理者は、タイプ・マネージャを使用して、Oracle Enterprise Repository内のタイプを確立できます。レジストラ管理者は、通常、次の操作を行うことができます。

- アセットの検索、評価、および使用/ダウンロード

- プロジェクトの表示

- レポートの生成

- レジストラへのアセットの発行

- アセット登録前のアセット・メタデータの編集

- 登録プロセスのアセットの受入れ

- タブの承認

- アセットの登録

- アクセス設定の編集

- アーティファクト・ストアおよびタイプの編集

- プロジェクト管理者
Oracle Enterprise Repositoryは、アセットの使用をプロジェクト・レベルで追跡して、メンテナンスの目的で履歴を維持します。プロジェクト管理者はプロジェクトを作成し、「プロジェクト」タブを使用してユーザーをプロジェクトに割り当てます。プロジェクト管理者は、プロジェクトのクローズ、デプロイ済アセットの指定、プロジェクトで使用されたアセットの予測価値とコンシューマから報告されたアセット価値のレビュー、検証、および必要に応じたオーバーライドを、プロジェクト報告のためのアセット値ユーザー・インタフェースを使用して行うことができます。プロジェクト管理者は、通常、次の操作を行うことができます。

- プロジェクトの作成、編集および表示

- レポートの生成

- システム管理者
システム管理者は、場合によって、インストールやインストール後の構成といった使用目的でOracle Enterprise Repositoryを構成します。システム管理者は、通常、次の操作を行うことができます。

- システム設定の有効化および編集

- レポートの生成

(システム管理者ロールは一般ユーザーには割り当てないようにします。)

1.5.2 新規ロールの作成

この手順は、Oracle Enterprise Repositoryの「管理」画面で実行します。

1. 左側のパネルで「ロール」をクリックします。図1-29のような「ロール」セクションが表示されます。

図1-29 「ロール」セクション

2. 「新規作成」をクリックします。図1-30のような「新しいロールの作成」ダイアログが表示されます。

図1-30 「新しいロールの作成」ダイアログ

3. 図1-30の「概要」セクションで、テキスト・フィールドにロール名および説明を入力します。

4. 必要な場合は、新規ユーザーへの自動割当てボックスを選択します。

5. 「ユーザー」セクションで「ユーザーの編集」をクリックします。図1-31のような「新規ユーザーの追加」ダイアログが表示されます。

図1-31 「新規ユーザーの追加」ダイアログ

6. 「検索」を使用するか、すべてをリストをクリックしてユーザーを探します。

7. 「>>」ボタンおよび「<<」ボタンを使用して、「使用可能なユーザー」列と「選択したユーザー」列の間でユーザーを移動します。

8. 終了したら、「保存」をクリックします。

アクセス設定をロールに追加するには、1.6.1項「ロールへの権限の付与」を参照してください。

1.5.3 ロールの編集

この手順は、Oracle Enterprise Repositoryの「管理」画面で実行します。

1. 左側のパネルで「ロール」をクリックします。図1-32に示すように、ロールのリストがメイン・ペインに表示されます。

図1-32 ロールのリスト

2. 「検索」を使用するか、リストを参照して、編集するロールを探します。

3. ロールをクリックすると、そのロールの情報が下部ペインに表示されます。

4. ロールの詳細(下部のフレーム)で、「編集」ボタンをクリックします。図1-33のような「ロールの編集」ダイアログが表示されます。

図1-33 「ロールの編集: ユーザー」ダイアログ

5. 終了したら、「保存」をクリックします。

1.5.4 ロールの削除

この手順は、Oracle Enterprise Repositoryの「管理」画面で実行します。

(削除権限が必要です。「アクセス設定」を参照してください。)

1. 左側のパネルで「ロール」をクリックします。ロールのリストがメイン・ペインに表示されます。

2. 「検索」を使用するか、リストを参照して、削除するロールを探します。

3. オプション1:

- 上部フレームのリストで、削除するロールの横のボックスを選択します。

- 「削除」をクリックします。

4. オプション2:

- 上部ペインのリストでロールを選択して、下部ペインにその情報を表示します。

- ロールの詳細(下部フレーム)で、「削除」ボタンをクリックします。

5. 「削除の確認」で「OK」をクリックします。

注意:

削除されたロールは「アクセス設定」に表示されなくなります。

1.6 アクセス設定

管理者はアクセス設定を使用して、各ロールに権限を割り当てることができます。アクセス設定はロールの職務および責務を識別し、Oracle Enterprise Repositoryにおけるアセットおよびアセット管理機能への各ロールのアクセス・レベルを決定します。

システム・セーフガードにより、管理者自身が後でアクセス設定にアクセスできなくなるような、不注意による権限の変更を回避できます。

- 基本アクセス設定(BAS)
ユーザーに割り当てられるロールに基づいて、Oracle Enterprise Repositoryにおけるアセットへのアクセスを全面的に制御します。アセット・エディタやタイプ・マネージャなどのOracle Enterprise Repositoryツールへのアクセスも同様に制御されます。基本アクセス設定では、システム全体へのアクセスが確立されます。たとえば、アセットの表示権限はすべてのアセットに適用されます。アセットの使用/ダウンロード権限についても同様です。OERの多くのアクションは監査証跡を残すようになっているため、プロジェクト数が少ない場合、および内部ユーザーの場合はBASで十分です。

- カスタム・アクセス設定(CAS)
Oracle Enterprise Repositoryにおける特定のアセットまたはアセット・グループへのアクセスを、特定のユーザー・ロールのみに制限する、詳細なロールベースのアクセス制御を確立します。

- 1.6.1項「ロールへの権限の付与」

- 1.6.2項「権限の編集」

- 1.6.3項「ユーザー権限の検証」

- 1.6.4項「セキュリティに関する考慮事項」

1.6.1 ロールへの権限の付与

この手順は、Oracle Enterprise Repositoryの「管理」画面で実行します。

1. 左側のパネルで、基本アクセス設定をクリックします。

2. 基本アクセス設定セクションで、リストから適切なグループを選択します。

図1-34 基本アクセス設定

選択したグループのアクセス設定がメイン・ペインに表示されます。

図1-35 権限の設定

3. 「編集」ボタン(メイン・ペインの右上角)をクリックします。「基本設定の編集: ...」ダイアログが表示されます。

図1-36 権限の設定

ロールが左側に、権限が上にリストされます。

4. 適切なオプションを選択し、表示するロールを決定します。

図1-37 権限の設定

5. 権限を付与するロールを選択します。

6. チェック・ボックスを使用して適切な権限を割り当てます。

- 空白のボックスを1回クリックすると、チェック・マークが付加されます(付与)

- 2回目のクリックでXが付与されます(拒否)。

- 3回目のクリックでボックスがクリアされます(付与しない)。

7. 終了したら、「保存」をクリックします。

1.6.2 権限の編集

1.6.1項「ロールへの権限の付与」を参照してください。

1.6.3 ユーザー権限の検証

この手順は、Oracle Enterprise Repositoryの「管理」画面で実行します。

1. 左側のパネルで、基本アクセス設定をクリックします。

2. 基本アクセス設定セクションで、リストから適切なグループを選択します。
選択したグループのアクセス設定がメイン・ペインに表示されます。

3. 「アクセスの表示」ボタン(メイン・ペインの右上角)をクリックします。メッセージ・ダイアログが表示されます。

図1-38 アセットの基本アクセス設定に対するアクセスの表示

4. 「構成」をクリックします。「ユーザーおよびアクセス設定の検索/フィルタ処理」ダイアログが表示されます。

図1-39 ユーザーおよびアクセス設定の検索/フィルタ処理

5. ユーザー検索セクションで、「検索」を使用するか、すべてをリストをクリックして、権限を検証するユーザーを探します。

6. 「>>」ボタンを使用して「使用可能なユーザー」列から「選択したユーザー」列にユーザーを移動します。

7. 「OK」をクリックします。選択したユーザーのアクセス設定が表示されます。

図1-40 ユーザーのアクセス設定

8. 複数のユーザーが選択されている場合は、ユーザー名の横にある「>」アイコンをクリックすると、そのユーザー固有の情報が表示されます。

9. 完了後、「閉じる」をクリックします。

1.6.4 セキュリティに関する考慮事項

ロールベースのアクセス制御(RBAC)により、Oracle Enterprise Repositoryでアセットの使用と作成をユーザーごとに追跡でき、Oracle Enterprise Repositoryの指定された部分における可視性を制限することでアセットのプレゼンテーションをパーソナライズできます。ただし、ロールベースのアクセス制御はアセット・メタデータに対するセキュリティの提供を想定しておらず、基盤となるアセット・リポジトリのセキュリティ補完も想定していません。

Oracle Enterprise Repositoryのアクセス設定は追加のセキュリティ機能を提供しません。したがってこの設定を行わない場合でも、アセットまたはデータのセキュリティが低下することはありません。最大限のセキュリティを確保するため、アセット・メタデータはセキュリティの確保されていないリポジトリを介したメタデータへのアクセスを回避するような方法で管理するようにします。機密情報はアセットのペイロードに埋め込むか、文書ファイルとして添付し、セキュアなリポジトリにホストするようにします。

認証および権限の問題を基盤となるアセット・リポジトリから回避することを選択した場合は、ご自身の責任でこれを行う必要があります。

次のアクションもセキュリティに影響を与える可能性があります。

- 単一のOracle Enterprise Repositoryユーザー・アカウントを介してアクセスするためのSCMシステムの構成

- 未承認ユーザーによるシステムへのアクセスの許可

- ゲスト・アカウントの作成

- ゲスト・アカウントは特定のOracle Enterprise Repositoryライセンスでは禁止されている可能性があります。

前述のアクションはいずれも、Oracle Enterprise Repositoryのコンテンツを、Oracle Enterprise Repositoryにネットワークを介してアクセス可能なすべてのユーザーに解放する可能性があります。

1.6.4.1 アクセス設定およびアセット・エディタ

使用しているアクセス設定によっては、アセット・エディタにアクセス可能なユーザーは、他の手段ではリポジトリ内で表示できないアセットのリレーションシップを表示できる場合があります。この状況では、非表示のアセットの名前が表示され、そのアセットとそのユーザーがアクセスできるアセットとのリレーションシップの詳細が表示されます。アセット・エディタでは、非表示のアセットのそれ以外の情報は表示されません。この状況では、表示されるアセットと非表示のアセットのリレーションシップを削除できます。ただし、このユーザーは非表示のアセットにはアクセスできないため、リレーションシップをリストアできません。

1.6.4.2 権限

権限については次の操作が可能です。

- 付与(権限が明示的に付与されます)

- 拒否(権限が明示的に拒否されます)

- 付与しない(権限は明示的に付与または拒否されません)

次の表は基本アクセス設定で管理できる権限を示しています。

アクセス定義

アセット: 制御されるツール: Oracle Enterprise Repositoryの「アセット」画面、アセット・エディタ、タイプ・マネージャ。

権限

説明

表示

アセットはOracle Enterprise Repositoryで表示可能です。

使用

Oracle Enterprise Repositoryで表示され、「使用 - ダウンロード」ボタンが有効になります。

ダウンロード

アセット・ファイルをダウンロードできます。「使用 - ダウンロード」ボタンを押すとファイル・リンクが表示されます。

レビュー

Oracle Enterprise Repositoryを使用してアセットをレビューします。

編集

アセット・エディタでアセットを編集します。

受入れ

アセットを受け入れます。アセット・エディタでこのボタンを使用すると、「発行済 -- レビュー保留中」キューから「発行済 -- レビュー中」キューに資産を移動します。

タブの承認

アセットのメタデータを承認します。このボタンは、各アセットのアセット・エディタ表示の各タブの下部に表示されます。タブを承認すると、承認者の名前と日付がメタデータに記録され、アセットがそのタブの「発行済 - レビュー中」キューから移動され、タブのテキスト・ラベルが緑色に変わります。

登録

アセットを登録します。この権限を持つユーザーは、アセット・エディタですべてのアセットを登録できます。

アクセス設定の編集

カスタム・アクセス設定の場合のみ適用可能です。カスタム・アクセス設定をアセットおよびファイルに割り当てられるようになります。

作成/発行

ユーザーがアセット・エディタを介してアセットを発行、または新規アセットを作成できるようになります。

アセット・エディタの起動

ユーザーがアセット・エディタ・ツールをオープンできるようになります。アセットの編集および登録にはこのツールを使用する必要があります。

アーティファクト・ストアの編集

(アセット・エディタを介して)ユーザーがアーティファクト・ストアを作成および編集できるようになります。

タイプの編集

ユーザーがアセット・タイプ/コンプライアンス・テンプレート・メタデータを構成できるようになります。アセット・エディタの起動権限が必要です。

通知

ユーザーが非定型の電子メールを他のユーザーに送信できるかを決定します。

グローバル権限

これらの権限は個別のアセットには適用されないため、カスタム・アクセス設定ではオーバーライドできません。

アクセス: 制御されるツール: Oracle Enterprise Repositoryの「管理」画面: ユーザー、セッション、ロール、部門、ファイル・ストア、基本アクセス設定、カスタム・アクセス設定

権限

説明

表示

前述のセクションのエントリを表示します。

編集

前述のセクションのエントリを編集します。

作成

ユーザー、ロール、部門、ファイル・ストア、およびカスタム・アクセス設定を作成します。

削除

セッション、ロール、およびカスタム・アクセス設定を削除します。

プロジェクト: 制御されるツール: Oracle Enterprise Repositoryの「プロジェクト」画面

権限

説明

表示

「プロジェクト」ページでプロジェクトを表示します。

編集

「プロジェクト」ページでプロジェクトを編集します。

作成

「プロジェクト」ページでプロジェクトを作成します。

テンプレートの適用

コンプライアンス・テンプレートをプロジェクトに適用します。

ポリシー: 制御されるツール: Oracle Enterprise Repositoryの「アセット」画面

権限

説明

ポリシーの適用

ユーザーが他のアセットにポリシーを適用できるようになります。

レポート: 制御されるツール: Oracle Enterprise Repositoryの「レポート」画面

権限

説明

表示

レポートを表示します。

システム管理: 制御されるツール: Oracle Enterprise Repositoryの「管理」画面: システム設定、電子メール・テンプレート

権限

説明

編集

一般設定、セキュリティ設定、認証設定、およびファイル・ストア設定を編集できます。

有効化

新しい一般設定、セキュリティ設定、認証設定、およびファイル・ストア設定を有効化できます。

1.7 セッション

管理者はセッションを使用して、Oracle Enterprise Repositoryにログインしているユーザーを確認でき、必要に応じてユーザー・セッションをシャットダウンできます。

- 1.7.1項「セッションの表示」

- 1.7.2項「単一セッションの削除」

- 1.7.3項「複数のセッションの削除」

1.7.1 セッションの表示

この手順は、Oracle Enterprise Repositoryの「管理」画面で実行します。

1. 左側のパネルで「セッション」をクリックします。図1-41のようなセッションのリストがメイン・ペインに表示されます。

図1-41 「セッション」ペイン

1.7.2 単一セッションの削除

1. メイン・ペインのリストから削除するセッションを選択します。セッションの詳細が下部のフレームで開きます。

2. セッションの詳細で「削除」ボタンをクリックします。確認ダイアログが表示されます。

3. 「OK」をクリックします。セッションが削除されます。

1.7.3 複数のセッションの削除

1. メイン・ペインのセッションのリストで、削除するセッションを個別に選択します。(列の最上部にあるチェック・ボックスにチェック・マークを付けると、リストのセッションがすべて選択されます。)

2. セッションの詳細で「削除」ボタンをクリックします。確認ダイアログが表示されます。

3. 「OK」をクリックします。セッションが削除されます。

(削除権限が必要です。1.6項「アクセス設定」を参照してください。

1.8 タイプ

タイプはアセットの構成を定義します。すべてのアセットに、属性を定義するタイプが必要になります。タイプに関してはXMLも生成できます。これは特に、あるタイプから別のタイプへのマッピング属性が必要になる移行プロセスで使用されます。『Oracle Fusion Middleware Oracle Enterprise Repositoryアップグレード・ガイド』を参照してください。

1.8.1 タイプの表示

「タイプ」セクションを使用して、各個別タイプの属性を検索および表示します。名前およびアーキタイプで検索できます。タイプはOracle Enterprise Repositoryの「管理」画面で表示できます。

- 「タイプ」セクションで、「検索」または「すべてをリスト」を使用して、表示するタイプを探します。
図1-42のようなユーザーのリストがメイン・ペインに表示されます。

図1-42 タイプ: ビューア

2 Oracle Enterprise Repositoryのカスタマイズ

この章では、Oracle Enterprise Repositoryホームページおよびその他のインタフェースを組織のためにカスタマイズする際に必要な情報を提供します。

この章には、次のセクションがあります。

- 2.1項「概要」

- 2.2項「Oracle Enterprise Repositoryの外観の変更」

- 2.3項「ロール/部門ベースのホームページ表示」

- 2.4項「Oracle Enterprise Repositoryソリューション・パックのインストール」

2.1 概要

Oracle Enterprise Repositoryのルック・アンド・フィールを、それぞれの組織にあわせてカスタマイズできます。Oracle Enterprise Repositoryのカラー・パレットを変更できます。さらに、Oracle Enterprise Repositoryホームページを、ロールまたは部門ごとにカスタマイズできます。これによって組織はガバナンスを推進でき、Oracle Enterprise Repositoryユーザーのサブセットに対して特定のアセットの普及を促進できます。

Oracle Enterprise Repositoryホームページにアクセスし、会社のロゴおよび会社固有の情報を使用してカスタマイズできます。この項には次のトピックが含まれます:

- 2.1.1項「Oracle Enterprise Repositoryホームページへのアクセス」

- 2.1.2項「Oracle Enterprise Repositoryホームページのカスタマイズ」

2.1.1 Oracle Enterprise Repositoryホームページへのアクセス

Oracle Enterprise Repositoryホームページにアクセスするには、次の手順を実行します。

1. Oracle Enterprise Repositoryをインストールしているhttp://<host>:<port>/<oer_instance_name>にログインします。または、http://<host>:<port>:/<oer-app-name>にログインできます。

2. ログイン画面で、「ユーザー名」ボックスと「パスワード」ボックスに適切な情報を入力します。

注意:

Oracle Enterprise Repositoryにログインするたびに組織でユーザー名とパスワードが必要な場合は、「自動ログインの有効化」ボックスが選択されていないことを確認します。

3. 「ログイン」をクリックします。ログイン・ステータス・ダイアログに、ようこそメッセージが表示され、ログインの日時が示されます。

4. ログイン・ステータス・ダイアログで、「閉じる」をクリックします。
Oracle Enterprise Repositoryホームページが表示されます。

注意:

OERインストールがファイアウォールで保護されている場合は、ブラウザでプロキシ設定を行ってからOERホームページを開く必要があります。

2.1.2 Oracle Enterprise Repositoryホームページのカスタマイズ

Oracle Enterprise Repositoryホームページを、会社のロゴおよび会社固有の情報でカスタマイズするには、次の手順を実行します。

1. Oracle Enterprise Repositoryホームページにログインします。

2. cmee.enterprisetab.homepageを、選択したWebサイトにあわせて設定します。デフォルトでは、このシステム設定はhttp://localhost:8080/oer/custom/home.jspになっています。

3. または、Webページを作成してOracle Enterprise RepositoryインストールのCustomディレクトリに追加できます。Customディレクトリのパスは、Oracle Enterprise Repositoryがインストールされているアプリケーション・サーバーによって変わります。

Oracle Enterprise Repositoryホームページの詳細は、『Oracle Fusion Middleware Oracle Enterprise Repositoryユーザーズ・ガイド』を参照してください。

2.2 Oracle Enterprise Repositoryの外観の変更

この項では、Oracle Enterprise Repositoryの外観の変更方法、およびOracle Enterprise Repositoryのスキンのカスタマイズ方法について説明します。内容は次のとおりです。

- 2.2.1項「最初に行うCSSの変更」

- 2.2.2項「スキンのカスタマイズ」

2.2.1 最初に行うCSSの変更

Oracle Enterprise Repositoryは、CSS (カスケード・スタイル・シート)を使用しています。これによりアプリケーションのカラーおよびその他の視覚的な要素を編集できます。Oracle Enterprise Repositoryはほぼニュートラルなカラー・パレットを使用して構築されており、単一カラーが特徴になっています。図Figure 2-1に示すように、CSSでカラーおよびタイプ・フェイスを編集できます。

図2-1 カスケード・スタイル・シート

Oracle Enterprise Repositoryは次のスキンを装備しています。

- 青 -- #0066CC

- 緑 -- #669933

- ニュートラル -- #999999

Oracle Enterprise RepositoryはOracleスキンをデフォルトとして装備しています。

このスキンには次のカラーも含まれます。

- 白 -- #FFFFFF

- 灰色 -- #EEEEEE

2.2.2 スキンのカスタマイズ

この項では、Oracle Enterprise Repositoryにおけるスキンのカスタマイズ方法について説明します。内容は次のとおりです。

- 2.2.2.1項「スキンの選択」

- 第2.2.2.2項「スキンの作成」

- 2.2.2.3項「イメージ」

- 2.2.2.4項「作成したカスタム・スキンのアクティブ化」

- 2.2.2.5項「Oracle提供のカスタム・スキンのOracle Enterprise Repositoryへのインストール」

- 2.2.2.6項「ディレクトリ構造の使用」

2.2.2.1 スキンの選択

Oracle Enterprise RepositoryはOracleスキンをデフォルトとして装備していますが、アクティブなスキンは変更できます。スキンを制御するファイルは、WEB-INF/classes/skin.propertiesファイルです。skin.propertiesファイルでは、skin.name.orgプロパティを使用するスキンに応じて「green」、「blue」、または「neutral」のいずれかに変更できます。サーバーを再起動すると、アプリケーションに対して新しいカラー・パレットが表示されます。

2.2.2.2 スキンの作成

Oracle Enterprise Repository向けに独自のカスタム・スキンを作成する場合は、そのスキン用に新しくフォルダを作成し、skinsフォルダに追加します。最初は既存のスキン・フォルダをコピーし、名前を変更して新しいフォルダを作成することをお薦めします。Oracle Enterprise Repositoryのインタフェースは単一カラーで設計されています。新しいスキンのカラー・パレット作成の際は、Oracle Enterprise Repositoryに用意されているデフォルトのカラー・パレットと同様の、中間的な諧調範囲のカラー・パレットを作成することを第一にお薦めします。

新しいカラーを使用してCSSを更新するには、置き換える色の十六進コードを検索して置き換えます。たとえば青のスキンをコピーした場合は、0066CCを新しい色で置き換えます。これをsettings.cssファイルおよびstyle.cssファイルに対して行います。次のCSSファイルが、<Oracle_home>/ user_projects\applications\base_domain\applications\oer_11.1.1.4.0\oer-web\skinsディレクトリにあります。

- settings.css

- style.css

- tabs.css (このファイルは無視)

- tree.css (このファイルは無視)

2.2.2.3 イメージ

デフォルトのイメージを更新して外観の変更を完了できます。イメージは2つの異なる場所に保存されますが、パスは同じように見えます。新しいイメージは置き換えるイメージと必ず同じサイズ(幅および高さ)で作成することをお薦めします。次のイメージが<Oracle_home>\user_projects\applications\base_domain\applications\oer_11.1.1.4.0\oer-web\skins\blue\images\menuディレクトリにあります。

- smalllogo.gif (271 X 21)

- wave.jpg (306 X 31)

- oracleicon.gif (68 X 51)

- logo.gif (414 X 28)

- menuLogo.jpg (423 X 54)

- login_splash.jpg (338 X 508)
"skins"フォルダのこの場所には、デフォルトのoracleを含むすべてのカラー・スキンがあります。このフォルダには、すべての.cssおよびその他のフォルダも含まれます。

2.2.2.4 作成したカスタム・スキンのアクティブ化

前の手順を完了すると、skinsフォルダにはデフォルトのスキンと非常に類似したカスタム・スキンが作成されます。最後の手順は、新しいスキンに対するskin.propertiesファイルの作成です。既存のskin.propertiesファイルをコピーし、編集することでこれを行います。propertiesファイルでは、名前とカラーの値という2つのアイテムを編集する必要があります。

- 行skin.name.org=blueでは、blueを新しいスキンの名前で置き換えます。

- 十六進数のカラー値を新しいスキンのパレットのカラーの値で置き換えます。

これらの値を変更し、サーバーを再起動すると新しいスキンがアクティブ化されます。

2.2.2.5 Oracle提供のカスタム・スキンのOracle Enterprise Repositoryへのインストール

Oracle提供のカスタム・スキンは、次の手順でインストールします。

1. カスタム・スキンのZIPファイルをOTNから入手します。

2. 一時ディレクトリにZIPファイルの内容を抽出します。ZIPファイル内の各ファイルのディレクトリ・パスは保持するよう注意してください。

3. 既存のOracle Enterprise Repositoryの<Oracle_home>\user_projects\applications\base_domain\applications\oer_11.1.1.4.0\oer-app\WEB-INF\classes\skin.propertiesファイルのバックアップ・コピーを取ります。

4. 新しいskin.propertiesファイルを、カスタム・スキンのZIPアーカイブからOracle Enterprise Repositoryの<Oracle_home>\user_projects\applications\base_domain\applications\oer_11.1.1.4.0\oer-app\WEB-INF\classesディレクトリにコピーします。

5. 既存のOracle Enterprise Repositoryの<Oracle_home>\user_projects\applications\base_domain\applications\oer_11.1.1.4.0\oer-app\WEB-INF\classes\skin.propertiesファイルを新しいファイルで置き換えます。

6. イメージおよびCSSファイルを含む、抽出されたカスタム・スキン・ディレクトリを<Oracle_home>/ user_projects\applications\base_domain\applications\oer_11.1.1.4.0\oer-web\skinsディレクトリに移動します。skin.propertiesファイルは、スキン・リソース検索のためこのディレクトリを指します。

7. アプリケーション・サーバーを再起動し、変更を適用します。

2.2.2.6 ディレクトリ構造の使用

この項では、スキン作成のためのディレクトリ構造の使用方法について説明します。内容は次のとおりです。

- 「スキンの新規作成」

- 「カスタム・タグ・ライブラリの使用」

- 「Skintagsライブラリ・タグの使用」

- 「CSS」

- 「イメージ」

スキンの新規作成

新しいスキンを作成するには、次の手順を実行します。

1. /skinsの下に自身のスキンのフォルダを作成します。

2. CSSおよびイメージを必要に応じて変更します。

3. skins.propertiesファイルを編集し、エントリskins.org.nameに自身のスキンのフォルダ名を反映します。

4. アプリケーション・サーバーを再起動します。

次の例に示す命名規則に従う必要があります。

/skins/your_skins/folder/style.css
/skins/your_skins/folder/images/logo.gif
/skins/your_skins/folder/buttons/all_the_buttons
/skins/your_skins/folder/icons/the_other_icons

カスタム・タグ・ライブラリの使用

skintagsカスタム・タグ・ライブラリは、本来の/skinsフォルダにCSSおよびイメージ参照を指定するために使用します。現在はcssおよびimageの2つのスキン・タグがあります。既存のJSPは更新されています。新規JSPはすべてskintagsライブラリを使用する必要があります。

Skintagsライブラリ・タグの使用

いずれかのスキン・タグを使用するには、次をJSPに追加します。

<%@ taglib uri="/skintags" prefix="skin" %>

(JSP内部のみでの参照のため、接頭辞は自由に指定できます。)

CSS

カスケード・スタイル・シートのタグは次に示す例のようになります。

<skin:css element='the_relative_path_to_the_style_sheet'/>

スタイルシート内で使用する場合は次のようになります。

<LINK HREF="" REL="stylesheet" TYPE="text/css">

イメージ

imageタグは次に示す例のようになります。

<skin:image element='the_relative_path_to_the_image'/>

次の例は、HTML IMGタグ内でのimageタグの使用方法を示しています。

<IMG SRC="" WIDTH="182" HEIGHT="32" BORDER="0" ALT="Geneva">

(ここで、relative_pathの起点は、(skin.propertiesファイルで定義された)スキンのフォルダです。

2.3 ロール/部門ベースのホームページ表示

この機能は、ユーザー・ロールおよび部門の割当てをベースにして特定のホームページを表示します。この節では、次のトピックについて説明します。

- 2.3.1項「インストール」

2.3.1 インストール

Oracle Enterprise Repositoryホームページをロールまたは部門ごとにカスタマイズできます。次のステップを実行します:

1. homepages.xmlという名前のファイルを作成します。例2-1を参照してください。

2. homepages.xmlファイルをアプリケーションのクラスパスに追加します。Oracle Enterprise RepositoryアプリケーションのWEB-INF/classesディレクトリをお薦めします。

3. ホームページのプロパティcmee.enterprisetab.homepageにhttp://SERVER/APP/custom/autoselect.jspを設定します。ここで、SERVERはサーバー名、APPはOracle Enterprise RepositoryのWebアプリケーションのコンテキスト名です。

ホームページ選択はhomepages.xmlファイルの内容で定義されます。

例2-1 homepages.xmlファイルの例

homepages.xmlファイルの内容の例を次に示します。

1 <HomepageSelector>
2 <select criteria="roles">
3 <option value="Admin">http://www.oracle.com</option>
4 <option value="Architect">architect.jsp</option>
5 <option value="Developer">developer.jsp</option>
6 <option value="User">generaluser.jsp</option>
7 <defaultLocation>homepageDefault.jsp</defaultLocation>
8 </select>
9 </HomepageSelector>

次の行に注目してください。

- 2行目:

- 基準に対する値を設定します。有効な値は次のとおりです。

- roles

- departments

- 3から6行目:

- オプションの値は、選択で使用されるロール名または部門名を示します。

- ノードの値は、ユーザーがリダイレクトされるページへの相対パスまたは絶対パスです。Oracle Enterprise Repositoryアプリケーション・サーバー上にホストされるホームページのパスは、custom/autoselect.jspファイルに対する相対パスです。前述の例では、architect.jspファイルがカスタム・ディレクトリにも置かれています。

- 順序が重要です。複数ロールを持つユーザー、または複数部門のメンバーシップを持つユーザーは、最初に一致する選択に向けられます。

- 7行目

- 選択基準を満たさないユーザー向けのデフォルト・ホームページを指定します。

注意:

homepages.xmlの構成後、カスタムjspへのリダイレクト時に「404 Not found」エラーが発生した場合は、</servers/<server name>/tmpフォルダのキャッシュ・データをすべて削除し、再デプロイします。

2.4 Oracle Enterprise Repositoryソリューション・パックのインストール

この項では、ベース・データ・パックおよびハーベスタ・ソリューション・パックのインストール手順について説明します。

ベース・データ・パック

ベース・データ・パックはOracle Enterprise Repositoryデータベース・インストールの一部としてインストールされます。ベース・データは他の方法では使用できません。Oracle Enterprise Repositoryをあるバージョンから次のバージョンにアップグレードする場合にも提供されません。

ベース・データとして提供されるアセットのタイプは、ほぼテンプレートとみなされます。アセット・タイプを新しく作成する場合は、最初に既存のアセット・タイプのクローニングを行います。これらのアセット・タイプに関しては、次の2つの推奨事項を必ず確認してください。

1. ベース・データ・アセット・タイプは、新しいOracle Enterprise Repositoryアプリケーションに固有のアセット・タイプが少なくとも1つ作成されるまで削除しないことをお薦めします。

2. ベース・アセット・タイプの拡張が必要な場合は、そのベース・アセット・タイプの変更をお薦めします。Oracleが提供しているタイプは各種アセット・モデルで使用されており、将来のOracleモデルへの移行を確実に行うために必要です。

3. ソリューション・パックで提供されるアセット・タイプの拡張が必要な場合は、ソリューション・パックで提供される要素がタイプから削除されないことが不可欠になります。次をお薦めします。

- エディタの場合: Deprecationなどの名前のタブを新しく作成し、要素を新しいタブに移動します。

- ビューアの場合: 要素はHidden Elementsというセクションに移動されます。

ハーベスタ・ソリューション・パック

ハーベスタは、Oracle Enterprise Repository 11gインストールにバンドルされている11.1.1.x.x-OER-Harvester-Solution-Pack.zipに含まれています。

ハーベスタ・ソリューション・パックのインストールには、インポート/エクスポート・ツールを使用する必要があります。このツールは、Oracle Enterprise Repositoryの「管理」タブの「インポート」オプションおよび「エクスポート」オプションで使用できます。ハーベスタ・ソリューション・パックの一部として提供されるアセット・タイプは、ハーベスタ・ツールで必要になります。インポート/エクスポート・ツールの詳細は、『Oracle Fusion Middleware Oracle Enterprise Repositoryユーザーズ・ガイド』の「インポート/エクスポート・ツール」を参照してください。

契約管理ソリューション・パック

契約管理ソリューション・パックは、Oracle Enterprise Repository 11gインストールにバンドルされています。

契約管理ソリューション・パックのインストールには、インポート/エクスポート・ツールを使用する必要があります。このツールは、Oracle Enterprise Repositoryの「管理」タブの「インポート」オプションおよび「エクスポート」オプションで使用できます。インポート/エクスポート・ツールの詳細は、『Oracle Fusion Middleware Oracle Enterprise Repositoryユーザーズ・ガイド』の「インポート/エクスポート・ツール」を参照してください。

3 外部認証ツールを使用するためのOracle Enterprise Repositoryの構成

この章では、LDAP/Active Directory、eTrust Single Sign-On、およびコンテナ管理設定などの外部認証ツールを使用してOracle Enterprise Repositoryを認証する方法について説明します。

この章には、次のセクションがあります。

- 3.1項「概要」

- 3.2項「eTrust Single Sign-On」

- 3.3項「コンテナ管理の設定」

3.1 概要

この項では、LDAP/Active Directoryを使用してOracle Enterprise Repositoryのユーザーを認証する方法について説明します。

この項には次のトピックが含まれます:

- 3.1.1項「LDAP/Active Directory」

- 3.1.2項「LDAP統合システム・プロパティの有効化」

- 3.1.3項「LDAP/Active Directoryプロパティの変更」

- 3.1.4項「セキュリティに関する考慮事項」

- 3.1.5項「LDAPプロパティの例」

3.1.1 LDAP/Active Directory

ユーザーの認証にLDAP/Active Directory (AD)を利用する場合、LDAP/Active Directoryサーバーを利用する前に、ユーザーの部門とロールの構成を検討する必要があります。統合が有効になるとすべてのユーザーがLDAP/ADを介して認証されますが、Oracle Enterprise Repositoryデータベース内でLDAP/ADからのユーザー名を照合する管理レベルのユーザー・アカウントを1つ以上設定する必要があります。LDAP/ADが有効な場合にOracle Enterprise Repository内で管理機能を引き続き実行できるように、このユーザー・アカウントには管理ロールが割り当てる必要があります。

LDAP/ADからのロール同期が有効な場合、1つ以上のユーザー・アカウントに管理レベル・ロールを割り当てる必要があります。LDAPロールは、ロール同期のオプションを利用する前にOracle Enterprise Repository内で作成し、適切なOracle Enterprise Repository権限を割り当てておく必要があります。ロール名は名前でのみ同期されます。管理レベル・ユーザーがLDAP/ADを使用してOracle Enterprise Repositoryにログインすると、そのユーザーはアプリケーションを適切に構成および管理できます。このユーザー・アカウントは日常業務には使用しないでください。

3.1.2 LDAP統合システム・プロパティの有効化

この手順は、Oracle Enterprise Repositoryの「管理」画面で実行します。

1. 左のペインで「システム設定」をクリックします。メイン・ペインで「システム設定」セクションが開きます。

2. Cookieログイン設定グループのエンタープライズ認証セクションを見つけます。

図3-1 Cookieログイン設定

3. Cookieログインの許可設定が「False」に設定されていることを確認します。

4. 「システム設定」の「検索」ボックスを使用すると、次のそれぞれの設定を容易に検索できます。

5. 「検索」ボックスに「enterprise.authentication.ldap.enabled」と入力します。値を「True」に設定し、「保存」をクリックします。
設定を次のように変更します。

- Cookieログインをデフォルトに設定

- 「False」に設定します。

- 承認されていないユーザーのログイン

- 「True」に設定します。

- Cookieログイン・モジュール

- 「False」に設定します。

- Cookieログイン・モジュール - 内部チェック

- 「False」に設定します。

- プラグイン・ログイン・モジュール・クラス名

- テキスト・ボックスに「com.oer.enterprise.authentication.server.loginmodule.LDAPLogin」と入力します。

注意:

このプロパティはLDAPのオン/オフを切り替えます。有効になると、アプリケーションのユーザー認証にLDAPサーバーが使用されます。

- プラグイン・ログイン・モジュール表示名

- テキスト・ボックスに「Enterprise LDAP Login」と入力します。

- プラグイン・ログイン・モジュール

- 「True」に設定します。

- プラグイン・ログイン・モジュール - 内部チェック

- 「False」に設定します。

6. 完了したら、「保存」をクリックします。

3.1.3 LDAP/Active Directoryプロパティの変更

LDAP/ADプロパティは次のように変更できます。

1. 左のペインで「システム設定」をクリックします。

2. 「システム設定」の「検索」を使用すると、次のそれぞれの設定を容易に検索できます。値を次に示のように入力します。

- LDAPサーバーのホスト名

- テキスト・ボックスにホスト名、またはディレクトリ・サーバーのIPアドレスを入力します。

- LDAPサーバーのポート番号

- テキスト・ボックスに「389」と入力します。

- LDAPマスク

- LDAPの場合、「uid=^」と入力します。
または

- Active Directoryの場合、「samAccountName=^」と入力します。

- 未承認ユーザー・アカウントの作成

- 「True」に設定します。

- デフォルト・ロールのユーザーへの割当て

- 「True」に設定します。

注意:

このプロパティでは、ユーザー認証ごとにデフォルトのロールを割り当てます。

- 不足ロールの自動作成

- 「True」に設定します。

注意:

このプロパティは、LDAP/ADサーバーで同期されているロールを作成しますが、これらのロールに権限は割り当てません。

- 不足部門の自動作成

- 「True」に設定します。

注意:

このプロパティは、LDAP/ADサーバーで同期されている部門を作成しますが、これらの部門に説明は割り当てません。ただし、ユーザーは新しいロールに割り当てられます。

- LDAPのバージョン

- テキスト・ボックスに「3」と入力します。(サポート対象のバージョンは2と3です。)

- 管理者アカウントの識別名

注意:

このプロパティはActive Directoryを使用する際に必要です。このプロパティには、少なくとも読取り専用ディレクトリの参照権限のあるユーザー・アカウントのDNが必要です。

例: CN=Some_User,CN=Users,DC=ad,DC=example,DC=com

- 管理者アカウントのパスワード

- テキスト・ボックスには、前述の管理者アカウントの識別名プロパティで識別した管理者アカウントのパスワードを入力します。

- SSL接続の使用

- LDAPのSSL接続を有効にするには、「True」に設定します。デフォルト値はfalseです。

- 照会先を追跡

- 「True」に設定します。

- 管理者アカウントを使用してデータを取得

- LDAPでは(該当する場合)、「False」に設定します。または

- Active Directoryまたは制限のあるLDAP環境では、「True」に設定します。

- 検索開始場所

注意:

このプロパティでは、ユーザー・レコードの検索を開始するディレクトリ・ツリーの場所を定義します。

例:

- LDAPの場合: OU=MemberGroupB, O=en_us

- Active Directoryの場合: CN=Users,DC=ad,DC=example,DC=com

- 検索範囲

- リストからサブツリーを選択します。

注意:

このプロパティでは、ユーザー・レコード検索の深さ(baseDNより下)を定義します。

- 検索エントリを識別する属性名

注意:

このプロパティでは、ツリー検索の範囲内でユーザー・アカウントを一意に識別する属性名を指定します。

- LDAPの場合: uid
または

- Active Directoryの場合: samAccountName

- 検索エントリの電子メール属性名

- 「mail」と入力します。

- 検索エントリの名前属性名

- 「givenName」と入力します。

- 検索エントリのミドル・ネーム属性名

- LDAPまたはActive Directory (該当する場合)のミドル・ネームの属性を入力します。

- 検索エントリの姓属性名

- 「sn」と入力します。

- 検索エントリの電話番号属性名

- 「telephoneNumber」と入力します。

- LDAP部門の使用

- 「True」に設定します。

注意:

このプロパティでは、Oracle Enterprise Repositoryで同期されるユーザーの部門属性の値を定義します。

- 部門属性

- 「department」と入力します。

- LDAPロールの使用

- 「False」に設定します。

- ロール属性

- ユーザーのロール情報を含むLDAP/Active directory属性を入力します。

- 第2レベル参照属性

注意:

このプロパティでは、ユーザー情報を取得するための第2レベル参照を識別する属性を定義します。値はDNである必要があります。第2レベル参照にリダイレクトを使用している場合は、この2つ目の参照にベースDNを定義します。

3. 完了したら、「保存」をクリックします。

4. Oracle Enterprise Repositoryアプリケーションを再起動します。

3.1.4 セキュリティに関する考慮事項

Oracle Enterprise Repository LDAP/Active Directory Connectorを使用すると、LDAPがOracle Enterprise Repositoryユーザー認証およびロール割当てにおけるユーザー識別の単一ソースとして機能します。ただし、これによって個々のホスト・リポジトリによるOracle Enterprise Repositoryを介したファイル・アクセスに対するユーザー認証管理が妨げられることはありません。

Oracle Enterprise Repository LDAP/Active Directory Connectorを使用した場合は、Oracle Enterprise RepositoryはLDAPまたはActive Directoryを使用してユーザーを認証します。ユーザー名/パスワードの組合せは、バインド・リクエストとしてLDAPシステムに委任されます。ユーザーはバインド・リクエストが完了した場合のみ認証されます。

オプションとして、Oracle Enterprise Repositoryユーザーのロール割当てを格納および取得するようにLDAPを構成できます。この構成では、ロールがLDAPに格納されるように、ユーザーのログインのたびにOracle Enterprise Repositoryがユーザーのロールと同期します。ロールはLDAPを介して直接追加されるため、Oracle Enterprise Repositoryでは管理されません。

3.1.4.1 サンプル・ユース・ケースのシナリオ

次のシナリオでは、LDAPの設定および構成の選択を示し、ユーザー管理のプロパティ設定を明確にします。

シナリオ1

LDAP認証に関係なく、Oracle Enterprise Repositoryへのユーザー・アクセスを防止します。アクセスは、アクティブなOracle Enterprise Repositoryアカウントを持つ既存のユーザーにのみ許可されます。

- 理由

- 非エンタープライズ・ライセンス契約では、ユーザー・ベースが事前定義されており、アプリケーションに許可されているユーザー数が限定されているため。

- プロパティ設定

- ldap.allow-user-creation

- 「False」に設定します。

- enterprise.security.unapproveduser.allowlogin

- 「False」に設定します。

シナリオ2

LDAP認証で、デフォルトのOracle Enterprise Repositoryユーザー・アカウントを作成し、デフォルトのロールを割り当てますが、Oracle Enterprise Repositoryへのユーザー・アクセスは拒否します。

- 理由

- 新規ユーザー・アカウントが作成されたことをセキュリティ管理者に通知するまで、新規ユーザーに対してOracle Enterprise Repositoryのアクセスを拒否するため。セキュリティ管理者の承認が得られたら、ユーザーのステータスがアクティブに変更され、Oracle Enterprise Repositoryログインが許可されます。

- プロパティ設定

- ldap.allow-user-creation

- 「True」に設定します。

- ldap.assign-default-roles

- 「True」に設定します。

- enterprise.security.unapproveduser.allowlogin

- 「False」に設定します。

シナリオ3

LDAP認証で、デフォルト・ロールを使用してデフォルトのOracle Enterprise Repositoryユーザー・アカウントが作成され、そのユーザーはOracle Enterprise Repositoryへのログインを許可されます。

- 理由

- エンタープライズ・ライセンス契約では、LDAP認証が新規ユーザー作成の唯一の制限であるため。通常、デフォルトのOracle Enterprise Repositoryロールがユーザーに設定され、LDAPアカウントで事前定義されていないロールを持つ新規ユーザーに対するアクセスは制限されます。

- プロパティ設定

- ldap.allow-user-creation

- 「True」に設定します。

- ldap.assign-default-roles

- 「True」に設定します。

- enterprise.security.unapproveduser.allowlogin

- 「True」に設定します。

3.1.5 LDAPプロパティの例

ディレクトリ・サーバーに匿名でバインドされている(認証されていない)間は、Active Directoryの制限によって、最上位より下のディレクトリが検索されないため、Oracle Enterprise Repositoryユーザー情報の参照では、「バインドDN」、「バインド・パスワード」、および管理者としてデータを取得のプロパティを適切な値に設定する必要があります。表3-1では、LDAP /Active Directoryプロパティとその例を示します。

表3-1 Active Directoryおよび従来のLDAPプロパティ

Active Directory

従来のLDAP (InetOrgPerson)

ldap.host

ad.example.com

ldap.host

ad.example.com

ldap.port

389

ldap.port

389

ldap.version

3

ldap.version

3

ldap.bindDN

CN=Some_User,OU=Users,DC=ad,DC=example,DC=com

ldap.bindDN

(匿名参照が無効の場合は必須)

ldap.bindPassword

パスワード

ldap.bindPassword

(匿名参照が無効の場合は必須)

ldap.retrieve-data-as-admin

true

ldap.retrieve-data-as-admin

False (匿名参照が無効の場合はTrue)

ldap.mask

sAMAccountName=^

ldap.mask

uid=^

ldap.baseDN

CN=Users,DC=ad,DC=example,DC=com

ldap.baseDN

OU=MemberGroupB, O=en_us

ldap.scope

subtree

ldap.scope

one

ldap.uniqueIDAttrib

samAccountName

ldap.uniqueIDAttrib

uid

ldap.emailAttrib

mail

ldap.emailAttrib

mail

ldap.givennameAttrib

givenname

ldap.givennameAttrib

givenName

ldap.surnameAttrib

sn

ldap.surnameAttrib

sn

ldap.telephoneAttrib

telephonenumber

ldap.telephoneAttrib

telephoneNumber

ldap.deptAttrib

department

ldap.deptAttrib

department

表3-2はカスタムおよび共通のLDAPプロパティを示します。

表3-2 カスタムおよび共通のLDAPプロパティ

実装に関係のないカスタムおよび共通のプロパティ

ldap.rbac.mapperclass

com.oer.enterprise.authentication.server.loginmodule.LDAPMapperImpl

ldap.deptAttrib

department

ldap.rbac.roleAttrib

roles

ldap.allow-user-creation

true

ldap.enable-synch-roles

true

ldap.enable-synch-depts

true

3.2 eTrust Single Sign-On

この項では、eTrust Single Sign-Onを使用してOracle Enterprise Repositoryのユーザーを認証する方法について説明します。

この項には次のトピックが含まれます:

- 3.2.1項「概要」

- 3.2.2項「シングル・サインオン認証で使用するOracle Enterprise Repositoryの構成」

- 3.2.3項「拡張オプション」

3.2.1 概要

Oracle Enterprise Repository Advanced Container Authentication LoginModuleを使用して、(SSOシステムから潜在的に生成される) HTTPリクエスト・ヘッダーから渡されるユーザー資格証明を受け入れます。この機能では、eTrust Single Sign-Onなどのシングル・サインオン・システムとの統合が可能です。

3.2.2 シングル・サインオン認証で使用するOracle Enterprise Repositoryの構成

次の構成プロパティには、管理者権限を使用してのみアクセスが可能です。

注意:

この拡張機能では、AdvancedContainerLoginモジュールでAuthtokenCreate REX APIメソッドのSOAPヘッダーのユーザー情報を受け入れることができます。ユーザー名は、Oracle Enterprise Repositoryシステム設定enterprise.container.auth.usernameで識別され、www.oracle.com/oerのnamespaceUriが付加された名前でSOAPヘッダーに渡されます。SOAPヘッダーの値はユーザーのユーザー名です。SOAPヘッダー内でユーザー名が渡されない場合、Oracle Enterprise Repositoryシステム設定enterprise.loginmodules.fallbackauthenticationが使用されます。enterprise.loginmodules.fallbackauthenticationがtrueの場合、ユーザーは指定のユーザー名/パスワードに対して構成されているPluggableLoginModuleで認証されます。

ログイン・モジュールのプラグインは、データベース・ログイン・モジュール、LDAPログイン・モジュール・およびコンテナ・ログイン・モジュールを構成するために設定されている構成です。コンテナ・ログイン・モジュールはコンテナ管理ログイン・モジュールまたはSSOなどの詳細コンテナ・ログイン・モジュールのいずれかです。これらは「システム設定」タブで構成できます。

この項には次のトピックが含まれます:

- 3.2.2.1項「シングル・サインオン統合システム・プロパティの有効化」

- 3.2.2.2項「Oracle Enterprise RepositoryのSSO統合およびBasic認証の使用」

- 3.2.2.3項「アプリケーション・プロパティ・ファイルの手動による変更」

注意:

フォールバック認証はREX APIでのみ機能します。

3.2.2.1 シングル・サインオン統合システム・プロパティの有効化

この手順は、Oracle Enterprise Repositoryの「管理」画面で実行します。

1. 左のペインで「システム設定」をクリックします。図3-2に示すように、Oracle Enterprise Repositoryの「システム設定」画面が表示されます。

図3-2 Oracle Enterprise Repositoryの「システム設定」画面

2. 「検索」ボックスに「enterprise.authentication.advancedcontainer.enabled」と入力します。値を「True」に設定し、「保存」をクリックします。

3. 図3-3に示すように、「新しいシステム設定の有効化」テキスト・ボックスに「cmee.jws.pass-all-cookies」と入力します。

図3-3 「新しいシステム設定の有効化」ダイアログ

4. 「有効化」をクリックします。図3-4に示すように、システム設定の「サーバー設定」グループのJava Web Start (JWS)セクションにJWSにすべてのCookieを渡すが表示されます。

図3-4 JWSにすべてのCookieを渡す

5. プロパティが「True」に設定されていることを確認します。

6. 「保存」をクリックします。

7. 「システム設定」の「検索」テキスト・ボックスに「container login module」と入力します。図3-5に示すように、エンタープライズ認証グループにコンテナ・ログイン・モジュール・セクションが表示されます。

図3-5 コンテナ・ログイン設定セクション

8. プロパティを次に示すとおり変更します。

- コンテナ・ログイン・モジュール・クラス名

- テキスト・ボックスに「com.oer.enterprise.authentication.server.loginmodule.AdvancedContainerLogin」と入力します。

- コンテナ・ログイン・モジュール表示名

- テキスト・ボックスに「Advanced Container Login Module」と入力します。

- コンテナ・ログイン・モジュール

- プロパティを「True」に設定します。

9. SSOヘッダー値を次のとおり入力します(これは通常、ポリシー・サーバー内のレスポンスと呼ばれます)。想定されるデータ型と指定できる値をヘッダー名の後に示します。想定される値の型はポリシー・サーバーからのレスポンスに適用されます。

- ユーザー名のヘッダー名

- このプロパティは、ユーザーのUID値を含むヘッダーの「名前」に設定します。
このヘッダーにはユーザーのユーザーIDを含む必要があります(必須)。

- 名のヘッダー名

- このプロパティは、ユーザーの名の値を含むヘッダーの「名前」に設定します。(英文字列)
このヘッダーにはユーザーの本名を含む必要があります。

- ミドルネームのヘッダー名

- このプロパティは、ユーザーのミドル・ネームの値を含むヘッダーの「名前」に設定します。(英文字列)
このヘッダーにはユーザーのミドル・ネームを含む必要があります。

- 姓のヘッダー名

- このプロパティは、ユーザーの姓の値を含むヘッダーの「名前」に設定します。(英文字列)
このヘッダーにはユーザーの姓を含む必要があります。

- ステータスのヘッダー名

- このプロパティは、ユーザーのアクティブ・ステータスの値を含むヘッダーの「名前」に設定します。
このヘッダーには、OER内でのユーザーのステータスを示す有効な整数値を含む必要があります。有効な値については、次の表を参照してください(必須)。

* 00 - アクティブ

* 10 - 未承認

* 20 - ロックアウト済

* 30 - 非アクティブ

- 電子メールのヘッダー名

- このプロパティは、ユーザーの電子メールの値を含むヘッダーの「名前」に設定します。
このヘッダーにはユーザーの電子メール・アドレスを含む必要があります(必須)。

- 電話のヘッダー名

- このプロパティは、ユーザーの電話番号の値を含むヘッダーの「名前」に設定します。
このヘッダーにはユーザーの電話番号を含む必要があります。

- ロールのヘッダー名

- このプロパティは、ユーザーのロールの値を含むヘッダーの「名前」に設定します。
このヘッダーにはユーザーのロールを含む必要があります。

- 部門のヘッダー名

- このプロパティは、ユーザーの部門の値を含むヘッダーの「名前」に設定します。
このヘッダーにはユーザーの部門を含む必要があります。

10. 次のプロパティでSSOモジュールの動作を更新します。

- コンテナが渡す部門を使用

- ポリシー・サーバーのレスポンスからのユーザーの部門を同期させるには、この値を「True」に設定します。

- 単一のヘッダーで渡される部門

- 複数の部門名がポリシー・サーバーのレスポンスとして渡される場合は、この値を「True」に設定します。

- 部門のデリミタ

- 単一の部門ヘッダー内で複数の部門を区切る文字をこのプロパティの値として設定します。このフィールドは、スペースを表す\u0020などのUnicode表記法を使用できます。

- コンテナが渡すロールを使用

- ポリシー・サーバーのレスポンスからのユーザーのロールを同期させるには、この値を「True」に設定します。(注意: 構成が正しいことを確認する前にこの値を「True」に設定すると、Oracle Enterprise Repositoryアプリケーションが使用不可として表示されることがあります)。

- 単一のヘッダーで渡されるロール

- 複数のロール名をポリシー・サーバーのレスポンスとして渡す場合は、この値を「True」に設定します。

- ロールのデリミタ

- 単一のロール・ヘッダー内で複数のロールを区切る文字をこのプロパティの値として設定します。このフィールドは、スペースを表す\u0020などのUnicode表記法を使用できます。

- デフォルト・ロールのユーザーへの割当て

- Oracle Enterprise Repositoryのユーザー・アカウントに割り当てられる、「デフォルト」としてマークされるすべてのロールを既存および新規のユーザーに割り当てるには、この値を「True」に設定します。

- 不足ロールの自動作成

- ユーザーのロール・ヘッダーに含まれており、現時点でOracle Enterprise Repositoryに存在しないロールの作成をOracle Enterprise Repositoryで許可するには、この値を「True」に設定します。この機能では、ロールを作成し、そのロールにユーザーを割り当てますが、作成したロールには権限が割り当てられません。

- 不足部門の自動作成

- この値を「True」に設定すると、ユーザーの部門ヘッダーに含まれており、現時点でOracle Enterprise Repositoryに存在しない部門の作成をOracle Enterprise Repositoryで許可します。この機能では、部門が作成され、ユーザーがその部門に割り当てられますが、新たに作成した部門はプロジェクトに割り当てられません。

11. 「システム設定」の「検索」テキスト・ボックスに「cookie login module」と入力します。「システム設定」のエンタープライズ認証グループでCookieログイン設定セクションが開きます。

12. Cookieログイン・モジュール・プロパティをFalseに設定します。

13. 「システム設定」の「検索」テキスト・ボックスに「plug-in login」と入力します。「システム設定」のエンタープライズ認証グループでプラグイン・ログイン設定セクションが開きます。

14. プラグイン・ログイン・モジュール・テキスト・ボックスに「false」と入力します。

15. 「保存」をクリックします。

3.2.2.2 Oracle Enterprise RepositoryのSSO統合およびBasic認証の使用

シングル・サインオンのインストールでBasic認証を使用している場合、Oracle Enterprise Repositoryのアセット・エディタを正しく機能させるには、追加のプロパティ設定が必要です。

1. 前述のプロセスを使用して、次のプロパティを有効にします。

- cmee.jws.suppress-authorization-header

2. プロパティを「True」に設定します。

3. 「保存」をクリックします。

3.2.2.3 アプリケーション・プロパティ・ファイルの手動による変更

前提条件: アプリケーション・サーバーを停止してください。プロパティ・ファイルを変更すると、アプリケーション・サーバー上で実行中のアプリケーションに影響を及ぼすことがあります。

1. WEB-INF/classesのcontainerauth.propertiesファイルを編集します。
このファイルには、シングル・サインオン・サーバー固有のヘッダー名のリストが含まれます。この情報は、シングル・サインオンが応答に使用するレスポンス・ヘッダーを表し、組織のシングル・サインオン管理者または設計者から取得する必要があります。

シングル・サインオンのレスポンスに電子メール・ヘッダーの適切な値がない場合は、trueのヘッダー値ではなく空白""を代用できます。シングル・サインオンで提供または生成されないその他のフィールドについては、nullのままにしてください。

(アスタリスク<*>は必須フィールドであることを示します。)

- 適切なOracle Enterprise Repositoryユーザー情報にマップする必要のあるヘッダー変数を構成します。

注意:

次に示す値は単なる例であり、使用するシングル・サインオン・システムで定義された正しいシングル・サインオン・レスポンス・ヘッダー名で置き換える必要があります。

- enterprise.container.auth.username = <UID>

- enterprise.container.auth.firstname = <FIRST_NAME>

- enterprise.container.auth.middlename = <MIDDLE_NAME>

- enterprise.container.auth.lastname = <LAST_NAME>

- enterprise.container.auth.status = <STATUS>

- enterprise.container.auth.email = <MAIL>

- enterprise.container.auth.phone = <PHONE>

- enterprise.container.auth.roles = <ROLES>

- enterprise.container.auth.depts = <DEPARTMENTS>

- enterprise.container.auth.enable-synch-roles = true

- enterprise.container.auth.roles-single-header = true

- enterprise.container.auth.roles-delimiter = \u0020

- enterprise.container.auth.enable-synch-depts = true

- enterprise.container.auth.depts-single-header = true

- enterprise.container.auth.depts-delimiter = \u0020

注意:

前述の最後の6つのプロパティは、ロールまたは部門(あるいはその両方)の同期が有効な場合に利用されます。1つのヘッダーには複数のロールまたは部門が指定されます。これらの追加のプロパティは、ブール・パラメータenable-synch-roles and enable-synch-deptsで提供される値に応じて無効化または無視できます。この例のデリミタ・フィールドでは、Unicodeスペース文字を使用していますが、Unicodeはその他のデリミタ文字には必要ありません。

2. シングル・サインオンWebエージェント・アプリケーションのほとんどが、アプリケーション・サーバーとは別のHTTPサーバーに対してデプロイされます。このシナリオでは、AJPタイプ・コンテナ(Apache HTTP Server向けのmod_jk/mod_jk2、IBM HTTP Server向けのmod_was_ap20_httpなど)によってHTTPサーバーがアプリケーション・サーバーにリンクされます。通常、HTTPサーバーはパフォーマンスまたはリソース・プールの理由から個別のマシン上で実行されます。このシナリオでは、アプリケーションの新しい名前を反映するように、cmee.propertiesファイルを変更する必要があります。

- WEB-INF/classesでcmee.propertiesファイルを編集します。

- オリジナル構成(Coyoteを使用するTomcat)
- cmee.server.paths.image=http\://tomcat.example.com\:8080/oer-web/images

- cmee.server.paths.jsp=http\://tomcat.example.com\:8080/oer

- cmee.server.paths.servlet=http\://tomcat.example.com\:8080/oer

- cmee.server.paths.jnlp-tool=http\://tomcat.example.com\:8080/oer-web/webstart

- cmee.server.paths.resource=http\://tomcat.example.com\:8080/oer-web

- cmee.enterprisetab.homepage=http\://tomcat.example.com\:8080/oer/custom/home.jsp

- cmee.assettab.asset-detail-page=http\://tomcat.example.com\:8080/oer/cmee/index.jsp

- 新しい構成(mod_jk2によるApache HTTPとTomcatの連携)
- cmee.server.paths.image=http\://apache.example.com/oer-web/images

- cmee.server.paths.jsp=http\://apache.example.com/oer

- cmee.server.paths.servlet=http\://apache.example.com/oer

-cmee.server.paths.jnlp-tool=http\://apache.exampe.com/oer-web/webstart

- cmee.server.paths.resource=http\://apache.example.com/oer-web

- cmee.enterprisetab.homepage=http\://apache.example.com/oer/custom/home.jsp

- cmee.assettab.asset-detail-page=http\://apache.example.com/oer/cmee/index.jsp

- この例で、リポジトリへ接続するための新しいURLは次のとおりです。http://apache.example.com/oer/index.jsp

3. Oracle Enterprise Repositoryアプリケーションを再起動します。

3.2.3 拡張オプション

次のオプションによって、デフォルトのロール割当て、新規ユーザーの作成と通知、部門の同期、およびロールの同期の機能が追加されます。

- 3.2.3.1項「新規ユーザーのデフォルト・ロールの作成と割当て」

- 3.2.3.2項「新規ユーザーの作成と未承認ユーザーの許可」

- 3.2.3.3項「未承認/新規ユーザー・ログインの有効化」

- 3.2.3.4項「新規ユーザー通知」

- 3.2.3.5項「部門の同期」

- 3.2.3.6項「ロールの同期」

- 3.2.3.7項「デバッグ・ロギングの有効化」

3.2.3.1 新規ユーザーのデフォルト・ロールの作成と割当て

拡張RBACを使用する場合:

1. Oracle Enterprise Repositoryのメニュー・バーで「管理」をクリックします。Oracle Enterprise Repositoryの「管理」画面が表示されます。

2. 「ロール」をクリックします。

3. 「新規作成」をクリックします。

4. 名前フィールドに「Browse_Only」と入力します。

- 新規ユーザーへの自動割当てを選択します。

- このプロファイルに合致する既存ユーザーを追加します。

5. 「保存」をクリックします。

6. ロール1: 作成/発行をクリックします。

7. 「編集」をクリックします。

- 新規ユーザーへの自動割当ての選択を解除します。

8. 「保存」をクリックします。

9. 「ユーザー」ロールをクリックします。

10. 「編集」をクリックします。

- 新規ユーザーへの自動割当ての選択を解除します。(Oracle Enterprise Repositoryに付属する「ユーザー」はデフォルト・ロールであり、新規ユーザーに自動的に割り当てられます。)

11. 「保存」をクリックします。

12. カスタム・アクセス設定をクリックします。

13. 「新規作成」をクリックします。

14. 名前フィールドに「Browse_Only」と入力します。

- すべての新規アセットへの自動割当てを選択します。

- ロールのリストでBrowse_Onlyを見つけます。

- 「ビュー」をチェックします。

15. 「保存」をクリックします。

16. 「OK」をクリックしてすべてのアセットに適用します。

基本アクセス設定を使用する場合:

1. Oracle Enterprise Repositoryのメニュー・バーで「管理」をクリックします。Oracle Enterprise Repositoryの「管理」画面が表示されます。

2. 「ロール」をクリックします。

3. 「新規作成」をクリックします。

4. 名前フィールドに「Browse_Only」と入力します。

- 新規ユーザーへの自動割当てを選択します。

- このプロファイルに合致する既存ユーザーを追加します。

5. 「ユーザー」ロールをクリックします。

6. 「編集」をクリックします。

- 新規ユーザーへの自動割当ての選択を解除します。(Oracle Enterprise Repositoryに付属する「ユーザー」はデフォルト・ロールであり、新規ユーザーに自動的に割り当てられます。)

7. 「保存」をクリックします。

3.2.3.2 新規ユーザーの作成と未承認ユーザーの許可

Oracle Enterprise Repositoryシングル・サインオン認証の統合では、認証が完了すると、Oracle Enterprise Repositoryデータベース内に新規ユーザーが自動的に作成されます。新規ユーザーに付与される特定のアクセス権および権限は、前の項で説明しているとおり、デフォルトの新規ユーザー・ロールの構成によって決定されます。アクセス管理者によって承認されると、新規ユーザーはそれぞれアクセス設定が異なる別のロールに割り当てられる場合があります。ただし、ロール同期を有効にしてシングル・サインオン統合が構成されている場合、ユーザーにはシングル・サインオンのレスポンス・ヘッダーで提供されるロールが割り当てられます。

3.2.3.3 未承認/新規ユーザー・ログインの有効化

有効な場合、このオプションによって未承認/新規のOracle Enterprise Repositoryユーザーにシングル・サインオン認証後のアプリケーションへのアクセスが許可されます。無効な場合、新規または未承認ユーザーはOracle Enterprise Repositoryにアクセスできません。この機能は、アプリケーションにアクセスする前に手動での認証プロセスが必要な場合に特に役立ちます。

- 未承認ユーザー・ログインの有効化 = true (ファイル: enterprise.properties)

- enterprise.security.unapproveduser.allowlogin=true

3.2.3.4 新規ユーザー通知

有効な場合、このプロパティは、シングル・サインオンによってOracle Enterprise Repositoryに新規ユーザー・アカウントが追加されたことを、アクセス管理者に電子メールで通知します。

- 新規ユーザー通知の有効化 = true (ファイル: cmee.properties)

- cmee.new.unapproved.users.notify=true

3.2.3.5 部門の同期

有効な場合、このプロパティによってシングル・サインオンのレスポンス・ヘッダー値からの部門名が同期されます。

- 部門の同期の有効化 = true (ファイル: containerauth.properties)

- enterprise.container.auth.enable-synch-depts - 既知の部門がユーザーと同期されるようにするにはtrueに設定し、それ以外の場合はfalseに設定します。

- 部門の作成の有効化 = true (file: containerauth.properties)*

- enterprise.container.auth.auto-create-missing-depts - ユーザーの部門がログイン時に自動的に作成されるようにするにはtrueに設定し、それ以外の場合はfalseに設定します。

部門の同期に関する注意事項

シングル・サインオン統合では、新規部門は作成されません。単に、Oracle Enterprise Repository内にすでに存在し、シングル・サインオンのレスポンス・ヘッダー値に指定されている名前と同じ名前の部門とユーザーがリンクされます。

シングル・サインオン・サーバーは、ユーザーが割り当てられている各部門の名前が同じであり、値が異なる複数のヘッダー、またはユーザーが割り当てられている部門すべてを含む1つのヘッダーを渡すよう構成されます。

- 構成1 - 名前が同じであり、それぞれの値の異なる複数のヘッダー:
enterprise.container.auth.enable-synch-depts= true

enterprise.container.auth.depts-single-header= false

enterprise.container.auth.depts-delimiter= ""

enterprise.container.auth.depts= DEPT_HEADER_NAME

DEPT_HEADER_NAME=DEPTA

DEPT_HEADER_NAME=DEPTB

DEPT_HEADER_NAME=DEPTC

次ではありません

DEPT_HEADER_NAME=DEPTA DEPTB DEPTC ..

- 構成2 - デリミタで区切られている複数の値のある1つのヘッダー:
enterprise.container.auth.enable-synch-depts= true

enterprise.container.auth.depts-single-header= true

enterprise.container.auth.depts-delimiter= "^"

enterprise.container.auth.depts= DEPT_HEADER_NAME

DEPT_HEADER_NAME=DEPTA^DEPTB^DEPTC^ ...

次ではありません

DEPT_HEADER_NAME=DEPTA

DEPT_HEADER_NAME=DEPTB

DEPT_HEADER_NAME=DEPTC

3.2.3.6 ロールの同期

有効な場合、このプロパティによってシングル・サインオンのレスポンス・ヘッダー値からのロール名が同期されます。

- ロールの同期 = true (ファイル: containerauth.properties)

- enterprise.container.auth.auto-create-missing-roles - 不明ロールが自動的に作成されるようにするにはtrueに設定し、それ以外の場合はfalseに設定します。

ロールの同期に関する注意事項

シングル・サインオン統合では、新規ロールを作成できます。Oracle Enterprise Repository内にすでに存在し、シングル・サインオンのレスポンス・ヘッダー値で指定される名前と同じ名前のロールにユーザーがリンクされます。また、既存のロールへのリンクに加えて、Oracle Enterprise Repository内にないヘッダー値のロールも統合によって作成されます。この方法で作成されたロールには、デフォルトでは権限が割り当てられていません。

- 不足ロールの作成の有効化 = true (ファイル: containerauth.properties)

- enterprise.container.auth.auto-create-missing-roles = true

シングル・サインオン・サーバーは、ユーザーが割り当てられている各ロールのヘッダー値を1つ渡すよう構成できます。

- 構成1 - 名前が同じであり、それぞれの値の異なる複数のヘッダー:
enterprise.container.auth.enable-synch-roles= true

enterprise.container.auth.roles-single-header= false

enterprise.container.auth.roles-delimiter= ""

enterprise.container.auth.roles= ROLE_HEADER_NAME

ROLE_HEADER_NAME=ROLEA

ROLE_HEADER_NAME=ROLEB

ROLE_HEADER_NAME=ROLEC

次ではありません

DEPT_HEADER_NAME=ROLEA ROLEB ROLEC ...

- 構成2 - デリミタで区切られている複数の値のある1つのヘッダー:
enterprise.container.auth.enable-synch-roles= true

enterprise.container.auth.roles-single-header= true

enterprise.container.auth.roles-delimiter= "^"

enterprise.container.auth.roles= ROLE_HEADER_NAME

DEPT_HEADER_NAME=ROLEA^ROLEB^ROLEC^ ...

次ではありません

ROLE_HEADER_NAME=ROLEA

ROLE_HEADER_NAME=ROLEB

ROLE_HEADER_NAME=ROLEC

3.2.3.7 デバッグ・ロギングの有効化

デバッグ・ロギングを有効化するには、log4fl.propertiesファイルに次の行を追加します。

log4j.category.com.oer.enterprise.authentication.client.LoginContext=debug, cmeeLog

3.3 コンテナ管理の設定

この項では、コンテナ管理の設定を使用してOracle Enterprise Repositoryのユーザーを認証する方法について説明します。

この項には次のトピックが含まれます:

- 3.3.1項「概要」

- 3.3.2項「コンテナ管理認証を使用するOracle Enterprise Repositoryの構成」

- 3.3.3項「コンテナ認証を許可するためのWebアプリケーションのWeb.xmlファイルの変更」

3.3.1 概要

Oracle Enterprise Repositoryアプリケーション内の値を有効化する前に、レルムまたはオーセンティケータ・バックエンドでコンテナが適切に構成されます。

3.3.2 コンテナ管理認証を使用するOracle Enterprise Repositoryの構成

Oracle Enterprise Repositoryのコンテナ管理認証は、アクセス管理者権限で構成できます。この手順は、Oracle Enterprise Repositoryの「管理」画面で実行します。

1. 「システム設定」の「検索」テキスト・ボックスに「container login module」と入力します。図3-5に示すように、エンタープライズ認証グループにコンテナ・ログイン・モジュール・セクションが表示されます。

2. プロパティを次に示すとおり変更します。

- コンテナ・ログイン・モジュール・クラス名

- テキスト・ボックスに「com.oer.enterprise.authentication.server.loginmodule.ContainerLogin」と入力します。

- コンテナ・ログイン・モジュール表示名

- テキスト・ボックスに「Container Login Module」と入力します。

- コンテナ・ログイン・モジュール

- プロパティを「True」に設定します。

- コンテナ管理認証機能の有効化

- enterprise.authentication.container.enabledをTrueに設定します。

- ユーザーのセキュリティ・プリンシパルからのロール同期の有効化

- enterprise.authentication.container.synchroles.enabledをTrueに設定します。

注意:

BPM Harvester、Exchange Utilityまたはその他のREX操作でコンテナ管理認証を使用する場合、このプロパティはfalseに設定する必要があります。このプロパティをfalseに設定すると、最低限のAdministrator-level権限のあるユーザーが手動でユーザー・アカウントを作成し、それにロールを割り当てる必要があります。

3. 「保存」をクリックします。

4. 「システム設定」の「検索」テキスト・ボックスに「cookie login module」と入力します。「システム設定」のエンタープライズ認証グループでCookieログイン設定セクションが開きます。

5. Cookieログイン・モジュール・プロパティをFalseに設定します。

6. 「保存」をクリックします。

7. 「システム設定」の「検索」テキスト・ボックスに「plug-in login」と入力します。「システム設定」のエンタープライズ認証グループでプラグイン・ログイン設定セクションが開きます。

8. プラグイン・ログイン・モジュール・テキスト・ボックスに「false」と入力します。

9. 「保存」をクリックします。

3.3.3 コンテナ認証を許可するためのWebアプリケーションのWeb.xmlファイルの変更

1. Oracle Enterprise Repositoryアプリケーション、またはこれが実行されているアプリケーション・サーバーを停止します。

2. Oracle Enterprise Repository web.xmlファイルを変更します。

- 次のセキュリティ制約内容をファイルの末尾に追加します。

注意:

ユーザーの認証条件に一致させるには、この構成を変更する必要があります。この例ではBASIC認証を使用していますが、使用している環境には適していない場合があります。

<!-- Define a security constraint on this application -->
<security-constraint>
<web-resource-collection>
<web-resource-name>Entire Application</web-resource-name>
<url-pattern>/*</url-pattern>
<http-method>GET</http-method>
<http-method>PUT</http-method>
<http-method>POST</http-method>
<http-method>DELETE</http-method>
</web-resource-collection>
<auth-constraint>
<description>These roles have access to the Oracle Enterprise
Repository</description>
<role-name>user</role-name>
</auth-constraint>
</security-constraint>
<security-constraint>
<web-resource-collection>
<web-resource-name>Secure Web Service</web-resource-name>
<url-pattern>/services/OERRegistry</url-pattern>
</web-resource-collection>
</security-constraint>
<!-- Define the login configuration for this application -->
<login-config>
<auth-method>BASIC</auth-method>
<realm-name>Oracle Enterprise Repository</realm-name>
</login-config>
<security-role>
<role-name>user</role-name>
<role-name>admin</role-name>
<role-name>accessAdministrator</role-name>
<role-name>advancedSubmitter</role-name>
<role-name>businessAnalyst</role-name>
<role-name>projectAdministrator</role-name>
<role-name>projectArchitect</role-name>
<role-name>registrar</role-name>
<role-name>registrarAdministrator</role-name>
<role-name>systemAdministrator</role-name>
</security-role>

3. Oracle Enterprise Repositoryアプリケーションを開始または再起動します。

4 拡張ロールベース・アクセス制御の構成

この章では、拡張ロールベース・アクセス制御の概要を示すとともに、ロールベース・アクセス制御における様々な概念について説明します。

この章には、次のセクションがあります。

- 4.1項「概要」

- 4.2項「セキュリティに関する考慮事項」

- 4.3項「基本的な概念」

- 4.4項「アクセス定義」

- 4.5項「プロセスの概要」

- 4.6項「権限の付与および拒否」

- 4.7項「既存のロールのアクセス設定の構成」

- 4.8項「ロールベース・アクセス制御のユースケース」

4.1 概要

拡張ロールベース・アクセス制御が有効な場合、組織では、Oracle Enterprise Repositoryコンテンツへのアクセスおよびこれらのコンテンツの表示を、ロールごとにアセット・レベルとファイル・レベルで制限できます。これを行うには、対象となる特定のコミュニティへのアクセスを制限するために、アセットまたはファイル(あるいはその両方)にカスタム・アクセス設定を適用します。

この基本機能は、次のような組織における様々な戦略に適用できます。

- 顧客や取引パートナにWebサービスを公開します。

- アウトソーシング先の開発チームが使用できる知的財産を制限し、輸出規制を管理します。

- 企業アセットの表示やアセットへのアクセスを全従業員に許可するが、ドメイン固有の情報を適切なドメイン内のユーザーに限定するフェデレーテッド・リポジトリを確立します。

- ユーザーが実行できるアクション(アセットの発行、受入れ、登録など)を管理します。

- 開発中のアセットおよびリタイア済アセットの表示を制限します。

- ソース・コード・ファイルへのアクセスをアセット生成チームに限定します。

- Oracle Enterprise Repositoryの参照専用のアクセス権を選択したグループに付与します。

4.2 セキュリティに関する考慮事項

ロールベース・アクセス制御(RBAC)を使用すると、Oracle Enterprise Repositoryでは、アセットの使用と生成をユーザー単位で追跡できます。また、アセットの提示方法をパーソナライズして、Oracle Enterprise Repository内の指定のコンテンツの表示を制限することもできます。ただし、ロールベースのアクセス制御はアセット・メタデータに対するセキュリティの提供を想定しておらず、基盤となるアセット・リポジトリのセキュリティ補完も想定していません。

Oracle Enterprise Repositoryのアクセス設定では、セキュリティを強化しないと安全ではないアセットやデータに対してもセキュリティは強化されません。セキュリティを最大限向上させるには、保護されていないデータベース内のアセット・メタデータへの直接アクセスを防ぐ方法でメタデータを管理する必要があります。機密情報は、アセットのダウンロード可能なペイロードに組み込むか、またはドキュメント・ファイルとして添付し、保護されたリポジトリでホストする必要があります。

注意:

認証および権限の問題を基盤となるアセット・リポジトリから回避することを選択した場合は、ご自身の責任でこれを行う必要があります。

次のアクションもセキュリティに影響を与える可能性があります。

- 単一のOracle Enterprise Repositoryユーザー・アカウントを介してアクセスするためのSCMシステムの構成

- 未承認ユーザーによるシステムへのアクセスの許可

前述のアクションでは、Oracle Enterprise Repositoryへのネットワーク・アクセスが可能なユーザーにリポジトリのコンテンツを公開する可能性があります。

4.2.1 アクセス設定およびアセット・エディタ

使用するアクセス設定に応じて、アセット・エディタへのアクセス権を持つユーザーは、このようなアクセス権を持たないとOracle Enterprise Repositoryでユーザーに対して表示されないアセットとのリレーションシップを参照できます。この状況では、非表示のアセットの名前が表示され、そのアセットとそのユーザーがアクセスできるアセットとのリレーションシップの詳細が表示されます。アセット・エディタでは、非表示のアセットのそれ以外の情報は表示されません。この状況では、表示されるアセットと非表示のアセットのリレーションシップを削除できます。ただし、表示されないアセットにユーザーがアクセスできない場合、そのリレーションシップを復元することはできません。

4.2.2 カスタム・アクセス設定の有効化

Oracle Enterprise Repositoryのユーザーの場合は、通常、カスタム・アクセス設定がインストール時にすでに有効になっており、適切に構成されています。そうでない場合、カスタム・アクセス設定を有効にするには、3つのプロパティを構成する必要があります。

1. Oracle Enterprise Repositoryの「管理」ページのサイドバーにある「システム設定」をクリックします。メイン・ペインで「システム設定」セクションが開きます。

2. 「新しいシステム設定の有効化」テキスト・ボックスに「cmee.customaccesssettings.enabled」と入力します。

3. 「有効化」ボタンをクリックします。図4-1に示すように、機能設定セクションの拡張ロールベース・アクセス制御グループにカスタム・アクセス設定が表示されます。

図4-1 機能設定

4. このプロセスを繰り返して、次の各プロパティを有効にします。

- cmee.customaccesssettings.file

- cmee.customaccesssettings.asset

有効にすると、3つのすべてのCASシステム設定が機能設定セクションの拡張ロールベース・アクセス制御グループに表示されます。(いずれかのプロパティを無効にすると、この機能が無効になります。)

注意:

これらのアクセス設定がシステム設定: アクセス・リストに表示されない場合は、システム管理者またはOracle Enterprise Repositoryカスタマ・サポートまでご連絡ください。

5. 各設定が「True」に設定されていることを確認します。

6. 終了したら、「保存」をクリックします。これで、図4-2に示すように、カスタム・アクセス設定が「管理」ページ画面のサイドバーに表示されます。

図4-2 カスタム・アクセス設定

4.3 基本的な概念

この項では、ロールベース・アクセス制御の基本的な概念について説明します。この節では、以下のトピックについて説明します。

- 4.3.1項「ロール」

- 4.3.2項「アクセス設定」

4.3.1 ロール

Oracle Enterprise Repositoryのコンテキスト内において、ロールは職務と職責の特定の組合せによって定義されます。任意のユーザーに複数のロールを割り当てることができます。特定のアセットまたはアセットの集合、およびOracle Enterprise Repositoryの様々な機能へのアクセスは、各ロールのアクセス設定の構成によって決定されます。

4.3.2 アクセス設定

アクセス設定では、ロールによって実行可能な職務と職責を特定します。Oracle Enterprise Repositoryのアクセス設定は、次の2つのカテゴリに分けられます。

- 基本アクセス設定(BAS)では、Oracle Enterprise Repository内のすべてのアセットおよび特定のツール(アセット・エディタなど)へのアクセスを決定します。基本アクセス設定では、システム全体の一般的な機能に対する各ユーザーの権限を決定します。たとえば、表示権限を持つユーザーは、Oracle Enterprise Repository内のすべてのアセットを表示できます。使用とダウンロードの権限を持つユーザーは、Oracle Enterprise Repository内のすべてのアセットのすべてのファイルをダウンロードできます。

- カスタム・アクセス設定(CAS)が有効な場合は、Oracle Enterprise Repository内の特定のアセットおよびファイルにアクセスする権限がユーザーに付与されます。たとえば、カスタム・アクセス設定では、特定のアセットのグループの表示、特定のアセットの編集、特定のアセット・セット内の特定のファイルの表示などの機能をユーザーに付与できます。

すべてのサイトで基本アクセス設定が有効になっています。カスタム・アクセス設定は、リポジトリの構成に応じて有効にできます。

4.4 アクセス定義

この項では、Oracle Enterprise Repositoryの様々な定義について説明します。この項には次のトピックが含まれます:

- 「アセット」

- 「アクセス」

- 「ポリシー」

- 「プロジェクト」

- 「レポート」

- 「システム管理」

アセット

制御されるツール: 「アセット」タブ、アセット・エディタ、タイプ・マネージャ(リポジトリの構成で有効な場合)。

権限

説明

BAS

CAS

表示

アセット詳細にアクセスします。

可

可

使用

アセット詳細に「使用/ダウンロード」ボタンを表示します。

可

可

ダウンロード

アセットの「使用/ダウンロード」ボタンをクリックした後、ファイルのリンクにアクセスします。

可

可

レビュー

アセット詳細のレビュー機能にアクセスします。

可

可

通知

アセットに関する非定型の電子メール通知をサブスクライバに送信します。

可

可

編集

アセット・エディタにアクセスします。

可

可

受入れ

アセット・エディタに「受入れ」ボタンを表示します。

可

可

タブの承認

アセット・エディタの各タブの一番下に「承認」ボタンを表示します

可

可

登録

アセット・エディタを使用してアセットを登録する機能です。

可

可

アクセス設定の編集

(CASのみ)すべてのアセットに対するCASの権限を変更する機能をユーザーに提供します。

可

可

作成/発行

Oracle Enterprise Repositoryの「アセット」画面を使用してアセットを発行し、アセット・エディタを使用して新しいアセットを作成する機能です。

可

アセット・エディタの起動

アセット・エディタにアクセスします。

可

アーティファクト・ストアの編集

アセット・エディタを使用してアーティファクト・ストアを作成および編集する機能です。

可

アセット・タイプの編集

タイプ・マネージャを使用してタイプ・メタデータを構成する機能です。アセット・エディタ権限が必要です。

可

アクセス

制御される機能: 「管理」画面、「ユーザー」、「セッション」、「ロール」、「部門」、「ファイル・ストア」、基本アクセス設定、カスタム・アクセス設定(リポジトリの構成で有効な場合)。

権限

説明

BAS

CAS

表示

前述のセクションにエントリを表示します。

可

編集

前述のセクションのエントリを編集します。

可

作成

ユーザー、ロール、部門、ファイル・ストアおよびカスタム・アクセス設定を作成します。

可

削除

セッション、ロール、およびカスタム・アクセス設定を削除します。

可

ポリシー

制御されるツール: 「ポリシー」画面(リポジトリの構成で有効な場合)。

権限

説明

BAS

CAS

ポリシーの適用

ユーザーが他のアセットにポリシーを適用できるようになります。

可

プロジェクト

制御される機能: 「プロジェクト」画面(リポジトリの構成で有効な場合)。

権限

説明

BAS

CAS

表示

「プロジェクト」画面にプロジェクトを表示します。

可

編集

「プロジェクト」画面のプロジェクトを編集します。

可

作成

「プロジェクト」画面でプロジェクトを作成します。

可

テンプレートの適用

アセット詳細またはアセット・エディタからコンプライアンス・テンプレートをプロジェクトに適用します。

可

レポート

制御される機能: 「レポート」画面(リポジトリの構成で有効な場合)。

権限

説明

BAS

CAS

表示

レポートを表示します。

可

システム管理

制御される機能: 「管理」画面: 「システム設定」、電子メール・テンプレート

権限

説明

BAS

CAS

編集

一般設定、セキュリティ設定、認証設定、およびファイル・ストア設定を編集できます。

可

有効化

新しい一般設定、セキュリティ設定、認証設定、およびファイル・ストア設定を有効化できます。

可

注意:

BASまたはCASを使用する場合は、グローバル機能の権限および機能を付与するために、BASで次のグローバル権限を保持する必要があります。

- 作成/発行

- アセット・エディタの起動

- アーティファクト・ストアの編集

- タイプの編集

4.5 プロセスの概要

次に示すいくつかの簡単な手順を行うのみで、様々なセキュリティ・モデルを組織で確立できます。

- ロールの設定

- ロールへのユーザーの割当て

- BASおよびCASを使用したロールへの権限の付与

- アセットまたはファイルへのCASの割当て

図4-3に、プロセスの概要を示します。

図4-3 プロセスの概要

4.6 権限の付与および拒否

通常、個々のユーザーは複数のOracle Enterprise Repositoryロールを所有します。たとえば、ユーザーは「ユーザー」ロールとレジストラ・ロールの両方を所有できます。この場合、レジストラには「ユーザー」には付与されない権限があります。同様に、アウトソーシング先の開発ユーザーは、「ユーザー」ロールと「アウトソーシング先の開発」ロールの両方を所有できます。「ユーザー」ロールでは、リポジトリ内のすべてのアセットへのアクセスを許可し、「アウトソーシング先の開発」ロールでは、機密情報を含むアセットへのアクセスを拒否します。

特定のOracle Enterprise Repositoryユーザーに特定の権限を割り当てる方法を決定する場合は、権限のステータスが次の3つのレベルに分けられることに注意してください。

- 付与済
権限が明示的に付与されます。

- 付与なし
権限が明示的に付与または拒否されません。

- 拒否済
権限が明示的に拒否されます。

複数のロールが存在する場合、Oracle Enterprise Repositoryでは最も制約の厳しいアクセス権を承認します。つまり、権限ステータスの設定では、「拒否済」が「付与済」よりも優先されます。あるユーザーが割り当てられているロールに対して明確に拒否される権限は、それ以外のロールの同じユーザーに対しても拒否されます。

この項には次のトピックが含まれます:

- 4.6.1項「特定のアセットに対するアクセス権の付与または拒否」

- 4.6.2項「アセット内の特定のダウンロード可能ファイルに対するアクセス権の付与または拒否」

4.6.1 特定のアセットに対するアクセス権の付与または拒否

拡張ロールベース・アクセス制御が構成で有効な場合は、カスタム・アクセス設定を使用して、個々のアセットやファイルにアクセスする権限を付与または拒否できます。アセットCASを作成するには、アクセス管理者ロールと次の(BAS)権限の両方が割り当てられる必要があります。

- アセット・エディタの起動

- アクセス設定の編集

既存のアクセス設定を変更するには、アセット・エディタへのアクセス権とアセットを編集する権限が必要です。Oracle Enterprise Repositoryの保護機能により、アセットのアクセス設定の編集後にユーザーがアセットからロックアウトされる可能性はなくなります(アセットに対するそのような変更を保存することはできません)。ただし、ロール設定に対する変更によって、特定のアセットへのアクセスが制限される場合があります。ロール設定を編集する場合は十分に注意してください。

4.6.1.1 前提条件

- すべての対象ユーザーがOracle Enterprise Repositoryに存在することを確認します。

- グローバルBAS権限(アセットの作成/発行、アセット・エディタの起動)を各ユーザーに割り当てます。

適切なユーザーが含まれる既存のロールがない場合は、作成する必要があります。この手順は、Oracle Enterprise Repositoryの「管理」ページで実行します。

1. 左サイドバーの「ロール」を選択します。図4-4に示すように、「ロール」セクションが表示されます。

図4-4 「ロール」セクション

2. 「新規作成」をクリックします。図4-5に示すように、「新しいロールの作成」ダイアログが表示されます。

図4-5 「新しいロールの作成」ダイアログ

3. 「名前」フィールドおよび「説明」フィールドに適切な情報を入力します。

4. 「保存」をクリックします。

4.6.1.2 アセットCASの作成

この手順は、Oracle Enterprise Repositoryの「管理」ページで実行します。

1. 左サイドバーの「ロール」を選択します。図4-6に示すように、使用可能なロールのリストがメイン・ペインに表示されます。

図4-6 ロールのリスト

2. リストから、編集するロールを選択します。メイン・ペインの下部のフレームにロールの詳細が表示されます。

3. ロールの詳細の「編集」ボタンをクリックします。図4-7に示すように、「ロールの編集」ダイアログが表示されます。

図4-7 「ロールの編集」ダイアログ

4. 「ロールの編集」ダイアログの「ユーザー」セクションの「ユーザーの編集」ボタンをクリックします。図4-8に示すように、「ユーザーの追加」ダイアログが表示されます。

図4-8 ユーザーおよびアクセス設定の検索/フィルタ処理

5. 「検索」を使用するか、すべてをリストをクリックし、「使用可能なユーザー」列に値を移入します。

6. 「<<」および「>>」ボタンを使用して、「使用可能なユーザー」列から「選択したユーザー」列にユーザーを移動します。

7. 終了したら、「OK」をクリックします。「ユーザーの追加」ダイアログが閉じ、選択したユーザーが「ロールの編集」ダイアログの「ユーザー」セクションに表示されます。

8. 「OK」をクリックします。「ロールの編集」ダイアログが閉じます。

9. 「管理」画面のサイドバーにあるカスタム・アクセス設定をクリックします。図4-9に示すように、カスタム・アクセス設定セクションが表示されます。

図4-9 カスタム・アクセス設定セクション

10. 「新規作成」をクリックします。図4-10に示すように、「新規カスタム・アクセス設定の作成」ダイアログが表示されます。

図4-10 「新規カスタム・アクセス設定の作成」ダイアログ

11. 「名前」テキスト・ボックスと「説明」テキスト・ボックスに必要に応じてテキストを入力します。

12. 「タイプ」リストで「アセット」を選択します。

13. 「権限の設定」セクションのオプションを使用して、適切なロールに関連する権限を割り当てます。

- 図4-11に示すように、1回クリックすると、権限が付与されます。

図4-11 チェック・マーク

- 図4-12に示すように、2回クリックすると、権限が拒否されます。

図4-12 クロス・マーク

- 3回クリックすると、オプションがクリアされます(権限が付与されていない状態です)。

図4-13 空白

14. 終了したら、「保存」をクリックします。「新規カスタム・アクセス設定の作成」ダイアログが表示されます。

15. Oracle Enterprise Repositoryのメニュー・バーの「アセット」リンクをクリックします。

16. アセットの編集/管理をクリックします。図4-14に示すように、アセット・エディタが表示されます。

図4-14 アセット・エディタ・ウィンドウ

17. 新しいカスタム・アクセス設定を適用するアセットを検索して開きます(または、必要に応じて作成します)。

18. 図4-15に示すように、アセットの「管理」タブをクリックします。

図4-15 「管理」タブ

19. 必要に応じて「<<」および「>>」ボタンを使用して、新しいCASを「使用可能」列から「選択済」列に移動します。

20. ユースケースで指定するユーザー権限と指定しないユーザー権限を確認することにより、CASをテストします。「アクセスの表示」ボタンをクリックして、ユーザー・アクセスを確認します。

4.6.2 アセット内の特定のダウンロード可能ファイルに対するアクセス権の付与または拒否

このファイルCASまたは任意のファイルCASを作成するには、アクセス管理者ロールと次の(BAS)権限の両方が割り当てられる必要があります。

- アセット・エディタの起動

- アクセス設定の編集

4.6.2.1 前提条件

- すべての対象ユーザーがOracle Enterprise Repositoryに存在することを確認します。

- グローバルBAS権限(アセットの作成/発行、アセット・エディタの起動)を各ユーザーに割り当て、アセットの発行と編集を許可します。

適切なユーザーが含まれる既存のロールがない場合は、作成する必要があります。この手順は、Oracle Enterprise Repositoryの「管理」画面で実行します。

1. 「ロール」をクリックします。

2. 「新規作成」をクリックします。

3. 「新規ユーザーの作成」ウィンドウの「名前」フィールドおよび「説明」フィールドに適切な情報を入力します。

4. 「保存」をクリックします。

4.6.2.2 ファイルCASの作成

この手順は、Oracle Enterprise Repositoryの「管理」画面で実行します。

1. 「ロール」をクリックします。

2. 「ロールの編集」画面の「ユーザーの編集」ボタンを使用して、新しいロールに適切なユーザーを追加します。

3. 終了したら、「保存」をクリックします。

4. Oracle Enterprise Repositoryのメニュー・バーの「管理」をクリックします。

5. 「管理」画面のサイドバーにあるカスタム・アクセス設定をクリックします。カスタム・アクセス設定セクションが表示されます。

6. 「新規作成」をクリックします。「新規カスタム・アクセス設定の作成」ダイアログが表示されます。

7. 「名前」テキスト・ボックスと「説明」テキスト・ボックスに必要に応じてテキストを入力します。

8. 「タイプ」リストで「ファイル」を選択します。

9. 「権限の設定」セクションで、適切なロールを選択し、このCASに「ダウンロード」権限を割り当てます。

10. 「保存」をクリックします。

11. Oracle Enterprise Repositoryのメニュー・バーの「アセット」リンクをクリックします。

12. アセットの編集/管理をクリックします。アセット・エディタ画面が表示されます。

13. 新しいカスタム・アクセス設定を適用するアセットを検索して開きます(または、必要に応じて作成します)。

14. アセットの「ファイル情報」メタデータ要素を探します。

15. 対象のファイルを選択します。

16. 「編集」ボタンをクリックします。

17. 「編集」ウィンドウのカスタム・アクセス設定セクションで、新しいファイルCASのみを注意して選択します。対象のファイルが存在しない場合は、新しいファイルを追加し、(カスタム・アクセス設定セクションで)新しいファイルCASを選択します。

18. アセットの「管理」タブをクリックします。

19. ユースケースで指定するユーザー権限と指定しないユーザー権限を確認することにより、CASをテストします。アセットの「アクセスの表示」ボタンをクリックして、ユーザー・アクセスを確認します。

最も一般的なセキュリティ・ユースケースのいくつかのシナリオを次の各項で示します。ただし、いずれかの新しいセキュリティ・モデルを実装する前に、カスタム・アクセス設定をサポートするようにシステム内の既存のロールを構成する必要があります。

4.7 既存のロールのアクセス設定の構成

Oracle Enterprise Repositoryには、次に定義されているように、複数のデフォルトのロールが付属しています。カスタム・アクセス設定用にOracle Enterprise Repositoryを構成する場合は、基本アクセス設定とカスタム・アクセス設定の組合せを使用してこれらのロールを再確立し、カスタム・アクセス設定によって既存のユーザー・アクセス権限が混乱しないようにする必要があります。

4.7.1 ユーザー・ロールおよびデフォルトの権限

ユーザー

Oracle Enterprise Repositoryのユーザー名とパスワードを持つすべてのユーザー。このロールは、ユーザー・アカウントの作成時、新しいユーザーのデフォルト・ロールとして割り当てることができます。すべてのOracle Enterprise Repositoryユーザーは、次の操作を行うことができます。

- ホスト会社の戦略に関するホームページでのニュースの表示

- アセットの検索、評価および使用

- プロジェクトの表示(有効な場合)

- レポートの生成(有効な場合)

- レジストラへのアセットの発行

アクセス管理者

アクセス管理者は、すべてのOracle Enterprise Repositoryユーザー・アカウントを作成し、権限を割り当てます。アクセス管理者は、Oracle Enterprise Repositoryの「管理」画面で使用できる機能について理解しておく必要があります。アクセス管理者は、通常、次の操作を行うことができます。

- ユーザーと権限の作成、表示および編集

- レポートの生成(有効な場合)

上級発行者

上級発行者ロールは、通常、アセットのビルダーおよびハーベスタに割り当てられます。アセットのビルダーは、組織のアセットのニーズや個々のプロジェクトのニーズに対応したアセット・コンテンツ・ベースを構築します。ハーベスタは将来のアセット再利用のために導入後のプロジェクトを検証します。上級発行者は、通常、次の操作を行うことができます。

- アセットの検索、評価および使用

- アセットに関連付けられたプロジェクトの表示(有効な場合)

- レポートの生成(有効な場合)

- レジストラへのアセットの発行

- アセット登録前のアセット・メタデータの編集

レジストラ

レジストラは、アセットの受入れまたは拒否および登録を行います。対処する機能に応じて、複数の人がリポジトリ・レジストラとしての役割を果たす場合があります。レジストラは、通常、次の操作を行うことができます。

- アセットの検索、評価および使用

- アセットに関連付けられるプロジェクトの表示

- レポートの生成(有効な場合)

- レジストラへのアセットの発行

- アセット登録前のアセット・メタデータの編集

- 登録プロセスのアセットの受入れ

- アセット・エディタのタブの承認

- アセットの登録

- アクセス設定の編集

レジストラ管理者

レジストラ管理者は、リポジトリの構成で有効な場合、タイプ・マネージャを使用してOracle Enterprise Repository内のアセット、コンプライアンス・テンプレートおよびポリシー・タイプを確立および管理します。レジストラ管理者は、通常、次の操作を行うことができます。

- アセットの検索、評価および使用

- アセットに関連付けられたプロジェクトの表示(有効な場合)

- レポートの生成(有効な場合)

- レジストラへのアセットの発行

- アセット登録前のアセット・メタデータの編集

- 登録プロセスのアセットの受入れ

- アセット・エディタのタブの承認

- アセットの登録

- アクセス設定の編集

- アーティファクト・ストアの編集

- タイプの編集(有効な場合)

プロジェクト管理者

複数のデフォルトのプロジェクトがリポジトリの構成で有効な場合、Oracle Enterprise Repositoryでは、メンテナンス用の履歴を維持するために、アセットの使用状況をプロジェクト・レベルで追跡します。プロジェクト管理者は、Oracle Enterprise Repositoryの「プロジェクト」画面(適切な権限を持つユーザーにのみ表示されます)を使用してプロジェクトを作成し、プロジェクトにユーザーを割り当てます。また、プロジェクト管理者は、プロジェクトを終了して、どのアセットがデプロイされたかを示します。プロジェクト管理者は、通常、次の操作を行うことができます。

- プロジェクトの作成、編集および表示(有効な場合)

- レポートの生成(有効な場合)

システム管理者

システム管理者は、Oracle Enterprise Repositoryを使用するための構成を行います。システム管理者は、通常、次の操作を行うことができます。

- システム設定の有効化および編集

- レポートの生成(有効な場合)

4.7.2 アクセスのオプション

既存のロールのアクセス設定を構成する場合は、次に示す2つのオプションを使用できます。拡張ロールベース・アクセス制御が有効な場合は、カスタム・アクセス設定を使用して、個々のアセットやファイルへのアクセスを制御できます。

- オプション1 - アセットへのアクセス
アセットへのアクセスを許可または拒否します。このオプションは、カスタム・アクセス設定を使用して特定のドメイン内の開発者、顧客や取引パートナ、アウトソーシング先の開発者にアセットのサブセットを公開する組織に役立ちます。

オプション1の用途:

- 顧客や取引パートナにWebサービスを公開します。

- アウトソーシング先の開発チームへの知的財産の公開を制限し、輸出規制の対象となるアセットを管理します。

- 企業アセットの表示やアセットへのアクセスを全従業員に許可するが、ドメイン固有の情報を適切なドメインに属するユーザーに限定するフェデレーテッド・リポジトリを確立します。

- 開発中のアセットへのアクセスを制限することにより、アセット・ライフサイクルを管理します。

- 特定のグループをリポジトリへの参照専用のアクセス権に制限します。

- オプション2 - ファイル・アクセス
アセット内のダウンロード・ファイル/ペイロードに対するアクセスを許可または拒否します。このオプションは、カスタム・アクセス設定を使用して、ブラック・ボックスの再利用をサポートする組織に役立ちます。たとえば、開発者はコンパイル済コードにアクセスでき、アセットのプロデューサと保持担当者はソース・コードとコンパイル済コードの両方にアクセスできます。

オプション2の用途:

- ソース・コード・ファイルへのアクセスをアセットの生成チームとメンテナンス・チームに限定します。

設定プロセスは各オプションで異なります。最も簡単な開始方法としては、アセットへのアクセスを許可または拒否し(オプション1)、ファイル・アクセス権限を後から必要に応じて追加します。

注意:

特定のアクセス設定が適用されている場合にアセット・エディタを使用すると、ダウンロード・プロセス時に特定のユーザーに対して非表示になっているアセット・ファイルがそのユーザーに表示され、アクセスも可能になります。ユーザーによるファイルの表示を完全に制限するには、アセット・エディタでユーザーのアセット表示機能もブロックする必要があります。

4.7.2.1 オプションI: CASを使用した特定のアセットに対するアクセスの許可または拒否

手順1 -- カスタム・アクセス設定を使用したデフォルトのロールの再確立

1. Basic_Default_Assetsという名前のアセットのCASを作成します。

2. CASに次のロールと関連する権限を追加します。

- ロール: ユーザー

- 権限: 「表示」、「使用」、「ダウンロード」、「確認」

- ロール: 上級発行者

- 権限: 「表示」、「使用」、「ダウンロード」、「確認」、「編集」

- ロール: レジストラ

- 権限: 「表示」、「使用」、「ダウンロード」、「確認」、「編集」、「受入れ」、タブの承認、「登録」、「アクセス設定の編集」

注意:

この構成では、レジストラがすべてのアセットのアクセス設定を表示および変更できます。この権限を制限するには、レジストラ・ロールの「アクセス設定の編集」オプションを空白のままにします。

- ロール: レジストラ管理者

- 権限: 「表示」、「使用」、「ダウンロード」、「確認」、「編集」、「受入れ」、タブの承認、「登録」、「アクセス設定の編集」

3. 画面の一番上にある「すべての新規アセットに自動的に適用」を選択します。

4. 「保存」をクリックします。

5. 「既存のすべてのアセットにこの新規設定を適用」ダイアログが表示されたら、「はい」をクリックします。図4-16に、作成されたカスタム・アクセス設定を示します。

図4-16 カスタム・アクセス設定画面

手順2 -- Oracle Enterprise Repositoryツールへのアクセスの有効化

1. 次の新しいロールを(ロール・リストにまとめるために、ロールの前に付いている番号も含めて)作成します。

- 1: 作成/発行

- 2: アセット・エディタの起動

- 3: アーティファクト・ストアの編集

- 4: タイプの編集

2. 現在のBAS設定を編集し、次を反映します。

- ロール: 1: 作成/発行

- 権限: 作成/発行

- ロール: 2: アセット・エディタの起動

- 権限: アセット・エディタの起動

- ロール: 3: アーティファクト・ストアの編集

- 権限: アーティファクト・ストアの編集

- ロール: 4: タイプの編集

- 権限: タイプの編集

アセットの既存のBAS権限を削除して、CASがOracle Enterprise Repository内の全アセットのデフォルト権限セットになるようにしてください。

注意:

BASを通じたグローバルなツール権限を保持するには、次に示すように、以前に指定された4つの機能またはツール権限のいずれかの新しい機能ロールに各ユーザーを割り当てる必要があります。

手順3 -- 既存のロールに基づいた新しいロールと既存のユーザーの関連付け

1. 各ロールを編集し、アセットの作成と発行、アセット・エディタの起動、アーティファクト・ストアの編集、およびタイプの編集の1つ以上の機能を割り当てる必要のあるすべてのユーザーを4つの各ロールに配置します。

- 補足事項: 次の表は、Oracle Enterprise Repositoryのデフォルトのロールのデフォルト権限を示しています。

ロール

権限

ユーザー

作成/発行

上級発行者

「作成/発行」、アセット・エディタの起動

レジストラ

「作成/発行」、アセット・エディタの起動

レジストラ管理者

「作成/発行」、アセット・エディタの起動、アーティファクト・ストアの編集、「タイプの編集」

例4-1 サンプル例

以前、Larryには、デフォルト権限を含むデフォルトのロールである「ユーザー」が割り当てられていました。新しい設定の下で彼の既存の権限を保持するには、「ユーザー」への再割当てを行い、新しい「1: 作成/発行」ロールにも割り当てる必要があります。

同様に、以前彼に割り当てられたレジストラ・ロールに付加されているデフォルト権限を保持するために、Darylをレジストラに再割当てし、「1: 作成/発行」と「2: アセット・エディタの起動」にも割り当てる必要があります。また、ユーザーにロールを追加するのとは逆に、ロールにユーザーを追加することもできます。Oracle Enterprise Repositoryのロールのデフォルト権限に変更がなければ、各ロールを編集して適用可能なすべてのユーザーを一度に追加できます。

手順4 -- 変更の確認

1. ユーザーを5人作成し、次のロールの組合せに各ユーザーを割り当てます。

- 「ユーザー」、「1: 作成/発行」

- 上級発行者、「1: 作成/発行」、2: アセット・エディタの起動

- レジストラ、「1: 作成/発行」、2: アセット・エディタの起動

- レジストラ管理者、「1: 作成/発行」、2: アセット・エディタの起動、3: アーティファクト・ストアの編集、4: 「タイプの編集」

- プロジェクト管理者

2. 前述の各ロールに割り当てられた各ユーザーが次の項目を表示できることを確認します。

- ユーザー

- Oracle Enterprise Repositoryのメニュー・バーに「アセット」、「プロジェクト」、My Stuffおよび「レポート」のリンクが表示されています。

- 「アセット」画面に「アセットの発行」リンクが表示されています。(「アセットの編集/管理」リンクを表示することはできません。)

- 「アセット」画面で「検索」ボタンをクリックすると、アセットのリストが表示されます。各アセットに「サブスクライブ」および「使用/ダウンロード」ボタンが表示されます。(「編集」ボタンを表示することはできません。)ユーザーはレビューも投稿できる必要があります。

- ダウンロード可能なファイルを含むアセットの「使用/ダウンロード」ボタンをクリックした後、ユーザーはファイルをダウンロードできる必要があります。

- 上級発行者

- Oracle Enterprise Repositoryのメニュー・バーに「アセット」、My Stuffおよび「レポート」のリンクが表示されています。

- 「アセット」画面に「アセットの発行」リンクと「アセットの編集/管理」リンクの両方が表示されています。

- 「アセット」画面で「検索」ボタンをクリックすると、アセットのリストが表示されます。各アセットに「サブスクライブ」、「使用/ダウンロード」および「編集」ボタンが表示されます。上級発行者はレビューも投稿できる必要があります。

- ダウンロード可能なファイルを含むアセットの「使用/ダウンロード」ボタンをクリックした後、上級発行者はファイルをダウンロードできる必要があります。

- 「アセット」画面のアセットの編集/管理リンクをクリックして、アセット・エディタを起動できます。

次のことを確認します。

- アセット・エディタの各タブの一番下にある「承認」ボタンが非アクティブです。

- アセット・エディタの「管理」タブの「登録」ボタンが非アクティブです。

- レジストラ

- Oracle Enterprise Repositoryのメニュー・バーに「アセット」、My Stuffおよび「レポート」のリンクが表示されています。

- 「アセット」画面に「アセットの発行」リンクと「アセットの編集/管理」リンクの両方が表示されています。

- 「アセット」画面で「検索」ボタンをクリックすると、アセットのリストが表示されます。各アセットに「サブスクライブ」、「使用/ダウンロード」および「編集」ボタンが表示されます。レジストラはレビューも投稿できる必要があります。

- ダウンロード可能なファイルを含むアセットの「使用/ダウンロード」ボタンをクリックした後、レジストラはファイルをダウンロードできる必要があります。

- 「アセット」画面のアセットの編集/管理リンクをクリックして、アセット・エディタを起動できます。

次のことを確認します。

- アセット・エディタの各タブの一番下にある「承認」ボタンが非アクティブです。

- アセット・エディタの「管理」タブの「登録」ボタンが非アクティブです。

- アセット・エディタで、Oracle Enterprise Repositoryの「アセット」画面の「アセットの発行」リンクを通じて発行されたアセットの「受入れ」ボタンが表示されています。

- レジストラはアセットのアクセス設定を変更できます(CASで有効な場合)。

- レジストラ管理者

- Oracle Enterprise Repositoryのメニュー・バーに「アセット」、My Stuffおよび「レポート」のリンクが表示されています。

- 「アセット」画面に「アセットの発行」リンクと「アセットの編集/管理」リンクの両方が表示されています。

- 「アセット」画面で「検索」ボタンをクリックすると、アセットのリストが表示されます。各アセットに「サブスクライブ」、「使用/ダウンロード」および「編集」ボタンが表示されます。レジストラ管理者はレビューも投稿できる必要があります。

- ダウンロード可能なファイルを含むアセットの「使用/ダウンロード」ボタンをクリックした後、レジストラはファイルをダウンロードできる必要があります。

- 「アセット」画面のアセットの編集/管理リンクをクリックして、アセット・エディタを起動できます。

次のことを確認します。

- アセット・エディタの各タブの一番下にある「承認」ボタンが非アクティブです。

- アセット・エディタの「管理」タブの「登録」ボタンが非アクティブです。

- アセット・エディタで、Oracle Enterprise Repositoryの「アセット」画面の「アセットの発行」リンクを通じて発行されたアセットの「受入れ」ボタンが表示されています。

- レジストラ管理者はアセットのアクセス設定を変更できます(CASで有効な場合)。

- アセット・エディタの「アクション」メニューには、アーティファクト・ストアの構成およびアセット・タイプの管理が含まれている必要があります。

- プロジェクト管理者

- Oracle Enterprise Repositoryのメニュー・バーに「アセット」、My Stuffおよび「レポート」のリンクが表示されています。

次のことを確認します。

- 「アセット」画面に「アセットの発行」リンクと「アセットの編集/管理」リンクは表示されません。

- 「検索」ボタンをクリックした後、検索結果が表示されません。

4.7.2.2 オプションII: CASを使用した特定のファイルおよびアセットに対するアクセスの許可または拒否

アセットおよびアセット内の特定のファイルへのユーザー・アクセスを決定するカスタム・アクセス設定を作成します。

手順1 -- 「システム設定」における3つすべてのCAS設定の有効化

「システム設定」ペインにある3つすべてのCAS設定を有効にする必要があります。

手順2 -- 現在すべてのアセットのダウンロード・ファイルにアクセスするすべてのロールに対する、ファイルCASを通じた同じ機能の取得の許可

1. Basic_Default_Filesという名前のファイルのCASを作成します。

2. それぞれにダウンロード権限を持つ次のロールを追加します。

- ユーザー

- 上級発行者

- レジストラ

- レジストラ管理者

3. 「すべての新規ファイルに自動的に適用」を選択します。

4. 「既存のすべてのファイルにこの新規設定を適用しますか」ダイアログが表示されたら、「はい」をクリックします。

手順3 -- 現在すべてのアセットにアクセスするすべてのロールに対する、アセットCASを通じた同じ機能の取得の許可

1. Basic_Default_Assetsという名前のアセットのCASを作成します。次のロールと関連する権限を追加します。

- ロール: ユーザー

- 権限: 「表示」、「使用」、「確認」

- ロール: 上級発行者

- 権限: 「表示」、「使用」、「確認」、「編集」

- ロール: レジストラ

- 権限: 「表示」、「使用」、「確認」、「編集」、「受入れ」、タブの承認、「登録」、「アクセス設定の編集」

- ロール: レジストラ管理者

- 権限: 「表示」、「使用」、「確認」、「編集」、「受入れ」、タブの承認、「登録」、「アクセス設定の編集」

2. 画面の一番上にある「すべての新規アセットに自動的に適用」を選択します。

3. 「既存のすべてのアセットにこの新規設定を適用しますか」ダイアログが表示されたら、「はい」をクリックします。

手順4 -- アセットの既存のBAS権限の削除

CASがOracle Enterprise Repository内の全アセットのデフォルト権限セットになります。

注意:

BASを通じたグローバルなツール権限を保持するには、図4-17に示すように、以前に指定された4つの機能またはツール権限のいずれかの新しい機能ロールに各ユーザーを割り当てる必要があります。

図4-17 カスタム・アクセス設定

1. 次の名前を持つ4つのロールを(ロール・リストにまとめるために、ロールの前に付いている番号も含めて)作成します。

- 1: 作成/発行

- 2: アセット・エディタの起動

- 3: アーティファクト・ストアの編集

- 4: タイプの編集

2. 現在のBAS設定を編集し、次を反映します。

- ロール: 1: 作成/発行

- 権限: 作成/発行

- ロール: 2: アセット・エディタの起動

- 権限: アセット・エディタの起動

- ロール: 3: アーティファクト・ストアの編集

- 権限: アーティファクト・ストアの編集

- ロール: 4: タイプの編集

- 権限: タイプの編集

手順5 -- 既存のロールに基づいた、新しいロールと既存のユーザーの関連付け

1. 各ロールを編集し、アセットの作成と発行、アセット・エディタの起動、アーティファクト・ストアの編集、およびタイプの編集の1つ以上の機能を割り当てる必要のあるすべてのユーザーを4つの各ロールに配置します。
次の表は、Oracle Enterprise Repositoryのデフォルトのロールのデフォルト権限を示しています。

ロール

権限

ユーザー

作成/発行

上級発行者

「作成/発行」、アセット・エディタの起動

レジストラ

「作成/発行」、アセット・エディタの起動

レジストラ管理者

「作成/発行」、アセット・エディタの起動、アーティファクト・ストアの編集、「タイプの編集」

例4-2 サンプル例

以前、Darylには、デフォルト権限を含むデフォルトのロールである「ユーザー」が割り当てられていました。新しい設定の下で彼の既存の権限を保持するには、「ユーザー」への再割当てを行い、新しい「1: 作成/発行」ロールにも割り当てる必要があります。

同様に、以前彼に割り当てられたレジストラ・ロールに付加されているデフォルト権限を保持するために、Larryをレジストラに再割当てし、「1: 作成/発行」と「2: アセット・エディタの起動」にも割り当てる必要があります。

また、ユーザーにロールを追加するのとは逆に、ロールにユーザーを追加することもできます。Oracle Enterprise Repositoryのロールのデフォルト権限に変更がなければ、各ロールを編集して適用可能なすべてのユーザーを一度に追加できます。

手順6 -- 変更の確認

1. ユーザーを5人作成し、次のロールの組合せに各ユーザーを割り当てます。

- 「ユーザー」、「1: 作成/発行」

- 上級発行者、「1: 作成/発行」、2: アセット・エディタの起動

- レジストラ、「1: 作成/発行」、2: アセット・エディタの起動

- レジストラ管理者、「1: 作成/発行」、2: アセット・エディタの起動、3: アーティファクト・ストアの編集、4: 「タイプの編集」

- プロジェクト管理者

2. 前述の各ロールに割り当てられた各ユーザーが次の項目を表示できることを確認します。

- ユーザー

- Oracle Enterprise Repositoryのメニュー・バーに「アセット」、「プロジェクト」、My Stuffおよび「レポート」のリンクが表示されています。

- 「アセット」画面に「アセットの発行」リンクが表示されています。(「アセットの編集/管理」リンクを表示することはできません。)

- 「アセット」画面で「検索」ボタンをクリックすると、アセットのリストが表示されます。各アセットに「サブスクライブ」および「使用/ダウンロード」ボタンが表示されます。(「編集」ボタンを表示することはできません。)ユーザーはレビューも投稿できる必要があります。

- ダウンロード可能なファイルを含むアセットの「使用/ダウンロード」ボタンをクリックした後、ユーザーはファイルをダウンロードできる必要があります。

- 上級発行者

- Oracle Enterprise Repositoryのメニュー・バーに「アセット」、My Stuffおよび「レポート」のリンクが表示されています。

- 「アセット」画面に「アセットの発行」リンクと「アセットの編集/管理」リンクの両方が表示されています。

- 「アセット」画面で「検索」ボタンをクリックすると、アセットのリストが表示されます。各アセットに「サブスクライブ」、「使用/ダウンロード」および「編集」ボタンが表示されます。上級発行者はレビューも投稿できる必要があります。

- ダウンロード可能なファイルを含むアセットの「使用/ダウンロード」ボタンをクリックした後、上級発行者はファイルをダウンロードできる必要があります。

- 「アセット」画面の「アセットの編集/管理」リンクをクリックして、アセット・エディタを起動できます。

次のことを確認します。

- アセット・エディタの各タブの一番下にある「承認」ボタンが非アクティブです。

- アセット・エディタの「管理」タブの「登録」ボタンが非アクティブです。

- レジストラ

- Oracle Enterprise Repositoryのメニュー・バーに「アセット」、My Stuffおよび「レポート」のリンクが表示されています。

- 「アセット」画面に「アセットの発行」リンクと「アセットの編集/管理」リンクの両方が表示されています。

- 「アセット」画面で「検索」ボタンをクリックすると、アセットのリストが表示されます。各アセットに「サブスクライブ」、「使用/ダウンロード」および「編集」ボタンが表示されます。レジストラはレビューも投稿できる必要があります。

- ダウンロード可能なファイルを含むアセットの「使用/ダウンロード」ボタンをクリックした後、レジストラはファイルをダウンロードできる必要があります。

- 「アセット」画面の「アセットの編集/管理」リンクをクリックして、アセット・エディタを起動できます。

次のことを確認します。

- アセット・エディタの各タブの一番下にある「承認」ボタンがアクティブです。

- アセット・エディタの「管理」タブの「登録」ボタンがアクティブです。

- アセット・エディタで、Oracle Enterprise Repositoryの「アセット」画面の「アセットの発行」リンクを通じて発行されたアセットの「受入れ」ボタンが表示されています。

- レジストラはアセットのアクセス設定を変更できます(CASで有効な場合)。

- レジストラ管理者

- Oracle Enterprise Repositoryのメニュー・バーに「アセット」、My Stuffおよび「レポート」のリンクが表示されています。

- 「アセット」画面に「アセットの発行」リンクと「アセットの編集/管理」リンクの両方が表示されています。

- 「アセット」画面で「検索」ボタンをクリックすると、アセットのリストが表示されます。各アセットに「サブスクライブ」、「使用/ダウンロード」および「編集」ボタンが表示されます。レジストラ管理者はレビューも投稿できる必要があります。

- ダウンロード可能なファイルを含むアセットの「使用/ダウンロード」ボタンをクリックした後、レジストラはファイルをダウンロードできる必要があります。

- 「アセット」画面の「アセットの編集/管理」リンクをクリックして、アセット・エディタを起動できます。

次のことを確認します。

- アセット・エディタの各タブの一番下にある「承認」ボタンがアクティブです。

- アセット・エディタの「管理」タブの「登録」ボタンがアクティブです。

- アセット・エディタで、Oracle Enterprise Repositoryの「アセット」画面の「アセットの発行」リンクを通じて発行されたアセットの「受入れ」ボタンが表示されています。

- アセットのアクセス設定を変更できます。

- アセット・エディタの「アクション」メニューには、アーティファクト・ストアの構成およびアセット・タイプの管理が含まれている必要があります。

- プロジェクト管理者

- Oracle Enterprise Repositoryのメニュー・バーに「アセット」、「プロジェクト」、My Stuffおよび「レポート」のリンクが表示されています。

次のことを確認します。

- 「アセット」画面に「アセットの発行」リンクと「アセットの編集/管理」リンクは表示されません。

- 「検索」ボタンをクリックした後、検索結果が表示されません。

4.8 ロールベース・アクセス制御のユースケース

この項では、ロールベース・アクセス制御のユースケースについて説明します。

この項には次のトピックが含まれます:

- 4.8.1項「ユースケース1: 顧客および取引パートナにWebサービスを公開する」

- 4.8.2項「ユースケース2: アウトソーシング先の環境で知的財産を管理する」

- 4.8.3項「ユースケース3: フェデレーテッド・リポジトリを確立する」

- 4.8.4項「ユースケース4: アセット・ライフサイクルを管理する」

- 4.8.5項「ユースケース5: ソース・コード・ファイルへのアクセスをアセット生成チームに限定する」

- 4.8.6項「ユースケース6: 参照専用のリポジトリ・アクセスを特定のグループに許可する」

4.8.1 ユースケース1: 顧客および取引パートナにWebサービスを公開する

この項では、顧客および取引パートナにWebサービスを公開する方法を示すユースケースについて説明します。この項には次のトピックが含まれます:

- 4.8.1.1項「メリット」

- 4.8.1.2項「概要」

- 4.8.1.3項「解決策」

4.8.1.1 メリット

このシナリオでは、組織がWebサービスを活用して、取引パートナとの業務を強化し、顧客がシステムに接続して情報を収集できるようにしつつ、制限しない場合はバックエンド・システムの機密データが公開される可能性のある情報へのアクセスを制限できます。

4.8.1.2 概要

このシナリオでは、組織の取引パートナと顧客が、Oracle Enterprise Repository内の適切なWebサービスにのみアクセスできます。その他のアセットへのアクセスは拒否されます。これらの対策を簡単に行うために、Webサービス・アセットのメタデータは、次の2つの一般的なグループにまとめられます。

- 制限なし
組織内と組織外のすべての関係者に公開するメタデータ、関連ファイルおよびダウンロード可能ファイル。

- 制限あり
組織のバックエンド・システムの内部構造を示すメタデータ、設計ドキュメントまたはファイル。この情報へのアクセスが許可されるのは、組織内の開発者のみです。

このシナリオで説明するカスタム・アクセス設定(CAS)では、Webサービス・アセットの制限ありの部分と制限なしの部分の両方およびリポジトリ内の他のアセットへのアクセス権が組織内のすべての開発者に与えられます。組織の取引パートナと顧客は、制限なしのWebサービス・アセットにのみアクセスできます。このシナリオでは、異なる2つのWebサービス・アセットのタイプ(制限なしのデータ用と制限ありのデータ用)を作成する必要があります。

注意:

このシナリオでは、顧客および取引パートナにWebサービスを公開する簡単な方法について説明します。ただし、このユースケースで扱われていないその他の考慮事項については、追加または代替の対策が必要な場合があります。たとえば、Oracle Enterprise Repositoryの組織外専用の個別のインスタンスを確立した方がよい場合などがあります。組織外のインスタンスには、組織内のインスタンスとは異なるブランド名が付けられ、組織外の関係者への公開に適したメタデータ、関連ファイルおよびダウンロード可能ファイルが含まれる場合があります。この場合、使用履歴およびレビューは組織外のユーザーによる処理のみを反映します。より複雑な解決策が必要な場合は、Oracle Enterprise Repositoryの実装マネージャまたはソリューション・コンサルタントまでご連絡ください。

4.8.1.3 解決策

この項では、このユースケースの解決策について説明します。

4.8.1.3.1 前提条件

顧客ユーザーおよび取引パートナ・ユーザーがOracle Enterprise Repositoryに存在することを確認します。

4.8.1.3.2 ロールの作成および割当て

この手順は、Oracle Enterprise Repositoryの「管理」画面で実行します。

1. 「ロール」をクリックします。図4-18に示すように、「ロール」セクションが表示されます。

図4-18 「ロール」セクション

2. 「新規作成」をクリックします。図4-19に示すように、「新しいロールの作成」ダイアログが表示されます。

図4-19 「新しいロールの作成」ダイアログ

3. 「名前」テキスト・ボックスに「ユーザー - 顧客」と入力します。

4. 「説明」テキスト・ボックスに、「Represents Web Services customers」と入力するか、または他の説明テキストを入力します。

5. 終了したら、「保存」をクリックします。

6. 前述のプロセスを繰り返して、「ユーザー - 取引パートナ」ロールを作成します。

7. 新しいロールを適切なユーザー(適切な顧客および取引パートナを表すユーザー・アカウント)に割り当てます。

- 「管理」画面で、次の操作を実行します。

- 「ロール」をクリックし、ユーザーをロールに割り当てます。

- 「ユーザー」をクリックし、ロールをユーザーに割り当てます。

4.8.1.3.3 メタデータの構成

Webサービス・アセットのメタデータは、情報に対するOracle Enterprise Repositoryのアクセス権を持つロールに従って2つの一般的なグループにまとめる必要があります。1つ目のグループは、すべてのユーザー(顧客、取引パートナ、および組織内の開発者)が表示できるメタデータで構成されます。2つ目のグループは、組織内の開発者のみが表示できるメタデータで構成されます。

1. アセット・エディタを起動します。

2. 「アクション」メニューの「タイプの管理」をクリックします。タイプ・マネージャが表示されます。

3. 「サービス」アセット・タイプをテンプレートとして使用して、サービス - 組織内のみという名前の新しいアセット・タイプを作成します。

4. 完了したら、タイプ・マネージャの「ファイル」メニューの「保存」をクリックします。

5. アセット・エディタの「ファイル」メニューの「コピー/移行」をクリックします。

6. 既存のすべてのWebサービス・アセットを、新しいアセット・タイプであるサービス - 組織内のみにコピー/移行します。

7. 一般ユーザーによる表示を制限する情報やメタデータを反映する、またはそれらを表すすべてのメタデータ・フィールドを削除するように、「サービス」アセット・タイプの元のすべてのアセットを編集します。

8. 新しい「サービス - 組織内のみ」アセット・タイプから、制限されていないすべてのフィールド(前述の1つ目のメタデータ・グループ)を削除します。

4.8.1.3.4 リレーションシップの作成

この手順は、アセット・エディタで実行されます。

1. 「アクション」メニューで、「リレーションシップの構成」を選択します。「リレーションシップの構成」ダイアログが表示されます。

2. 「追加」をクリックします。

3. 図4-20に示すように、「External-Use-Internal-Only」という名前の双方向のリレーションシップを構成します。

図4-20 「リレーションシップの追加」ダイアログ

4.8.1.3.5 リレーションシップの適用

External-Use-Internal-Onlyリレーションシップをサービス・アセットに追加します。

この手順は、アセット・エディタで実行します。

1. いずれかのサービス・アセットを開きます。

2. 「リレーションシップ」タブをクリックします。

3. External-Use-Internal-Onlyリレーションシップを各サービス・アセットに適用します。これで、制限されたフィールドに組織内のユーザーがアクセスできるようになります。

4. CASを作成します。

- 「管理」画面のサイドバーにあるカスタム・アクセス設定をクリックします。

- 「新規作成」をクリックします。

- 図4-21に示すように、新しいCASにAccess_Web_Service_Information_for_External_Useという名前を付けます。

図4-21 カスタム・アクセス設定: CAS Access_Web_Service_Information_for_External_Use

- 次の権限を設定します。

- ロール: ユーザー - 顧客

- 権限: 「表示」、「使用」、「ダウンロード」、「確認」

- ロール: ユーザー - 取引ユーザー

- 権限: 「表示」、「使用」、「ダウンロード」、「確認」

5. アセット・エディタを起動します。

6. いずれかのWebサービス・アセットを開きます。

7. 「管理」タブを選択します。

8. 新しいCASであるAccess_Web_Service_Information_for_External_UseをWebサービスに適用します。このCASは、図4-22に示すように、各アセットにすでに割り当てられたCASであるBasic_Default_Assetsと連携して機能します。

図4-22 アセット・エディタ画面

9. Webサービス・アセットごとにこのプロセスを繰り返します。

4.8.1.3.6 結果

- 「サービス」アセット・タイプ

図4-23 「サービス」アセット・タイプ

- 「サービス - 組織内のみ」アセット・タイプ

図4-24 「サービス - 組織内のみ」アセット・タイプ

注意:

このビューに表示されている情報はほんの一部です。

4.8.1.3.7 検証テスト

次に示すように、指定された3つの各ロールでユーザーを選択し、アクセスを検証します。

- ロール

- ユーザー - 顧客

- ユーザー - 取引パートナ

- アクセス

- Oracle Enterprise Repositoryのメニュー・バーには、「アセット」とMy Stuffのリンクのみが表示されます。

- 組織外での表示用のWebサービス・アセット・メタデータ(「サービス」アセット・タイプ)のみ参照できます。

- これらのアセットのリレーションシップは表示されません。

- Webサービス・アセットを使用する場合は、ダウンロード可能なプライマリ・ファイルのみダウンロードできます。関連アセットを使用することはできません。

- Oracle Enterprise Repositoryの「アセット」画面には、「アセットの発行」ボタンと「アセットの編集/管理」ボタンは表示されません。

- Webサービス・アセットのアセット詳細画面を表示する場合、「編集」ボタンは表示されません。

- ロール

- ユーザー(組織内の従業員):

- アクセス

- 組織内と組織外での表示用のWebサービス・メタデータ(「サービス」アセットと「サービス - 組織内のみ」アセット)を参照できます。

- 「サービス」アセットのすべてのリレーションシップを参照できます。

- 「サービス - 組織内のみ」アセットを表示する場合に「使用/ダウンロード」ボタンをクリックすると、組織外での表示用のファイルは関連アセットとしてダウンロード・ウィンドウに表示されます。組織内と組織外のファイルの両方を同時にダウンロードできます。

4.8.2 ユースケース2: アウトソーシング先の環境で知的財産を管理する

この項では、アウトソーシング先の環境で知的財産を管理する方法を示すユースケースについて説明します。この項には次のトピックが含まれます:

- 4.8.2.1項「メリット」

- 4.8.2.2項「概要」

- 4.8.2.3項「解決策」

4.8.2.1 メリット

このシナリオで説明する設定を使用すると、高度に分散されたアウトソーシング環境を使用する組織では、アウトソーシング先の開発チームへの知的財産の公開を制限することにより、知的財産を管理および保護できます。また、これらの設定では、輸出管理規制に基づいて指定された制限事項にアセットを準拠させることができます。

4.8.2.2 概要

アウトソーシング先の開発チーム

このシナリオでは、組織外のサービス・プロバイダ(ESP)が、プロジェクト・プロファイルで指定されたアセットのレビューのみ表示、使用および提供できます。また、プロジェクトの過程において、ESPはプロジェクト内で生成されたアセットをレビュー、承認およびアセット登録の目的で技術責任者やプロジェクト設計者に発行することもできます。たとえば、プロジェクトの設計フェーズ後、技術責任者またはプロジェクト設計者からの承認を得るために、ESPは設計ドキュメントを発行できます。このシナリオでは、プロジェクト・ライフサイクルのガバナンス・モデルを提示し、プロジェクト・マイルストーンのレビューを容易にします。

輸出規制

通常、輸出管理規制では、ソフトウェアまたはその他の種類の知的財産を特定の国に輸出することを禁止します。このシナリオでは、輸出規制の対象となるアセットが特定の輸出規制品目分類番号(ECCN)に基づいて制限されていることを示すカスタム・アクセス設定が、それらのアセットに割り当てられます。制限されるユーザーには、従業員としての通常の職務に基づいて付与されるロールに加えて、対応する輸出規制品目分類番号(ECCN)ロールが割り当てられます。たとえば、ECCN 5D002に基づき、暗号化ソフトウェアはイラク、イラン、リビア、北朝鮮、スーダン、シリアまたはキューバには輸出できません。Oracle Enterprise Repositoryのすべての暗号化ソフトウェア・アセットは、それらが輸出規制の対象となることを示すカスタム・アクセス設定Access_Restricted_by_ECCN_5D002を受け取ります。また、イラク、イラン、リビア、北朝鮮、スーダン、シリアまたはキューバのユーザーには、暗号化ソフトウェアへのアクセスが禁止されることを示す「ユーザー - 制限付き」ロールがECCN 5D002によって割り当てられます。輸出規制の制限事項が変更された場合は、対象のユーザーやアセットを簡単に識別してアクセス設定を変更できます。

4.8.2.3 解決策

この項では、このユースケースの解決策について説明します。この項には次のトピックが含まれます:

- 4.8.2.3.1項「アウトソーシング先の開発チームのための解決策」

- 4.8.2.3.2項「輸出規制のための解決策」

4.8.2.3.1 アウトソーシング先の開発チームのための解決策

次の手順は、Oracle Enterprise Repositoryの「管理」画面で実行します。

前提条件

組織外のサービス・プロバイダにOracle Enterprise Repositoryのユーザー・アカウントが割り当てられていることを確認します。

ロールの作成

1. 「ロール」をクリックします。

2. 「新規作成」をクリックします。

3. 「ユーザー - ESPプロジェクトX」という名前の新しいロールを作成します。
このロールは、特定のプロジェクトに取り組んでいる組織外のサービス・プロバイダを表します。このロールのユーザーは、プロジェクト・プロファイルで指定されたアセットのみ表示およびダウンロードできます。また、プロジェクトの過程において、レビュー、承認およびアセット登録の目的で、技術責任者にアセットを発行することもできます。

ロールの割当て

「ユーザー - ESPプロジェクトX」ロールおよび「1: 作成/発行」ロールを適切なユーザーに割り当てます。

「1: 作成/発行」ロールを使用すると、プロジェクトの過程において、ESPはプロジェクトで生成するアセットをレビュー、承認およびアセット登録の目的で技術責任者やプロジェクト設計者に発行することもできます。

図4-25に示すように、「ロール」をクリックし、ユーザーをロールに割り当てます。

図4-25 「ロールの編集」ダイアログ

図4-26に示すように、「ユーザー」をクリックし、ロールをユーザーに割り当てます。

図4-26 ユーザー

カスタム・アクセス設定の作成

1. カスタム・アクセス設定をクリックします。

2. 「新規作成」をクリックします。

3. Access_Project_X_Assetsという名前の新しいCASを作成します。このCASでは、プロジェクトXで使用するために指定されたアセットへのアクセスが許可されます。

4. 図4-27に示すように、次の権限を設定します。

- ロール: ユーザー - ESPプロジェクトX

- 権限: 「表示」、「使用」、「ダウンロード」、「確認」

図4-27 「カスタム・アクセス設定の編集」ダイアログ

5. 図4-28に示すように、プロジェクト・プロファイルを通じてプロジェクトXで使用するために指定されたアセットを特定します。

図4-28 アセット・プロジェクト・プロファイル - プロジェクトX (1.0)

6. 図4-29に示すように、Access_Project_X_AssetsというCASをプロジェクトXのプロジェクト・プロファイル、およびプロジェクトXのプロジェクト・プロファイルで指定された各アセットに追加します。

図4-29 カスタム・アクセス設定

検証テスト

プロジェクトXに割り当てられている組織外のサービス・プロバイダの次の条件を検証します。

- ロール

- Outsourced_Dev_User:

- アクセス

- プロジェクトXのプロジェクト・プロファイルを参照できます。

- プロジェクトXのプロジェクト・プロファイルで指定されたアセットのみ参照できます。

- プロジェクトXのプロジェクト・プロファイルで指定されたアセットをダウンロードできます。

- 「アセット」画面には、「アセットの発行」リンクが表示されます。

- アセット詳細表示には、「サブスクライブ」および「使用/ダウンロード」ボタンが表示されます。「編集」ボタンは非表示になります。

- Oracle Enterprise Repositoryには、「アセット」およびMy Stuffタブのみが表示されます。

4.8.2.3.2 輸出規制のための解決策

次の手順は、Oracle Enterprise Repositoryの「管理」画面で実行します。

前提条件

輸出規制で制限されているユーザーにOracle Enterprise Repositoryのユーザー・アカウントが割り当てられていることを確認します。

ロールの作成

1. 「ロール」をクリックします。

2. 「新規作成」をクリックします。

3. 「ユーザー - ECCN 5D002による制限」という名前のロールを作成します。このロールは、イラク、イラン、リビア、北朝鮮、スーダン、シリアまたはキューバのユーザーに割り当てられます。これらのユーザーは、暗号化ソフトウェアまたはECCN 5D002で輸出が制限されているソフトウェアへのアクセスが禁止されます。

4. 図4-30に示すように、新しい「ユーザー - ECCN 5D002による制限」ロールを適切なユーザーに割り当てます。

図4-30 ロールの編集

カスタム・アクセス設定の作成

1. カスタム・アクセス設定をクリックします。

2. 「新規作成」をクリックします。

3. Access_Restricted_by_ECCN_5D002という名前の新しいCASを作成します。このCASは、ECCN 5D002で輸出が制限されているアセットへのアクセスを制限します。

4. 図4-31に示すように、次の権限を設定します。

- ロール: ユーザー - ECCN 5D002による制限

- 権限: 次のアクセスを拒否します: 「表示」、「使用」、「ダウンロード」、「確認」、「受入れ」、タブの承認、「登録」、「アクセス設定の編集」

図4-31 「カスタム・アクセス設定の編集」ダイアログ

5. Access_Restricted_by_ECCN_5D002というCASをすべての暗号化ソフトウェア・アセットまたはECCN 5D002で輸出が制限されているアセットに追加します。

図4-32 カスタム・アクセス設定

検証テスト

輸出規制の制限事項によって制限されているユーザーを検証します。

- 輸出規制の制限事項によって制限されているアセットを参照できません。

- 輸出規制の制限事項に基づいて制限されていないすべてのアセットを参照できます。

4.8.3 ユースケース3: フェデレーテッド・リポジトリを確立する

この項では、フェデレーテッド・リポジトリを確立する方法を示すユースケースについて説明します。この項には次のトピックが含まれます:

- 4.8.3.1項「メリット」

- 4.8.3.2項「概要」

- 4.8.3.3項「解決策」

4.8.3.1 メリット

このシナリオで説明する設定を使用すると、Oracle Enterprise Repositoryのユーザーは企業アセットを表示したり、それらのアセットにアクセスできますが、ドメイン固有の情報へのアクセスは、適切なドメインに割り当てられたユーザーに限定されます。これにより、大規模な組織では、特定のアセット・コンシューマ・グループを対象として、そのニーズに合せた最適なアセットを提供できるようになります。

4.8.3.2 概要

このシナリオでは、組織内のすべてのユーザーが表示およびダウンロードできる企業全体のアセット、および特定のビジネス・ドメイン内の開発チームにのみ関連するドメイン固有のアセットを使用します。企業全体のアセットのプロデューサは、アセットを作成、編集および登録し、すべてのドメイン・アセットを表示およびダウンロードできます。ドメイン固有のアセットのプロデューサは、自身のドメイン内のアセットを作成、編集および登録できます。組織内のすべてのユーザーは、自身のドメイン固有のアセットに加えて、企業全体のアセットを表示およびダウンロードできます。

4.8.3.3 解決策

この項では、このユースケースの解決策について説明します。

4.8.3.3.1 前提条件

企業およびドメインのプロデューサとすべてのコンシューマにOracle Enterprise Repositoryユーザー・アカウントが割り当てられていることを確認します。

4.8.3.3.2 ロールの作成

1. Oracle Enterprise Repositoryのメニュー・バーの「管理」リンクをクリックします。

2. 「管理」画面で、「ロール」をクリックします。

3. 「新規作成」をクリックします。

4. 次のロールを作成します。

- ロール: 企業のプロデューサ

- アクセス
企業アセットを表示、ダウンロード、編集および登録できます。

ドメイン・アセットを表示およびダウンロードできます。

- ロール: ドメインXのプロデューサ

- アクセス
ドメインXのアセットを表示、ダウンロード、編集および登録できます。

企業アセットを表示およびダウンロードできます。

- ロール: ドメインXのコンシューマ

- アクセス
ドメインXのアセットと企業アセットを表示およびダウンロードできます。

- ロール: ドメインYのコンシューマ

- アクセス
ドメインYのアセットを表示、ダウンロード、編集および登録できます。

企業アセットを表示およびダウンロードできます。

4.8.3.3.3 カスタム・アクセス設定の作成

1. Oracle Enterprise Repositoryのメニュー・バーの「管理」リンクをクリックします。

2. 「管理」画面で、カスタム・アクセス設定をクリックします。

3. 「新規作成」をクリックします。

4. 次のカスタム・アクセス設定を作成します。

- CAS: Access_Enterprise_Assets

- Oracle Enterprise Repositoryのユーザーに企業全体のアセットの表示を許可します。

- CAS: Access_Domain_X_Assets

- ドメインXのアセットへのアクセスを、企業のプロデューサ・ロールまたはドメインXのプロデューサ・ロール(あるいはその両方)に割り当てられたユーザーに限定します。

- CAS: Access_Domain_Y_Assets

- ドメインYのアセットへのアクセスを、企業のプロデューサ・ロールまたはドメインYのプロデューサ・ロール(あるいはその両方)に割り当てられたユーザーに限定します。

ドメイン・アセットまたは企業アセットのそれぞれについて、基本のデフォルト・アセットのアクセス設定を削除し、前述の手順4に示した適切なカスタム・アクセス設定に置き換えます。

- Enterprise_Producerに割り当てられたロール

図4-33 「概要」セクション

- 対応するCAS

図4-34 権限の設定

- Domain_X_Producersに割り当てられたロール

図4-35 「概要」セクション

- Domain_X_Consumersに割り当てられたロール

図4-36 「概要」セクション

- 対応するCAS

図4-37 権限の設定

- Domain_Y_Producersに割り当てられたロール

図4-38 「概要」セクション

- 対応するCAS

図4-39 アクセス設定の編集

5. 図4-40に示すように、ドメイン・アセットまたは企業アセットのそれぞれについて、Basic_Default_Assets設定を削除し、適切なCASであるAccess_Enterprise_Assets、Access_Domain_X_AssetsまたはAccess_Domain_Y_Assetsに置き換えます。

図4-40 アセット・エディタ

4.8.3.3.4 検証テスト

各ユーザーまたはロールの次の条件を検証します。

- 企業のプロデューサ:

- Oracle Enterprise Repositoryの「アセット」画面には、企業アセット、ドメインX、ドメインYのアセットのメタデータが表示されます。

- アセット・エディタには、企業アセットのみ表示されます(アセット・エディタからドメインXまたはドメインYのアセットにアクセスすることはできません)。

- 企業アセットのメタデータを表示する場合は、「サブスクライブ」、「使用/ダウンロード」および「編集」ボタンが表示されます。

- アセット・エディタで企業アセットを編集および登録できます。

- ドメインXとドメインYの両方のアセットのメタデータ表示には、「使用/ダウンロード」ボタンが表示されます。ただし、「編集」ボタンは表示されません。

- ドメインXのプロデューサ:

- Oracle Enterprise Repositoryの「アセット」画面には、企業アセットおよびドメインXのアセットのメタデータが表示されます。ドメインYのアセットは表示されません。

- アセット・エディタには、ドメインXのアセットが表示されます(アセット・エディタからドメインYのアセットまたは企業アセットにアクセスすることはできません)。

- 企業アセットのメタデータを表示する場合は、「サブスクライブ」および「使用/ダウンロード」ボタンを使用できます。ただし、「編集」ボタンは使用できません。

- 企業アセットのファイルをダウンロードできます。

- ドメインXのアセットのメタデータ表示には、「サブスクライブ」、「使用/ダウンロード」および「編集」ボタンが表示されます。

- アセット・エディタでドメインXのアセットを編集および登録できます。

- ドメインXのコンシューマ:

- Oracle Enterprise Repositoryの「アセット」画面には、企業アセットおよびドメインXのアセットのメタデータが表示されます。ドメインYのアセットは表示されません。

- 企業アセットおよびドメインXのアセットのメタデータを表示する場合は、「サブスクライブ」および「使用/ダウンロード」ボタンを使用できます。ただし、どちらの場合も、「編集」ボタンは使用できません。

- 企業アセットおよびドメインXのアセットのファイルをダウンロードできます。

- ドメインYのプロデューサ:

- Oracle Enterprise Repositoryの「アセット」画面には、企業アセットおよびドメインYのアセットのメタデータが表示されます。ドメインXのアセットは表示されません。

- アセット・エディタには、ドメインYのアセットが表示されます。ただし、アセット・エディタからドメインXのアセットと企業アセットにアクセスすることはできません。

- 企業アセットおよびドメインYのアセットのメタデータを表示する場合は、「サブスクライブ」および「使用/ダウンロード」ボタンを使用できます。ただし、どちらの場合も、「編集」ボタンは使用できません。

- 企業アセットおよびドメインYのアセットのファイルをダウンロードできます。

4.8.4 ユースケース4: アセット・ライフサイクルを管理する

この項では、Oracle Enterprise Repositoryでアセット・ライフサイクルを管理する方法を示すユースケースについて説明します。この項には次のトピックが含まれます:

- 4.8.4.1項「メリット」

- 4.8.4.2項「概要」

- 4.8.4.3項「ユースケースの解決策の構成」

- 4.8.4.4項「アセット・ライフサイクル管理の解決策の検証テスト」

4.8.4.1 メリット

このシナリオで説明する設定を使用すると、初期構想からリタイアまでのライフサイクルを通じてアセットを管理できます。これらの設定では、開発中のアセット(進行中のアセット)とリタイアしたアセットへのアクセスが制限されます。これにより、すべての開発チームに開発中のアセットを公開することで、余分な開発作業を行う必要がなくなります。そのようなアセットを必要とする開発チームは、プロジェクトにアセットを組み込むように計画し、アセット生成チームと協力してアセットを開発できます。その他の設定ではリタイアしたアセットの配布が制限されるため、デプロイ済のアセットの制御に役立ちます。

4.8.4.2 概要

注意:

このユースケースは、アセットのライフサイクルとアセットを構成するアーティファクトの管理に重点を置くアセット・リリース管理のポリシーおよび手順に基づいています。アセット・リリース管理の一部として、アセットを構成するアーティファクトがプロジェクトによって生成されます。その結果は、アセット自体から製品またはシステム全体に至るまで、様々な状態になる可能性があります。これらのアーティファクトはサポート・アーティファクトやその他の情報とともに収集され、それらを集めたものがアセットとしてパッケージ化されます。この処理が完了し、適切な状態であることが確認されると、これらのアセットはリポジトリに格納され、組織全体で使用できるようになります。登録されたアセットはリポジトリからダウンロードされ、障害が特定され、機能拡張が要求されます。これらの変更要求に対処するために、新しいバージョンのアセットが作成されます。最終的には、アセットが使用されなくなるか、または別のバージョンによって置き換えられることにより、アセットはリタイアされます。リタイアしたアセットを使用することはできません。

Oracle Enterprise Repositoryを使用すると、生成からリタイアまでのライフサイクル全体を通じてアセットへのアクセスを管理できます。このユースケースでは、拡張RBACを使用して、アセット・ライフサイクル全体を通じて別の関係者のグループにアセットを公開し、アセットへのアクセスを提供することに主に重点を置いています。

4.8.4.2.1 アセット・ライフサイクル・ステージ

- 要件の収集
組織では、特定のアセットに関する以降の複数のプロジェクトによるニーズを特定します。生成チームは、提示された進行中のアセットを作成します。このアセットのメタデータには、アセットとその目的の簡単な説明が含まれています。このメタデータは、適切なプロジェクトに関連付けられた一連の対象分野の専門家によるレビューやコメントを受けるために公開されます。アセットのリポジトリ表示には、まもなく実施されるプロジェクトのメンバーから機能要件を収集するために使用される専用仮想フォーラムへのリンクが含まれます。アセットは、少なくとも提示されたアセットが承認され、ライフサイクルの次のステージに移って、より広範なユーザーに対して表示されるようになるまで、アセットを生成するユーザーおよび適切なプロジェクトの対象分野の専門家に対してのみ表示されます。

注意:

Oracle Enterprise Repositoryの進行中のアセット・オプションを使用する必要があります。

- 設計および開発
要件が収集され、アセット開発のための資金が承認されると、プロデューサはサポート・アーティファクト(設計ドキュメントやコードなど)の収集およびリポジトリ内のアセットへのサポート・アーティファクトの関連付けを開始します。この時点で、アセットにアーティファクトとメタデータを追加し、アセットのコードをダウンロードできるのは、アセットのプロデューサのみです。ただし、関係者がアセットの進捗状況を追跡できるようにするために、アセットは開発者の広範なコミュニティに対して表示されます。

- ベータ・リリース
コードのテストが完了すると、アセットを使用する予定である、まもなく実施されるプロジェクトを代表する対象分野の専門家にベータ・リリースとしてアセットが公開されます。

- リリース
アセットのテストと文書化が完全に終了すると、ユーザー・コミュニティ全体にアセットが公開されます。

- リタイアのスケジュール設定
アセットの実用性がなくなると、リタイアのスケジュールが設定されます。リポジトリのステータスは非アクティブに変更されます。非アクティブなアセットはリポジトリ内に残りますが、そのアセットへのアクセスはメタデータに限定されます。アセットを使用したり、アセットのファイルをダウンロードすることはできません。これらの制限事項は、プロジェクトにおいて最新バージョンのアセットに移行するための動機付けになります。アセットの管理の担当者は、アセットがリタイアされるまでは、アセットにアクセスして表示および編集を行うことができます。

- リタイア
すべてのプロジェクトにおいて新しいバージョンのアセットへの移行が完了すると、元のアセットのリポジトリのステータスはリタイア済に変更されます。アセットがリポジトリ内の別のアセットに関連する場合、そのアセットは(ロールに関係なく)リポジトリ・ユーザーに対してのみ表示されます。ユーザーはリレーションシップ・リンクを通じてアセット・メタデータを表示できます。

このシナリオでは、進行中のアセットおよびリタイアしたアセットへのアクセスを管理するための複数の戦略のうち1つについてのみ説明します。これらの戦略の詳細は、Oracleサポートまでご連絡ください。

4.8.4.2.2 一般構成

この項で説明するアセット・ライフサイクル管理の様々な解決策には、次のロールおよびアクセス設定の構成が必要です。

(前提条件: アセット生成チームと対象分野の専門家がOracle Enterprise Repository内のユーザーであることを確認します。)

4.8.4.2.3 ロールの作成

1. Oracle Enterprise Repositoryのメニュー・バーの「管理」リンクをクリックします。

2. 「管理」画面で、「ロール」をクリックします。

3. 「新規作成」をクリックします。

4. 次のロールを作成します。

- ユーザー - 生成チーム・プロジェクトX

- ユーザー - 対象分野の専門家プロジェクトX

4.8.4.2.4 カスタム・アクセス設定の作成

1. Oracle Enterprise Repositoryのメニュー・バーの「管理」リンクをクリックします。

2. 「管理」画面で、カスタム・アクセス設定をクリックします。

3. 「新規作成」をクリックします。

4. 次のカスタム・アクセス設定を作成します。

- CAS: Access_Project_X_Assets_Propose

- CAS: Access_Project_X_Assets_Plan

- CAS: Access_Project_X_Assets_Build

- CAS: Access_Project_X_Assets_Release

次の図は、各ロールの詳細および対応するカスタム・アクセス設定を示しています。

- Project_X_Producer: ロール

図4-41 ユーザー: Project_X_Producer

- Project_X_Subject_Matter_Expert: ロール

図4-42 ユーザー: Project_X_Subject_Matter_Expert

- User_Community: ロール

図4-43 ユーザー: User_Community

- アセット・ライフサイクル・ステージ - 提案

- CAS: Access_Project_X_Assets_Propose

図4-44 アクセス設定の編集

- アセット・ライフサイクル・ステージ - 計画

- CAS: Access_Project_X_Assets_Plan

図4-45 アクセス設定の編集

- アセット・ライフサイクル・ステージ - ビルド

- CAS: Access_Project_X_Assets_Build

図4-46 アクセス設定の編集

- アセット・ライフサイクル・ステージ - リリース

- CAS: Access_Project_X_Assets_Release

図4-47 アクセス設定の編集

4.8.4.3 ユースケースの解決策の構成

次の項では、アセット・ライフサイクル管理のユースケースの各フェーズに必要な手順について説明します。

4.8.4.3.1 要件の収集ステージの解決策

(前提条件: アセット・ライフサイクル・カテゴリの分類が、選択されたアセット・タイプの一部として含まれていることを確認します。)

1. Oracle Enterprise Repositoryのメニュー・バーの「アセット」リンクをクリックします。

2. アセットの編集/管理をクリックして、アセット・エディタを起動します。

3. アセット・エディタの「ファイル」メニューを開きます。

4. 「新規」をクリックします。

5. 図4-48に示すように、初期ステータスが未発行であるアセットを作成します。

図4-48 「アセットの新規作成」ダイアログ

6. アセット・エディタの新しいアセットの分類タブで、アセット・ライフサイクル・ステージ・カテゴリを探します。

7. 「ステージ1 - 提案」を選択します。

8. 図4-49に示すように、アセットの「管理」タブで、アセットの新しいCASであるAccess_Project_X_Assets_Proposeを追加します。

図4-49 アセット・エディタ

9. アセット・エディタで、アセットの「一般」タブにある適切なテキスト・ボックスに、アセットおよびその目的の簡単な説明を入力し、アセットの機能要件の収集に使用するフォーラムを追加します。

10. 図4-50に示すように、Oracle Enterprise Repositoryのアセット・ライフサイクル・ステージ・カテゴリにあるステージ1 - 提案フォルダにアセットを表示します。

図4-50 アセット・ツリーの参照

4.8.4.3.2 設計および開発ステージの解決策

1. アセット・エディタで、このアセットは未発行ステータスのままになります。

2. アセット・ライフサイクル・ステージ・カテゴリの「ステージ2 - 計画」を選択します。

3. Access_Project_X_Assets_ProposeアセットCASを削除し、Access_Project_X_Assets_PlanアセットCASを追加します。

図4-51 アセット・エディタ

4.8.4.3.3 ベータ・リリース・ステージの解決策

1. アセット・エディタで、このアセットは未発行ステータスのままになります。

2. アセット・ライフサイクル・ステージ・カテゴリの「ステージ3 - ビルド」を選択します。

3. Access_Project_X_Assets_PlanアセットCASを削除し、Access_Project_X_Assets_BuildアセットCASをアセットに追加します。

4.8.4.3.4 リリース・ステージの解決策

1. アセット・エディタで、アセットを発行します。レジストラによって受け入れられて登録されたアセットのステータスは、未発行から「登録済」に変更されます。

2. アセット・ライフサイクル・ステージ・カテゴリの「ステージ4 - リリース」を選択します。

3. Access_Project_X_Assets_BuildアセットCASを削除し、Access_Project_X_Assets_ReleaseアセットCASをアセットに追加します。

4.8.4.3.5 リタイアのスケジュール設定ステージの解決策

1. アセット・エディタで、アセットのステータスを「アクティブ」から「非アクティブ」に変更します。

4.8.4.3.6 リタイア・ステージの解決策

1. アセット・エディタで、アセットのステータスを「非アクティブ」から「リタイア」に変更します。

4.8.4.4 アセット・ライフサイクル管理の解決策の検証テスト

指定されているとおり、各ロールの次の条件を確認します。

- ロール

- Project_X_Producer

- アクセス

- アセット・ライフサイクルを通じてレジストラ権限が割り当てられています。

- Oracle Enterprise Repositoryのアセットを表示できます。

- 「使用/ダウンロード」および「編集」ボタンが表示されます。

- アセット・エディタで、アセットの受入れ、タブの承認、登録、およびアクセス設定の編集を行うことができます。

- リタイア・フェーズでは、アセットまたは検索のリポジトリ・リストにアセットが表示されません。このロールでは、アセットが別のアセットに関連する場合にのみ、「リレーションシップ」リンクを通じて、アセットへのリポジトリ・アクセスが可能です。ただし、アセット・エディタでは、引き続きアセットにアクセスできます。

- ロール

- Project_X_Subject_Matter_Expert

- アクセス

- 要件の収集フェーズでは:

- アセットの表示、レビューの発行、アセットのサブスクライブができます(「サブスクライブ」ボタンを使用)。

- アセットのフォーラムにアクセスでき、コメントを寄稿できます。

- 設計および開発フェーズでは:

- アセットの表示、レビューの発行、アセットのサブスクライブができます(「サブスクライブ」ボタンを使用)。

- アセットのフォーラムにアクセスでき、コメントを寄稿できます。

- ベータ・リリース・フェーズでは:

- アセットの表示、レビューの発行、アセットのサブスクライブができます(「サブスクライブ」ボタンを使用)。

- アセットをダウンロードできます(「使用/ダウンロード」ボタンを使用)。

- アセットのフォーラムにアクセスでき、コメントを寄稿できます。

- リリース・フェーズでは:

- アセットの表示、レビューの発行、アセットのサブスクライブができます(「サブスクライブ」ボタンを使用)。

- アセットをダウンロードできます(「使用/ダウンロード」ボタンを使用)。

- アセットのフォーラムにアクセスでき、コメントを寄稿できます。

- リタイアのスケジュール設定フェーズでは:

- アセットの表示、レビューの発行、アセットのサブスクライブができます(「サブスクライブ」ボタンを使用)。

- アセットのフォーラムにアクセスでき、コメントを寄稿できます。

- リタイア・フェーズでは、アセットまたは検索のリポジトリ・リストにアセットが表示されません。アセットが別のアセットに関連する場合にのみ、「リレーションシップ」リンクを通じて、アセットへのリポジトリ・アクセスが可能です。アセットには、リタイアのスケジュール設定フェーズのリストと同じ機能/権限が表示されます。

- ロール

- User_Community

- アクセス

- 要件の収集フェーズでは:

- アセットにアクセスできません。

- 設計および開発フェーズでは:

- アセットの表示、レビューの発行、アセットのサブスクライブができます(「サブスクライブ」ボタンを使用)。

- アセットのフォーラムにアクセスでき、コメントを寄稿できます。

- ベータ・リリース・フェーズでは:

- アセットの表示、レビューの発行、アセットのサブスクライブができます(「サブスクライブ」ボタンを使用)。

- アセットのフォーラムにアクセスでき、コメントを寄稿できます。

- リリース・フェーズでは:

- アセットの表示、レビューの発行、アセットのサブスクライブができます(「サブスクライブ」ボタンを使用)。

- アセットをダウンロードできます(「使用/ダウンロード」ボタンを使用)。

- アセットのフォーラムにアクセスでき、コメントを寄稿できます。

- リタイアのスケジュール設定フェーズでは:

- アセットの表示、レビューの発行、アセットのサブスクライブができます(「サブスクライブ」ボタンを使用)。

- アセットをダウンロードできます(「使用/ダウンロード」ボタンを使用)。

- アセットのフォーラムにアクセスでき、コメントを寄稿できます。

- リタイア・フェーズでは、アセットまたは検索のリポジトリ・リストにアセットが表示されません。アセットが別のアセットに関連する場合にのみ、「リレーションシップ」リンクを通じて、アセットへのリポジトリ・アクセスが可能です。アセットには、リタイアのスケジュール設定フェーズのリストと同じ機能/権限が表示されます。

4.8.5 ユースケース5: ソース・コード・ファイルへのアクセスをアセット生成チームに限定する

このユースケースは、ユースケース#1 (Webサービス)と少し類似する点があります。そのユースケースでは、組織内で公開するアセット・メタデータと組織外で公開するアセット・メタデータの提示方法および可用性を管理するために、Webサービス・アセットごとに異なる2つのアセットのタイプを使用しました。ユースケース#5でもアセット・メタデータおよびファイルへのアクセスを制限しますが、使用するアセット・タイプは1つのみです。

この項には次のトピックが含まれます:

- 4.8.5.1項「メリット」

- 4.8.5.2項「概要」

- 4.8.5.3項「解決策」

4.8.5.1 メリット

このシナリオで説明する設定では、特定のユーザー/ロールのアクセスを、コンパイル済コードを含むアセットに限定することにより、ブラックボックスの再利用を促進します。そのようなブラックボックス・アセットは、ソース・コードを変更することなくそのまま使用されます。ブラックボックス・アセットは、プロジェクト内で使用すると、通常、メンテナンスの手間が大幅に省けるという点において価値の高いアセットです。

4.8.5.2 概要

このシナリオでは、指定されたアセット・コンシューマ・ロールの開発者は、コンパイル済コードにのみアクセスできます。一方、アセットの作成とメンテナンスの担当者は、ソース・コードとコンパイル済コードの両方にアクセスできます。

4.8.5.3 解決策

この節では、次の使用例について説明します。

4.8.5.3.1 ロールの作成

1. Oracle Enterprise Repositoryのメニュー・バーの「管理」リンクをクリックします。

2. 「管理」画面で、「ロール」をクリックします。

3. 「新規作成」をクリックします。

4. 次のロールを作成します。

- 生成チーム

- メンテナンス・チーム

- コンシューマ

4.8.5.3.2 カスタム・アクセス設定の作成

1. Oracle Enterprise Repositoryのメニュー・バーの「管理」リンクをクリックします。

2. 「管理」画面で、カスタム・アクセス設定をクリックします。

3. 「新規作成」をクリックします。

4. 次のカスタム・アクセス設定を作成します。

- Access_Domain_X_Compiled_Code_Files

- コンパイル済コード・ファイルを参照できるユーザー用です。

- Access_Domain_X_Source_Code_Files

- ソース・コード・ファイルを参照できるユーザー用です。

5. 対象のアセットからBasic_Default_Files CASを削除します。(図4-52に示すように、これは、デフォルト・ファイルのCASが設定済であることを前提としています。)

図4-52 「編集」ダイアログ

6. 図4-53に示すように、Access_Domain_X_Compiled_Code_Files CASをすべてのコンパイル済コード・ファイルに割り当てます。

図4-53 「編集」ダイアログ

7. Access_Domain_X_Source_Code_Files CASをすべてのソース・コード・ファイルに割り当てます。

図4-54、図4-55、図4-56、図4-57、図4-58および図4-59は、生成チーム、メンテナンス・チームおよび「コンシューマ」の各ロールおよび関連するCAS設定をそれぞれ示しています。

- Production_Team (すべての生成ユーザー): ロール

図4-54 ユーザー: Production_Team

- Maintenance_Team (すべてのメンテナンス・ユーザー): ロール

図4-55 ユーザー: Maintenance_Team

- Consumers (すべてのコンシューマ): ロール

図4-56 ユーザー: Consumer

- Access_Domain_X_Compiled_Code_Files

図4-57 カスタム・アクセス設定

- Access_Domain_X_Source_Code_Files

図4-58 カスタム・アクセス設定

4.8.5.3.3 結果

図4-59に示すように、生成チーム、メンテナンス・チームおよび「コンシューマ」の各ユーザーは、Oracle Enterprise Repositoryのアセットを表示する場合に同じメタデータ情報を参照します。

図4-59 アセット: サンプル・コンポーネント

図4-60に示すように、生成チームおよびメンテナンス・チームの各ユーザーは、アセットのダウンロード時にコンパイル済コード・ファイルとソース・コード・ファイルの両方を参照します。

図4-60 「使用/抽出」ダイアログ

図4-61に示すように、「コンシューマ」は、アセットのダウンロード時にコンパイル済コード・ファイルのみを参照します。

図4-61 「使用/抽出」ダイアログ

4.8.5.3.4 検証テスト

各ロールの次の条件を検証します。

- Production_Team and Maintenance_Team:

- 「使用/ダウンロード」ボタンをクリックした後、ソース・コード・ファイルとコンパイル済コード・ファイルの両方が表示される必要があります。

- Oracle Enterprise Repositoryのアセットを表示する場合に、「編集」ボタンが表示される必要があります。

- コンシューマ

- 「使用/ダウンロード」ボタンをクリックした後、コンパイル済コード・ファイルのみが表示されます。

- 「コンシューマ」がコンパイル済コードにのみアクセス可能なアセットには、「編集」ボタンは表示されません。ソース・コードが含まれるアセットの編集権限が「コンシューマ」に割り当てられている場合、アセット・エディタでは、ソース・コード・ファイルが「コンシューマ」に対して表示されます。

4.8.6 ユースケース6: 参照専用のリポジトリ・アクセス権を特定のグループに付与する

この項では、参照専用のリポジトリ・アクセス権を特定のグループに付与する方法を示すユースケースについて説明します。この項には次のトピックが含まれます:

- 4.8.6.1項「メリット」

- 4.8.6.2項「概要」

- 4.8.6.3項「解決策」

- 4.8.6.4項「検証テスト」

4.8.6.1 メリット

このシナリオで説明する設定を使用すると、参照専用のリポジトリ・アクセス権をすべてのユーザーに提供することにより、組織内のリポジトリのロールアウトを制御できます。これは、大規模な開発チームのグループに対してリポジトリの使用を促進する場合に役立ちます。組織のポリシーで指定されているように、アクセス管理者は追加のアクセス権を適切なロールに必要に応じて割り当てることができます。

4.8.6.2 概要

このシナリオでは、すべてのリポジトリ・ユーザーに参照専用のアクセス権が自動的に割り当てられます。ユーザーは、組織が割り当てた標準のログイン用のユーザー名とパスワードを使用して、LDAPに対して認証され、リポジトリへのアクセス権が割り当てられる可能性があります。このようなユーザーが追加機能のニーズを決定すると、リポジトリ管理者はユーザーに追加のロールを割り当てることができます。

4.8.6.3 解決策

この項では、このユースケースの解決策について説明します。

1. 次のロールを作成します。

- ユーザー - 参照専用

2. 図4-62に示すように、このロールが新しいユーザーに自動的に割り当てられるようにします。

図4-62 ロールの編集: ユーザー - 参照専用

3. 図4-63に示すように、「ユーザー」を、新しいユーザーに自動的に割り当てられないように編集します。

図4-63 ロールの編集: ユーザー

4. CAS: Basic_Default_Assetsを編集します。

図4-64 カスタム・アクセス設定の編集: Basic_Default_Assets

- 使用可能なすべてのロールを表示オプションをクリックして、使用可能なすべてのロールのリストを表示します。

- 適切なボックスを選択して、「表示」アクセス権を「ユーザー - 参照専用」に割り当てます。

- CASを保存します。

4.8.6.4 検証テスト

システムに新しいユーザーを追加します。

- 新しいユーザーに参照専用の権限が割り当てられていることを確認します。

- すべてのアセットを表示およびサブスクライブできます。

- My Stuffにアクセスできます。

- アセットを発行することはできません。

- アセットをダウンロードすることはできません。

- アセットをレビューすることはできません。

5 診断およびパスワードの暗号化

この章では、Oracle Enterprise Repositoryの「診断」ページにアクセスし、パスワードを暗号化する方法について説明します。

この章には、次のセクションがあります。

- 5.1項「Oracle Enterprise Repositoryの「診断」ページへのアクセス」

- 5.2項「暗号化パスワードの生成」

- 5.3項「構成ファイルのパスワードの暗号化」

Oracle Enterprise Repositoryではパスワード暗号化がデフォルトで有効ですが、JVM起動パラメータcmee.passwordencryption=falseを使用するとパスワード暗号化を無効にできます。

5.1 Oracle Enterprise Repositoryの「診断」ページへのアクセス

Oracle Enterprise Repository 11gリリースでは、Oracle Enterprise Repositoryの「診断」ページはデフォルトで無効にされています。http://host_name:port/application_name/diag/index.jspに移動します(host_nameを適切な場所に置き換えます)。

「診断」ページをデフォルト・モードで開くと、次のメッセージが表示されます。

診断ページは現在無効です。Oracle Enterprise Repository管理者にお問い合せください。

「診断」ページを有効にするには、次の手順を実行します。

1. <Oracle_home>\user_projects\domains\base_domain\binに移動し、.shおよび.cmdファイルにアクセスします。

2. Oracle Enterprise Repositoryサーバーを起動する前にsetOERdomain.shまたはsetOERdomain.cmdを編集します。

3. デフォルトでコメント化されている次の行を非コメント化します。
OER_DIAG_OPTION="-DdiagPagesEnabled=true"

4. Oracle Enterprise Repositoryサーバーを再起動します。

これは、必要な場合のみ有効化し、システムが問題なく稼働している場合はすぐに無効化することをお薦めします。

5.2 暗号化パスワードの生成

パスワードを暗号化するには、Oracle Enterprise Repositoryの「診断」ページを使用する方法と、パスワード暗号化ツールを使用する2つの方法があります。暗号化パスワードを生成するには、次の手順を実行する必要があります。

1. Oracle Enterprise Repositoryの「診断」ページにアクセスします。
http://host_name:port/application_name/diag/index.jspに移動します(host_nameを適切な場所に置き換えます)。

2. 「ツール」セクションにスクロールして、パスワードの文字列の暗号化リンクをクリックし、パスワードの暗号化ページを表示します。

3. クリア・テキストのパスワードを「暗号化する文字列」テキスト・ボックスに入力します。

4. 「問合せの発行」ボタンをクリックします。

5. 暗号化されたパスワード文字列をコピーして、適切なコンテキスト・ファイルまたはプロパティ・ファイルに貼り付けます。

パスワード暗号化ツールは<ORACLE_HOME>/repositoryXXX/core/tools/solutions/11.1.1.x.x-OER-PasswordTools.zipにあります。11.1.1.x.x-OER-PasswordTools.zipファイルにはWindows用とUNIX用の2つのスクリプトがあります。

- encrypt.bat/encrypt.sh - xml構成ファイルのパスワード要素を暗号化

- encryptpassword.bat/encryptpassword.sh - コマンド行から単一パスワードを暗号化

この項には次のトピックも含まれます。

- 5.2.1項「Oracle Enterprise Repositoryのデプロイメントで使用される暗号化パスワード」

- 5.2.2項「その他のパスワード」

5.2.1 Oracle Enterprise Repositoryのデプロイメントで使用される暗号化パスワード

暗号化パスワードの推奨の使用方法は次のとおりです。

- database.propertiesファイル内
データベースの接続パスワード。

- Antタスク・プロパティ・ファイルまたはビルド・スクリプト
Oracle Enterprise Repositoryのユーザーがログイン時に使用するパスワード。

- ハーベスタHarvesterSettings.xml構成ファイル内
HarvesterSettings.xmlファイルに格納されているパスワード。

- Oracle Registry Repository Exchange Utility構成(orrxu.xml)ファイル内
orrxu.xmlファイルに格納されているパスワード。

- Oracle Enterprise Repository Workflow構成(workflow.xml)ファイル内
workflow.xmlファイルに格納されているパスワード。

5.2.2 その他のパスワード

システム内のその他のパスワードは自動的に暗号化されます。この操作はユーザーには表示されません。デフォルトでは、プロパティ・ファイルに格納されている次を含む多数のフィールドが暗号化されています。

- ldap.bindPassword

- enterprise.guest.password

- cmee.wsaa.password

この暗号化は、プロパティが編集され、保存されると実行されます。アップグレード中のパスワードの自動暗号化は、この時点では使用できません。

アーティファクト・ストアで格納されるパスワードは、暗号化された形式でデータベースに格納されます。

5.3 構成ファイルのパスワードの暗号化

セキュリティを確保するため、構成ファイル内のパスワードは暗号化されます。次については、構成ファイルのパスワードを暗号化する必要があります。

- 5.3.1項「ハーベスタ構成ファイル」

- 5.3.2項「交換ユーティリティ構成ファイル」

- 5.3.3項「ワークフロー構成ファイル」

5.3.1 ハーベスタ構成ファイル

セキュリティを確保するため、ハーベスタ構成内のパスワードは暗号化されます。ハーベスタにより配信されるパスワード暗号化ツール(encrypt.bat/encrypt.sh)を使用すると、ハーベスタ構成(HarvesterSettings.xml)ファイルに格納されるパスワードの暗号化が可能です。

1. <Harvester Home>ディレクトリに移動します。

2. 次のように、コマンド・プロンプトからパスワード暗号化ツールを実行します。
> encrypt.bat HarvesterSettings.xml HarvesterSettings.xml

意味は次のとおりです。

HarvesterSettings.xml = ハーベスタ構成ファイル。

5.3.2 交換ユーティリティ構成ファイル

セキュリティ強化のため、交換ユーティリティ・キットにパッケージされているパスワード暗号化ツール(encrypt.bat/encrypt.sh)がインストール・ディレクトリに常駐しており、Oracle Registry Repository交換ユーティリティ構成(orrxu.xml)ファイルに格納されるパスワードの暗号化が可能です。

1. <ExchangeUtility Tool Home>ディレクトリに移動します。

2. 図5-1に示すように、コマンド・プロンプトから次のようにパスワード暗号化ツールを実行します。

> encrypt.bat orrxu.xml orrxu.xml

ここで、

orrxu.xml = Oracle Registry Repository交換ユーティリティ構成ファイル

図5-1 パスワード暗号化ツール

図5-2 は、暗号化の前にパスワード・フィールドがどのように表示されるかを示すサンプル・イメージです。

図5-2 暗号化の前のパスワードのサンプル・イメージ

図5-3 は、パスワード暗号化ツールを実行した後にパスワード・フィールドがどのように表示されるかを示すサンプル・イメージです。

図5-3 暗号化の後のパスワードのサンプル・イメージ

5.3.3 ワークフロー構成ファイル

セキュリティ強化のため、11.1.1.x.x-OER-PasswordTools.zipファイルに常駐するパスワード暗号化ツール(encrypt.bat/encrypt.sh)を使用すると、ワークフロー構成(workflow.xml)ファイルに格納されるパスワードの暗号化が可能です。

1. ORACLE_HOME/repositoryXXX/core/tools/solutionsディレクトリに移動します。

2. 11.1.1.x.x-OER-PasswordTools.zipファイルをディレクトリに解凍し、このディレクトリの場所でコマンド・プロンプトを開きます。

3. 次のように、コマンド・プロンプトからパスワード暗号化ツールを実行します。

> encrypt.bat workflow.xml workflow.xml

意味は次のとおりです。

workflow.xml = ワークフロー構成ファイル

6 設計時および実行時環境における自動収集の構成と使用

この章では、ハーベスタの使用を開始する方法について説明します。Oracle Enterprise Repositoryへの移入に使用されるツールは、ハーベスタと呼ばれます。ハーベスタは、Oracle製品および標準ベースのファイルからメタデータを読み取ります。これには、Oracle SOA Suite、Oracle Service Bus、Oracle BPAによって生成されたコンポジット、および標準のBPEL、WSDL、XSD、XSLT、BPMN 2.0、WS-Policyファイルが含まれます。

ハーベスタによって、アセットの作成、アセット・メタデータの移入、およびアーティファクト・ファイルの情報に基づいたリレーション・リンクの生成が自動的に実行されます。これらのファイルは、設計時に開発環境から直接収集できます。

また、これらのファイルは、実行時環境にデプロイされるときに収集することもできます。ハーベスタは、Oracle JDeveloperを含むIDE内や、AntおよびWeblogic Scripting Tool (WLST)内で、コマンド行から使用できます。詳細は、10.2項「Oracle Registry Repository Exchange Utilityの構成」を参照してください。

この章は次の項で構成されています。

- 6.1項「ハーベスタを使用する前に」

- 6.2項「ハーベスタの構成」

- 6.3項「アーティファクトの収集」

6.1 ハーベスタを使用する前に

この項では、ハーベスタの使用を開始する方法、および高度な各種ユースケースにおけるその使用について説明します。

この項には次のトピックが含まれます:

- 6.1.1項「前提条件」

- 6.1.2項「ハーベスタの機能」

- 6.1.3項「アーティファクト/製品のバージョン・マトリクス」

6.1.1 前提条件

ハーベスタを使用する前に、次の前提条件を実行する必要があります。

- 必要なアセット・タイプおよびリレーションシップが含まれるハーベスタ・ソリューション・パックをOracle Enterprise Repositoryにインポートします。Oracle Enterprise Repositoryのインストール・ホームからrepositoryxxx/core/tools/solutions/11.1.1.x.x-OER-Harvester-Solution-Pack.zipファイルをインポートします。
Oracle Enterprise Repositoryソリューション・パックのインポートの詳細は、『Oracle Fusion Middleware Oracle Enterprise Repositoryインストレーション・ガイド』を参照してください。

ハーベスタ・ソリューション・パックのアセット・タイプ・インベントリの詳細は、B.8項「アセット・タイプのインベントリ」を参照してください。

- Oracle Service Busから収集する場合、Oracle Service Busサーバー(バージョン10.3.1.0)をハーベスタと同じマシン、またはハーベスタからアクセスできる共有ファイル・システムにインストールします。

注意:

Oracle Service Bus 11gより後のバージョンから収集する場合、Oracle Service Bus 11gより後のバージョン専用として開発され、Oracle Service Bus 11g製品インストールの一部として使用できる、対応するOracle Service Busのハーベスタ・バージョンを使用する必要があります。

- Oracle SOA SuiteやOracle Service Busなどのデプロイされたアプリケーション、またはWebサービスからアセットを収集する場合、アプリケーションはWebLogic 10.3.1以上にデプロイする必要があります。

- Oracle Application Integration Architectureからの収集の詳細は、Oracle Fusion Middleware Oracle Application Integration Architecture Foundation Pack開発者ガイドのOracle AIAコンテンツ収集の設定方法に関する項を参照してください。

- ハーベスタでは、Java SDKバージョン6以上が必要です。

6.1.2 ハーベスタの機能

ハーベスタを使用すると、次の作業が可能になります。

- SCAコンポジット、BPEL、WSDL、XSD、XSLT、BPMN 2.0およびWS-Policyなどの標準SOAアーティファクト(Oracleや他のベンダーのもの)をOracle Enterprise Repositoryに公開します。

- 影響分析を目的としてアーティファクト間の依存関係を取得します。

- ネストしたWSDLおよびXSDファイルを処理します。

- 抽象インタフェース・アセットおよび具象デプロイメント/エンドポイントを作成します。

- BPELパートナ・リンクの依存関係を取得し、これらをインタフェースに関連付けます。

- 変換に対するBPEL PMの依存関係を取得します。

- 再利用を目的としてOracle Enterprise Repository内でアーティファクト・コンテンツを格納または参照します。

- 重複を検出するためにアーティファクトのソフトウェア・ファイルID (SFID)を計算します。

- ネストしたディレクトリ、リモート・サーバー、zipファイル、jarファイル、SOAコンポジットまたはOracle BPELスーツケースからアーティファクトを公開します。

- トランザクション方式でアーティファクトを公開します。

- アーティファクトは、コマンド行から、およびハーベスタのAntタスクを使用して自動Antビルド・プロセスから公開します。

- プロキシ・サービス、ビジネス・サービス、XQuery、MFL、XSLT、WS-PolicyなどのOracle Service Busプロジェクト・アーティファクトを公開します。

- 収集プロセスをWLSTデプロイメント・スクリプトの一部として統合します。

- SSL対応SOAサーバーに収集します。SOAサーバーでSSLを有効化する方法や、証明書をクライアントにエクスポートおよびインポートする方法の詳細は、Oracle Fusion Middlewareセキュリティ・ガイドを参照してください。

注意:

証明書のインポート/エクスポートの詳細は、次の場所にある「セキュリティ・ガイド」を参照してください。

http://download.oracle.com/docs/cd/E15523_01/index.htm

6.1.3 アーティファクト/製品のバージョン・マトリクス

表6-1に、ハーベスタでサポートされるアーティファクト/製品のバージョン・マトリクスを示します。

表6-1 アーティファクト/製品のバージョン・マトリクス

アーティファクト/製品

バージョン

BPEL

1.1および2.0

WSDL

1.1

SCA

0.95

JCAアダプタ

1.5

XSD

1.0

XSLT

1.0

Oracle BPEL PM

10.1.3.4

JDeveloper

10.1.3および11.1.1

Oracle SOA Suite

10.1.3および11.1.1

WS-Policy

1.2

Oracle Service Bus

10.3および11.1.1

WebLogic Webサービス

10.3

BPMN

2.0

6.2 ハーベスタの構成

この項では、ハーベスタを構成して、統合開発環境で使用する方法について説明します。

この項には次のトピックが含まれます:

- 6.2.1項「ハーベスタの入手」

- 6.2.2項「コマンド行用のハーベスタの構成」

- 6.2.3項「統合開発環境でのハーベスタの使用」

- 6.2.4項「repository.submit Antタスクを使用したハーベスタの呼出し」

- 6.2.5項「WLSTからのハーベスタの呼出し」

- 6.2.6項「ランタイム収集の詳細」

- 6.2.7項「オプションのハーベスタ構成の実行」

- 6.2.8項「ハーベスタのロギングの構成」

- 6.2.9項「ハーベスタでのトランザクション処理」

- 6.2.10項「拡張構成」

6.2.1 ハーベスタの入手

ハーベスタは11.1.1.x.x-OER-Harvester.zipに含まれていますが、これはOracle Enterprise Repository 11gインストールとバンドルされており、次の場所にあります。

<ORACLE_HOME>/repositoryXXX/core/tools/solutions/11.1.1.x.x-OER-Harvester.zip

このマニュアルでは、11.1.1.x.x-OER-Harvester.zipファイルの抽出先のディレクトリのことを<Harvester Home>ディレクトリと呼びます。

表6-2に、製品と対応するバージョンのリレーションシップのマトリクスを示します。

表6-2 ハーベスタの製品とバージョンのマトリクス

製品とバージョン

収集

IDEの検索、参照および使用

コマンド行

IDE

11g OSB

OSB 11g

はい

はい

10.3.1 OSB

OER 11g

はい

Oracle Enterprise Repository 11gハーベスタをEclipse IDEに追加します。詳細は、『Oracle Fusion Middleware Oracle Enterprise Repository統合ガイド』を参照してください。

SOA Suite 11g

OER 11g

はい

はい

SOA Suite 10g

OER 11g

はい

いいえ

AIA Foundation Pack 11g

AIA

いいえ

いいえ

標準ベースのアーティファクト(WSDL 1.1、XSD、BPEL、XSLT、BPMN 2.0)

OER 11g

状況により異なる

状況により異なる

ハーベスタ・ソリューション・パックによって使用されるparameter.properties

parameter.propertiesファイルにより、Oracle Enterprise Repositoryへのインポート操作時のハーベスタ・ソリューション・パックの動作が決まります。このファイルは一切変更しないでください。ソリューション・パック内のオブジェクトは、リストに記載されている動作に応じてインポートされます。

- ハーベスタ・ソリューション・パックの/META-INF/parameter.properties

PreserveUUIDs=true
Standard.saver.assettype.props.duplicate.handling=Merge
Standard.saver.assettype.props.duplicate.matching=UUID
Standard.saver.relationshiptype.props.duplicate.handling=Overwrite
Standard.saver.metadata.props.duplicate.handling=ignore
Standard.saver.metadataentrytype.props.duplicate.handling=ignore

- ハーベスタ・ソリューション・パックの動作のサマリー

- アセット
Oracle Enterprise Repository内にすでに存在するアセット(同じUUID)はマージされます。

アセットは、インポート・バンドルに指定されているUUIDとともに追加されます。

- アセット・タイプ
アセット・タイプは、UUIDがOracle Enterprise Repository内にすでに存在する場合は重複しているとみなされます。

ソリューション・パック内のアセット・タイプに新しい要素またはタブ(あるいはその両方)が追加されている場合、これらの要素およびタブはOracle Enterprise Repository内の既存のアセット・タイプに追加されます。

インポート・バンドル内の新しいアセット・タイプはOracle Enterprise Repositoryに追加されます。

- リレーションシップ・タイプ
同じ名前および方向を持つリレーションシップ・タイプは、Oracle Enterprise Repository内でインポート・バンドル内の情報に置き換えられます。

- カテゴリ分けタイプ
Oracle Enterprise Repository内のカテゴリ分けタイプと同じ名前を持つカテゴリ分けタイプ内の新しいカテゴリ分けエントリは、インポート・バンドル内の情報を使用してそのタイプに追加されます。

新しいカテゴリ分けタイプはOracle Enterprise Repositoryに追加されます。

- 許容値リスト(AVL)
Oracle Enterprise Repository内のAVLと同じ名前を持つAVL内の新しい値は、インポート・バンドル内の情報を使用してそのAVLに追加されます。

新しいAVLはOracle Enterprise Repositoryに追加されます。

- CMFメタデータ・エントリ・タイプ
重複するメタデータ・エントリ・タイプ(同じUUID)は無視されます。(ソリューション・パック内のエントリは無視されます。)

新しいメタデータ・エントリ・タイプはOracle Enterprise Repositoryに追加されます。

- CMFメタデータ・エントリ
重複するメタデータ・エントリ(同じUUID)は無視されます。(ソリューション・パック内のエントリは無視されます。)

新しいメタデータ・エントリはOracle Enterprise Repositoryに追加されます。

parameter.propertiesの詳細は、『Oracle Fusion Middleware Oracle Enterprise Repositoryユーザーズ・ガイド』のparameter.propertiesファイルに関する項を参照してください。

6.2.2 コマンド行用のハーベスタの構成

コマンド行からハーベスタを構成できます。Enterprise Repositoryは、コマンド行からハーベスタを使用して簡単にブートストラップできます。コマンド行を使用した収集により、組織では次を収集できます。

- 個々のファイル

- ファイルのディレクトリ

- リモート・ファイル

- アーティファクト・ストア内のファイル

- Oracle MetaData Store (MDS)内のファイル

この項では、コマンド行用としてハーベスタを構成するために実行する必要があるタスクについて説明します。

- 6.2.2.1項「コマンド行用のリポジトリ接続情報の設定」

- 6.2.2.2項「コマンド行用の収集対象のアーティファクトの選択」

6.2.2.1 コマンド行用のリポジトリ接続情報の設定

<Harvester Home>にあるXMLファイルHarvesterSettings.xmlファイルを開き、ハーベスタが適切な資格証明を使用してOracle Enterprise Repositoryインスタンスを参照するように次のXMLを変更します。

<repository>
<uri>http://localhost:7101/oer</uri>
<credentials>
<user>smith</user>
<password>*****</password>
//To ensure security, the password must be encrypted.
//The password encryption tool (encrypt.bat/encrypt.sh), which is located in
<ORACLE_HOME>/repositoryXXX/core/tools/solutions/11.1.1.x.x-OER-PasswordTools.zip,
allows you to encrypt
// the passwords that are stored in the Harvester configuration
// (HarvesterSettings.xml) file.
</credentials>
<timeout>30000</timeout>
</repository>

注意:

アセットの表示、編集、承認および登録を行うための基本的なアクセス権が設定されたユーザーとしてハーベスタを実行することをお薦めします。

また、次のようにリポジトリ接続情報をコマンド行ユーティリティにパラメータとして渡すこともできます。

C:\test\harvester> harvest -url http://localhost:7101/oer -user admin -password <password> -file c:\test\samples

6.2.2.2 コマンド行用の収集対象のアーティファクトの選択

ハーベスタは、harvest.batユーティリティを使用してコマンド行から実行できます。harvest.batまたはharvest.shを実行する前に、表6-3で示された環境変数が設定されていることを確認してください。Windowsでは、コマンド・ウィンドウから「set X」と入力すると、変数Xの値を表示でき、「set X=abc」と入力すると、Xの値を「abc」に設定できます。

表6-3 コマンド行スクリプト

環境変数

説明

JAVA_HOME

JAVA_HOME環境変数がインストール済のJavaランタイム(JRE)またはSDKを指していることを確認します。Oracle Service Busのイントロスペクションの場合、これはJavaバージョン6以上である必要があります。

BEA_HOME

Oracle Service Busからプロジェクトを収集する場合のみ、Oracle Service Busサーバーが含まれるインストール・ディレクトリをBEA_HOME環境変数が指していることを確認してください。たとえば、C:\beaです。

JAVA_OPTS

オプションで、JAVA_OPTSパラメータを設定し、別の必要なjavaパラメータを追加します。たとえば、HTTPプロキシ・サーバーを使用する必要がある場合、値を-Dhttp.proxyHost=www-proxy.yourhost.com -Dhttp.nonProxyHosts= "*.yourhost.com |localhost"に設定します。

関連項目: http://java.sun.com/javase/6/docs/technotes/guides/net/proxies.html

表6-4に、ハーベスタ・コマンド行ユーティリティを使用して指定できるオプションを示します。

表6-4 ハーベスタのコマンド行オプション

ハーベスタのオプション

説明

-settings<file>

構成設定のXMLファイルを指定します。

-mds_settings <file>

MDSを初期化するためのadf-config.xmlファイルの場所を指定します。省略した場合、ハーベスタに用意されているadf-config.xmlファイルにデフォルト設定されます。

-url <URL>

Oracle Enterprise RepositoryのURLを指定します。

-user <OER User Name>

Oracle Enterprise Repositoryユーザーのユーザー名を指定します。

-password <OER Password>

Oracle Enterprise Repositoryユーザーのパスワードを指定します。

セキュリティを確実にするために、パスワードを暗号化する必要があります。

Oracle Enterprise Repository Webコンソールには、パスワードを暗号化するためのツールがあります。

http://<host>:<port>/<domain>/diag/encryptstrings.jsp

関連項目: パスワードの暗号化の詳細は、第5章「診断およびパスワードの暗号化」を参照してください。

-artifact_store

参照するOracle Enterprise Repositoryアーティファクト・ストアの名前を指定します。アーティファクト・ストアは、Oracle Enterprise Repositoryのアセット・エディタで事前に作成する必要があります。指定した場合、-file引数はアーティファクト・ストアのURLを基準に解決されます。

アーティファクト・ストアを基準にURIを指定する場合、URIは.wsdlファイルまたは.zipファイルなどのファイルに解決される必要があります。directoriesを指すURIはサポートされません。

アーティファクト・ストアの詳細は、6.2.4.2項「ネストした要素としてのパラメータの指定」を参照してください。

-file <filename or URL>

収集するファイルまたはディレクトリを指定します。これは、ファイル名またはファイルのURLに設定できます。

-file_type <type>

収集するファイルのファイル・タイプを指定します。指定しない場合、タイプはファイルの拡張子から導出されます。これは、config/pluginsフォルダ内のファイル・タイプの1つと一致する必要があります。デフォルトでは、.bpel、.mfl、.policy、.wsdl、.xsd、.xquery、.xsltがサポートされます。

-remote_url <URL>

リモート・プロジェクトの収集元として、ファイルではなく、実行中のサーバーを指定します。

-remote_username <username>

リモート・サーバーに接続するためのユーザー名を指定します。

-remote_password <password>

リモート・サーバーに接続するためのパスワードを指定します。

セキュリティを確実にするために、パスワードを暗号化する必要があります。

Oracle Enterprise Repository Webコンソールには、パスワードを暗号化するためのツールがあります。

http://<host>:<port>/<domain>/diag/encryptstrings.jsp

-remote_server_type <type>

リモート・サーバーのタイプを指定します。リモート・サーバーには、SOASuite、OSB、WLSのいずれかを含めることができます。

-remote_project <type>

ファイルではなく、収集するリモート・プロジェクトの名前を指定します。省略した場合、サーバー上のすべてのプロジェクトが収集されます。Oracle SOA Suiteの場合、これは、コンポジットの名前にリビジョンを付けた名前(たとえば、MyComposite_rev1など)にする必要があります。WLSの場合、これは、WebLogic管理コンソールおよびEnterprise Managerで見られるようなアプリケーション名にする必要があります。

-deployment_status <status>

作成したアセットに設定されるデプロイメント・ステータスを指定します。これは、設計時の値またはランタイム値をとります。

-version

出力のバージョン情報を指定します。

-soa_partition <type>

Oracle SOA Suiteのパーティションの名前を指定します。デフォルトでは、SOAの"default"パーティションが使用されます。

-preview

収集をプレビュー・モードで実行できるかどうかを指定します。trueに設定した場合、ハーベスタはプレビュー・モードで実行されます。成功および失敗に関する詳細情報が記録され、変更はOracle Enterprise Repositoryにコミットされません。

falseに設定したか、値が指定されていない場合、ハーベスタは本番モードで実行されます。成功および失敗に関する詳細情報が記録され、変更はOracle Enterprise Repositoryにコミットされます。

-producing_project <project>

収集から作成されたすべてのアセットがこのプロジェクトの作成に適用されます。

プロジェクトはOER内にすでに存在する必要があります。

-help

ハーベスタのコマンド行ユーティリティのオンライン・ヘルプが表示されます。

リモート収集の例は、次のとおりです。

harvest.bat -remote_url mysoasuiteserver:8001 -remote_username weblogic -remote_password ****** -remote_server_type SOASuite -remote_project MyComposite_rev1.0 -soa_partition department1

セキュリティを確実にするために、パスワードを暗号化する必要があります。Oracle Enterprise Repository Webコンソールには、パスワードを暗号化するためのツールがあります。

http://<host>:<port>/<domain>/diag/encryptstrings.jsp

図6-1に、harvest.bat -helpコマンドで表示されたコマンド行ユーティリティのオプションとオンライン・ヘルプを示します。

図6-1 収集のコマンド行ユーティリティのオプション

コマンド行のオプションはどれも必須ではありません。これらは省略できます。

オプションが省略された場合、ハーベスタはharvest.batが存在する<Harvester Home>ディレクトリのHarvesterSettings.xmlファイルにある情報を使用します。コマンド行でオプションを指定した場合、これらにより、HarvesterSettings.xmlの設定がオーバーライドされます。

<Harvester Home>内のHarvesterSettings.xmlファイルを使用して収集されるアーティファクトを参照するには、次のXMLを変更します。

<query>
<fileQuery>
<rootDir>C:\samples</rootDir>
<files>BPEL</files>
</fileQuery>
</query>

または

<query>
<fileQuery>
<files>http://remote/server/my_generated_wsdl</files>
<fileType>.wsdl</fileType>
</fileQuery>
</query>

6.2.3 統合開発環境でのハーベスタの使用

ハーベスタは、Oracle JDeveloper、EclipseおよびVisual Studio .NETなどの統合開発環境(IDE)と統合できます。

注意:

Oracle Enterprise Repositoryは、エンドポイントおよびホストされているWSDLを持つサービスのみをOracle Service Registryに昇格します。また、具体的なWSDLを持つサービスのみをJDeveloperを介して使用できます。エンドポイントおよびWSDLの場所を取得するために実行時環境から収集することをお薦めします。

ハーベスタとIDEの統合の詳細は、『Oracle Fusion Middleware Oracle Enterprise Repository統合ガイド』を参照してください。

6.2.4 repository.submit Antタスクを使用したハーベスタの呼出し

ハーベスタをAntタスクとして呼び出すと、デプロイメント時にすべてのデプロイメント情報がOracle Enterprise Repositoryに格納されます。ハーベスタが提供するrepository.submit Antタスクを使用して、メタデータを収集してOracle Enterprise Repositoryにインポートできます。このタスクは、<Harvester Home>ディレクトリ(11.1.1.x.x-OER-Harvester.zipを解凍したディレクトリ)にあるharvest-tasks.xmlファイルで定義できます。

この項には次のトピックが含まれます:

- 6.2.4.1項「repository.submit Antタスクのパラメータの指定」

- 6.2.4.2項「ネストした要素としてのパラメータの指定」

- 6.2.4.3項「Antからのハーベスタの実行」

- 6.2.4.4項「サード・パーティ・タスクの使用」

6.2.4.1 repository.submit Antタスクのパラメータの指定

表6-5に、harvest-tasks.xmlファイル内のrepository.submit Antタスクに指定できるパラメータを示します。

表6-5 repository.submit Antタスクのパラメータ

属性

説明

必須

repositoryURL

接続先のリポジトリ・インスタンス。

はい(プロパティによって指定されていない場合)。

repositoryUsername

Oracle Enterprise Repositoryにログインするためのユーザー名。

はい(プロパティによって指定されていない場合)。

repositoryPassword

Oracle Enterprise Repositoryにログインするためのパスワード。

セキュリティを確実にするために、パスワードを暗号化する必要があります。

Oracle Enterprise Repository Webコンソールには、パスワードを暗号化するためのツールがあります。

http://<host>:<port>/<domain>/diag/encryptstrings.jsp

はい(プロパティによって指定されていない場合)。

timeout

Oracle Enterprise Repositoryに対する呼出しがタイムアウトするまでの秒数。

いいえ。デフォルト値は300 (5分)です。

failOnError

Oracle Enterprise Repositoryの操作の結果としてエラーになった場合、ビルド・スクリプト全体が失敗します。

いいえ。デフォルト値はtrueです。

errorProperty

リポジトリの操作の結果としてエラーになった場合に設定するAntプロパティの名前。これはfailOnErrorがfalseに設定されている場合のみ有効です。エラーが発生した場合、指定したプロパティはtrueに設定されます。それ以外の場合は、指定したプロパティは設定が解除されたままです。

いいえ。

debug

Antの-debug設定とは関係なく、Oracle Enterprise Repositoryタスクからのデバッグ情報を表示します。また、デバッグ情報は、-debugパラメータをAntランタイムに渡す場合も表示されます。

いいえ。デフォルト値はtrueです。

description

Oracle Enterprise Repositoryで作成された各アセットに関連付けるハーベスタの説明。これは、ハーベスタ・プロパティに表示されます。ハーベスタ・プロパティの詳細は、B.10項「ハーベスタのプロパティ」を参照してください。

いいえ。

namespace

Oracle Enterprise Repositoryで作成された各アセットに接頭辞を付けるためのネームスペース。

いいえ。

version

Oracle Enterprise Repositoryで作成された各アセットに関連付けるハーベスタ・バージョン。これは、ハーベスタ・プロパティに表示されます。

いいえ。

beaHome

インストールされているOracle Service BusサーバーのBEA_HOMEディレクトリ。

はい(Oracle Service Busプロジェクトのjarを収集する場合)。

settingsFile

設定XMLファイルの場所。BPEL_Harvester_Settings.xsdに準拠している必要があります。このファイルにより、どのファイル・タイプにどのようなハーベスタ・クラスがマップされるか、およびOracle Enterprise Repository内のタイプにエンティティとリレーションシップがどのようにマップされるかが構成されます。オプションで、この属性とsettingsURL属性のどちらかを指定できますが、両方を指定することはできません。

いいえ。Antタスクにバンドルされた設定XMLにデフォルト設定されます。

settingsURL

設定XMLファイルの場所。BPEL_Harvester_Settings.xsdに準拠している必要があります。このファイルにより、どのファイル・タイプにどのようなハーベスタ・クラスがマップされるか、およびOracle Enterprise Repository内のタイプにエンティティとリレーションシップがどのようにマップされるかが構成されます。オプションで、この属性とsettingsFile属性のどちらかを指定できますが、両方を指定することはできません。

いいえ。Antタスクにバンドルされた設定XMLにデフォルト設定されます。

preview

このオプションにより、ハーベスタをプレビュー・モードに設定します。ハーベスタには、作成または変更するすべてのアセットが表示されますが、トランザクションはコミットされません。有効にするには、値をtrueに設定します。

いいえ。デフォルト値はfalseです。

6.2.4.2 ネストした要素としてのパラメータの指定

fileSet

fileSetは、収集する一連のファイルを選択するために使用されます。1つ以上のfileSetを指定する必要があります。ハーベスタにより、fileSetによって選択されたすべてのファイルが調査されます。これには、.zip形式(.zip、.jarおよび.earファイルなどを含む)が含まれます。例6-1に示すAnt repository.submitタスクでは、fileSetディレクトリ(/tmp/componentsディレクトリ)の下のすべてのファイルおよびディレクトリが調査され、これらがOracle Enterprise Repositoryにインポートされています。

URI

URIは、イントロスペクトするファイルを識別します。1つ以上のURIを指定できます。これには、リモート・ファイルを指す"http:" URL、ローカル・ファイルを指す"file:" URL、またはJavaでサポートされる他の任意のURLを指定できます。これは、単一のファイル、またはzip、jar、earなどを含むzip形式のファイルを指すことができます。これには、エクスポートされたOracle Service Busプロジェクトのjarが含まれる場合があります。Oracle Service Busプロジェクトは、Export|Oracle Service Bus|Configuration JarコマンドをOracle Service Bus Workshopからエクスポートできます。artifactStore属性は、参照するOracle Enterprise Repositoryアーティファクト・ストアの名前です。アーティファクト・ストアは、Oracle Enterprise Repositoryのアセット・エディタで事前に作成する必要があります。指定した場合、URIはアーティファクト・ストアのURLを基準に解決されます。アーティファクト・ストアを基準にURIを指定する場合、URIは.wsdlファイルまたは.zipファイルなどのファイルに解決される必要があります。ディレクトリを指すURIはサポートされません。fileType属性は、収集するファイルのファイル・タイプを示します。指定しない場合、タイプはファイルの拡張子から導出されます。これは、config/pluginsフォルダ内のファイル・タイプの1つと一致する必要があります。デフォルトでは、.bpel、.mfl、.policy、.wsdl、.xsd、.xquery、.xsltがサポートされます。

例6-1 Ant repository.submitタスクを使用した収集対象ファイルの指定

<repository.submit repositoryurl="http://server.example.com:8080/oer"
repositoryusername="myuser"
registrypassword="*****"
registrationStatus="Registered"
applyRegistrationStatusToExistingAssets="true"
//To ensure security, the password must be encrypted.
//The password encryption tool (encrypt.bat/encrypt.sh) allows you to encrypt
// the passwords that are stored in the Harvester configuration
// (HarvesterSettings.xml) file.
settingsFile="../MyCustomSettings.xml">
<fileset dir="/tmp/components/">
<include name="**/*"/>
</fileset>
<applyCategorization type="Classification" value="Raw"
applyToExistingAssets="false" />
<applyCategorization type="AssetFunction" value="XML Standards"
applyToExistingAssets="true" />
<uri filetype=".wsdl">http://remote/server/my_generated_wsdl</uri>
</repository.submit>

登録ステータスおよびカテゴリ分け

ハーベスタから作成されるアセットの登録ステータスを指定できます。使用できる値は次のとおりです。

- 未発行

- 発行済 - レビュー保留中

- 発行済 - レビュー中

- 登録済

デフォルトでは、新しく作成されたアセットに登録ステータスが適用されます。また、同じアーティファクトの以前の収集から作成されるアセットの登録ステータスを指定することもできます。有効にするには、例6-1に示すように、applyRegistrationStatusToExistingAssetsをtrueに設定します。

収集から作成されるアセットにカテゴリ分けを適用できます。これには、アセット・エディタの「カテゴリ分けの構成」タブに表示される、カテゴリ分けタイプの内部名が判明していることが必要です。必要な値は、Element Nameです。

1. アセット・エディタを開きます。

2. 「アクション」→カテゴリ分けの構成を選択します。

3. カテゴリ分けタイプを選択し、「編集」を選択します。「要素名」フィールドに、値が表示されます。例6-2を参照してください。

図6-2 カテゴリ分けの編集

「要素名」は、アセット・エディタの「カテゴリ分けの構成」ウィンドウのフィールドを参照しています。このフィールドの値をHarvesterSettings.xmlで使用します。

remoteProject

remoteProjectにより、ハーベスタがファイルからではなくリモート・サーバーからプロジェクトを読み込むよう指定します。uri属性は、リモート・プロジェクトの読込み元の実行中のサーバーを示します。usernameおよびpassword属性は、リモート・サーバーのログイン情報を示します。

serverType属性は、リモート・サーバーのタイプを示し、これには、SOASuite、Oracle Service BusまたはWebLogic Serverなどがあります。projectName要素は、ファイルではなく、収集するリモート・プロジェクトの名前を示します。省略した場合、サーバー上のすべてのプロジェクトが収集されます。Oracle SOA Suiteの場合、これは、コンポジットの名前にリビジョンを付けた名前(たとえば、MyComposite_rev1など)にする必要があります。WLSの場合、これは、WebLogic管理コンソールおよびEnterprise Managerで見られるようなアプリケーション名にする必要があります。

例6-2 ネストした要素としてのパラメータの指定 - remoteProject

<repository.submit repositoryurl="http://server.example.com:8080/oer"
repositoryusername="myuser"
registrypassword="*****"
//To ensure security, the password must be encrypted.
//The password encryption tool (encrypt.bat/encrypt.sh) allows you to encrypt
// the passwords that are stored in the Harvester configuration
// (HarvesterSettings.xml) file.
settingsFile="../MyCustomSettings.xml">
<remoteProjects uri="http://mywlsserver:7001" username="admin" password="*****"
serverType="SOASuite" soaPartition="${partiton}">
//To ensure security, the password must be encrypted.
//The password encryption tool (encrypt.bat/encrypt.sh) allows you to encrypt
// the passwords that are stored in the Harvester configuration
// (HarvesterSettings.xml) file.
<projectName>MySOAComposite1_rev1.0</projectName>
<projectName>MySOAComposite3_rev2.0</projectName>
</remoteProjects>
</repository.submit>

プロジェクトの作成

収集から作成されたすべてのアセットに対するプロジェクトの作成としてタグ付けされた複数のプロジェクトを指定できます。プロジェクトはOER内にすでに存在する必要があります。

<repository.submit>要素内に、次を追加します。

- <producingProject name="MyProjectName"/>

- <producingProject name="MyOtherProjectName"/>

プロジェクトの作成は、同じ方法で、HarvesterSettings.xmlファイル内に設定することもできます。

6.2.4.3 Antからのハーベスタの実行

ハーベスタのAntタスクをインポートするには、Ant XML内に次の行を追加します。

<taskdef file=${harvester.dir}/harvest-tasks.xml/>

ここで、harvester.dirは11.1.1.x.x-OER-Harvester.zipを解凍した<harvester home>ディレクトリです。

コマンド行から実行する場合、Antのクラスパスでハーベスタ・ライブラリが使用可能であることを確認してください。ハーベスタには、Antのクラスパスを正しく設定するためのrunantと呼ばれるスクリプトがあります。ハーベスタのAntタスクを使用する場合は、このスクリプトを使用してAntを呼び出す必要があります。次に例を示します。

runant -f mybuild.xml

(ここで、mybuild.xmlは自分のAntのビルドXMLです。)

runantに渡される引数はすべてAntに渡されます。harvest.batまたはharvest.shを実行する前に、必要な環境変数が設定されていることを確認してください。設定する必要がある環境変数のリストは、表6-6を参照してください。

表6-6 コマンド行スクリプト

環境変数

説明

JAVA_HOME

JAVA_HOME環境変数がインストール済のJavaランタイム(JRE)またはSDKを指していることを確認します。Oracle Service Busのイントロスペクションの場合、これはJavaバージョン6以上である必要があります。

ANT_HOME

ANT_HOME環境変数がApache Antバージョン1.6.2以上のインストールを指していることを確認してください。Oracle Service Busのイントロスペクションの場合、Antバージョン1.6.5以上であることを確認してください。

BEA_HOME

Oracle Service Busからプロジェクトを収集する場合、Oracle Service Busサーバーが含まれるインストール・ディレクトリをBEA_HOME環境変数が指していることを確認してください。たとえば、C:\beaです。

JAVA_OPTS

オプションで、JAVA_OPTSパラメータを設定し、別の必要なjavaパラメータを追加します。たとえば、HTTPプロキシ・サーバーを使用する必要がある場合、値を-Dhttp.proxyHost=www-proxy.yourhost.com -Dhttp.nonProxyHosts= "*.yourhost.com |localhost"に設定します。

関連項目: http://java.sun.com/javase/6/docs/technotes/guides/net/proxies.html

6.2.4.4 サード・パーティ・タスクの使用

runantスクリプトは、Antの古いランチャであるorg.apache.tools.ant.Mainを使用します。新しいランチャは、Oracle Service BusのカスタムURIStreamHandlersの使用に影響を及ぼすURIClassLoaderインタフェースを使用します。

古いAntランチャは、ant/libディレクトリでのカスタムAntタスクの自動検出をサポートしていません。<taskdef>を使用してカスタム・タスクを定義する場合、クラスパス属性を指定する必要があります。

たとえば、次の例は、<taskdef>の定義方法として正しくない方法を示しています。

<taskdef id="ant-contrib" resource="net/sf/antcontrib/antcontrib.properties"/>

次の例は、<taskdef>の定義方法として正しい方法を示しています。

<taskdef id="ant-contrib" resource="net/sf/antcontrib/antcontrib.properties" classpath="${ant.home}\lib\ant-contrib.jar"/>

6.2.5 WLSTからのハーベスタの呼出し

WLST (WebLogic Scripting Tool)はコマンド行スクリプト・インタフェースです。システム管理者は、このインタフェースでWebLogic Serverのインスタンスを管理できます。WLSTは、Oracle Service Bus 10gおよびSOA Suite 11gをサポートしています。WLSTの詳細は『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』を参照してください。ハーベスタをWLSTから呼び出すと、デプロイメント時にすべてのデプロイメント情報をOracle Enterprise Repositoryに格納できます。次の手順を実行し、WLSTからハーベスタを呼び出します。

1. oer.pyファイルをハーベスタのインストール・フォルダから<BEA_HOME>\wlserver_10.3\common\wlst\libディレクトリにコピーします。

2. コマンド・ウィンドウで、次のコマンドを入力します。

- WLSTクラスパスを初期化します。<BEA_HOME>\wlserver_10.3\server\bin\setWLSEnv.cmdを実行します。

- ハーベスタのクラスパスを初期化します。<harvester>フォルダに移動し、<harvester>\setenv.batを実行します。

- WLSTを呼び出します: java weblogic.WLST<scriptname>

3. AntからWLSTを呼び出すには、次の手順を実行します。

- コマンド・プロンプトで、cdコマンドを使用して<harvester>ディレクトリに変更します。

- runant.bat -f<antscriptname>を入力します。この場合、Antスクリプトにより、Antの<java>タスクを使用してweblogic.WLST Javaクラスが呼び出されます。

- <java>タスクは、fork = trueに設定する必要があります。

- <java>タスクでは、環境のCLASSPATHを含める必要があります(runant.batにより、ハーベスタ・クラスを追加するようCLASSPATHが設定されます)。

- <java>タスクでは、WLSTスクリプトによって参照される任意のライブラリもクラスパスに含める必要があります。

Antスクリプトの例を次に示します。

<property environment="env"/>
<target name="harvest">
<java classname="weblogic.WLST" fork="true">
<arg line="${domain.import.script}"/>
<arg line="${import.config.file}"/>
<classpath refid="extra.class.path"/> <!--extra jars used by WLST script, e.g.
OSB jars-->
<classpath path="${env.CLASSPATH}"/>
</java>
</target>

oer.harvest()メソッドは、1つの引数(コマンド行パラメータのディクショナリ)をとります。これらは、ハーベスタのコマンド行から使用可能なパラメータと同じパラメータです。

コマンド行からのハーベスタの使用の詳細は、6.2.2.2項「コマンド行用の収集対象のアーティファクトの選択」を参照してください。

次に、その使用方法の例を示します。

argMap = {}
argMap['-harvester_home'] = '.'
argMap['-bea_home'] = 'c:/bea'
argMap['-remote_url'] = 'http://mywlsserver:7001'
argMap['-remote_username'] = 'admin'
argMap['-remote_password'] = '*****'
//To ensure security, the password must be encrypted.
//The password encryption tool (encrypt.bat/encrypt.sh) allows you to encrypt
// the passwords that are stored in the Harvester configuration
// (HarvesterSettings.xml) file.
argMap['-remote_server_type] = 'SOASuite'
argMap['-remote_project] = 'MySOAComposite_rev1.0'
argMap['-soa_partition'] = 'department1'
oer.harvest(argMap)

-harvester_home引数は、ハーベスタ・インストールの場所を指す必要があります。-bea_home引数は、Oracle Service Busによる収集の場合に必要です。

6.2.6 ランタイム収集の詳細

アセットが開発からテスト、ステージングおよび本番の各環境に移行するにつれ、これらのアセットをOracle Enterprise Repository内に収集することにより、Oracle Enterprise Repositoryのエンドポイントを最新のものにできます。Oracle Enterprise Repositoryでは、新しいエンドポイントがOracle Enterprise Repository内の既存のアセットに関連付けられます。アセットのライフサイクルの経過に応じてWSDLが変更されると、更新されたWSDLもOracle Enterprise Repository内の既存のアセットに関連付けられます。

この項では、様々なサーバーに関するランタイム収集の詳細を説明します。この項には次のトピックが含まれます:

- 6.2.6.1項「Oracle SOA Suiteサーバーからの収集」

- 6.2.6.2項「WebLogic ServerからのWebサービスの収集」

- 6.2.6.3項「Oracle Service BusからのWebサービスの収集」

6.2.6.1 Oracle SOA Suiteサーバーからの収集

Oracle SOA Suiteサーバーから収集する場合、次のWLSセキュリティ・ロールが必要です。

- 管理者

- オペレータ

- モニター

-remote_urlパラメータは、SOAインフラ管理対象サーバーのポートを指す必要があります。Oracle SOA Suiteでのこのデフォルト値は8001です。

SOAインフラ管理対象サーバーは稼働している必要があります。収集の際には、リモート収集の一環としてMDSデータベースへの接続が行われます。MDSデータベースは稼働しており、収集が行われるマシンからアクセスできる必要があります。

SSL/HTTPプロトコルがサポートされます。ハーベスタは、t3プロトコルを介してサーバーのMBeanに接続します。

Deployment URIプロパティ内の-remote_urlの値は、ランタイム・サーバーから収集されたアセットに自動的に保存されます。

Oracle SOA Suiteサーバーからの収集の例は、次のとおりです。

harvest.bat -remote_url mysoasuiteserver:8001 -remote_username weblogic -remote_password <*****> -remote_server_type SOASuite -remote_project MyComposite_rev1.0 -soa_partition default

セキュリティを確実にするために、パスワードを暗号化する必要があります。パスワード暗号化ツール(encrypt.bat/encrypt.sh)を使用すると、ハーベスタ構成ファイル(HarvesterSettings.xml)に格納されているパスワードを暗号化できます。パスワードの暗号化の詳細は、第5章「診断およびパスワードの暗号化」を参照してください。

Oracle SOA Suiteサーバーには、ランタイム中にコンポジットをさらにカテゴリ分けするためのパーティションも実装されています。これにより、ハーベスタ内でコンポジット名とともに使用するパーティションを選択できます。HarvesterSettings.xmlファイル内のパラメータ名は、soaPartitionと呼ばれます。HarvesterSettings.xmlファイルの例を次に示します。

<remoteQuery>
<serverType>SOASuite</serverType>
<projectName>MyComposite_rev1.0</projectName>
<uri>http://remotehost:8001/</uri>
<credentials>
<user>weblogic</user>
<password>password</password>
</credentials>
<soaPartition>partition_name</soaPartition>
</remoteQuery>

注意:

パーティションは、バージョン11g R1 PS2以上のSOAサーバーでのみ使用する必要があります。PS2より前のバージョンを使用している場合は、soaPartition要素にコメントを付ける必要があります。

デフォルトでは、"default"に設定されたpartition_nameオプションを使用して収集が行われます。指定されていない場合、パーティションの"default"はSOAデプロイメントによって即時利用可能になります。

クラスタ内のSOA Suiteコンポジットの収集

OHSサーバーは、WebTierラベルの一部としてミドルウェア・ホームにデプロイされており、このミドルウェア・ホーム内で構成されたドメインにも関連付けられています。

通常はOHSサーバーのmod_wl_2x.so HTTPサーバー・モジュールに割り当てられているURIがいくつか存在しますが、その一部を次に示します(OHSのmod_wl_ohs.confファイルから取得され、外部で使用できるよう汎用化するために変更されたものです)。

LoadModule weblogic_module

"/opt/Oracle/Middleware/wlserver_10.3/server/plugin/linux/x86_64/mod_wl_22.so"
<IfModule weblogic_module>
ConnectTimeoutSecs 10
ConnectRetrySecs 2
Debug ALL
WLLogFile /tmp/weblogic.log
DebugConfigInfo ON
WLSocketTimeoutSecs 2
WLIOTimeoutSecs 300
Idempotent ON
FileCaching ON
KeepAliveSecs 20
KeepAliveEnabled ON
DynamicServerList ON
WLProxySSL OFF
</IfModule>

<Location /soa-infra>
SetHandler weblogic-handler
WebLogicCluster slc01ese.example.com:23049,wls02.example.com:15980
</Location>
<Location  ~ "/bea_wls_internal/iiop/Client*">
SetHandler weblogic-handler
WebLogicCluster wls01.example.com:23049,wls02.example.com:15980
</Location>
<Location  ~ "/bea_wls_internal/HTTPClnt*">
SetHandler weblogic-handler
WebLogicCluster wls01.example.com:23049,wls02.example.com:15980
</Location>
<Location /console>
SetHandler weblogic-handler
WebLogicHost wls01.example.com
WebLogicPort 19617
</Location>
<Location /em>
SetHandler weblogic-handler
WebLogicHost wls01.example.com
WebLogicPort 19617
</Location>
<Location /bea_wls_internal>
SetHandler weblogic-handler
WebLogicHost wls01.example.com
WebLogicPort 19617
</Location>
<Location /jndi>
SetHandler weblogic-handler
WebLogicHost wls01.example.com
WebLogicPort 23049
</Location>
<Location /HTTPClnt>
SetHandler weblogic-handler
WebLogicHost wls01.example.com
WebLogicPort 23049
</Location>

これらの特別なURIパターンを使用すると、JMSおよびJMXリクエストをOHS WebLogicモジュールを経由してルーティングできます。

コードに適用した変更を除いて、これらが、SOAクラスタ・インストールに適用された唯一のカスタマイズです。

6.2.6.2 WebLogic ServerからのWebサービスの収集

WebLogic Serverから収集する場合、WebLogic Serverのセキュリティ・ロールは必要ありません。

-remote_urlパラメータは、WLS管理サーバーのポートを指す必要があります。Weblogicでのこのデフォルト値は7001です。WLS管理サーバーは稼働している必要があります。SSL/HTTPプロトコルがサポートされます。ハーベスタは、t3プロトコルを介してサーバーのMBeanに接続します。

Deployment URIプロパティ内の-remote_urlの値は、ランタイム・サーバーから収集されたアセットに自動的に保存されます。

6.2.6.3 Oracle Service BusからのWebサービスの収集

Oracle Service BusからWebサービスを収集する場合、管理WLSセキュリティ・ロールが必要です。

-remote_urlパラメータは、Oracle Service BusドメインのWLS管理サーバーのポートを指す必要があります。Weblogicでのこのデフォルト値は7001です。WLS管理サーバーは稼働している必要があります。SSL/HTTPプロトコルがサポートされます。ハーベスタは、t3プロトコルを介してサーバーのMBeanに接続します。

Deployment URIプロパティ内の-remote_urlの値は、ランタイム・サーバーから収集されたアセットに自動的に保存されます。

Oracle Service BusからのWebサービスの収集の例は、次のとおりです。

harvest.bat -remote_url myosbserver:7001 -remote_username weblogic -remote_password (******) -remote_server_type OSB -remote_project MyOSBProject

セキュリティを確実にするために、パスワードを暗号化する必要があります。パスワード暗号化ツール(encrypt.bat/encrypt.sh)を使用すると、ハーベスタ構成ファイル(HarvesterSettings.xml)に格納されているパスワードを暗号化できます。パスワードの暗号化の詳細は、第5章「診断およびパスワードの暗号化」を参照してください。

6.2.7 オプションのハーベスタ構成の実行

オプションで、<Harvester Home>ディレクトリのXMLファイルHarvesterSettings.xml内の次の追加構成設定を変更できます。

- <harvesterDescription>: 実行される収集に関する説明。この情報は、Oracle Enterprise Repositoryで作成されたアセットのハーベスタ・プロパティに格納されます。

- <harvesterVersion>: 実行される収集のバージョン。この情報は、Oracle Enterprise Repositoryで作成されたアセットのハーベスタ・プロパティに格納されます。

- <namespace>: 収集中に作成された抽象(非アーティファクト) Oracle Enterprise Repositoryアセットに追加されるネームスペース。ネームスペースは、重複の検出で使用されます。空白のままにすると、Oracle SOA SuiteおよびOracle Service Busプロジェクト(使用可能な場合)の情報に基づいて設定されます。通常、これが最適であるため、オーバーライドする場合は慎重に行ってください。

- <workDir>: zipおよびjarファイルが解凍される一時ディレクトリ。デフォルトでは、システムの一時ディレクトリが使用されます。

- <triggerEvent>: ワークフローによって使用されるOracle Enterprise Repositoryイベントの状態。trueの場合、ワークフローによって使用されるOracle Enterprise Repositoryイベントがトリガーされます。

ハーベスタのプロパティの詳細は、B.10項「ハーベスタのプロパティ」を参照してください。

6.2.7.1 Oracle Metadata ServiceのURL

ハーベスタは、OracleのMDS (メタデータ・サービス)からのファイルの読込みをサポートしています。MDSは、SOA Suite 11gでSOA Suiteフレームワーク・スキーマ、共有ポリシー、およびデプロイ済コンポジットなどの共有データを格納するために使用されます。

Oracle MDSファイルは、oramds: URLプロトコルを介して参照されます。ハーベスタには、MDSへの接続を構成するために使用されるadf-config.xmlファイルが含まれます。このファイルは、JDeveloperでフレームワーク・スキーマ用として使用されるローカルMDSストアを指すことができます。また、フレームワーク・スキーマ、共有ポリシー、およびデプロイ済コンポジットにアクセスするためにリモートMDSストアを指すこともできます。ハーベスタに同梱されているadf-config.xmlファイルには、両方の使用事例が示されています。

ローカルMDSの場合、adf-config.xml内のmetadata-pathプロパティを変更し、JDeveloperインストールの場所と一致するよう設定します。リモートMDSの場合、adf-config.xmlで、file store (JDev)とマークされたセクションをコメント化し、「DB store (SOA Suite server)」とマークされたセクションを非コメント化します。また、jdbc-url、jdbc-useridおよびjdbc-passwordプロパティも変更し、Oracle SOA SuiteサーバーのMDSデータベースを指すようにします。

次の例に示すように、コマンド行から収集することもできます。

harvest.bat -file oramds:/policies/oracle/wsmtom_policy

Oracle JDeveloper 11gは、MDS内のコンテンツを表示できるブラウザ・ベースのアプリケーションです。JDeveloperで、「ファイル」、「新規」をクリックします。新規ギャラリ・ダイアログで、「接続」、SOA-MDS接続をクリックし、MDS接続を表示します。

また、HarvesterSettings.xmlまたはハーベスタのAntタスク内の<mdsSettingsFile>要素を介してハーベスタが別のadf-config.xmlファイルを指すようにすることができます。

MDSの構成の詳細は、『Oracle Fusion Middleware Oracle Application Development Framework Fusion開発者ガイド』のOracle ADF XMLファイルに関する項を参照してください。

6.2.7.2 クラスパスのURL

ハーベスタは、Javaのクラスパスからのファイルの読込みをサポートしています。これらのファイルは、classpath: URLプロトコルを介して参照されます。これらのファイルは、ハーベスタのクラスパス内のjarファイルまたはディレクトリ内にあります。たとえば、classpath:/META-INF/wsdl/ServiceException.wsdlなどです。

6.2.8 ハーベスタのロギングの構成

ハーベスタは、実行された詳細タスクのロギング用としてlog4jを使用し、ログ・ファイルは<Harvester Home>ディレクトリに格納されます。ロギング・オプションを変更するには、<Harvester Home>ディレクトリ内のlog4fl.propertiesファイルを更新します。

6.2.9 ハーベスタでのトランザクション処理

デフォルトでは、ハーベスタは、Oracle Enterprise Repositoryに対するすべての変更を単一のトランザクションで行います。ハーベスタ機能におけるトランザクション操作は、次のルールに基づいています。

- 11g R1の場合、Oracle Enterprise Repositoryサーバーは一度に1つのトランザクションのみをサポートします。トランザクションを開始できない場合、その旨通知されます。

- トランザクションには、一連のタイムアウトが関連付けられています。これらにより、タイムアウトを超えた場合にハーベスタの操作が終了します。

- cmee.extframework.impexp.monitor.rex.maxidleの設定により、トランザクションとクライアントとの接続が失われたときにトランザクションの稼働状態を維持する最大時間を指定します。これにより、クライアント側のハーベスタ・プロセスが中断されたときにトランザクションを取り消すことが可能になります。

- cmee.extframework.impexp.monitor.maxruntimeの設定により、トランザクション全体に必要な最大時間を指定します。

1つの操作がcmee.extframework.impexp.monitor.rex.maxidle (maxidle)設定を超えると、これが原因で後続のすべての操作が失敗する可能性があります。この場合、ログ内の最後のエラーには「トランザクションが開始されていないためにトランザクションをロールバックしようとしたときにエラーが発生しました。」と表示されます。これは、文がmaxidleを超えたときにトランザクションが自動的にロールバックされることが原因であり、クライアント・アプリケーションが強制的にロールバックを試行すると対象のトランザクションを使用できなくなり、エラーが検出されます。この結果、ハーベスタの操作によるデータは、Oracle Enterprise Repositoryに追加されなくなります。

6.2.10 拡張構成

この項では、ハーベスタの拡張構成オプションについて説明します。

アダプタおよびアプリケーション

ハーベスタには、サポートされるアダプタ・アセットおよびアプリケーション・アセットを制御するadapters.xmlと呼ばれる構成ファイルが含まれます。構造は次のとおりです。

- adapter

<adapter name="AQ Adapter"
jcaSpecBinding="oracle.tip.adapter.aq.inbound.AQDequeueActivationSpec"/>
<adapter name="AQ Adapter"
jcaSpecBinding="oracle.tip.adapter.aq.outbound.AQEnqueueInteractionSpec"/>
<adapter name="PeopleSoft Adapter"
jcaSpecBinding="com.ibi.afjca.cci.IWAFInteractionSpec"
jcaCSAdapterName="PeopleSoft"/>
<adapter name="PeopleSoft Adapter"
namespace="http://xmlns.oracle.com/Enterprise/"/>
<adapter name="PeopleSoft Adapter" namespace="http://peoplesoft.com/"/>

- adapterAsset

<adapterAsset name="AQ Adapter">
</adapterAsset>
<adapterAsset name="PeopleSoft Adapter" applicationName="PeopleSoft
Application">
</adapterAsset>

各adapterAsset要素は、Oracle Enterprise Repository内に存在するアダプタ・アセットまたはアプリケーション・アセット(あるいはその両方)に対応している必要があります。ハーベスタでは、アダプタ・アセットまたはアプリケーション・アセットは作成されません。これらは、Oracle Enterprise Repositoryソリューション・パックを介してインポートされるか、Oracle Enterprise Repository内に手動で作成される必要があります。11.1.1.x.x-OER-Harvester-Solution-Pack.zipには、デフォルトのadapters.xmlファイルで構成されているアダプタ・アセットおよびアプリケーション・アセットがすべて含まれます。各adapter要素は、作成されているアダプタ構成アセットまたはアプリケーション・デプロイメント・アセット(あるいはその両方)を示します。name属性は、対応するadapterAsset要素の名前と一致する必要があります。各adapter要素内には、jcaSpecBindingまたはnamespace属性が存在する必要があります。

- jcaSpecBinding
jcaSpecBinding属性は、Oracle SOA Suiteによって作成されたWSDLで見られるように、JCAのinteractionSpecまたはactivationSpecクラスの完全修飾クラス名に対応しています。jcaSpecBindingが存在する場合、アダプタ構成アセットが作成されます。

注意:

対応するadapterAsset要素内にapplicationName属性が存在する場合、アプリケーション・デプロイメント・アセットも作成される場合があります。

- jcaCSAAdapterName
jcaCSAAdapterName属性はオプションです。これは、アダプタ・タイプを識別する上でJCAのinteractionSpec/activationSpecでは十分でない場合に指定できます。指定した場合、これは、WSDLのjca:addressセクションのcs.AdapterName属性と一致する必要があります。

- namespace
namespace属性は、Oracle BSEフレームワークを使用してOracle SOA Suiteによって作成されるWSDLのtargetNamespaceに対応しています。ネームスペースが存在する場合、アダプタ構成アセットは作成されず、アプリケーション・デプロイメントのみが作成されます。

アダプタまたはアプリケーションで複数のJCAクラスまたはXMLネームスペースが使用可能な場合、複数のadapter要素が1つのadapterAssetに対応している可能性があります。各adapterAsset要素は、作成されるアダプタ・アセットまたはアプリケーション・アセット(あるいはその両方)を示します。name属性は、対応するadapter要素の名前と一致する必要があります。Oracle Enterprise Repositoryでは、adapterAsset要素ごとに1つのアダプタ・アセットまたはアプリケーション・アセット(あるいはその両方)が作成されます。

- applicationName
applicationName属性(存在する場合)は、アプリケーション・アセットも作成する必要があることを示します。各プロパティ要素の結果、作成されるアダプタ・アセットのハーベスタ・プロパティ・セクション内に指定したデータが設定されます。

ハーベスタのプロパティの詳細は、B.10項「ハーベスタのプロパティ」を参照してください。

6.3 アーティファクトの収集

この項では、ハーベスタを構成して、統合開発環境で使用する方法について説明します。

この項には次のトピックが含まれます:

- 6.3.1項「アーティファクトの収集」

- 6.3.2項「Oracle Business Process Analysisプロジェクトの収集」

- 6.3.3項「Oracle Business Process Management 11gプロジェクトの収集」

- 6.3.5項「Oracle Service Bus 10gアセットの収集」

- 6.3.6項「JDeveloperからのSOAプロジェクトの収集」

- 6.3.7項「JDeveloperからのデプロイ済コンポジットの収集」

- 6.3.10項「重複アーティファクトの検出」

- 6.3.11項「収集されたアーティファクトのダウンロード」

- 6.3.12項「収集されたアセットの検索」

- 6.3.13項「ハーベスタ内で作成されたアセットのプレビュー」

- 6.3.14項「ベスト・プラクティス」

- 6.3.15項「既知の問題」

6.3.1 アーティファクトの収集

コマンド行またはOracle JDeveloperから、あるいはAntタスクを使用してメタデータをOracle Enterprise Repositoryに発行できます。

ハーベスタにより、アーティファクトがスキャンされ、これらのアーティファクトが収集され、これらの間に存在する依存関係が検出されます。次の項で、アーティファクトについて説明します。

- 6.3.1.1項「BPEL」

- 6.3.1.2項「WSDL」

- 6.3.1.3項「XSD」

- 6.3.1.4項「XSL」

- 6.3.1.5項「Oracle SOA Suiteの収集」

- 6.3.1.6項「JCAアダプタ」

- 6.3.1.7項「Oracle BSE (WSDL/SOAP)を介したアプリケーション」

- 6.3.1.8項「プロキシ・サービスまたはビジネス・サービス」

- 6.3.1.9項「Oracle Service Bus (OSB)プロジェクト」

- 6.3.1.10項「BPMN」

ハーベスタにより、これらのアーティファクトのエンティティがOracle Enterprise Repository内に作成され、これらの間のリレーションシップが作成されます。

Oracle Enterprise Repository内に作成されたアーティファクトは、作成されたアセットのファイル情報に格納されます。ローカルで格納された収集済アーティファクトの場合、物理ファイルはOracle Enterprise Repositoryに格納されます。一方、リモートで格納された収集済アーティファクト(http://)の場合、Oracle Enterprise RepositoryはそのアーティファクトのURLの場所を指します。デフォルトでは、ローカルで格納された収集済アーティファクトはExchange UtilityによってはOSRに公開されません。リモートで格納されたアーティファクトのみが公開されます。

図6-3に、ハーベスタによって作成されるアセット・タイプとこれらのリレーションシップを示し、図6-4に、アセット・モデル図の例を示します。

注意:

リレーションシップ・ロール名は、プライマリ・ロール、セカンダリ・ロールの順にリストされています。

これに続く各図では、プライマリ・ロールが各矢印の始点にあり、セカンダリ・ロールが各矢印の終点にあります。

図6-3 ハーベスタによって作成されるアセット・タイプ

6.3.1.1 BPEL

BPELアーティファクトをOracle Enterprise Repositoryに発行すると、Oracle Enterprise Repositoryで次のアクションが行われます。

- ビジネス・プロセス・アセット(タイプ: ビジネス・プロセス:BPEL)がタイプがアーティファクト:BPELのアーティファクト・アセットに直接関連付けられます。

- BPELアーティファクト・コンテンツが含まれるBPELアーティファクト・アセット(タイプ: アーティファクト:BPEL)が作成されます。

- "Defined by"リレーションシップを使用してビジネス・プロセスがBPELアーティファクト・アセットに関連付けられます。

- BPELフロー内のすべてのパートナ・リンクについて、ビジネス・プロセスがインタフェース・アセット(タイプ: インタフェース)にも関連付けられます。

- BPELアーティファクト・アセットがWSDLアーティファクト・アセットおよびXSLTアーティファクト・アセット(フロー内で変換が実行される場合)に関連付けられます。これらは、ビジネス・プロセスのパートナ・リンクの定義およびエントリ・ポイントが含まれるWSDLです。

図6-4 アセット・モデル

6.3.1.2 WSDL

WSDLアーティファクトをOracle Enterprise Repositoryに発行すると、Oracle Enterprise Repositoryで次のアクションが行われます。

- WSDLにサービスが含まれる場合、サービス・アセット(タイプ: サービス)が作成されます。

- ポート・タイプに対してインタフェース・アセット(タイプ: インタフェース)が作成されます。

- "Contains interface"リレーションシップを使用してサービスがインタフェース・アセットに関連付けられます。

- ポート用のエンドポイント・アセットが作成されます。

- "Deployed to"リレーションシップを使用してサービス・アセットがエンドポイント・アセットに関連付けられます。

- WSDLアーティファクト・コンテンツが含まれるWSDLアーティファクト・アセット(タイプ: アーティファクト:WSDL)が作成されます。

- WSDLアーティファクトがWSDLをインポートし、XSDをインポート/インクルードする場合、"References"リレーションシップを使用してこれらのWSDLおよびXSDアーティファクト・アセットに関連付けられます。

6.3.1.3 XSD

XSDアーティファクトをOracle Enterprise Repositoryに発行すると、Oracle Enterprise Repositoryで次のアクションが行われます。

- XSDアーティファクト・コンテンツが含まれるXSDアーティファクト・アセット(タイプ: アーティファクト:XSD)が作成されます。

- XSDアーティファクトがXSDをインポート/インクルードする場合、"References"リレーションシップを使用してこれらのXSDアーティファクト・アセットに関連付けられます。

6.3.1.4 XSL

XSLアーティファクトをOracle Enterprise Repositoryに発行すると、Oracle Enterprise Repositoryで次のアクションが行われます。

- XSLアーティファクト・コンテンツが含まれるXSLアーティファクト・アセット(タイプ"アーティファクト:XSL")が作成されます。

- XSLアーティファクトが変換のソースおよびターゲットとしてXSDおよびWSDLを参照する場合、"References"リレーションシップを使用してこれらのXSDおよびWSDLアーティファクト・アセットに関連付けられます。

6.3.1.5 Oracle SOA Suiteの収集

この項では、Oracle SOA Suite 11gプロジェクトの収集について説明します。

- コンポジット: Oracle SOA Suite 11gプロジェクト・フォルダまたはそのcomposite.xmlファイルをイントロスペクションすると、Oracle Enterprise Repository内で次のアクションが行われます。

- コンポジット・アセットが作成されます。

- コンポジットによってサービスが公開されることにより、Oracle Enterprise Repository内にコンポジット・サービス・アセットが生成されます。これらは、Sync-ExposesServiceリレーションシップによってコンポジットに関連付けられます。

- コンポジットによって参照が公開されることにより、Oracle Enterprise Repository内にコンポジット参照アセットが生成されます。これらは、Sync-ExposesReferenceリレーションシップによってコンポジットに関連付けられます。

- composite.xmlファイルは、Artifact: Compositeタイプのアセットになり、Sync-Definesリレーションシップによってコンポジットに関連付けられます。

- コンポジット・デプロイメント: Oracle SOA Suite 11gプロジェクト・フォルダまたはそのcomposite.xmlファイルをイントロスペクションすると、Oracle Enterprise Repository内で次のアクションが行われます。

- コンポジット・デプロイメント・アセットが作成されます。

- コンポジット・デプロイメントによってサービスが公開されることにより、Oracle Enterprise Repository内にコンポジット・デプロイメント・サービス・アセットが生成されます。これらは、Sync-ExposesServiceリレーションシップによってコンポジット・デプロイメントに関連付けられます。

- コンポジット・デプロイメントによって参照が公開されることにより、Oracle Enterprise Repository内にコンポジット・デプロイメント参照アセットが生成されます。これらは、Sync-ExposesReferenceリレーションシップによってコンポジット・デプロイメントに関連付けられます。

- コンポジット・デプロイメントは、Deployment-Deploysリレーションシップによってコンポジットに関連付けられます。

- コンポーネント・レベルのアーティファクト: 次のコンポジットのコンポーネントを作成し、Sync-Containsリレーションシップによってコンポジットにリンクする必要があります。

- BPELプロセスの結果、ビジネス・プロセス:BPELアーティファクトが生成されます。

- これは、Sync-Definesリレーションシップによってアーティファクト:BPELアーティファクトに関連付けられます。これは、6.3.1.1項「BPEL」に示すように、任意の従属アーティファクトに関連付けられます。

- メディエータにより、サービス・タイプ属性がMEDIATORに設定された状態でサービス・アセットが生成される必要があります。

- これは、Sync-Definesリレーションシップによってアーティファクト:MPlanアーティファクトに関連付けられます。これは、Artifact-Referencesリレーションシップによって従属アーティファクト:XSLTアーティファクトに関連付けられます。

- ヒューマン・タスクにより、ヒューマン・タスク・アセットが生成される必要があります。

- これは、Sync-Definesリレーションシップによってアーティファクト:タスク・アーティファクトに関連付けられます。これは、Artifact-Referencesリレーションシップによって従属アーティファクト:XSDアーティファクトに関連付けられます。

- ビジネス・ルールにより、ビジネス・ルール・アセットが生成される必要があります。

- これは、Sync-Definesリレーションシップによってアーティファクト:Decsアーティファクトに関連付けられます。これは、Artifact-Referencesリレーションシップによって従属アーティファクト:ルール・アーティファクトに関連付けられます。Artifact:Rulesアーティファクトは、Artifact-Referencesリレーションシップによって従属アーティファクト:XSDアーティファクトに関連付けられます。

- Springコンテキスト・コンポーネントにより、Springコンテキスト・アセットが生成される必要があります。

- これは、Sync-Definesリレーションシップによってアーティファクト:SpringBeansアーティファクトに関連付けられます。これは、Artifact-Referencesリレーションシップによって他のアーティファクト:SpringBeansアーティファクトに関連付けられます。

- コンポーネント・レベルのリレーションシップ:

- コンポーネントによって提供されるコンポーネント・サービスにより、インタフェース・アセットが生成されます。これは、BPEL-Entry pointリレーションシップによってコンポーネント・レベルのアセットに関連付けられます(Service-Interfaceリレーションシップによって関連付けられるメディエータは除く)。

- composite.xmlの<interface.ws>の場合、サービスはインタフェース・アセットに関連付けられます。composite.xmlの<interface.java>の場合、サービスはインタフェース・タイプとしてJava属性を持つインタフェース・アセットに関連付けられます。

- コンポーネント・サービスがコンポジット・レベルに昇格される場合、サービス・アセットは、Composite-Promotesリレーションシップによって対応するコンポジット・サービス・アセットに関連付けられます。

- そのコンポーネント・サービスを定義しているcomposite.xmlでWebサービスまたはWSIFバインディングが使用されている場合、Endpoint: Web Serviceアセットが作成されます。これにより、バインディング・タイプ属性がWeb ServiceまたはWSIFに設定されます。サービスが昇格される場合、これは、Composite-Promotesリレーションシップによってコンポジット・デプロイメント・サービス・アセットに関連付けられます。

- そのコンポーネント・サービスを定義しているcomposite.xmlでEJBまたはADFバインディングが使用されている場合、エンドポイント・アセットが作成されます。これにより、バインディング・タイプ属性がADF ServiceまたはEJB Serviceに設定されます。サービスが昇格される場合、これは、Composite-Promotesリレーションシップによってコンポジット・デプロイメント・サービス・アセットに関連付けられます。

- コンポーネント・サービスにJCAまたはB2Bアダプタが使用される場合、アダプタ構成アセットが作成されます。JCAアダプタの場合、これは、対応するアーティファクト: JCAアセットに関連付けられます。これは、対応するアダプタ・アセットに関連付けられます。サービスが昇格される場合、アダプタ構成は、Composite-Promotesリレーションシップによってコンポジット・デプロイメント・サービス・アセットに関連付けられます。

- コンポーネントによって使用される非昇格済コンポーネント参照により、インタフェース・アセットが生成されます。いずれのコンポーネント参照にも新しいサービスは作成されません。ただし、対応するサービス・アセットがOracle Enterprise Repositoryまたは現在のイントロスペクション内にすでに存在する場合、これらはコンポーネント参照に関連付けられます。このルールにより、参照する側のプロジェクトと公開する側のプロジェクトの両方のネームスペースで重複するサービス・アセットが作成されることを防止できます。これは、Partner-Link pointリレーションシップによってコンポーネント・レベルのアセットに関連付けられます(Service-Frontsリレーションシップによって関連付けられるメディエータは除く)。

- 昇格済コンポーネント参照の場合、対応するサービス・アセットがOER内にある場合、サービス・アセットは、Composite-Promotesリレーションシップによって対応するコンポジット参照アセットに関連付けられます。

- WebサービスまたはWSIFバインディングを使用してデプロイされた昇格済コンポーネント参照の場合、対応するEndpoint: Web ServiceがOER内にある場合、これは、Composite-Promotesリレーションシップによってコンポジット・デプロイメント参照アセットに関連付けられます。

- ADFまたはEJBバインディングを使用してデプロイされた昇格済コンポーネント参照の対応するエンドポイントがOER内にある場合、これは、Composite-Promotesリレーションシップによってコンポジット・デプロイメント参照アセットに関連付けられます。

- JCAまたはB2Bアダプタを使用してデプロイされた昇格済コンポーネント参照の場合、対応するアダプタ構成アセットがOER内にある場合、これは、Composite-Promotesリレーションシップによってコンポジット・デプロイメント・サービス・アセットに関連付けられます。

6.3.1.6 JCAアダプタ

JCAアダプタ拡張を使用するOracle SOA SuiteまたはOracle Service BusからWSDLが収集される場合、Oracle Enterprise Repositoryで次のアクションが行われます。

- ハーベスタは、ハーベスタのadapters.xmlファイルの構成に従い、Oracle Enterprise Repository内でアダプタ・アセットを見つけようとします。

- 特定のサービスによって使用されるバインディングおよび接続性情報が含まれるアダプタ構成アセットが作成されます。

- これは、アダプタ・アセットに関連付けられます。

- これは、アダプタ構成を使用しているサービス・アセットに関連付けられます。

- ハーベスタは、ハーベスタのadapters.xmlファイルの構成に従い、Oracle Enterprise Repository内でアプリケーション・アセットを見つけようとします。

- デフォルトでは、アプリケーション・アセットは次のすべてのアダプタに対してサポートされています。

- Oracle Applications (E-Business Suiteとも呼ぶ)

- PeopleSoft

- Siebel

- SAP

- JDE One World

- サービスにエンドポイントが含まれる場合、アプリケーション・デプロイメント・アセットが作成されます。

- これは、アプリケーション・アセットに関連付けられます。

- これは、エンドポイント・アセットに関連付けられます。

6.3.1.7 Oracle BSE (WSDL/SOAP)を介したアプリケーション

BSE (Business Service Engine)を使用して外部アプリケーションに接続するBPELプロセスまたはアプリケーションが収集される場合、Oracle Enterprise Repositoryで次のアクションが行われます。

- ハーベスタは、ハーベスタのadapters.xmlファイルの構成に従い、Oracle Enterprise Repository内でアプリケーション・アセットを見つけようとします。

- サービスにエンドポイントが含まれる場合、アプリケーション・デプロイメント・アセットが作成されます。

- これは、アプリケーション・アセットに関連付けられます。

- これは、エンドポイント・アセットに関連付けられます。

6.3.1.8 プロキシ・サービスまたはビジネス・サービス

プロキシ・サービスまたはビジネス・サービスをOracle Enterprise Repositoryに発行すると、Oracle Enterprise Repositoryで次のアクションが行われます。

- サービス・タイプがプロキシ・サービスまたはビジネス・サービスであるサービス・アセットが作成されます。

- Contains interfaceリレーションシップを使用してサービスがインタフェース・アセットに関連付けられます。

- Oracle Service Bus内でプロキシ・サービスまたはビジネス・サービスのタイプがWeb Serviceである場合

- ポート・タイプ用にインタフェース・アセットが作成されます。

- ポート用にエンドポイント・アセットが作成されます。

- これにより、Oracle Enterprise RepositoryのWeb UIの「概要」セクションにEndpointURIプロパティが表示されます。

- "Deployed to"リレーションシップを使用してサービス・アセットが"Endpoint"アセットに関連付けられます。

- WSDLアーティファクト・コンテンツが含まれるWSDLアーティファクト・アセット(タイプ: アーティファクト:WSDL)が作成されます。

- Oracle Service Bus内でプロキシ・サービスまたはビジネス・サービスのタイプがWebサービスでない場合

- ポート・タイプ用にインタフェース・アセットが作成されます。

- ポート用のエンドポイント・アセットが作成されます。

- これにより、Oracle Enterprise RepositoryのWeb UIのハーベスタ・プロパティ・セクションにEndpointURIプロパティが表示されます。ハーベスタ・プロパティの詳細は、B.10項「ハーベスタのプロパティ」を参照してください。

- "Deployed to"リレーションシップを使用してサービス・アセットがエンドポイント・アセットに関連付けられます。

- このサービスに関連付けられるWSDLはありません。このため、RR-XUユーティリティを使用してUDDIと統合できなくなります。また、Oracle Enterprise RepositoryのWeb UIの「使用」|「ダウンロード」機能、またはOracle Eclipse WorkshopのService Consumption Framework機能を使用してWSDLを使用することはできません。

- WSDLアーティファクトがWSDLをインポートし、XSDをインポート/インクルードする場合、"References"リレーションシップを使用してこれらのWSDLおよびXSDアーティファクト・アセットに関連付けられます。

- プロキシ・サービスは、"Fronts"リレーションシップを介して、直面するビジネス・サービスまたはプロキシ・サービスに関連付けられます。

- プロキシ・サービスは、"Invokes"リレーションシップを介して、呼び出す外部サービスおよびフローに関連付けられます。

- Oracle Service Busでインタフェースを定義するアーティファクト(アーティファクト:WSDL、アーティファクト:XSDまたはアーティファクト:MFL)は、"Defined by"リレーションシップを介してインタフェース・アセットに関連付けられます。

- Oracle Service Busでサービスを実装するために使用されるアーティファクト(アーティファクト:XQuery、アーティファクト:XSLT、アーティファクト:MFLまたはアーティファクト:WS-Policy)は、"Artifact-References"リレーションシップを介してアーティファクト:Proxyまたはアーティファクト:Bizアセットに関連付けられます。

6.3.1.9 Oracle Service Bus (OSB)プロジェクト

Oracle Service Busプロジェクトは、コマンド行からOracle Enterprise Repositoryに発行できます。プロジェクトは、コマンドExport|Oracle Service Bus: Configuration jarを使用してOracle Service Bus Workshopからエクスポートする必要があります。

ハーベスタにより、プロキシ・サービス、ビジネス・サービスおよびフローが処理されます。また、BPEL、WSDL、XSD、XSLT、XQuery、WS-PolicyおよびMFLなどのアーティファクトも処理され、これらのアーティファクト間に存在する依存関係を検出するためにアーティファクトが収集されます。ハーベスタにより、エンティティがOracle Enterprise Repository内に作成され、これらの間のリレーションシップが作成されます。

注意:

収集を行う場合は、収集対象のコンテンツにより適したハーベスタを使用してください。たとえば、Oracle Service Busプロジェクトを収集する場合、Oracle Enterprise Repositoryインストールで提供されているハーベスタではなく、Oracle Service Busハーベスタを使用してください。同様に、AIAを収集する場合は、AIAハーベスタを使用してください。

6.3.1.10 BPMN

BPMNアーティファクトをOracle Enterprise Repositoryに発行すると、Oracle Enterprise Repositoryで次のアクションが行われます。

- ビジネス・プロセス・アセット(タイプ: ビジネス・プロセス:BPMN)がタイプがアーティファクト:BPMNのアーティファクト・アセットに直接関連付けられます。

- BPMNアーティファクト・コンテンツが含まれるBPMNアーティファクト・アセット(タイプ: アーティファクト:BPMN)が作成されます。

- "Defined by"リレーションシップを使用して、ビジネス・プロセスがBPMNアーティファクト・アセットに関連付けられます。

6.3.2 Oracle Business Process Analysisプロジェクトの収集

Oracle Enterprise Repository Harvester 11gは、SOA Oracle Business Process Analysis (BPA)プロジェクトがSOAコンポジットに変換される場合にBPAプロジェクトの収集をサポートします。実行する手順は次のとおりです。

注意:

Oracle JDeveloper 11g Release 1 (11.1.1.2.x)は、BPAサーバーからのBPELプロセスのインポートはサポートしません。インポートするには、11gリリース1 (11.1.1.7) JDeveloperを使用する必要があります。

手順1: BPAプロジェクトのSOAコンポジットへの変換

1. BPA Architectを使用してBPAプロセスを設計します。

2. デザイナ・ウィンドウを右クリックし、「SOA」、「ビジネス・プロセスをBPELプロセスに変換」を選択します。デザイナ・ウィンドウを右クリックし、「SOA」、「ITとブループリントを共有」を選択します。

3. JDeveloperを開き、BPAサーバー接続を作成します(まだ行われていない場合)。

4. 新しいアプリケーションを作成し、新しいSOAプロジェクトを作成します。

5. 「SOA設定の構成」ダイアログで、Oracle BPA Blueprintからのコンポジットを選択し、「終了」をクリックします。
新しいアプリケーションおよびSOAプロジェクトの作成の詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』を参照してください。

6. 図6-5に示すように、BPAサーバーを展開し、必要なBPMNプロセスを選択します。「OK」をクリックし、SOAプロジェクトを作成します。BPAサーバーの詳細は、http://www.oracle.com/technology/software/products/bpa/index.htmlにあるBPAドキュメントを参照してください。

図6-5 「BPAブループリント・コンポジットの作成」ダイアログ

7. BPELプロセスを開き、すべてのコンパイル・エラー(存在する場合)を修正します。アプリケーションを閉じます。

手順2: 変換したBPAプロジェクトの収集

1. Oracle SOA Suiteプロジェクトを収集します。詳細は、6.3.14.9項「SOAプロジェクトの収集」を参照してください。

2. JDeveloper 11gリリース1 (11.1.2)を開きます。前述のアプリケーションを開き、右クリックし、Oracle Enterprise Repositoryに収集するためのプロジェクトの収集オプションを選択します。

6.3.3 Oracle Business Process Management 11gプロジェクトの収集

Oracle Enterprise Repository Harvester 11gは、Oracle Business Process Management (Oracle BPM)プロジェクトの収集をサポートしています。Oracle SOA 11gの一部として、Oracle JDeveloperは、BPMNプロセスを使用したOracle BPMプロジェクトの設計および開発をサポートしています。BPMNコンポーネントを持つコンポジットとしてプロジェクトを開発してから、BPMプロジェクトをOracle Enterprise Repositoryに収集できます。実行する手順は次のとおりです。

手順1: JDeveloperでのBPMプロジェクトの作成

BPMプロジェクトを作成するには、次の手順を実行します。

1. JDeveloperの「アプリケーション・ナビゲータ」で、「新規アプリケーション」をクリックします。「汎用アプリケーションの作成 - アプリケーションの名前付け」ページが表示されます。

2. 「アプリケーション」フィールドに名前を入力し、「次へ」をクリックします。「汎用アプリケーションの作成 - プロジェクトの名前付け」ページが表示されます。

3. 「プロジェクト名」フィールドにBPMプロジェクトの名前を入力します。

4. 図6-6に示すように、「プロジェクト・テクノロジ」タブの「選択可能」リストで「BPM」をダブルクリックし、「選択済」リストに移動します。

図6-6 汎用アプリケーションの作成 - 「プロジェクトの名前付け」ページ

5. 「終了」をクリックします。

手順2: BPMプロセスの設計およびSOAサーバーへのデプロイ

BPMプロセスの設計およびSOAサーバーへのデプロイの詳細は、『Oracle Fusion Middleware Oracle Business Process Managementモデリングおよび実装ガイド』のBPMプロジェクトのBPAプロジェクトからの作成に関する項を参照してください。

手順3: JDeveloperからOracle Enterprise RepositoryへのBPMプロジェクトの収集およびOracle SOA Serverへのデプロイ

- JDeveloper 11gリリース1 (11.1.2)を開きます。

- 右クリックし、Oracle Enterprise Repositoryに収集するためのプロジェクトの収集オプションを選択します。

6.3.4 Oracle Service Bus 11gアセットの収集

Oracle Service Bus 11gアセットの収集の詳細は、『Oracle Fusion Middleware Oracle Service Bus開発者ガイド』を参照してください。

6.3.5 Oracle Service Bus 10gアセットの収集

Oracle Service Bus 10gアセットをOracle Enterprise Repository 11gに収集できます。次の手順は、Workspace StudioおよびOracle Service Bus Eclipseを対象としており、Oracle Service Bus 10.3およびOracle Service Bus 10.3.1に対して機能します。

次の手順は、Oracle Service Bus 10.3.1がBEA_HOMEにインストールされており、Oracle Enterprise RepositoryハーベスタがHARVESTER_HOMEにインストールされていることを前提としています。

1. com.bea.alsb.harvester.connector_1.0.200.zip (ハーベスタ・プラグイン)をダウンロードし、<BEA_HOME>\osb_10.3\eclipse\pluginsディレクトリに解凍します。

2. 11.1.1.x.x-OER-Harvester.zipをダウンロードして<dir>ディレクトリに解凍します。HARVESTER_HOMEが<dir>/harvesterになります。

3. <BEA_HOME>\workshop_10.3\workshop.iniを編集します。次を追加します。
-Dharvester.home=HARVESTER_HOME

- コマンド行から実行するには、Linuxの場合はosb10harvest.sh、Windowsの場合はosb10harvest.batを使用します。

- Antから実行するには、Linuxの場合はosb10runant.sh、Windowsの場合はosb10runant.batを使用します。

Oracle Service Bus Eclipse からの収集の手順

1. Oracle Workshop for WebLogicを起動します。

2. Oracle Service Bus構成jarファイルをインポートします。

3. Oracle Service Busプロジェクトを右クリックし、「Oracle Enterprise Repositoryに発行」をクリックします。「アセットをOracle Enterprise Repositoryに発行」ダイアログが表示されます。

4. 接続パラメータを入力して、「発行」をクリックします。

詳細は、6.3.1.9項「Oracle Service Bus (OSB)プロジェクト」を参照してください。

6.3.6 JDeveloperからのSOAプロジェクトの収集

SOAプロジェクトをOracle JDeveloperからOracle Enterprise Repositoryに収集できます。SOAプロジェクトを収集するには、次の手順を実行します。

1. Oracle JDeveloperを開き、Oracle Enterprise Repository接続を作成します。

1. リソース・パレット・タブをクリックします。

2. 「新規」、「新規接続」、「Oracle Enterprise Repository」をクリックします。「Oracle Enterprise Repository接続の作成」ダイアログが表示されます。

3. 「IDE接続」を選択します。

4. 「接続名」フィールドにOracle Enterprise Repository接続の名前を入力します。

5. リポジトリのURL (たとえば、http://localhost:port/oer)を入力します。

6. リポジトリ接続用の有効なユーザー名/パスワードを入力し、「接続テスト」をクリックします。「ステータス」ペインに成功ステータスが表示された後、IDE接続タブの下にOracle Enterprise Repository接続が表示されます。

2. アプリケーション・ナビゲータで、SOAプロジェクト・ノードを右クリックし、プロジェクトの収集を選択します。「SOAプロジェクトの収集」ダイアログが表示されます。

3. 「リポジトリ接続」リストで、手順1で作成したリポジトリ接続を選択します。

4. 「登録ステータス」リストで未発行を選択します。

5. 「ハーベスタの説明」フィールドに収集の説明を入力します。

6. 「OK」をクリックします。これにより、Antスクリプトが実行され、SOAコンポジットがOracle Enterprise Repositoryに収集されます。

7. 同様に、XSDまたはWSDLをOracle Enterprise Repositoryに収集することもできます。アプリケーション・ナビゲータで、適切なノードを右クリックし、ファイルの収集を選択します。これにより、Antスクリプトが実行され、スキーマ/WSDLがOracle Enterprise Repositoryに収集されます。

6.3.7 JDeveloperからのデプロイ済コンポジットの収集

デプロイ済SOAコンポジットをOracle JDeveloperからOracle Enterprise Repositoryに収集することもできます。デプロイ済SOAコンポジットをOracle JDeveloperから収集するには、次の手順を実行します。

1. デプロイ済SOAコンポジットが含まれるJDeveloperを開きます。

2. アプリケーション・サーバー・ナビゲータで、SOAコンポジット・ノードを右クリックし、Enterprise Repositoryに発行を選択します。「Enterprise Repositoryに発行」ダイアログが表示されます。

3. 次の詳細を入力します。

- リポジトリ接続: デプロイ済コンポジットの発行先のリポジトリ接続を選択します。

- 登録ステータス: リストから適切な登録ステータスを選択します。

- コンポジット名およびリビジョン: デプロイするコンポジットの名前がこのフィールドに表示されます。

- パーティション名: デフォルト値が表示されます。

- リモート・サーバーのURL: リモート・サーバーのURLを入力します。

- デバッグ情報の表示: デバッグ情報を表示する場合は、このオプションを選択します。

Oracle Enterprise Repositoryのサービス、スキーマ、XSLTおよびイベントを使用することもできます。使用状況追跡を有効にするには、JDeveloperアプリケーションをOracle Enterprise Repositoryプロジェクトに関連付ける必要があります。

注意:

WSDL/XSDなどの個々のアセットを収集する場合は、コマンド行からハーベスタを使用します。

6.3.8 JDeveloperアプリケーションとOracle Enterprise Repositoryプロジェクトとの関連付け

1. アプリケーション・ナビゲータでアプリケーションの右側に表示されるアプリケーション・メニューをクリックします。

2. 「アプリケーション・プロパティ」を選択します。「アプリケーションのプロパティ」ダイアログが表示されます。

3. 左側のペインで「リポジトリ」をクリックします。右側に「リポジトリ」ページが表示されます。

4. 「リポジトリ接続」リストで、使用状況の追跡に使用するOracle Enterprise Repository接続を選択します。

5. リポジトリ・プロジェクト・リストで、使用状況の追跡に使用するOracle Enterprise Repositoryプロジェクトを選択します。

6. 「OK」をクリックします。

6.3.9 JdeveloperからのOracle Enterprise RepositoryのWSDLサービスの使用

1. JDeveloperで、コンポジット・エディタを開きます。

2. コンポーネント・パレットから、Webサービス・コンポーネントを「外部参照」スイムレーンにドラッグ・アンド・ドロップします。「Webサービスの作成」ダイアログが表示されます。

3. 「名前」フィールドに参照名を入力します。

4. 「WSDL URL」フィールドの一番右に表示される「既存のWSDLの検索」アイコンをクリックします。「SOAリソース・ブラウザ」ダイアログが表示されます。

5. リストからリソース・パレットを選択します。

6. IDE接続、「Oracle Enterprise Repository」、「<Connection Name>」、「アセット・タイプ」、「サービス」を選択し、呼び出すか使用するサービスを選択します。
サービスに関連付けられているWSDLまたはUDDIキーが1つしかない場合、同じWSDLまたはUDDIキーを使用して参照を作成します。関連付けられているWSDLまたはUDDIキー(あるいはその両方)が2つ以上ある場合、「WSDLの選択」ダイアログが表示されます。使用するURLまたはUDDIキーの1つを選択する必要があります。

JDeveloperでUDDIキーを解決するには、参照を作成する前にUDDI接続を作成する必要があります。これを行わないと、UDDIキーを選択できません。

注意:

同じ手順を使用して、スキーマ(XSD)、イベント(EDL)、変換(XSLT)を参照します。ただし、サービスではなく各アーティファクトを選択します。

6.3.10 重複アーティファクトの検出

WSDL、BPEL、BPMNおよびXSDなどのファイルに関する情報は、アーティファクトとしてOracle Enterprise Repositoryに格納されます。同じアーティファクトを2回格納するのを防止するため、各アーティファクトを格納するときにハーベスタがソフトウェア・ファイルID (SFID)を計算します。新しいアーティファクトを発行する前に、SFIDをリポジトリ内の既存のSFIDと比較することにより、重複がないかどうかを確認できます。

計算されたSFIDはMD5ハッシュです。SFIDを計算する前に一定レベルの正規化が実行されます。特に、アーティファクト・ファイルがXMLである場合、Apache XMLセキュリティ・ライブラリ内のCanonicalizerクラスを使用して正規化されます。これにより、W3C Canonical XML標準(www.w3.org/TR/xml-c14nを参照)に従って正規化が行われます。これには、テキスト・エンコーディング、改行、空白、コメントおよび属性順序付けの正規化が含まれます。W3C標準に指定されていないいくつかの追加正規化も実行されます。これには、ネームスペースの接頭辞の正規化、WSDL内の要素の順序の正規化、ドキュメント要素の削除、およびインクルード/インポートされたファイルのインライン化が含まれます。

6.3.11 収集されたアーティファクトのダウンロード

ハーベスタにより、収集したアセットからダウンロードされる場合があるアーティファクト・バンドルが作成されます。これらのアセットのアーティファクト・バンドルはzipファイルに格納されます。たとえば、エンドポイントの場合、WSDLファイルおよび関連付けられたXSDファイルは、zipペイロード内の相対的な場所に格納されます。

1つのアーティファクトによって別のアーティファクトがインポートされる(たとえば、WSDLによってXSDがインポートされる)場合、親に対して相対的な子アーティファクトが常に参照されます。たとえば、MyWSDL.wsdlがc:\temp内にあり、インポートされる子XSDがc:\temp\schemas\MyXSD.xsd内にある場合、親MyWSDL.wsdlは相対パス./schemas/MyXSD.xsdを使用して子をインポートします。バンドルがダウンロードされる際、親が子アーティファクトを解決できるように、親に対して相対的なschemasと呼ばれるフォルダに子を作成する必要があります。

アセットの使用/ダウンロードの詳細は、『Oracle Fusion Middleware Oracle Enterprise Repositoryユーザーズ・ガイド』を参照してください。

6.3.12 収集されたアセットの検索

次の2つのいずれかの方法を使用して、収集されたアセットを検索できます。

- 6.3.12.1項「使用方法の使用」

- 6.3.12.2項「メタデータの使用」

6.3.12.1 使用方法の使用

使用方法に基づいて、収集されたサービスを検索できます。「基本検索」セクションで、図6-7に示すように、使用方法リストから「WSDLポート」を選択できる場合、検索により、WSDLサマリーを持つサービス、WSDLに定義されているエンドポイント、およびglobalに設定されたスコープが返されます。また、このリストは、「詳細な検索オプション」の下で使用することもできます。

図6-7 「アセット」ペイン - 使用方法

6.3.12.2 メタデータの使用

各アセットには、問合せ用として使用できるプロパティがハーベスタによってタグ付けされます。

図6-8に、書込み操作を呼び出すビジネス・プロパティに対する問合せを示します。検索画面を表示するには、Oracle Enterprise Repository Webコンソールのメイン・ページで「詳細な検索オプション」をクリックします。「詳細な検索オプション」ダイアログで、次を実行します。

- 追加基準によるフィルタ: オプションを選択します。

- フィールドの選択: リストから「internal.introspector.store」を選択します。

- XPathの入力: テキスト・フィールドに「/」と入力します。使用可能なフィールドのリストが表示されます。

図6-8 Oracle Enterprise Repositoryでの「詳細な検索オプション」ダイアログの表示

次の検索基準が使用可能です。

- ハーベスタの説明

- ハーベスタ・バージョン

- ハーベスタのネームスペース

- 収集者

- 呼び出されたビジネス・プロセスの操作

6.3.13 ハーベスタ内で作成されたアセットのプレビュー

「プレビュー」機能を使用して、ハーベスタ内で作成されたアセットを表示できます。次のいずれかの方法を使用して「プレビュー」機能を使用できます。

コマンド行の使用

コマンド行またはAntタスクで、"-preview true"を追加すると、ハーベスタが実行され、作成されるすべてのアセットのリストが表示されますが、変更が実際にコミットされることはありません。

Using the HarvesterSettings.xmlファイルの使用

プレビュー・モードは次のようにHarvesterSettings.xmlファイルで設定することもできます。

<introspection preview="true">
<reader>com.oracle.oer.sync.plugin.reader.file.FileReader</reader>
<writer>com.oracle.oer.sync.plugin.writer.oer.OERWriter</writer>
</introspection>

6.3.14 ベスト・プラクティス

この項では、ハーベスタに関するベスト・プラクティスについて説明します。内容は次のとおりです。

- 6.3.14.1項「収集用として推奨される権限」

- 6.3.14.2項「推奨されないネームスペース・パラメータのオーバーライド」

- 6.3.14.3項「WSDLファイル内のネームスペース」

- 6.3.14.4項「完了した作業の収集」

- 6.3.14.5項「XSDの収集およびメンテナンス・リリース」

- 6.3.14.6項「アセットのライフサイクル全体でのメタデータの収集」

- 6.3.14.7項「WSDLアーティファクトのダウンロード」

- 6.3.14.8項「リタイアしたエンドポイントの収集」

- 6.3.14.9項「SOAプロジェクトの収集」

- 6.3.14.10項「Oracle JDeveloper 11gからの収集」

- 6.3.14.11項「ハーベスタ・フォルダ内のファイルの収集」

- 6.3.14.12項「同じコンピュータでのハーベスタおよびExchange Utilityの実行」

- 6.3.14.13項「コンポジット・サービスWSDLの収集」

6.3.14.1 収集用として推奨される権限

レジストラまたはOracle Enterprise Repository内のすべてのアセットを表示する権限を持つユーザーのみがアセットを収集するように権限を設定します。リポジトリ内のすべてのアセットを表示する権限を持たないユーザーは、すでに存在するアセット、および誤って作成された重複アセットを収集する可能性があります。

6.3.14.2 推奨されないネームスペース・パラメータのオーバーライド

ハーベスタには、収集対象のアセットにプロジェクト・ネームスペースを設定する機能が用意されています。ネームスペースが異なるとアセットが異なるため、プロジェクト・ネームスペースは重複するアセットを検出するために使用されます。ほとんどの場合、このパラメータはオーバーライドしないことをお薦めします。

ただし、Oracle SOA SuiteまたはOracle Service Busから収集する場合、これらの製品のプロジェクト名に基づいてプロジェクト・ネームスペースが自動的に設定されますが、これは推奨される動作です。

このことは、複数のソース(JDevおよびランタイム)から同じプロジェクトおよびリビジョンを収集する場合、特に重要です。ネームスペースを変更またはオーバーライドすると、結果としてOER内のアセットが重複します。

6.3.14.3 WSDLファイル内のネームスペース

収集するWSDLファイル内では、一意のインタフェース、サービスおよびエンドポイントに対して一意のネームスペースを使用することをお薦めします。

Oracle Enterprise Repository内の既存のアセットとの相互の関連付けはQNameを介して行われるため、インタフェース・アセット、サービス・アセットまたはエンドポイント・アセットを大幅に変更するが、QNameは変更しない場合、変更したアセットによって既存のアセットが上書きされます。

表6-7に、Oracle Enterprise RepositoryアセットとWSDL構造の相関を示します。

表6-7 Oracle Enterprise RepositoryアセットとWSDL構造の相関

リポジトリ・アセット

WSDL構造

サービス

/definition/service/@name

エンドポイント

/definition/service/port/@name

インタフェース

/definition/portType/@name

6.3.14.4 完了した作業の収集

完了した作業または完了が近い作業のみを収集することをお薦めします。開発環境から定期的に収集する場合、古いバージョンのアセットが収集され、Oracle Enterprise Repositoryが乱雑になる可能性があります。

Oracle Enterprise Repositoryは、エンドポイントおよびホストされているWSDLを持つサービスのみをOracle Service Registryに昇格します。また、具体的なWSDLを持つサービスのみをJDeveloperを介して使用できます。エンドポイントおよびWSDLの場所を取得するために実行時環境から収集することをお薦めします。

6.3.14.5 XSDの収集およびメンテナンス・リリース

一部のスキーマ開発パターンには、不具合の修正またはマイナー構造の追加があり、スキーマのネームスペース変更のないメンテナンス・リリースが含まれます。若干変更されたスキーマ・アーティファクトを後で収集する場合、リポジトリ内にかなりの数の新しいアーティファクト・アセットが作成される場合に影響を与える可能性があります。Oracle Enterprise Repositoryでは、アーティファクトのコンテンツのハッシュ (ソフトウェア・ファイルID (SFID))に基づいてアーティファクト・アセットが相互に関連付けられます。SFIDは、すべてのインポートおよびインクルードがインライン化された後に各アーティファクトのコンテンツについて計算されます。したがって、WSDLによってインポートされたXSDが変更されると、新しいXSDアーティファクトと新しいWSDLアーティファクトの両方が生成されます。

このことは、企業全体で幅広く使用されるスキーマを検討する場合に特に重要です。たとえば、他のスキーマ、WSDL、XSLT、BPELなどによって広くインポートされる下位のスキーマ(customer.xsdなど)があるとします。customer.xsdに対する重要な変更を行い、その後に企業のすべてのアーティファクトを再収集する(なんらかの定期的なバッチ収集など)と、customer.xsdを直接または間接的に参照する同様の大量のアーティファクト・アセットがリポジトリ内に作成されます。

6.3.14.6 アセットのライフサイクル全体でのメタデータの収集

ハーベスタはアセット・ライフサイクル内の複数の場所から呼び出すことができ、呼出しごとに異なるソースからアーティファクトおよびメタデータが収集されます。次のリストに、Oracle Enterprise Repositoryを最新の状態に保つためにアセットのライフサイクル中にハーベスタを使用する方法に関する推奨事項を示します。

1. 設計/開発時
実装後、アセットをOracle Enterprise Repositoryに公開する必要があります。アセットに関連付けられたポリシーもOracle Enterprise Repositoryに公開されます。Oracle Enterprise Repositoryガバナンス・プロセスは、実装を一般的なコンシューマ・コミュニティで再利用できるようにする前に実装が組織のポリシーに合致していることを確認する方法を提供します。

推奨方法: ハーベスタをIDE (JDeveloper、Oracle Service Bus Workshop、EclipseまたはVS.NET)から呼び出します。

2. デプロイメント時
デプロイメント後すぐに、アセットをOracle Enterprise Repositoryに公開する必要があります。デプロイメント時には、本番エンドポイントが収集され、アセットのメタデータがエンドポイント情報を使用して更新されます。1つの組織に、開発、テスト、ステージングおよび本番環境をサポートするエンドポイントが複数含まれる場合があります。エンドポイントをOracle Enterprise Repositoryに収集すると、ガバナンス・プロセスも必要になる場合があります。たとえば、開発エンドポイントおよびテスト・エンドポイントは使用者コミュニティ全体で使用可能になる場合がありますが、本番エンドポイントはサービス・プロバイダおよびサービス・コンシューマがサービス契約について交渉するまでは提供されない場合があります。

推奨方法: ハーベスタをデプロイメント・スクリプト(WLST、Antまたはコマンド行)から呼び出します。

デプロイメントの最後にハーベスタを呼び出します。-remote_server引数を使用して、実行中のサーバーからデプロイ済アーティファクトを収集します。

3. ランタイム
プロジェクトがデプロイされて稼働した後、ランタイム・メトリックが収集され、Oracle Enterprise Repositoryアセットに関連付けられます。ランタイム・メトリックの収集用として複数のオプションが用意されています。その1つが、Enterprise Managerからランタイム・メトリックを収集し、Oracle Enterprise Repositoryを更新するEM-Integrationです。詳細は、『Oracle Enterprise Manager Connectors統合ガイド』を参照してください。

もう1つの方法は、ランタイム・メトリックをUDDIレジストリに公開するサード・パーティのランタイム・モニタリング・ツールに頼る方法です。メトリックは、UDDIレジストリ内に入ったら、Oracle Registry Repository Exchange Utilityを使用してOracle Enterprise Repositoryに伝播し戻すことができます。Amberpoint統合の詳細は、『Oracle Fusion Middleware Oracle Enterprise Repository統合ガイド』の第5章「Amberpointとの統合」を参照してください。

6.3.14.7 WSDLアーティファクトのダウンロード

Oracle Enterprise RepositoryでWSDLアーティファクトを使用する場合、WSDLファイルをダウンロードできます。多くの場合、このファイルはリモートの場所にあります。また、このファイルのURLは?wsdlで終わる場合があります。これらの場合、WSDLを保存するときに、デフォルトではブラウザ上でファイルの拡張子が.xmlになる可能性があります。その場合は、.xmlを.wsdlに置き換える必要があります。WSDLファイルは、HTTP/HTTPSまたはFTPサーバー上でホストできます。

6.3.14.8 リタイアしたエンドポイントの収集

エンドポイントが変更された(リタイアしたか別の場所に移動された)場合、エンドポイントをOracle Enterprise Repositoryからリタイアし、Oracle Service Registryのエンドポイントを削除することをお薦めします。次に、新しいエンドポイントを使用して同じWSDLサービスを再収集します。

注意:

Exchange Utilityパブリッシャを再実行しても、リタイアしたエンドポイントはOracle Service Registryから削除されません。

6.3.14.9 SOAプロジェクトの収集

SOAライフサイクルのベスト・プラクティスとして、すべてのSOAプロジェクトをOracle Enterprise Repositoryに収集し、SOAサーバーにデプロイし、Exchange Utilityを実行してOracle Service Registryに公開してから、公開したアセットをOracle Enterprise RepositoryまたはOracle Service Registryから使用することをお薦めします。

6.3.14.10 Oracle JDeveloper 11gからの収集

Oracle JDeveloper 11gから収集する場合、ネームスペースの変更はお薦めしません。

また、2つの異なるステータス(登録済と発行済など)を使用してJDeveloper 11gから同じコンポジットを収集しないことをお薦めします。

6.3.14.11 ハーベスタ・フォルダ内のファイルの収集

解凍されていないハーベスタ・フォルダ(11.1.1.x.x-OER-Harvester.zip)内にあるファイルを収集しないことをお薦めします。これは現在サポートされていません。

6.3.14.12 同じコンピュータでのハーベスタおよびExchange Utilityの実行

Oracle Service Registryにサービスを公開する場合、Exchange Utilityとハーベスタを同じコンピュータ上で実行し、これらが同じURLに解決されるようにすることをお薦めします。また、WSDL内のアクセス・ポイントが完全な形式ではない異なるコンピュータ上でこれらを実行することもできますが、両方のコンピュータ上でこれらが同じURLに解決されることを確認する必要があります。ハーベスタとExchange Utilityでアクセス・ポイントが異なるURLに解決される場合、サービスが失敗し、エラーが発行されます。

6.3.14.13 コンポジット・サービスWSDLの収集

公開されたコンポジット・サービスのWSDLはそれ自体で個別に収集されないようにすることをお薦めします。コンポジット・プロジェクト全体として収集し、完全で正しいSOAアセット・モデルをOracle Enterprise Repository内で取得することを常にお薦めします。

6.3.15 既知の問題

この項では、ハーベスタの既知の問題について説明します。

- 6.3.15.1項「システム内にアセット・タイプが必要」

- 6.3.15.2項「アセット・タイプの2つのバージョン」

- 6.3.15.3項「収集したアセット内でハーベスタ固有のメタデータ・エントリは削除しない」

- 6.3.15.4項「サポートされるリモート・サーバーのタイプ」

- 6.3.15.5項「不正な暗号化パスワードの使用」

- 6.3.15.6項「リポジトリ内のビュー・オプション」

6.3.15.1 システム内にアセット・タイプが必要

ハーベスタの機能を使用する前提条件として、システム内にアセット・タイプが存在する必要があります。必要なアセット・タイプは、11.1.1.x.x-OER-Harvester-Solution-Pack.zipでインストールされます。

6.3.15.2 アセット・タイプの2つのバージョン

Oracle Enterprise Repository内の既存のアセット・タイプ名の一部が、11.1.1.x.x-OER-Harvester-Solution-Pack.zipでインストールされるアセット・タイプの名前と同じである場合、ハーベスタのアセット・タイプ名にはバージョン番号が付けられます。これは、ハーベスタのアセット・タイプの機能には影響せず、ハーベスタはこれらのアセット・タイプをそのUUIDに基づいて参照します。

6.3.15.3 収集したアセット内でハーベスタ固有のメタデータ・エントリは削除しない

プロセスの収集時にアセットが作成される場合、メタデータ・エントリ・タイプがinternal.inspector.storeおよびinternal.harvester.manifest.storeであるアセットにメタデータ・エントリがアタッチされます。これらのメタデータ・エントリは変更または削除しないでください。そうすると、システムの動作が予測できなくなります。

これらのメタデータ・エントリはOracle Enterprise Repositoryユーザー・インタフェースを使用して削除できないことに注意してください。

6.3.15.4 サポートされるリモート・サーバーのタイプ

現在、ハーベスタは、WebLogic 10.x上で動作しているリモートのOracle SOA Suite、Oracle Service BusおよびWebLogic Serverプロジェクトへの接続のみをサポートしています。

6.3.15.5 不正な暗号化パスワードの使用

不正な暗号化パスワードでHarvesterSettings.xmlファイルを構成した場合、次のような、長いスタック・トレースが表示されます。

log4j:WARN No appenders could be found for logger
(org.apache.axis.i18n.ProjectResourceBundle).
log4j:WARN Please initialize the log4j system properly.
@ com.oracle.oer.sync.framework.MetadataIntrospectionException:
@ com.oracle.oer.sync.framework.MetadataIntrospectionException: Unable to read
plugin file:
C:\Drive-E\XU-harvest-tools\dec16\OER-Harvester\.\plugins\biz.introspector
at
@ com.oracle.oer.sync.framework.MetadataManager.init(MetadataManager.java:308)
@         at com.oracle.oer.sync.framework.Introspector.<init>
Introspector.java:188)
at
@ com.oracle.oer.sync.framework.Introspector.main(Introspector.java:395)
@ Caused by: com.oracle.oer.sync.framework.MetadataIntrospectionException:
Unable
to read plugin file:
C:\Drive-E\XU-harvest-tools\dec16\OER-Harvester\.\plugins\biz.introspector
at
@ com.oracle.oer.sync.framework.impl.DefaultPluginManager.processIntrospector(De
faultPluginManager.java:127)
at
@ com.oracle.oer.sync.framework.impl.DefaultPluginManager.<init>(DefaultPluginMa
nager.java:73)
at
@ com.oracle.oer.sync.framework.MetadataManager.init(MetadataManager.java:306)
... 2 more
Caused by: java.lang.IllegalArgumentException: The char '0x12' in
'java.lang.Ill
egalArgumentException: The char '0x12' in 'E/?&#8597;?&#8597;H?rd' is not a
valid XML character.' is not a valid XML character.
at
@ org.apache.axis.components.encoding.AbstractXMLEncoder.encode(Abstrac
tXMLEncoder.java:110)
at org.apache.axis.utils.XMLUtils.xmlEncodeString(XMLUtils.java:131)
at org.apache.axis.AxisFault.dumpToString(AxisFault.java:366)
at org.apache.axis.AxisFault.printStackTrace(AxisFault.java:796)
at
com.oer.log4j.spi.ThrowableInformation.getThrowableStrRep(Throw
ableInformation.java:42)
at
com.oer.log4j.spi.LoggingEvent.getThrowableStrRep(LoggingEvent.java:217)
at
com.oer.log4j.WriterAppender.subAppend(WriterAppender.java:298)
at
com.oer.log4j.RollingFileAppender.subAppend(RollingFileAppender.java:294
)
at com.oer.log4j.WriterAppender.append(WriterAppender.java:157)
at
com.oer.log4j.AppenderSkeleton.doAppend(AppenderSkeleton.java:251)
at
com.oer.log4j.helpers.AppenderAttachableImpl.appendLoopOnAppenders(Appen
derAttachableImpl.java:57)
at com.oer.log4j.Category.callAppenders(Category.java:255)
at com.oer.log4j.Category.forcedLog(Category.java:445)
at com.oer.log4j.Category.log(Category.java:882)
at
@ com.oracle.oer.sync.framework.logger.DefaultMetadataLogger.error(DefaultMetada
taLogger.java:98)
at
@ com.oracle.oer.sync.plugin.writer.oer.OERConnectionCache.getAuthToken(OERCon
nectionCache.java:138)
at
@ com.oracle.oer.sync.plugin.writer.oer.OERAssetQueries.getToken(OERAssetQueri
es.java:82)
at
@ com.oracle.oer.sync.plugin.writer.oer.OERAssetQueries.assetTypeQueryByUUID(AL
ERAssetQueries.java:159)
at
@ com.oracle.oer.sync.framework.MetadataManager.putAssetType(MetadataManager.jav
a:204)
at
@ com.oracle.oer.sync.framework.impl.DefaultPluginManager.processIntrospector(De
faultPluginManager.java:104)
... 4 more

6.3.15.6 リポジトリ内のビュー・オプション

Oracle JDeveloper 11g以降、リポジトリ内のビュー・オプションをクリックすると、JDeveloper内でアセットの詳細が開きますが、これは読取り専用であり、このページ内のリンクは機能しません。

回避策として、Oracle Enterprise Repositoryコンソールにログインし、詳細に関するリンクをクリックする必要があります。

7 メトリックの構成

この章では、組織内でメトリックを構成する方法について説明します。

この章には、次のセクションがあります。

- 7.1項「概要」

- 7.2項「アセット・タイプの要素の有効化」

- 7.3項「データベースに対する問合せの実行」

7.1 概要

この項では、Oracle Enterprise Repositoryの使用可能なメトリックの機能拡張について説明します。このガイドの情報は、メトリック・フィールドのないアセット・タイプへメトリック・フィールドを追加する際に役立ちます。このガイドで取り上げるメトリック・フィールドには、合計開発時間(TDH)、生成投資(Pinv)、消費係数(Cfac)、予測年間再利用回数(n)、および時間ごとの間接費率(B)があります。これらのフィールドは通常、アセット・エディタの「メトリック」タブに表示されます。

7.1.1 メトリック要素

この項では、タイプにメトリック要素を追加する方法について説明します。これらのメトリックは、各アセット値の見積もり、およびアセット・ポートフォリオのROIの決定に使用されます。

メトリック要素は5つまで追加され、「タイプ」には開発時間要素がすでに存在する必要があります。登録されていない、または削除されている場合は、この要素も追加する必要があります。タイプ・マネージャとデータベースに必要な変更を加えます。両方の手順についてここで説明します。新しいメトリック要素は次のとおりです。

- 合計開発時間(TDH) - このアセットの作成のために要した開発労力の合計。

- 生成投資(Pinv) - アセットを再利用可能にするために、アセットの構築または収集、およびアセットのパッケージ化と文書化に要した追加の時間または労力。この値は1回の使用を目的としたアセットの構築のために、最初に必要な時間に対する割合として表されます。

- 消費係数(Cfac) - アセット・コンシューマがアセットの検索、評価、および使用に要する時間。アセットを最初から構築する場合に必要な時間に対する割合として表示されます。

- 予測年間再利用回数(n) - アセットについて予測される年間使用回数を示します。

- 時間ごとの間接費率(B) - アセットを生成するユーザーの時間当たりの間接費。

メトリックは10のベース・アセット・タイプ、およびユーザーのシステムに追加されている他のアセット・タイプに含まれている必要があります。

- アプリケーション

- ビジネス・プロセス

- 通信アダプタ

- コンポーネント

- 環境

- フレームワーク

- パターン

- プロセス

- サービス

- XMLスキーマ

7.1.2 再利用可能メトリックの追加タブ

Oracle Enterprise Repositoryを初めてインストールする場合は、この手順を実行する必要はありません。再利用メトリックは、これらのメトリックを含まない旧バージョンの製品にのみ追加する必要があります。この手順は、アセット・エディタで実行されます。

このテキストを使用して、要素名を切り取って貼り付けます。

- 合計開発時間(TDH)

- 生成投資(Pinv)

- 消費係数(Cfac)

- 予測年間再利用回数(n)

- 時間ごとの間接費率(B)

注意:

ValidateMetrics.sqlファイルをデータベースに対して実行する必要があります。

1. 「アクション」メニューで、タイプの管理を選択します。タイプ・マネージャが起動します。

2. タイプ・マネージャのサイドバーからメトリックを追加するタイプを選択します。

3. 「エディタ」ビューを選択します。

4. 「タブ」セクションで「メトリック」をクリックします。

5. 「要素」セクションで、「追加」をクリックします。

6. リストから数値テキスト・フィールドを選択し、「OK」をクリックします。「数値テキスト・フィールドの編集」ダイアログが表示されます。

7. 「表示名」テキスト・ボックスで要素名をコピー・アンド・ペーストします。

8. 図7-1に示すように、小数桁数の値を0に変更します。

図7-1 「数値テキスト・フィールドの編集」ダイアログ

9. 「OK」をクリックします。

10. メトリックごとに手順4から9を繰り返します。

11. すべてのメトリックを「タイプ」に追加した後、「保存」をクリックします。

- この時点では、「ビューア」タブに要素を追加しないでください。

12. このプロセスをベース・アセット・タイプごとに繰り返します。

7.2 アセット・タイプの要素の有効化

アセット・タイプの要素を有効化するには、次の手順を実行します。

1. 直前に変更したアセット・タイプの1つに属するアセットを選択します。このようなアセットを最も簡単に検出するには、アセット・エディタで「登録済」フォルダを右クリックし、アセット・タイプ別にソートします。

2. このアセットの各メトリック要素に一意の値を追加します。図7-2に示すように、推奨値は1、2、3、4、5です。

図7-2 「管理」タブ

3. アセット名、バージョン、およびアセット・タイプ名を編集済アセットのステータス・バーから選択します。

4. アセットを保存します。

7.3 データベースに対する問合せの実行

次のデータベース問合せは、メトリック・フィールドが適切に追加されるよう有効化するために使用されます。

後述の手順を実行して、データベースに対して次のメトリック問合せを実行できます。

-- Metrics SQL (for Oracle, UDB and MsSQL Server)
-- Total Development Hours
select a.name as AssetName, a.version as Version, at.name as
AssetTypeName, axi.stringvalue as tdh
from assetxmlindex axi, assets a, assettypes at
where axi.assetid = a.id and axi.assettypeid = at.id
and axi.fieldid in
(select id from assetxmlindexmappings where fieldname =
'/custom-data/total-development-hours--tdh-')
order by a.name, a.version;
-- Production Investment
select a.name as AssetName, a.version as Version, at.name as
AssetTypeName, axi.stringvalue as Pinv
from assetxmlindex axi, assets a, assettypes at
where axi.assetid = a.id and axi.assettypeid = at.id
and axi.fieldid in
(select id from assetxmlindexmappings where fieldname =
'/custom-data/production-investment--pinv-')
order by a.name, a.version;
-- Consumption Factor
select a.name as AssetName, a.version as Version, at.name as
AssetTypeName, axi.stringvalue as Cfac
from assetxmlindex axi, assets a, assettypes at
where axi.assetid = a.id and axi.assettypeid = at.id
and axi.fieldid in
(select id from assetxmlindexmappings where fieldname =
'/custom-data/consumption-factor--cfac-')
order by a.name, a.version;
-- Predicted Number of Annual Reuse Opportunities
select a.name as AssetName, a.version as Version, at.name as
AssetTypeName, axi.stringvalue as n
from assetxmlindex axi, assets a, assettypes at
where axi.assetid = a.id and axi.assettypeid = at.id
and axi.fieldid in
(select id from assetxmlindexmappings where fieldname =
'/custom-data/predicted-number-of-annual-reuse-opportunities--n-')
order by a.name, a.version;
-- Hourly Burden Rate
select a.name as AssetName, a.version as Version, at.name as
AssetTypeName, axi.stringvalue as B
from assetxmlindex axi, assets a, assettypes at where axi.assetid =
a.id and axi.assettypeid = at.id
and axi.fieldid in
(select id from assetxmlindexmappings where fieldname =
'/custom-data/hourly-burden-rate--b-')
order by a.name, a.version;
-- Predicted Net Hours Saved
select a.name as AssetName, a.version as Version, at.name as
AssetTypeName, axi.stringvalue as PNHS
from assetxmlindex axi, assets a, assettypes at
where axi.assetid = a.id and axi.assettypeid = at.id
and axi.fieldid in
(select id from assetxmlindexmappings where fieldname =
'/custom-data/development-hours')
order by a.name, a.version;
-- End Metrics SQL

7.3.1 dbqueries

この項では、メトリック問合せを実行する手順について説明します。

1. データベースに対する接続を開き、前述の6つの問合せを実行します。アセット名、バージョン、アセット・タイプおよびメトリックが結果として返されます。メトリックが返されない場合は、メトリック名が正しくコピー・アンド・ペーストされていない可能性があります。各メトリックには独自の問合せがあり、それぞれの問合せを個別に実行することをお薦めします。予期した結果を返すメトリックが有効化されます。

2. メトリック問合せが失敗した場合は、その要素を削除した後、手順に従ってメトリック要素を作成、有効化、およびデータベースに対して実行します。選択したアセット・タイプにPNHS要素がない場合、次に示すように追加する必要があります。

1. 開発時間という文字列を追加します。

2. 「OK」をクリックします。

3. 開発時間要素を編集し、名前を予測節約正味時間(PNHS)に変更します。(メトリックの要素名は、開発時間プログラム名に基づいています。)アセット・エディタに予測節約正味時間ラベルが表示されます。

3. すべてのメトリックが有効化されたら、Oracle Enterprise Repositoryのタイプ・マネージャでアセット・タイプを開きます。

4. 「ビューア」タブを選択します。

注意:

- 追加した要素はすべて非表示要素領域に表示される必要があります。

- アセット・コンシューマにとっては、予測節約正味時間(PNHS)メトリックのみが意味を持ちます。

- 予測節約正味時間(PNHS)が「概要」グループの最初の列に表示されていることが推奨されます。

5. アセット・タイプを保存します。

6. 他のアセット・タイプについて手順1から5を繰り返し、メトリック要素を追加します。

7. 問合せのテスト用に追加したサンプル・データを削除し、データを保存します。

8 電子メール通知および配信リストの構成

この章では、電子メール通知とテンプレートを構成する方法、および配信リストを管理する方法について説明します。

この章の内容は次のとおりです。

- 8.1項「概要」

- 8.2項「電子メール通知の設定」

- 8.3項「電子メール配信リストの管理」

- 8.4項「電子メール・テンプレートの使用」

8.1 概要

Oracle Enterprise Repositoryでは、アセット登録プロセスの様々な参加者に対する自動電子メールをサポートしています。電子メールはリポジトリ・イベントに基づいて送信され、このイベントはユーザー・インタフェースを介したOERとのインタラクションまたはOER自動ワークフローによってトリガーされます。自動電子メールは有効化または無効化でき、特定のOERインスタンスに対してこれらの電子メールのテンプレートを構成できます。自動通知と任意のサブスクライバ電子メールのどちらについても、受信者はOERから電子メールを受信する電子メール配信リストを指定できます。

8.1.1 電子メール通知および電子メール配信リストの使用

ユーザーは電子メール配信リストを作成し、アセット登録プロセスの一部として生成される特定の電子メール通知のコピーが、リストのメンバーに自動的に送信されるようにできます。配信リストのメンバーに対しては、リスト所有者がアセット・レビューアまたは承認者として関連するアセット登録イベントについて通知されるため、配信リストによってアセット登録ワークフローを自動化できます。たとえば、リスト所有者が不在になる予定の場合は、所定の権限を持つ他のユーザーを電子メール配信リストに追加して、そのアセットのレビューと承認の作業を「委任」できます。

8.2 電子メール通知の設定

アセットの新しいバージョンが作成されたときに電子メール通知を受信するには、cmee.registrar.emailシステム設定で電子メール・アドレスを入力する必要があります。電子メール・アドレスを使用してcmee.registrar.emailシステム設定を更新するには、「管理」ページの「システム設定」に移動します。システム設定を有効化していない場合は、「新しいシステム設定の有効化」フィールドに「cmee.registrar.email」と入力し、「有効化」をクリックします。設定済の場合は、「検索」フィールドに「cmee.registrar.email」と入力します。「通知」セクションでは、図8-1に示すように、システム登録電子メール・フィールドに電子メール・アドレスを入力します。「保存」をクリックして設定を保存します。

図8-1 機能の設定

8.3 電子メール配信リストの管理

配信リストはユーザーのMy Stuff→「構成オプション」→「電子メール通知の管理」ページで作成します。配信リストには、既存のOracle Enterprise Repositoryユーザーおよび外部の電子メール・アドレスを選択できますが、これはOracle Enterprise Repository管理者がこのオプションを許可している場合のみ可能です。

これらの手順は図8-2に示すように、My Stuffページの「電子メール通知」セクションで実行します。

図8-2 電子メール通知

配信リストの作成

電子メール配信リストを作成するには、次の手順を実行します。

1. 図8-3に示すように、「リストの作成」をクリックして「配信リストの更新」ダイアログを開きます。

図8-3 配信リストの更新

2. 「リストの作成」をクリックして「配信リストの更新」ダイアログを開きます。

1. 「名前」テキスト・ボックスに適切なテキストを入力します。

2. 「部門」リストを使用して検索を絞り込みます。

3. 「検索」をクリックします。

検索結果はリストの「検索結果」列に表示されます。

3. 配信リストにユーザーを追加するには、「>>」および「<<」アイコンを使用して「検索結果」列から「選択したユーザー」列にユーザーを移動します。いずれかの列にすべてのユーザーを追加、または列からすべてのユーザーを削除するには、「すべて >>」および「すべて <<」ボタンを使用します。

注意:

配信リストに含むメンバー数の上限は20です。

4. 外部ユーザーをリストに追加するには、追加の電子メール・アドレス・ボックスでカンマを区切り記号として電子メール・アドレスを入力します。
例: jack@msn.com,jill@yahoo.com,jake@comcast.net

5. 「OK」をクリックして配信リスト名を保存します。

図8-4 電子メール通知

8.3.1 配信リストの更新

電子メール配信リストを更新するには、次の手順を実行します。

1. 「リストの更新」をクリックして「配信リストの更新」ダイアログを開きます。

2. 「配信リストの作成」の手順を実行し、新しいメンバーを追加またはメンバーを削除します。

3. 「OK」をクリックして配信リスト名を保存します。

8.3.2 リスト・メンバーに電子メールのコピーが送信される場合

次の通知電子メールでは、ユーザーの配信リストのメンバーに電子メールのコピーが送信されます。

- アセット受入れ

- アセット割当て

- アセット登録済

- アセット発行拒否

- アセット受入れ不可

- アセット割当て解除

- アセット登録解除

- アセット未発行

8.4 電子メール・テンプレートの使用

Oracle Enterprise Repository内の特定のイベントによって、自動電子メールのレスポンスがトリガーされます。たとえば、新しいアセットが発行されると、電子メール通知がレジストラに送信されます。各種のテンプレートについて次に説明します。

- すべてのアセット・タブ承認済: アセットに割り当てられているレジストラとユーザーに、すべてのタブが承認されたことを通知します。
アセットのタブはアセット・エディタで承認できます。「管理」タブを除くそれぞれのタブに、「承認」ボタンがあります。このボタンはアセットが「管理」タブで受け入れられるまで使用できません。

- アセット受入れ: 発行者にアセットが受け入れられたことを通知します。
アセットはアセット・エディタの「管理」タブで受け入れられます。「受入れ」オプションはアセットが発行されるまで使用できません。

- アセット・アクティブ: 発行者とサブスクライバに、アセットがアクティブであるとマークされていることを通知します。
アセットはアセット・エディタの「管理」タブ、「ステータス」セクションで「アクティブ」とマークされます。

- アセット割当て: アセットが処理のためにユーザーに割り当てられたことをそのユーザーに通知します。
アセットはアセット・エディタの「管理」タブ、「ユーザーの割当て」セクションでユーザーに割り当てられます。

- アセット削除: 発行者とサブスクライバに、アセットが削除されたことを通知します。
アセットはアセット・エディタの「管理」タブ、「ステータス」セクションで削除されます。

- アセット・エディタ発行: アセットの発行をアセット・エディタ経由でレジストラに通知します。
アセットはアセット・エディタ内で「ファイル」→「新規」または「ファイル」→コピーと移行を選択すると発行できます。

- アセット非アクティブ: 発行者とサブスクライバに、アセットが非アクティブであるとマークされていることを通知します。
アセットはアセット・エディタの「管理」タブ、「ステータス」セクションで非アクティブとマークされます。

- アセット登録済: アセットが登録されたことを発行者に通知します。
アセットはアセット・エディタの「管理」タブで登録できます。アセットは登録する前に発行し、受け入れられる必要があります。

- アセット・リタイア済: 発行者とサブスクライバに、アセットがリタイアされたことを通知します。
アセットはアセット・エディタの「管理」タブ、「ステータス」セクションでリタイアされます。

- アセット発行拒否: アセットが拒否されたことを発行者に通知します。
アセットはアセット・エディタのレジストラで拒否されます。

- アセット・タブ承認済: 特定のタブが承認されたことをレジストラに通知します。
アセットのタブはアセット・エディタで承認できます。「管理」タブを除くそれぞれのタブに、「承認」ボタンがあります。このボタンはアセットが「管理」タブで受け入れられるまで使用できません。

- アセット・タブ非承認: 特定のタブが非承認になったことをレジストラに通知します。未登録のアセットについては、そのアセットに割り当てられているユーザーにも通知されます。
アセットのタブはアセット・エディタで非承認にすることができます。「管理」タブを除くそれぞれのタブに、ステータスに応じた「承認」または非承認ボタンがあります。このボタンはアセットが「管理」タブで受け入れられるまで使用できません。

- アセット受入れ不可: アセットの受入れが不可にされたことを発行者に通知します。
アセットはアセット・エディタの「管理」タブで受入れ不可にできます。受入れ/受入れ不可のオプションを使用可能にするには、アセットを発行しておく必要があります。

- アセット割当て解除: アセットに割り当てられていたユーザーに、アセットの割当てが解除されたことを通知します。
ユーザーはアセット・エディタの「管理」タブ、「ユーザーの割当て」セクションでアセットへの割当てを解除できます。

- アセット登録解除: アセットの登録が解除されたことを発行者に通知します。
アセットはアセット・エディタの「管理」タブで登録を解除できます。アセットは登録/登録を解除する前に発行され、受け入れられる必要があります。

- アセット未発行: アセットが未発行キューに送信されたことを発行者に通知します。
アセットはアセット・エディタの「管理」タブで未発行にできます。未発行にするためには、アセットが受入れ不可にされている必要があります。

- リポジトリ発行: アセットの発行をレジストラに通知します。
アセットはWebツールの「アセット」タブでアセットの発行を選択すると発行できます。

- 使用状況問合せ1: アセットの対象ユーザーに関するアセット・コンシューマを問い合せます。
このアセットに関するアンケートの発行をユーザーに知らせる通知です。アンケートはWebツールのMy Stuffタブの使用されるアセット・セクションにあります。指定のアセットの詳細には、アンケート・ステータスの更新というボタンがあります。このボタンは、コンシューマ・アンケートのシステム設定が有効な場合のみ使用できます。この設定はcmee.extraction.consumer-survey.enableです。

- 使用状況問合せ2: 使用状況問合せ1に対するレスポンスに応じて、アセット・コンシューマがアセットの意図した用途に関する2つ目の問合せを受信します。
このアセットに関するアンケートの発行をユーザーに知らせる通知です。アンケートはWebツールのMy Stuffタブの使用されるアセット・セクションにあります。指定のアセットの詳細には、アンケート・ステータスの更新というボタンがあります。このボタンは、コンシューマ・アンケートのシステム設定が有効な場合のみ使用できます。この設定はcmee.extraction.consumer-survey.enableです。

8.4.1 電子メール・テンプレートの表示

電子メール通知は、「管理」タブの電子メール・テンプレート・セクションで構成できます。それぞれの電子メール・テンプレートでは、そのテンプレートで使用できる有効な置換のリストがあります。この置換の例としては、アセットの名前をテンプレートに入力する<%asset.name%>があります。有効な置換のリストは、Oracle Enterprise Repositoryで使用可能な30の各テンプレートで異なります。Oracle Enterprise Repositoryで電子メール通知を表示するには、次の手順を実行します。

1. ログイン資格証明を使用してOracle Enterprise Repositoryにログインします。Oracle Enterprise Repositoryホームページが表示されます。

2. 「管理」をクリックします。「管理」ページが表示されます。

3. 電子メール・テンプレートをクリックします。図8-5に示すように、電子メール・テンプレートのリストとそのステータスおよび説明が表示されます。

図8-5 電子メール・テンプレートのリスト

4. 任意のテンプレートをクリックして、次のペインに電子メール・テンプレートの詳細を表示します。たとえば、アセット使用済をクリックします。図8-6は、アセットの通知電子メール・フィールドで、アセットが使用されたことを指定した連絡先に通知するアセット使用済の電子メール・テンプレートを示しています。

図8-6 電子メール・テンプレート - アセット使用済

5. 「保存」をクリックします。

6. 同様に、別の電子メール・テンプレートの詳細も表示できます。

8.4.2 電子メール・テンプレートの編集

この手順は、Oracle Enterprise Repositoryの「管理」画面で開始します。

1. 「管理」サイドバーで電子メール・テンプレートをクリックします。メイン・ペインの上部フレームに電子メール・テンプレートのリストが表示されます。

図8-7 電子メール・テンプレートのリスト

2. 編集する電子メール・テンプレートをリストから選択します。下部のフレームに電子メール・テンプレートの編集画面が表示されます。

図8-8 電子メール・テンプレート: すべてのアセット・タブ承認済

3. 「ステータス」リストを使用して電子メール・メッセージをアクティブ/非アクティブにします。

4. 必要に応じてテンプレート情報を編集します。

編集に関する注意事項

- 「ステータス」フィールドは「アクティブ」または「非アクティブ」に設定できます。「非アクティブ」の場合、指定のイベントに関する電子メール通知は送信されません。「アクティブ」がデフォルトのステータスです。

- 「置換」は件名、メッセージ、およびメール送信者の電子メール・アドレスを置換できる動的変数です。通知が送信される場合に、これらの変数が適切な値に置き換えられます。次の例では、置換するアセット名を入力する場合の構文を示しています。
<%asset.name%>という名前のアセットを発行しました。

受入れ可能な置換のリストは、電子メール・テンプレート画面のそれぞれの電子メール通知に表示されます。

9 Oracle Enterprise Repositoryエクスプレス・ワークフローの構成

この章では、Oracle Enterprise Repository (OER) 11g エクスプレス・ワークフローの設定および構成方法について説明します。

この章には、次のセクションがあります。

- 9.1項「Oracle Enterprise Repositoryエクスプレス・ワークフローの概要」

- 9.2項「エクスプレス・ワークフローの構成」

- 9.3項「サンプル・ワークフローの実行」

- 9.4項「サンプル・ワークフローの変更」

この章では、次の概念を十分に理解していると想定します。

- アセットおよびアセット・タイプ、アセット発行、アセット登録ステータス、アセット・カテゴリ分け(『Oracle Fusion Middleware Oracle Enterprise Repositoryユーザーズ・ガイド』)

- プロジェクトおよびユーザー(『Oracle Fusion Middleware Oracle Enterprise Repository構成ガイド』)

- Oracle SOA Suiteアプリケーション・デプロイメント(『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』)

9.1 Oracle Enterprise Repositoryエクスプレス・ワークフローの概要

この項で説明するとおり、エクスプレス・ワークフローでは次のものが必要です。

- OER PS6 (11.1.1.7)、パッチ17420982適用済

- Oracle SOA Suite + Oracle BPM Suite、どちらも11.1.1.7

注意:

専用の管理対象サーバーに、エクスプレス・ワークフローSCAをデプロイできる独自のSOA Suiteを用意することをお薦めします。エクスプレス・ワークフローは、SOA Suiteを管理サーバーにデプロイするSOA Suiteの開発者エディションでは、正しく機能しないことがあります。

Oracle Enterprise Repositoryのエクスプレス・ワークフローは、一般的なアセットのライフサイクル承認プロセスを自動化するためのメカニズムです。OERでは、アセットを初期状態から最終状態に移すための一連の機能とオプションを提供しています。エクスプレス・ワークフローでは、OERアセット・エディタで可能なアクションの組合せを組み込むためのアセット承認プロセスが必要です。

- アセットの発行

- アセットの受入れ

- アセット・タブの承認

- アセットの登録

AssetLifeCycleStageおよび分類のカテゴリ分けに対する値の変更も必要です。

より複雑なワークフローの自動化を必要とする組織では、『Oracle® Fusion Middleware Oracle Enterprise Repository統合ガイド』のIV部に示すように、Oracle Business Process Management Suiteなどの他のツールを使用して外部ワークフローを開発し、REX APIインタフェースを使用してOERの機能にアクセスできます。

エクスプレス・ワークフローには、次のコンポーネントが組み込まれています。

- アセット

- プロジェクト

- ユーザー

- 承認フロー

- イベントおよびアクション

これらのコンポーネントは、次のように、エクスプレス・ワークフローで関連付けられています。

- アセットはリポジトリに発行され、同時にプロジェクトを作成します。エクスプレス・ワークフローでは、アセットが作成するプロジェクトは1つのみである必要があります。

- プロジェクトの作成にフローの承認が割り当てられており、アセットのタイプが承認フローで識別される場合、アセットを発行または受け入れると自動的にフローに進みます。プロジェクトで許可される承認フローは1つのみであり、そのプロジェクトに関連するアセットが発行された場合または受け入れられた場合にのみ開始されます。

- 承認フローはアセット・タブのグループと層で構成されます。それぞれの層には承認者が割り当てられています。アセットは、割り当てられた承認者が層内のタブをすべて承認すると、次の層に移動します。

承認フローには、次のことを決定する設定があります。

- アセット発行または受入れの時点でフローを開始するかどうか。

- 指定のタブが承認されたときにアセットが自動的に登録されるかどうか。

OER管理者は任意の数の承認フローを作成でき、承認フローには任意の数のプロジェクトを割り当てられます。アセットは、アセットが登録されたときにカスタム・アクセス設定をアセットに割り当てる、あるいはアセットのライフサイクル・ステージのカテゴリ分けの値が変更したときにサブスクライバに通知するなど、特定のアクションを個別のイベントにマップして操作します。

9.2エクスプレス・ワークフローの構成

エクスプレス・ワークフローは次のコンポーネントに依存しています。

- エクスプレス・ワークフローSOAコンポジット・アプリケーション(SCA)

- OERイベント・マネージャ

- エクスプレス・ワークフロー構成ファイル

ここでは、構成に関連する手順を示します。

1. OERエクスプレス・ワークフローSOAコンポジット・アプリケーション(SCA)のインストール

2. デプロイ済SCAへイベントを配信するOERイベント・マネージャの構成

3. エクスプレス・ワークフローの定義および構成

この項では、Oracle Enterprise Repository WorkflowをOracle BPM 10.3.2にインストールする方法について説明します。内容は次のとおりです。

9.2.1 手順1: OERエクスプレス・ワークフローSOAコンポジット・アプリケーションのインストール

エクスプレス・ワークフローSOAコンポジット・アプリケーションは、OERイベント・マネージャからそのWebサービス・エンドポイントへのイベント配信をリスニングします。このアプリケーションのインストールには、Oracle SOA Suite 11g R1以降のインスタンスおよびBPM Suiteをインストールしておく必要があります。SOA SuiteおよびBPM Suiteサーバーに追加の構成は必要ありません。

注意:

続行する前に、「soa-infra」→「SOA管理」→「共通プロパティ」のペイロードの検証がfalseに設定されていることを確認します。

WebLogic Serverでのエクスプレス・ワークフローSOAコンポジット・アプリケーションのデプロイ

1. SOA Suite Enterprise Managerコンソールにログインします(通常はhttp://<soaserver_hostname>:<soaserver_port>/emなど)。

2. 左側のメニューから、「SOA」を展開します。

3. 「soa-infra」をクリックします。

4. 「デプロイ済コンポジット」タブを選択します。

5. 「デプロイ…」をクリックします。

6. 「アーカイブの選択」ウィンドウが表示されます。

7. 「アーカイブまたは展開済ディレクトリ」で適切なオプションを選択します。

8. ExpressWorkflowsパッチで配信されたコンポジットをアップロードします。

9. 「次」をクリックします。

10. デフォルトのSOAパーティションを選択します。「次」をクリックします。

11. 「デプロイ」をクリックします。

9.2.2 手順2: デプロイ済SCAへイベントを配信するOERイベント・マネージャの構成

イベント・マネージャはOracle Enterprise Repositoryに埋込みのコンポーネントであり、イベント・サブスクリプション、イベント永続性、イベントのフィルタ処理、およびイベント配信を管理します。

アセットがライフサイクルを進むと、外部アプリケーションが生成されたイベントにサブスクライブします。エクスプレス・ワークフローの場合、Oracle SOA Suiteサーバー・インスタンスにデプロイされたSOAコンポジット・アプリケーションが、OER構成ファイルで定義されたWebサービス・エンドポイントを介してこれらのイベントにアクセスします。OERイベントにアクセスする他のアプリケーションのオプションの詳細は、『Oracle Fusion Middleware Oracle Enterprise Repository構成ガイド』の第9.4章を参照してください。

エクスプレス・ワークフローは次のイベントをサポートしています。

- アセットの発行

- アセット未発行

- アセット受入れ

- アセット受入れ不可

- アセット・タブの承認: 値=<tab name>

- すべてのアセット・タブの承認

- アセット登録済

- アセット登録解除

- アセット・ステータス変更: 値="DELETED/INACTIVE/RETIRED

- ポリシー・アサーション変更: 値="pass/fail"

- カテゴリ分け変更:AssetLifecycleStage (どの変更にも有効)

- カテゴリ分け変更:AssetLifecycleStage: 値="stage name"

- カテゴリ分け変更:Classification (どの変更にも有効)

- カテゴリ分け変更:Classification: 値="stage name"

9.2.2.1 Webサービスのエンドポイント構成

イベント・マネージャは構成ファイルを使用して、イベントを配信するWebサービスのエンドポイントに関する情報をロードします。このファイルはOERのインストール、<oer webapp name>\WEB-INF\classes\EndPointEventSubscription.xmlにあります。

例: C:\ofm_wls1036\user_projects\applications\oer_domain\applications\oer_11.1.1.7.0\oer-app\WEB-INF\classes\ EndPointEventSubscription.xml

このファイルで、イベントを受け取るようにSCAエンドポイントを追加するには、次の例に示すように、に<sub:eventSubscription>要素の新規インスタンスを作成します。

図9-1 SCAにイベントを配信するOERイベント・マネージャの構成

このファイルでは、前述の例1に示すように、エクスプレス・ワークフローSOAコンポジット・エンドポイントのホスト、ポート、ユーザー名、およびパスワードを手動で構成する必要があります。その他のタグにあるコメントは、内容の概略を示します。前述の例は、サンプル・ファイル<OERHome>\repository111\core\express-workflows-config\EndPointEventSubscription.xmlのエクスプレス・ワークフローパッチにあります。

注意:

パスワードはOERで提供される2つの暗号化ツールのいずれかを使用して暗号化する必要があります。『Oracle Fusion Middleware Oracle Enterprise Repository構成ガイド』の暗号化パスワードの生成に関する項を参照してください。

このファイルの変更は、次にイベント・マネージャを有効化した後にOERを停止し、再起動するまで反映されません。イベント・マネージャが有効化されている場合は、この時点でOERサーバーを再起動できます。

9.2.2.2 イベント・マネージャの有効化

イベント・マネージャの構成が完了したら、Oracle Enterprise Repositoryでイベント・マネージャを有効化して、外部Webサービスのエンドポイントへのイベント送信を許可する必要があります。

1. Oracle Enterprise Repositoryの「管理」画面のサイドバーで「システム設定」をクリックします。

2. 「システム設定」の「検索」に「event」と入力して、イベント・マネージャ関連の設定をすべて表示します。

3. 「イベント・マネージャの有効化」プロパティcmee.eventframework.enabledの横にある「True」をクリックします。

4. 「保存」をクリックします。

5. Oracle Enterprise Repositoryを再起動して構成の変更内容を反映します。

9.2.3 手順3:エクスプレス・ワークフローの定義および構成

エクスプレス・ワークフローコンポーネントとそのリレーションシップはXMLファイルで定義および構成され、OERイベントがアプリケーションのWebサービス・エンドポイントに配信される場合は常にこのファイルがエクスプレス・ワークフローSOAコンポジット・アプリケーションで読み込まれます。

このファイルのサンプル・バージョン(およびそのXSD)は、構成手順が完了したときに実行する事前構成のサンプル・ワークフローとともに提供されます。OERのインストールでは、このサンプル・ファイルは<OERHome>\repository111\core\express-workflows-config\expressWorkflow.xmlにあります。

このXMLの各種要素の詳細な説明は、「サンプル・ワークフローの変更」の項に記載されています。ここではファイルを構成し、サンプル・ワークフローを有効化します。

構成ファイルの設定およびサンプル・ワークフローの有効化

1. アセット・エディタを起動し、アセットを編集し、タブを承認するアクセス権限を持つOERユーザーを新規に作成します。『Oracle® Fusion Middleware Oracle Enterprise Repository構成ガイド』のユーザー、ロール、および基本アクセス権限の設定に関する項を参照してください。

2. 元のサンプルExpressWorkflow.xmlを新しいファイル名で保存します。

3. ExpressWorkflow.xmlの編集: <oerConnection>タグ内でOERサーバーのホスト: ポートと管理ユーザーのクリア・テキストのパスワードを入力します。

<oerConnection>
<uri>http://[OERHOST:PORT]/oer/services/FlashlineRegistry</uri>
<registrar>
<username>admin</username>
<password>[your admin password]</password>
</registrar>

4. 新規OERユーザーのユーザー名を第2層の承認者として入力します。

<approvalFlow name="Flow1" acceptOnAssetSubmission="true" registerOnFlowCompletion="true">
<tiers>
<tier name="Tier1">
<approvers>
<oeruser>
<username>admin</username>
</oeruser>
</approvers>
<tabs>
<tab name="Overview"/>
<tab name="Technical"/>
<tab name="Documentation"/>
</tabs>
</tier>
<tier name="Tier2">
<approvers>
<oeruser>
<username>[Your New Username]</username>
</oeruser>
</approvers>
<tabs>
<tab name="Taxonomy"/>
</tabs>
</tier>

5. 『Oracle® Fusion Middleware Oracle Enterprise Repository構成ガイド』の暗号化パスワードの生成に関する項にあるとおり、ファイル内でパスワードを暗号化します。

6. ファイルを保存します。

7. OERサーバーが実行されていることを確認し、エクスプレス・ワークフロー検証スクリプト(<OERHome>\repository111\core\express-workflows-config\validateWorkflow.sh)を実行してexpressWorkflow.xmlファイルを確認します。
validateWorkflow.sh -settings [使用中のexpressWorkflow.xmlファイル]

8. 次のように、Oracle SOA Suiteドメインにoerconfigと呼ばれる新規フォルダを作成します。
<SOAHome>\user_projects\domains\<SOAdomain>\oerconfig

9. 検証したファイルをExpressWorkflow.xmlという名前でoerconfigフォルダにコピーします。

この時点でサンプルが有効化され、エクスプレス・ワークフローの設定および構成が完了しました。これで次の項に進み、サンプルを実行できます。

9.3 サンプル・ワークフローの実行

OERサーバーおよびSOAサーバーの実行中に、リポジトリに「サービス」タイプの新規アセットを作成します。

アセットの新規作成

1. 管理者またはアセット作成の権限を持つユーザーとしてOERにログインします。

2. アセット・エディタで「ファイル」→「新規」を選択します。

3. 「アセットの新規作成」ダイアログでアセット名を入力します。

4. 「サービス」タイプと初期状態の未発行を選択します。

5. 「OK」をクリックします。新しいアセット・タブが表示されます。

6. 「概要」タブでプロジェクトの作成の共通プロジェクトを選択します。「保存」をクリックします。

サンプルの実行

1. 管理ユーザーとしてOERにログインします。

2. My Stuffに進むと、新しく作成し、発行されたアセットがキューに表示されます。

3. アセット・エディタを開き、「概要」、「技術的」、および「ドキュメント」のタブを承認します。アセット・エディタを終了します。

4. ログアウトし、新たに作成したユーザーとしてOERに再度ログインします。

5. My Stuffに進み、「サービス」アセットを検索して編集し、分類タブを承認します。アセット・エディタを終了します。

6. OERコンソールで「登録ステータス」が「登録済」になっているサービス・アセットを名前で検索します。

検索結果に次のアセットが表示されます。

9.4 サンプル・ワークフローの変更

サンプル・ワークフローの実行が完了したら、次のようにこれを変更するか、新たにワークフローを作成することができます。

1. インストール済のExpressWorkflow.xmlを新しい場所にコピーし、これを編集して新規プロジェクト、ユーザー、アセット・タイプ、イベント/アクションのマッピング、および承認フローを追加します。

2. 検証スクリプトを実行して、変更内容が実行中のOERインスタンスに対応していることを確認します。

3. インストール済のExpressWorkflow.xmlファイルを新しいバージョンと置き換えます。

注意:

エクスプレス・ワークフローSOAコンポジットでは、OERイベント・マネージャからイベントを受け取るたびにインストール済ファイルを読み取るため、新たにインストールしたExpressWorkflow.xmlバージョンの変更内容はすぐに反映され、再起動は必要ありません。

9.4.1エクスプレス・ワークフロー構成ファイルの変更

ExpressWorkflow.xmlファイルは、次を実行できるように変更しました。

- OERサーバー・インスタンスの識別

- OER管理ユーザーの暗号化パスワードを提供

- 承認フローFlow1内アセット・タブの第2層の承認者名の変更

9.4.1.1 プロジェクトの作成

ここでは、共通プロジェクトを作成するためのデフォルトのExpressWorkflow.xmlファイルの一部を示します。

<producingProject name="Common Project" approvalFlow="Flow1"/>
<assetTypes>
<assetType name="Business Process"/>
<assetType name="Composite"/>
<assetType name="Service"/>
</assetTypes>
</producingProject>

- 名前は既存のOERプロジェクトを示します。検証スクリプトにより、指定したプロジェクトがOERインスタンスにない場合はエラーが生成されます。

- approvalFlowはオプションの属性であり、このプロジェクト内に作成したアセットの階層化したタブの承認、またはガバナンス・フローを指定します。作成するプロジェクトには、approvalFlowが1つ含まれるか、あるいはまったく含まれません。

- assetTypeは既存のタイプを示します。プロジェクトの作成で発行した指定タイプのアセットはすべて、プロジェクトに指定したapprovalFlowおよびそのアセット・タイプに指定したイベント/アクションのマッピングに従います。

注意:

アセットはExpressWorkflow.xmlファイルで作成するプロジェクトが1つのみ指定されている場合、ExpressWorkflowで管理されます。

9.4.1.2 承認フロー

エクスプレス・ワークフロー承認フローでは、ガバナンス・プロセスの間にアセット・タブが承認されるように、指定したアセットの動作を決定します。ここでは、変更したExpressWorkflow.xmlの一部を示します。

<approvalFlow name="Flow1" acceptOnAssetSubmission="true" registerOnFlowCompletion="true">
<tiers>
<tier name="Tier1">
<approvers>
<oeruser>
<username>admin</username>
</oeruser>
</approvers>
<tabs>
<tab name="Overview"/>
<tab name="Technical"/>
<tab name="Documentation"/>
</tabs>
</tier>
<tier name="Tier2">
<approvers>
<oeruser>
<username>[Your New Username]</username>
</oeruser>
</approvers>
<tabs>
<tab name="Taxonomy"/>
</tabs>
</tier>

- 名前はフローを識別し、producingProjectのapprovalFlow属性で使用されます。この属性はexpressWorkflow.xmlファイル以外では使用されません。

- acceptOnAssetSubmissionは、指定したアセットが発行のときに自動的に受け入れられる(値=「true」)、または十分なアクセス権のあるOERユーザーによって手動で受け入れられる(値=「false」)かを決定するオプションの属性です。この属性が指定されていない場合、デフォルト値は「false」です。

- registerOnFlowCompletionは、承認フローで指定したすべてのタグが承認済(値=「true」)のとき、指定したアセットを自動的に登録するかどうかを決定するオプションの属性です。この属性が指定されていない場合、デフォルト値は「false」です。

- 層名はアセット・タブの組合せを示します。

- 層の承認者とは、最初に指定した層でアセットを受け入れたとき、または前の層のすべてのタブを承認したときに、アセットが割り当てられる既存のOERユーザーを示します。

- 層のタブ名は、特定の層で承認される、指定したアセット・タイプに固有のアセット・タブを示します。

9.4.1.3 イベント/アクション間のマッピング

イベント/アクション間のマッピングは、アセットの自動受入および登録のための承認フローを指定するための、代替の方法を提供します。これらのマッピングは、指定したアセット・タイプにのみ適用されます。1つのプロジェクト内の複数のアセット・タイプについて、異なる(または同一の)マッピングが可能です。

エクスプレス・ワークフローは、イベント・マネージャで生成される多数のアセット・ライフサイクル・イベントを識別し、これらのイベントを特定のアセットの特定のアクションに関連付けるメカニズムを提供しています。サポートされるイベントとアクションの完全なリストは、ExpressWorkflow.xmlファイルに必要な次の構文に含まれています。

次のプロジェクトの作成のサンプルを調査します。

<producingProject name="Project1"/>
<assetTypes>
<assetType name="Service">
<events>
<event name="urn:com:bea:aler:events:type:AssetSubmission">
<actions>
<action name="AcceptAsset" />
</actions>
</event>
<event name="urn:com:bea:aler:events:type:AssetTabApproved">
<actions>
<action name="RegisterAsset" />
<tabs>
<tab name="Management Review" />
</tabs>
</action>
</actions>
</event>
</events>
</assetType>
</assetTypes>
</producingProject>

前述の例では、Project1に承認フローが指定されていません。ただし、assetType「サービス」ではイベント/アクション間のマッピングを指定しています。最初のマッピングで、「サービス」タイプのアセットが発行時に自動的に受け入れられます。2つ目は、管理レビュー・タグが承認されるとアセットが登録されます。

次の例では、expressWorkflow.xmlファイルのデフォルトから「サービス」タイプのアセットを承認フローのFlow1で登録するとき、カスタム・アクセス設定をそのタイプのアセットに自動的に適用します。

<producingProject name="Project2" approvalFlow="Flow1"/>
<assetType name="Service">
<event name="urn:com:bea:aler:events:type:AssetRegistered">
<action>ChangeCAS</action>
<customAccessSettings>
<customAccessSetting>[YourSetting]<customAccessSetting/>
</customAccessSettings>
<assetLifecycle/>
</event>
</assetType>
</producingProject>

カスタム・アクセス設定はガバナンス・コミュニティ内でアセットの可視性の制御に使用されるため、この例の設定は、承認プロセスの完了後に潜在的なコンシューマに対してアセットを公開することに多く使用されます。

一般的に、プロジェクトの作成では承認フローの指定、または特定のアセット・タイプのイベント/アクション間のマッピングの指定、あるいはその両方が可能です。ただし、両方を使用する場合は、承認フローの層で承認のためにタブを指定するとき、およびイベント/アクション間のマッピングで「承認」タブを指定するときに重複やルールの複雑化を避けるよう注意する必要があります。

エクスプレス・ワークフローでサポートされているイベントとアクションのリストを次に示します。

サポートされているイベント

- urn:com:bea:aler:events:type:AssetSubmission

- urn:com:bea:aler:events:type:AssetUnSubmission

- urn:com:bea:aler:events:type:AssetAccepted

- urn:com:bea:aler:events:type:AssetUnAccept

- urn:com:bea:aler:events:type:AssetTabApproved

- urn:com:bea:aler:events:type:AssetAllTabApproved

- urn:com:bea:aler:events:type:AssetRegister

- urn:com:bea:aler:events:type:AssetUnregister

- urn:com:bea:aler:events:type:PolicyAssertionChanged

- urn:com:bea:aler:events:type:CategorizationChanged:assetLifecycleStage

- urn:com:bea:aler:events:type:CategorizationChanged:classification

サポートされるアクション

- ChangeCAS: アセットへの1つ以上のカスタム・アクセス設定に適用されます。

- ChangeAssetLifecycle: アセットのアセット・ライフサイクル・ステージを設定します。

- ChangeClassification: アセットの分類を設定します。

- ReAssignAssetToRegistrar: アセットをレジストラに割り当てます。

- NotifySubscriber: メタデータ変更をサブスクライバに通知します。

- ApproveTab: 1つ以上のタブを承認します。

- UnapproveTab: 1つ以上のタブを承認しません。

- AcceptAsset: アセットを受け入れます。

- UnacceptAsset: アセットを受入れ不可にします。

- RegisterAsset: アセットが登録済の状態の場合にアセットを登録解除します。

- UnRegisterAsset: アセットが登録済の状態の場合にアセットの登録を解除します。

- PublishAssetToUddi: 個々のサービスが登録されるとき、またはサービスのライフサイクルが変更されるときにトリガーされるイベントをワイヤリングして、これらのサービスとそのメタデータをOracle Service Registryに移動します。

10 Oracle Service Registryとメタデータを交換するためのOracle Enterprise Repositoryの構成

この章では、Oracle Service Registryとメタデータを交換するためにOracle Enterprise Repositoryを構成する方法について説明します。

この章には、次のセクションがあります。

- 10.1項「Oracle Registry Repository Exchange Utilityを使用する前に」

- 10.2項「Oracle Registry Repository Exchange Utilityの構成」

- 10.3項「Oracle Enterprise Repository Exchange Utilityの使用」

10.1 Oracle Registry Repository Exchange Utilityを使用する前に

この項では、Oracle Registry Repository Exchange Utilityの使用を開始する方法と、このユーティリティを使用したユースケース例について説明します。

この項には次のトピックが含まれます:

- 10.1.1項「Oracle Registry Repository Exchange Utilityとは」

- 10.1.2項「ユースケース例」

10.1.1 Oracle Registry Repository Exchange Utilityとは

Oracle Registry Repository Exchange Utilityでは、Oracle Enterprise RepositoryとOracle Service Registryを双方向に同期し、これらの両方の製品のメタデータがこのユーティリティを介してどちらかの方向に流れることができるようにします。このユーティリティで処理されるメタデータ・エンティティを次に示します。

Oracle Registry Repository Exchange Utilityで可能な処理は次のとおりです。

- UDDIを使用して、設計時環境から実行時環境にサービスとエンドポイントを公開します。

- 新しく検出された実行時サービスとエンドポイントをリポジトリに発行し、それらを管理および制御できるようにします。

- UDDIレジストリに格納されたサービス・パフォーマンス情報をリポジトリに戻し、予期されるサービス・コンシューマとポートフォリオ・マネージャにより適切に通知します。

- Oracle Business Process Managementワークフローによってトリガーされることにより、Oracle Service Registryにアセットを自動的に公開します。

10.1.1.1 有効なメタデータ・エンティティ

Oracle Registry Repository Exchange Utilityでは、次のメタデータ・エンティティが処理されます。

- すべてのUDDI対応サービスとSCAサービス・タイプ、およびエンド・ユーザーが開発するOracle Enterprise Repositoryアセット・タイプのカスタム・サービス。

- ビジネス・サービスを提供するビジネス・エンティティ。
Oracle Registry Repository Exchange Utilityがビジネス・エンティティに到達する方法の詳細は、10.3.2.1項「Oracle Enterprise RepositoryからOracle Service Registryに公開されるメタデータの同期」および10.3.2.2項「Oracle Service RegistryからOracle Enterprise Repositoryに移動するメタデータの同期」を参照してください。

- サービスへのアクセス・ポイントを提供するサービスにリンクされるエンドポイント・アセット。たとえば、ステージングまたは本番としてタグ付けされ、UDDIバインディング・テンプレートに適切にマップされる複数のエンドポイントが存在する可能性があります。

- Oracle Enterprise Repositoryのカテゴリ分けは、UDDIのt-modelにマップされます。カテゴリ分けがサービス・アセットに適用される場合は、適切なエントリがUDDIカテゴリ・バッグに追加され、適切な分類t-modelにリンクされます。これらのt-modelは初回の検出時に自動的にOracle Service Registryにロードされるか、またはOracle Enterprise Repository Exchange Utilityによって手動でロードできます。
詳細は、表10-4の-publish_tmodelを参照してください。

- サービスがOracle Service Registryにプッシュされるときに、サービス登録ステータスと「アクティブ・ステータス」がOracle Service Registryのビジネス・サービスのカテゴリ・バッグに項目として追加されます。

- 非WSDLベースのサービスはUDDIレジストリに公開されます。

- HTTPトランスポートのないサービスはUDDIレジストリに公開されません。

- サービス・キー - Oracle Enterprise Repositoryによってサービスが複数のサービス・レジストリに昇格される場合、サービス・キーの一貫性が保たれ、同じサービス・キーが各サービス・レジストリに表示されます。サービスがOracle Service RegistryからOracle Enterprise Repositoryに公開される場合、Oracle Enterprise Repositoryでは常にこのサービス・キーを使用してサービスを他のサービス・レジストリに昇格します。

10.1.1.2 前提条件

Oracle Registry Repository Exchange Utilityを使用する前に、次の前提条件を満たす必要があります。

- Oracle Registry Repository Exchange Utilityには、Java SDKバージョン6以上が必要です。

10.1.2 ユースケース例

Oracle Registry Repository Exchange Utilityは双方向であるため、次のユースケースをサポートできます。

- Oracle Service Registry内のサービスが変更される(たとえば、ステージング環境や本番環境でエンドポイントが追加される)場合、Oracle Registry Repository Exchange Utilityでは、そのサービスをOracle Enterprise Repository内の1つ以上のエンドポイントに関連付けることができます。サービスおよびアセットが複数のUDDIレジストリ環境に公開される場合、単一のUDDIサービス・キーが各レジストリ内に保持されます。

- アセットのリレーションシップを使用してビジネス・サービスがOracle Enterprise Repository内の別のビジネス・エンティティに移動される場合、サービスが再同期されると、新しいリレーションシップがOracle Service Registryにも反映されます。

- Oracle Enterprise RepositoryメタデータをOracle Service Registryと同期する場合、Oracle Registry Repository Exchange Utilityでは、すべての変更をマージしてエンドポイントの変更が保持されるようにします。

- Exchange Utilityでは、特定の種類の非WSDLサービスをOracle Enterprise RepositoryからOracle Service Registryに公開します。これらのサービスは双方向ではありません。つまり、Exchange Utilityでは、Oracle Service RegistryからOracle Enterprise Repositoryに公開し戻すことはできません。

- エンドポイントの指定されたアセット・ライフサイクルに基づいて、一致するサービスのエンドポイントをフィルタ処理できるため、一致するエンドポイントのみがリポジトリに公開されます。この問合せは、ステージングされたエンドポイントをリストするレジストリと本番エンドポイントをリストするレジストリという2つのレジストリが存在する場合に役立ちます。

注意:

Oracle Registry Repository Exchange UtilityはOracle Enterprise Repositoryワークフローで呼び出すことができます。たとえば、アセット・ライフサイクル・ステージの変更または他のイベント・トリガーによってOracle Enterprise RepositoryとOracle Service Registryとの同期をトリガーできる場合などです。

詳細は、A.2.2項「自動ワークフロー」を参照してください。

- Exchange Utilityは、SAPなどのサード・パーティのUDDIレジストリからサービスを導入できます。SAPとの統合の詳細は、『Oracle Fusion Middleware Oracle Enterprise Repository統合ガイド』の「SAPとの統合」を参照してください。

- Exchange Utilityはまた、Oracle Service Registryからメトリックを受け取ることもでき、これらのメトリックはOracle Service RegistryからOracle Business Transaction Management 10gに公開されます。詳細は、『Oracle Fusion Middleware Oracle Enterprise Repository統合ガイド』の「Amberpointとの統合」を参照してください。

10.2 Oracle Registry Repository Exchange Utilityの構成

この項では、Oracle Registry Repository Exchange Utilityをインストールおよび構成する方法について説明します。

この項には次のトピックが含まれます:

- 10.2.1項「Oracle Registry Repository Exchange Utilityのインストールおよび構成」

- 10.2.2項「Oracle Service Registryのインストール」

- 10.2.3項「Oracle Registry Repository Exchange Utilityの構成ファイルの構成」

- 10.2.4項「UDDIマッピング・ファイル内のOracle Enterprise Repositoryカテゴリ分けの構成」

- 10.2.5項「tModelKey UDDI設定の構成」

- 10.2.6項「Oracle Registry Repository Exchange Utilityのプロパティ・ファイルの理解」

10.2.1 Oracle Registry Repository Exchange Utilityのインストールおよび構成

Oracle Registry Repository Exchange Utilityを使用してOracle Enterprise RepositoryメタデータをOracle Service Registryとの間で公開したり受け取る前に、次に示す構成の手順を完了しておく必要があります。

- 10.2.1.1項「Oracle Registry Repository Exchange Utilityのインストール」

- 10.2.1.2項「アセット・タイプ名を使用した構成」

10.2.1.1 Oracle Registry Repository Exchange Utilityのインストール

デフォルトでは、Oracle Enterprise Repositoryをインストールすると、Oracle Registry Repository Exchange Utilityファイルは次の場所にあります。

<Oracle_HOME>\repositoryXXX\core\tools\solutions

Oracle Enterprise Repository 11g用のOracle Registry Repository Exchange Utilityファイルは、次のとおりです。

- 11.1.1.x.x-RR-ExchangeUtility.zip: Exchange Utilityのパッケージが含まれています。

11.1.1.x.x-RR-ExchangeUtility.zipファイルは、Oracle Enterprise Repositoryをインストールしたファイル・システム上のディレクトリ(通常は、Oracle_HOME\repositoryXXX)に解凍できます。Oracle Registry Repository Exchange Utilityが含まれるzipファイルをファイル・システムに解凍すると、次の構造が作成されます。

orrxu  <ExchangeUtility Tool Home>
|      lib

<ExchangeUtility Tool Home>ディレクトリ内には、Oracle Registry Repository Exchange Utilityファイル(orrxu.xml、UDDIMappings.xml、orrxu.properties、orrxu.batおよびencrypt.batファイルなど)があります。

10.2.1.2 アセット・タイプ名を使用した構成

ソリューション・パックとは異なるUUIDを持つ既存のアセット・タイプが含まれるシステムにソリューション・パックをインポートすると、これらのアセット・タイプが作成され、バージョニングされます。orrxu.propertiesファイルでは、名前別にアセット・タイプが指定されますが、この結果、処理結果が不正確になります。これは、新しいソリューション・パックに含まれていたアセット・タイプではなく、すでに存在していたアセット・タイプを使用しようとすることが原因です。

Oracle Enterprise Repositoryの以前のバージョンでは、一部のアセット・タイプはソリューション・パックによってではなく、手動で作成されており、この結果、ランダムなUUIDが生成されました。

データパックと同じ名前を持つ既存のアセットが存在する場合の回避策としては、新しいデータパックをインポートする前に、システム内のアセットの名前を変更します。

10.2.2 Oracle Service Registryのインストール

Oracle Service Registryをインストールし、UDDI問合せURL (http://host:port/registry/uddi/inquiryなど)を取得できます。

Oracle Service Registryのインストールの詳細は、http://download.oracle.com/otndocs/tech/soa/OSR11gR1ProductDocumentation.pdfを参照してください。

10.2.3 Oracle Registry Repository Exchange Utilityの構成ファイルの構成

この項では、Oracle Registry Repository Exchange Utilityの構成ファイルを環境にあわせて構成する方法について説明します。内容は次のとおりです。

- 10.2.3.1項「リポジトリ接続情報の設定」

- 10.2.3.2項「レジストリ接続情報の設定」

- 10.2.3.3項「リポジトリ問合せの設定」

- 10.2.3.4項「宛先レジストリの設定」

- 10.2.3.5項「レジストリ問合せの設定」

- 10.2.3.6項「ソース・レジストリの設定」

10.2.3.1 リポジトリ接続情報の設定

<ExchangeUtility Tool Home>にあるorrxu.xmlファイルを開き、次のXMLセクションを変更して、適切な資格証明でOracle Enterprise Repositoryインスタンスを参照するようにします。

<repository>
<uri>http://localhost:7101/oer</uri>
<credentials>
<user>admin</user>
<password>*****</password>
//To ensure security, the password must be encrypted.
//The password encryption tool (encrypt.bat/encrypt.sh), which is located in
<Oracle_home>/repositoryXXX/core/tools/solutions/11.1.1.x.x-OER-PasswordTools.zip,
allows you to encrypt
// the passwords that are stored in the Oracle Registry Repository Exchange Utility configuration (orrxu.xml) file.
</credentials>
</repository>

ここで、URIにはOracle Enterprise Repository URIを次の形式で指定します。

http://<host>:<port>/<Oracle Enterprise Repository web app name>

注意:

アセットの表示、編集、受入れおよび登録を行うための基本的なアクセス権が設定されたユーザーとしてExchange Utilityを実行することをお薦めします。

パスワードの暗号化の詳細は、第5章「診断およびパスワードの暗号化」を参照してください。

10.2.3.2 レジストリ接続情報の設定

Oracle Registry Repository Exchange Utilityでは、1つ以上のレジストリに公開したり、複数のレジストリから読み取ることができます(各レジストリからの読取りには個別のトランザクションが必要です)。最初の手順は、次に示すように、接続情報を格納する<registry>ノードを1つ以上作成することです。

<registries>
<registry name="osr">
<inquiryURI>http://localhost:7001/registry/uddi/inquiry</inquiryURI>
<publishURI>http://localhost:7001/registry/uddi/publishing</publishURI>
<securityURI>http://localhost:7001/registry/uddi/security</securityURI>
<credentials>
<user>admin</user>
<password>*****</password>
//To ensure security, the password must be encrypted.
//The password encryption tool (encrypt.bat/encrypt.sh), which is located in
<Oracle_home>/repositoryXXX/core/tools/solutions/11.1.1.x.x-OER-PasswordTools.zip,
allows you to encrypt
// the passwords that are stored in the Oracle Registry Repository Exchange Utility configuration (orrxu.xml) file.
</credentials>
</registry>
<registry name="osr2">
<inquiryURI>http://localhost:7201/registry/uddi/inquiry</inquiryURI>
<publishURI>http://localhost:7201/registry/uddi/publishing</publishURI>
<securityURI>http://localhost:7201/registry/uddi/security</securityURI>
<credentials>
<user>admin</user>
<password>*****</password>
//To ensure security, the password must be encrypted.
//The password encryption tool (encrypt.bat/encrypt.sh), which is located in
<Oracle_home>/repositoryXXX/core/tools/solutions/11.1.1.x.x-OER-PasswordTools.zip,
allows you to encrypt
// the passwords that are stored in the Oracle Registry Repository Exchange Utility configuration (orrxu.xml) file.
</credentials>
</registry>
</registries>

10.2.3.3 リポジトリ問合せの設定

次の構成スニペットは、Oracle Enterprise Repositoryに対して実行する問合せを作成し、Oracle Service Registryに公開する必要のあるサービスのリストを受け取る方法を示しています。これにより、Oracle Service Registryにプッシュされるサービスが問合せの形式でフィルタ処理されます。サービスに対して問合せを実行する方法はいくつか存在するため、1つ以上の問合せを作成できます。サービスに対して問合せを実行する方法をいくつか次に示します。

- 10.2.3.3.1項「名前による問合せ」

- 10.2.3.3.2項「登録ステータスによる問合せ」

- 10.2.3.3.3項「カテゴリ分けによる問合せ」

- 10.2.3.3.4項「フィルタによる問合せ」

10.2.3.3.1 名前による問合せ

<services>要素を構成すると、指定されたサービス名がOracle Service Registryに公開されます。ただし、Oracle Enterprise Repository REX APIでの制限により、追加できる<services>要素は1つのみです。

<query>
<repositoryQuery>
<services>
<service name="HelloWorld" />
</services>
<registrationStatus></registrationStatus>
<serviceCategorizations type="AssetLifecycleStage" value=""/>

名前による問合せはまた、一致するサービス名を検索するワイルドカード文字%もサポートしています。たとえば、問合せに<Service name="Hello%">が含まれる場合、名前の先頭が「Hello」であるすべてのサービスが検索されます。また、<Service name="%">の場合は、OER内のすべてのサービスが返されます。

10.2.3.3.2 登録ステータスによる問合せ

<registrationStatus>要素を構成すると、指定された登録ステータスのサービスのみ公開されます。たとえば、このフィールドをRegisteredに設定すると、登録済のサービスのみがOracle Service Registryに公開されます。一致するその他のサービスのうち、それ以外の状態のものはすべて無視されます。

<registrationStatus>Registered</registrationStatus>

登録ステータスで許容される値(大/小文字は区別されません)は、次のとおりです。

- registered

- rejected

- under_review

- pending_review

- submitted

- unsubmitted

- undefined

10.2.3.3.3 カテゴリ分けによる問合せ

<serviceCategorizations>要素を構成すると、指定されたカテゴリ分けのサービスのみ公開されます。たとえば、次のカテゴリ分けを使用すると、リリース済サービスのみがOracle Service Registryに公開されます。

<serviceCategorizations type="AssetLifecycleStage" value="Stage 4 - Release"/>

注意:

serviceCategorizationタイプは、サービス・アセットの分類で見つかったすべてのカテゴリ分けがサポートされます。次に例を示します。

<serviceCategorizations type="Classification" value="Approved"/>
<serviceCategorizations type="AssetFuntion" value="Governance"/>

10.2.3.3.4 フィルタによる問合せ

Oracle Enterprise RepositoryからUDDIレジストリに昇格されるサービスの種類を制限できます。フィルタ要素を使用すると、サービスのタイプの他に、登録ステータス、サービス・カテゴリ分け、およびエンドポイント・アセット・ライフサイクルに基づいて選択内容を絞り込むことができます。構成した場合、指定した基準を満たすサービスのみが公開されます。各<filter>要素には、type、excludeおよびvalueという3つの属性があります。

- type (必須フィールド): metadataとwsdllocationという2つのタイプのフィルタがあります。

- metadata: Oracle Enterprise Repositoryでは、サービス・アセットには複数のタイプのメタデータがあります。このデータは、メタデータ・タイプ名とフィールドのXPathに基づいてフィルタ処理できます。
1つの例としてサービス・タイプがあります。これは、ハーベスタによって作成されるすべてのサービスに適用されるメタデータの一部です。メタデータ・タイプはinternal.introspectorであり、フィールドのXPathは/sync/Service_Typeです。

フィルタのフォーマットは、次のとおりです(先頭に"metadata"が付いています)。

<filter type="metadata.internal.introspector.store/sync/Service_Type" value="Proxy Service" />

- wsdllocation: サービスをOracle Enterprise Repositoryに収集する場合、WSDLの場所はリモート・サーバーに格納することも、ローカル・ファイル情報としてOracle Enterprise Repositoryに格納することもできます。

注意:

ローカル・ファイル情報を持つサービスが公開された場合、このWSDLに関する情報はOracle Service Registryに追加されず、サービスのメタデータのみが追加されます。

- value (必須フィールド): 各タイプには独自の使用可能な値セットがあります。この値が、フィルタ処理するサービスを決定するために使用されます。

- metadata値: 許容値は、フィルタ処理するメタデータ・タイプによって異なります。次に例を示します。
Service_Type: Proxy ServiceまたはSplit-Join Service

<filter type="metadata.internal.introspector.store/sync/Service_Type" value="Proxy Service" />

Scope: globalまたはlocal

<filter type="metadata.internal.introspector.store/sync/Scope" value="global" />

localは、使用不可能なサービスを示します。

Deployment_Status: run-timeまたはdesign-time

<filter type="metadata.internal.introspector.store/sync/Deployment_Status" value="run-time" />

- wsdllocation values: remote、local。次の場合、リモートWSDLを持つサービスが公開されます。
<filter type="wsdllocation" value="remote" />

- exclude (オプションのフィールド): excludeフラグの値をtrueに設定すると、フィルタの基準を満たすサービスを除くすべてのサービスが公開されます。次の場合、ローカル・ファイル情報に格納されているWSDLを持つサービスを除くすべてのサービスが公開されます。
<filter exclude="true" type="wsdllocation" value="local" />

excludeフラグが設定されている場合、同じタイプのフィルタが複数存在できます。つまり、サービスのタイプがBusiness ServiceまたはSplit-Join Serviceである場合に検索を実行できます。ただし、excludeフラグが設定されていない場合、同じタイプの複数のフィルタが機能しません。つまり、サービスのタイプがBusiness ServiceまたはSplit-Join Serviceである場合に検索を実行することはできません。

複数のFILTER基準を結合できるのは、検索結果から基準を除外する場合のみです。EXCLUDE Business ServiceとEXCLUDE Proxy Serviceは機能します。ただし、INCLUDE Business ServiceとINCLUDE Proxy Serviceは機能しません。

例

<filter type="metadata.internal.introspector.store/sync/Service_Type" value="Business Service" />
or
<filter exclude="true" type="metadata.internal.introspector.store/sync/Service_Type" value="Business Service" />
<filter exclude="true" type="metadata.internal.introspector.store/sync/Service_Type" value="Proxy Service" />

次の例は機能しません。

<filter type="metadata.internal.introspector.store/sync/Service_Type" value="Business Service" />
<filter type="metadata.internal.introspector.store/sync/Service_Type" value="Proxy Service" />

例1

次の例は、Exchange Utilityのデフォルトの構成です。この場合、サービス・タイプがProxy Serviceでないサービス、およびリモートWSDLを持つサービスのみがOracle Service Busから公開されます。

<repositoryQuery>
<services>
<service name=" "/>
</services>
<!--Search criteria for the registration status of the service in
Oracle Enterprise Repository -->
<registrationStatus></registrationStatus>
!--Search criteria for a categorization assigned to the service in
Oracle Enterprise Repository -->
<serviceCategorizations type="AssetLifecycleStage" value=""/>
<!--Name of UDDI Registries to publish to.  This name corresponds with
UDDI Registry definitions -->
<!--below under the <registries> section -->
<destinationRegistries>
<destinationRegistry name="TEST_UDDI">
<endpointAssetLifecycleStatus></endpointAssetLifecycleStatus>
</destinationRegistry>
</destinationRegistries>
<!--Filter: identify metadata to apply filter on services to
publish-->
<filters>
<filter type="wsdllocation" value="remote" />
<filter type="metadata.internal.introspector.store/sync/Scope"
value="global" />
<filter exclude="true"
type="metadata.internal.introspector.store/sync/Service_Type" value="Proxy
Service" />
</filters>
</repositoryQuery>

例2

次の例では、リモートおよびローカルの両方で格納されたWSDLを持つサービス、およびProxy Serviceタイプのサービスのみが公開されます。

<filters>
<filter type="metadata.internal.introspector.store/sync/Service_Type" value="Proxy Service" />
</filters>

例3

次の場合、Webサービスのみが公開され、Business Service、Proxy ServiceおよびSplit-Join Serviceは除外されます。

<filters>
<filter type="metadata.internal.introspector.store/sync/Service_Type" value="Web Service" />
</filters>

10.2.3.4 宛先レジストリの設定

次の構成スニペットは、<destinationRegistries>要素を使用して、一致するOracle Enterprise Repositoryサービスを格納する1つ以上の宛先レジストリを構成する方法を示しています。各宛先レジストリには、endpointAssetLifecycleStatusプロパティが含まれる場合があります。これには、このレジストリに公開される特定のアセット・ライフサイクル・ステージ・カテゴリ分けタイプのサービス・エンドポイントをフィルタ処理する機能があります。つまり、特定のアセット・ライフサイクル・ステージ・カテゴリ分けを持つエンドポイントのみが、そのように定義されたレジストリに公開されます。endpointAssetLifecycleStatusプロパティは、オプションのプロパティです。

これらのレジストリは、Oracle Enterprise Repositoryからサービスが選択されてOracle Service Registryに移動されるとき(たとえば、Oracle Enterprise Repository > Oracle Service Registry)に使用されます。

<services>
<service name="%"/>
</services>
<destinationRegistries>
<destinationRegistry name="DEV">
<endpointAssetLifecycleStatus>Stage3- Build</endpointAssetLifecycleStatus>
</destinationRegistry>
<destinationRegistry name="PROD">
<endpointAssetLifecycleStatus>Stage4-Release</endpointAssetLifecycleStatus>
</destinationRegistry>
</destinationRegistries>

宛先レジストリを変更し、これらにendpointLifecycleStatus要素を追加します。

10.2.3.5 レジストリ問合せの設定

次の構成スニペットは、<registryQuery>要素を使用して、Oracle Service Registryに対して実行する問合せを作成し、Oracle Service RegistryからフェッチしてOracle Enterprise Repositoryに配置する必要のあるサービスのリストを受け取る方法を示しています。

<registryQuery>
<businessEntities>
<businessEntity name="Account Services"/>
</businessEntities>
<services>
<service name="AddCustomerService%" />
</services>
<qualifiers>
<qualifier>approximateMatch</qualifier>
</qualifiers>
<sourceRegistry>osr</sourceRegistry>
</registryQuery>

次の構成のガイドラインに従ってください。

- businessEntities nameまたはservice nameの値が空でないことを確認します。

- businessEntities nameには、正確な名前を指定する必要があります。

- service nameには、少なくとも1つのワイルドカード文字を使用する必要があります。たとえば、すべてのサービスを取得するには、「%」を指定します。

- Oracle Service Registry問合せの検索基準では大/小文字が区別されます。

サービスは、次の方法で検索できます。

- 1つ以上のサービス名で検索します。修飾子が不確定な場合は、サービス名をワイルドカードにすることができます。たとえば、サービス名が「Google%」の場合は、名前が「Google」で始まるサービスがフェッチされ、Oracle Enterprise Repositoryに配置されます。

- 1つ以上のビジネス・エンティティを選択します。これにより、これらのビジネス・エンティティ内のすべてのサービスがフェッチされ、Oracle Enterprise Repositoryに配置されます。ビジネス・エンティティ名には正確な名前を指定する必要があります。ワイルドカードがサポートされるのはサービスの場合のみです。ビジネス・エンティティの場合はサポートされません。

警告:

ビジネス・エンティティ問合せとサービス問合せの両方が指定される場合は、ビジネス・エンティティ問合せによってサービス問合せがオーバーライドされます。

10.2.3.6 ソース・レジストリの設定

<sourceRegistry>要素は、Oracle Enterprise Repositoryに配置するサービスの選択元のレジストリを示します。このレジストリは、Oracle Service Registryからサービスが選択されてOracle Enterprise Repositoryに移動されるとき(たとえば、Oracle Service Registry > Oracle Enterprise Repository)に使用されます。

<sourceRegistry>osr</sourceRegistry>

10.2.4 UDDIマッピング・ファイル内のOracle Enterprise Repositoryカテゴリ分けの構成

次のXMLスニペットに示すように、アセットをOracle Service Registryに公開する前に、<ExchangeUtility Tool Home>ディレクトリに格納されているUDDIマッピング・ファイル(UDDIMappings.xml)にOracle Enterprise Repositoryのカテゴリ分けがマップされます。

<uddi:uddiSettings xmlns:uddi="http://www.bea.com/aler/integration/config/uddi">
<categorizationMappings>
<categorizationType alerCategorizationTypeName="AssetLifecycleStage"
alerCategorizationTypeId="112"
uddiCategoryTModelKey="uddi:bea.com:aler:categorization:AssetLifecycleStage">
<categorization alerCategorization="Stage 1 - Propose" uddiKeyName="Stage 1
- Propose" uddiKeyValue="Stage 1 - Propose" />
<categorization alerCategorization="Stage 2 - Plan" uddiKeyName="Stage 2 -
Plan" uddiKeyValue="Stage 2 - Plan" />
<categorization alerCategorization="Stage 3 - Build" uddiKeyName="Stage 3 -
Build" uddiKeyValue="Stage 3 - Build" />
<categorization alerCategorization="Stage 4 - Release" uddiKeyName="Stage 4
- Release" uddiKeyValue="Stage 4 - Release" />
<categorization alerCategorization="Stage 5 - Target For Retirement"
uddiKeyName="Stage 5 - Target For Retirement" uddiKeyValue="Stage 5 - Target For
Retirement" />
<categorization alerCategorization="Stage 6 - Retirement" uddiKeyName="Stage
6 - Retirement" uddiKeyValue="Stage 6 - Retirement" />

Oracle Enterprise Repositoryのカテゴリ分けは、対応するマッピングがUDDIマッピング・ファイルに存在する場合にのみOracle Service Registryで受け付けられます。それ以外の場合、カテゴリ分けは単純に無視されます。そのため、Oracle Enterprise Repositoryで新しいアセット・カテゴリ分けが作成される場合は、UDDIマッピング・ファイルを再生成して、そのカテゴリ分けがOracle Service Registryで受け付けられるようにする必要があります。

10.2.5 tModelKey UDDI設定の構成

この項では、Oracle Enterprise Repositoryで新しいカテゴリ分けタイプを作成する際にtModelKey UDDI設定を構成する手順について説明します。

Oracle Service Registryによって公開された一部のサービスには、Oracle Enterprise Repositoryにプルする必要があるカテゴリ分けの形式の追加メタデータが含まれます。これにより、Oracle Enterprise Repositoryでカスタム・カテゴリ分けタイプを作成し、これらをこれらのカスタム・カテゴリ分けにバインドできます。

現在、Oracle Registry Repository Exchange Utilityでは、図10-1に示すように、Oracle Enterprise Repositoryでカテゴリ分けタイプを作成する際にtModelキーv3オプションを使用して、Oracle Service Registryのカスタム・カテゴリ分けをOracle Enterprise Repositoryのカスタム・カテゴリ分けにバインドできます。このフィールドに入力するキーは、関連するOracle Service Registryカテゴリ分けのtModelキーである必要があります。

図10-1 「カテゴリ分けの編集」ダイアログ

tModelKey UDDI設定の構成手順は、次のとおりです。

1. アセット・エディタ・ウィンドウで、「アクション」、カテゴリ分けの構成の順に選択します。「カテゴリ分けの構成」ダイアログが表示されます。これにより、Oracle Service Registryカテゴリ分けをミラー化するカスタム・カテゴリ分けタイプを作成します。

注意:

tModelキーv3フィールドはuddi:oracle.com:aia:service:lifecyclestatusに設定されます。これは、Oracle Service Registryサービス・カテゴリのtModelキー内にあるものと正確に同じものです。

2. 「追加」をクリックし、カテゴリ分けを追加します。「カテゴリ分けの追加」ダイアログが表示されます。たとえば、AIA-LifeCylceStatusカテゴリ分け設定を追加します。

3. 図10-2に示すように、「カテゴリ分けの追加」ダイアログに値を入力します。

図10-2 「カテゴリ分けの追加」ダイアログ

4. tModelキーv3フィールドの下のペインで「AIA-LifeCycleStatus」を選択し、「追加」をクリックします。「カテゴリ分けの追加」ダイアログが表示されます。

5. 図10-3に示すように、「名前」フィールドに「Active」と入力します。

図10-3 「カテゴリ分けの追加」ダイアログ

6. 「OK」をクリックします。

7. 同様に、図10-4に示すように、カテゴリ分けとして「非推奨」、「不要」および「計画済」の各値を追加します。

図10-4 「カテゴリ分けの追加」ダイアログ

8. 「OK」をクリックします。

9. アセット・エディタ・ウィンドウで、「アクション」、「タイプの管理」の順にクリックします。タイプ・マネージャ・ウィンドウが表示されます。

10. 「サービス」アセット・タイプを選択します。右側のペインに、「サービス」アセット・タイプの詳細が表示されます。

11. 「タブ」ペインで、分類を選択します。分類に対応する要素が「要素」ペインに表示されます。

12. 「要素」ペインに隣接する「追加」ボタンをクリックします。「追加する要素タイプの選択」ダイアログが表示されます。

13. 図10-5に示すように、「要素タイプ」リストから「カテゴリ分け: AIA-LifeCycleStatus」を選択します。

図10-5 「追加する要素タイプの選択」ダイアログ

14. 「OK」をクリックします。「カテゴリ分けの編集: AIA-LifeCycleStatus」ダイアログが表示されます。

15. 「OK」をクリックします。

16. 「ビューア」タブをクリックします。

17. 非表示要素ペインで、「AIA-LifeCycleStatus」を選択し、グループで表示を選択します。「要素の移動」ダイアログが表示されます。

18. 図10-6に示すように、「AIA-LifeCycleStatusの移動先」フィールドで分類を選択します。

図10-6 「要素の移動」ダイアログ

19. Exchange Utilityツールで、UDDIMappings.xmlファイルを生成します。orrxu.xmlファイルでOracle Enterprise Repositoryインスタンスへの接続情報を指定します。

20. Exchange Utilityツールから、orrxu.bat -mapをインストールします。

21. 新しく作成したOracle Enterprise Repositoryカテゴリ分けがUDDIMappings.xmlファイルに含まれることを確認します。

図10-7 UDDIMappings.xmlファイル

Oracle Service RegistryサービスがOracle Enterprise Repositoryで受け取られたら、Oracle Enterprise Repositoryサービス・アセットは、このカテゴリ分け値が設定され、Oracle Enterprise RepositoryのWeb UIに表示されるようになります。

10.2.6 Oracle Registry Repository Exchange Utilityのプロパティ・ファイルの理解

この項では、<ExchangeUtility Tool Home>ディレクトリに格納されているファイルである、プロパティ・ファイルorrxu.properties内のプロパティについて説明します。一部のプロパティはすでにOracle Enterprise Repositoryの「システム設定」に存在します。また、Oracle Registry Repository Exchange Utility用の新しいプロパティもあります。

- cmee.uddi.service.endpoint.relationship=Deployment-Deployed - サービスとエンドポイントのリレーションシップ。

- cmee.import.uddi.business.assettype=SOA - Business Entity - ビジネス・エンティティのアセット・タイプ。

- cmee.import.uddi.accesspoint.assettype=Endpoint - エンドポイントのアセット・タイプ。

- cmee.import.uddi.artifactwsdl.relationship=Sync-Defines - サービスとWSDLアーティファクトのリレーションシップ。

- cmee.import.uddi.receiver.batch.size=100 - Oracle Service Registryから受け取る場合のみ、これによってバッチ・サイズが決まります。

- cmee.import.uddi.publish.ifendpointmissing: デフォルトでは、Oracle Enterprise Repository内のサービスに1つ以上のエンドポイントがないか、既存のエンドポイントにアクセス・ポイントが無効である場合、このサービスは公開されません。この設定がtrueに設定されている場合、エンドポイントのないサービスはOracle Service Registryに公開されます。

注意:

次のプロパティは、対応するプロパティがOracle Enterprise Repositoryの「システム設定」で設定されていない場合にのみ使用されます。Oracle Enterprise Repositoryの「システム設定」プロパティが構成されている場合、その設定によってorrxu.propertiesファイルのプロパティがオーバーライドされます。

- cmee.uddi.business.service.relationship=BusinessService - サービスのアセット・タイプとビジネス・エンティティのアセット・タイプのリレーションシップ。

- cmee.import.uddi.service.assettype=Service - サービスのアセット・タイプ。

- cmee.uddi.default.business=A UDDI Node - アセットがビジネス・エンティティにリンクされず、Oracle Service Registryにサービスを公開する場合のみ。

Oracle Enterprise Repositoryのその他の「システム設定」の詳細は、『Oracle Fusion Middleware Oracle Enterprise Repositoryユーザーズ・ガイド』を参照してください。

10.2.7 XUのサポート

デフォルトでは、XUは、ハーベスタ・ソリューション・パックに用意されているアセット・タイプを使用した操作の収集によってOERで生成されたWSDLベースのHTTPサービスをOSRに公開することをサポートしています。これらのサービスはインタフェース、アーティファクト、エンドポイントおよびシステム提供のリレーションシップとともに、OSRに統合されているツール(Oracle Service Busコンソールを含む)で使用できる方法でOSRでレンダリングされます。

注意:

すべてのサービスは、特に断りのないかぎり、Oracle Service RegistryでOracle Service Busによる使用が可能です。

表10-1 収集したWSDLサービスに対するXUのサポート

サービス・タイプ/元

OER内のサービス・モデルに含まれる内容

XUによってOERからOSRに対して公開されるかどうか

注意

WSDLアタッチメントとともに収集されたWSDLベースのHTTPサービス

インタフェースにアタッチされたArtifact:WSDL

はい(WSDLにリモートURIが含まれる場合)

サービスを発行するためにエンドポイントは必要ありませんが、OSBで使用する場合はエンドポイントが必要です。

10.2.7.1 手動で作成されたサービスに対するXUのサポート

XUは、別の方法で構成すると、異なるモデルを使用して異なるソースから生成された様々な非WSDL HTTPサービス・タイプもOERでサポートできます。

表10-2 手動で作成された*サービスに対するXUのサポート

サービス・タイプ/元

OER内のサービス・モデルに含まれる内容

XUによってOERからOSRに対して公開されるかどうか

注意

アタッチメントとともに手動で作成されたWSDLベースのHTTPサービス(収集なし)

インタフェースに手動でアタッチされたArtifact:WSDL

はい(WSDLにリモートURIが含まれる場合)

サービス、インタフェース、エンドポイント、Artifact:WSDLを持つSOAモデルとこのモデルの間に一貫性がある場合、異なるアセットおよびリレーションシップをXUマッピング・ファイルで使用およびマップできます。

XSDアタッチメントとともに手動で作成された非WSDLベースのHTTPサービス

XUでマップされているリレーションシップを介してインタフェースに手動でアタッチされたArtifact:XSDまたは同様のアーティファクト。インタフェース・タイプは定義されていません。

はい(XSDにリモートURIがある場合。XSDはtModel: uddi-org:resource:type with value=xsdとして公開されます)

- OSBではXSDは使用されません。

- 入力XML/出力XMLとともにメッセージング・サービス・タイプとして公開されます。

アーティファクト(WADLを持つRESTなど)とともに手動で作成された非WSDL HTTPサービス

XUでマップされているリレーションシップを介してインタフェースにアタッチされた様々なタイプのアーティファクト(非XSD、WADLなど)

はい(アーティファクトにリモートURIがあるかぎり。アーティファクトはtModel: uddi-org:resource:type with value=xmlとして公開されます)

- OSBではXSDは使用されません。

- 入力XML/出力XMLとともにメッセージング・サービス・タイプとして公開されます。

アーティファクト(RESTなど)なしで手動で作成された非WSDL HTTPサービス

アタッチされたXSDまたは同様のアーティファクトなし

はい

入力XML/出力XMLとともにメッセージング・サービス・タイプとして公開されます。

注意:

OERで(収集なしで)手動で作成されたサービスを、Oracle Service Busで使用可能な形式でOSRに公開できるようにするには、少なくとも1つのエンドポイントおよび1つのインタフェースが必要です。

*REX APIを使用して作成されたサービスにも適用されます。

10.2.7.2 Oracle Service Busから収集された非WSDLサービスに対するXUのサポート

XUは、別の方法で構成すると、異なるモデルを使用して異なるソースから生成された様々な非WSDL HTTPサービス・タイプもOERでサポートできます。

表10-3 Oracle Service Busから収集された非WSDLサービスに対するXUのサポート

サービス・タイプ/元

OER内のサービス・モデルに含まれる内容

XUによってOERからOSRに対して公開されるかどうか

注意

WSDLアタッチメントとともにOSBで収集されたWSDLベースのHTTPサービス

インタフェースにアタッチされたArtifact:WSDL

はい(WSDLにリモートURIが含まれる場合)

OERハーベスタによって収集されたWSDLサービスと同じです。

OSBで収集された非WSDLベースのHTTPサービス

任意のXML (REST以外)

はい

OSBで収集された非WSDLベースのHTTPサービス

任意のSOAP (REST以外)

はい

OSBで収集された非WSDLベースのHTTPサービス

MFLを使用したメッセージングのみ(Artifact:MFLアタッチ済)

いいえ

- OSRでOSBによる使用は不可能です。

- MFLアーティファクトには、OERにリモートURIはありません。

OSBで収集された非WSDLベースのHTTPサービス(RESTプロキシ・サービスを含む)

MFLを除くすべてのメッセージング(Artifact:XSDを持つ場合と持たない場合あり)

はい。ただし、XSDアーティファクトはリモートURIなしでは公開されません。

OSBで収集されたREST HTTPビジネス・サービス

インタフェースにアタッチされたArtifact:XSDまたは同様のアーティファクトなし

OSRでOSBによる使用は不可能です。

注意:

サービスをOracle Service Busで使用可能な形式でOSRに公開できるようにするには、少なくとも1つのエンドポイントおよび1つのインタフェースが必要です。

XUでマップされたリレーションシップ(たとえば、インタフェースとアーティファクト間)のうち、特定のXUセッションで非WSDLサービスまたは手動で作成されたサービスの公開時に使用できるのは1つのタイプのみです。これは同時に、収集されたWSDLベースのサービスでもサポートされます。XUでは、単一指定されたシステムで提供(システム提供または手動提供)されるリレーションシップを持つ非WSDLサービスを公開できますが、一度に複数のタイプを公開することはできません。

10.2.7.3 非収集またはカスタム・アセット・タイプおよびリレーションシップを公開するためのXUの構成

XUでは、サービスおよびそのエンドポイントを構成するアセット・タイプおよびリレーションシップを定義します。たとえば、OERサービスのアセット・タイプにより、UDDIビジネス・サービスが定義されます。エンドポイント・アセットにより、アクセス・ポイントとリレーションシップDeployed-Toが定義され、2つのアセット・タイプが関連付けられます。これらのデフォルト設定を使用して、ハーベスタによって作成されたサービスがOSRに公開されます。

ただし、ハーベスタなしでサービスを作成するか、デフォルトの構成とは異なる独自のアセット・タイプおよびリレーションシップを使用する場合、OSBから収集した非WSDLベースのHTTPサービスなどのサービスをOSRに公開するには、次の構成手順に従う必要があります。

一度に公開できるサービス・アセット・タイプは1つのみです。デフォルトで定義されているものとは異なる独自のアセット・タイプおよびリレーションシップを使用する場合:

- OERでシステム設定のcmee.import.uddi.service.assettypeを変更し、カスタム・アセット・タイプを指すようにします。デフォルトでは、サービスを指していますが、目的のアセット・タイプを指すことができます。

- orrxu.propertiesを変更します。

- cmee.import.uddi.accesspoint.assettype=<custom endpoint asset type>

WSDLサービスの場合

- cmee.import.uddi.artifactwsdl.assettype=<custom artifact WSDL asset type>

注意:

このカスタム・アーティファクトWSDLタイプのNAMEは、先頭がArtifactである必要があります。

非WSDLサービスの場合

- cmee.import.uddi.definingartifact.relationship=<custom artifact asset type>

- cmee.import.uddi.artifactwsdl.relationship=<custom relationship between endpoint/interface and artifact asset>

- cmee.import.uddi.interface.service.relationship=<custom relationship between service and interface assets>

- cmee.uddi.service.endpoint.relationship=<custom relationship between service and endpoint>

収集されていないサービス

- タイプ・マネージャで、アクセス・ポイントを定義するために使用されているアセット・タイプ(即時利用可能なエンドポイント)を選択し、カスタム・データURL要素endpoint-uriを追加します。

- このendpoint-uriフィールドには、UDDIレジストリに公開するサービスのアクセス・ポイントを手動で移入する必要があります。

例10-1 WSDL内のサービス定義

<service name=”OERSearchService”>
<port name=”OERSearchPort” binding=”typens:OERSearchBinding”>                              <soap:address location=”http://api.oracle.com/search/oer”/>                     </port>      </service>

10.3 Oracle Enterprise Repository Exchange Utilityの使用

この項では、Oracle Registry Repository Exchange Utilityを使用してメタデータを同期し、Oracle Enterprise Repository内で交換されるメタデータを検索する方法について説明します。

この項には次のトピックが含まれます:

- 10.3.1項「Oracle Registry Repository Exchange Utilityの実行」

- 10.3.2項「交換されるメタデータの同期方法」

- 10.3.3項「Oracle Enterprise Repository内のOracle Service Registryの交換されるメタデータの検索」

- 10.3.4項「Oracle Registry Repository Exchange Utilityのログ・ファイルの確認」

- 10.3.5項「既知の問題」

10.3.1 Oracle Registry Repository Exchange Utilityの実行

Oracle Registry Repository Exchange Utilityは、次の構文を使用してコマンド・プロンプトから実行されます。

> orrxu.bat <options>

表10-4では、Oracle Registry Repository Exchange Utilityの実行時に使用できる構成オプションを定義しています。

表10-4 Oracle Registry Repository Exchange Utilityのコマンド行オプション

オプション

必須

動作

-mode <mode>

はい

publishまたはreceiveモードで実行するようにユーティリティを構成します。

- サービスをOracle Enterprise RepositoryからOracle Service Registryに公開するには、次を使用します。
orrxu.bat -mode publish

- Oracle Service RegistryのサービスをOracle Enterprise Repositoryで受け取るには、次を使用します。
orrxu.bat -mode receive

-config <File Name>

オプション

orrxu.xmlファイルをパラメータとして渡します。

使用例:

orrxu.bat -mode publish -config C:\rm\uddi\orrxu.xml

このパラメータを省略すると、orrxu.batファイルが保存されている現在のディレクトリから、システムのクラスパスを使用して構成XMLファイルがロードされます。

-map <Dir Name>

オプション

UDDIMappings.xmlファイルを生成します。これを行うには、Oracle Enterprise Repositoryに接続し、構成済のカテゴリ分けに基づいてこのファイルにt-modelを移入します。また、ここでは、-configパラメータを使用して、デフォルトの場所からOracle Registry Repository Exchange Utilityの構成をロードします。Oracle Service Registryにt-modelがすでに存在する場合は、このファイルをカスタマイズして、Oracle Enterprise Repositoryのカテゴリ分けをt-modelにマップできます。

使用例: orrxu.bat -map c:/rm/uddi

UDDIMappings.xmlファイルの詳細は、10.2.4項「UDDIマッピング・ファイル内のOracle Enterprise Repositoryカテゴリ分けの構成」を参照してください。

-publish_tmodel <File Name>

オプション

UDDIMappings.xmlファイルで構成されているすべてのt-modelをOracle Service Registryに公開します。Oracle Service Registryにt-modelがすでに存在する場合、そのt-modelはスキップされます。Oracle Registry Repository Exchange Utilityを使用してこれらのt-modelを移入する場合は、既存のt-modelを手動で削除する必要があります。また、ここでは、-configパラメータを使用して、デフォルトの場所からOracle Registry Repository Exchange Utilityの構成をロードします。

使用例: orrxu.bat - publish_tmodel c:/rm/UDDIMappings.xml

UDDIMappings.xmlファイルの詳細は、10.2.4項「UDDIマッピング・ファイル内のOracle Enterprise Repositoryカテゴリ分けの構成」を参照してください。

10.3.1.1 ワークフローを使用したOracle Registry Repository Exchange Utilityの起動

ワークフローを使用してOracle Registry Repository Exchange Utilityを起動すると、Oracle Enterprise RepositoryとOracle Service Registryの同期を自動化できます。

この項には次のトピックが含まれます:

- 10.3.1.1.1項「前提条件」

- 10.3.1.1.2項「タイマー・ベースのワークフローを使用した同期」

- 10.3.1.1.3項「イベントのトリガー時の同期」

- 10.3.1.1.4項「ユースケース例」

workflow.xmlファイルおよびワークフローの構成の詳細は、第A章「Oracle Enterprise Repositoryワークフローの構成」を参照してください。

10.3.1.1.1 前提条件

この項では、Oracle Registry Repository Exchange Utilityワークフローを実行する前に必要な前提条件の構成手順について説明します。

1. Oracle Registry Repository Exchange Utilityのソリューション・パック11.1.1.x.x-RR-ExchangeUtility.zipを<Oracle_HOME>\repository111\core\tools\solutionsからダウンロードします。

2. zipファイルを抽出し、ここから次のファイルを<Oracle_Home>\obpm\enterprise\server\aler_engineディレクトリにコピーします。

- plugins

- orrxu.properties

- orrxu.xml

- log4fl.properties

- types.properties

- UDDIMappings.xml

これらのファイルは、Oracle Registry Repository Exchange UtilityワークフローをOracle BPMから実行する際に必要です。

3. Oracle Service Registryインスタンスからイベントを生成したりOracle Service Registryインスタンス用のイベントを生成するOracle Enterprise Repositoryインスタンスの接続情報について、およびアセットの公開または受取りのためにorrxu.xmlを構成します。

4. ファイル内のパスワードが暗号化ツールを使用して暗号化されていることを確認します。

10.3.1.1.2 タイマー・ベースのワークフローを使用した同期

タイマー・ベースのワークフローを使用すると、Oracle Service RegistryからOracle Enterprise Repositoryへの同期、またはOracle Enterprise RepositoryからOracle Service Registryへの同期が可能になります。

表10-5は、タイマー・ベースのワークフローの名前と説明を示しています。

表10-5 タイマー・ベースのワークフロー

ワークフロー名

説明

autoSyncAlerToUddi

サービスをOracle Enterprise RepositoryからOracle Service Registryに移動します。

autoSyncUddiToAler

サービスをOracle Service RegistryからOracle Enterprise Repositoryに移動します。

タイマーは、workflow.xmlファイルのtimerIntervalの設定に基づいて起動するように構成できます。次の例は、workflow.xmlファイルで構成されているautoSyncAlerToUddiおよびautoSyncUddiToAlerワークフローを示しています。

<automation>
<autoSyncAlerToUddi configFilename="AlerToUddiSyncOrrxuConfig.xml"
mappingFileName="AlerToUddiSyncOrrxuMapping.xml" timerInterval="2d"/>
<autoSyncUddiToAler configFileName="UddiToAlerSyncOrrxuConfig.xml"
mappingFileName="UddiToAlerSyncOrrxuMapping.xml" timerInterval="3d"/>
</automation>

10.3.1.1.3 イベントのトリガー時の同期

個々のサービスとそのメタデータは、これらのサービスが登録された場合やサービスのライフサイクルが変更された場合にトリガーされるイベントをワイヤリングすることにより、Oracle Service Registryに移動できます。

サービスの移動には、PublishAssetToUDDIワークフローを使用できます。PublishAssetToUDDIワークフローは、要件に応じて任意のイベント・トリガーにワイヤリングできます。

たとえば、次の構成では、アセット・ライフサイクル・ステージがQAである場合にサービスを移動します。

<state name="urn:com:bea:aler:events:type:CategorizationChanged:AssetLifecycleStage" value ="QA">
<action>PublishAssetToUddi</action>
<alrrxConfigFileName>my_orrxu.xml</alrrxConfigFileName>
<alrrxMappingFileName>my_uddiMappings.xml</alrrxMappingFileName>
</state>

また、レジストリの実行場所に関連する構成はalrrxConfigFileNameの設定を使用して構成され、カテゴリ分けに関連するマッピング・ファイルはalrrxMappingFileNameの設定を使用して構成されます。

注意:

<alrrxConfigFileName>および<alrrxMappingFileName>に指定されているファイルは、obpm内のaler_engineフォルダ内に存在します。

異なるレジストリを指すように構成された複数の構成ファイルを使用できます。ライフサイクルによっては、アセット・ライフサイクルのトリガーに基づいて別のレジストリにサービスを移動できます。

10.3.1.1.4 ユースケース例

Oracle Enterprise Repositoryでは、自動ワークフローに対して次のユースケースをサポートします。

- 自動ワークフローでは、構成されているタイマー間隔に基づいてOracle Enterprise RepositoryとOracle Service Registryの同期を自動化できます。

- ライフサイクルに基づいてサービスを分類するために異なるレジストリが実行される場合は、公開するアセット・ライフサイクル・イベン・トリガーを適切なレジストリにワイヤリングすることで、これらのレジストリにサービスを自動的に公開できます。

- サービスがOracle Enterprise Repositoryに発行される場合は、サービスをOracle Service Registryに自動的に公開できます。サービスがOracle Enterprise Repositoryに発行されると、ワークフローによって処理されるイベントがトリガーされます。ワークフローでは、このサービスをOracle Service Registryに自動的に移動します(そのように構成されている場合)。

10.3.2 交換されるメタデータの同期方法

この項では、Oracle Enterprise RepositoryとOracle Service Registryの間でアセットが交換される場合のメタデータの同期方法について説明します。この項には次のトピックが含まれます:

- 10.3.2.1項「Oracle Enterprise RepositoryからOracle Service Registryに公開されるメタデータの同期」

- 10.3.2.2項「Oracle Service RegistryからOracle Enterprise Repositoryに移動するメタデータの同期」

10.3.2.1 Oracle Enterprise RepositoryからOracle Service Registryに公開されるメタデータの同期

この項では、Oracle Enterprise RepositoryからOracle Service Registryにアセットを公開する場合のメタデータの同期方法について説明します。内容は次のとおりです。

- 10.3.2.1.1項「ビジネス・エンティティ」

- 10.3.2.1.2項「サービス・キー」

- 10.3.2.1.3項「エンドポイント」

- 10.3.2.1.4項「カテゴリ分け」

- 10.3.2.1.5項「登録およびアクティブ・ステータス」

- 10.3.2.1.6項「Oracle Enterprise RepositoryからOracle Service Registryへのメタデータのフロー例」

注意:

以前に同期されたサービスをOracle Service Registryと同期するときに、Oracle Service Registryブラウザ・インスタンスがすでに開いている場合、Oracle Service Registryでは更新された値が表示されません。そのため、更新された値を参照するには、すべてのOracle Service Registryブラウザ・インスタンスを再起動する必要があります。

詳細は、10.3.5項「既知の問題」を参照してください。

10.3.2.1.1 ビジネス・エンティティ

公開されるサービス・アセットに、関連する(構成されたリレーションで指定されている)ビジネス・エンティティ・アセットがあるかどうかを確認します。

- 該当する場合は、構成されているリレーションを使用して、既存のビジネス・エンティティ・アセットを使用して、新しく作成されるサービス・アセットに関連付けます。

- 該当しない場合は、次に示すように、デフォルトのビジネス・エンティティ名を構成から取得します。

- デフォルトのビジネス・エンティティ・アセットがOracle Enterprise Repositoryの「システム設定」で構成されているかどうかを確認します。

- 該当する場合は、それをデフォルトのビジネス・エンティティとして使用します。

- 該当しない場合は、orrxu.propertiesファイルのデフォルトのビジネス・エンティティ名を使用します。

10.3.2.1.2 サービス・キー

Oracle Service Registryにサービスを公開すると、新しいサービス・キーが自動的に生成され、Oracle Enterprise RepositoryおよびOracle Service Registry内のサービスに割り当てられます。また、アセット・エディタを介してサービスに独自のサービス・キーを指定することもできます。

注意:

独自のサービス・キーを指定する場合、英数字および':'、'.'、'%'、'_'および'-'のみを含める必要があります。サービスがUDDIレジストリに公開されると、サービス・キーがorg.apache.axis.types.URIオブジェクトに変換されます。したがって、これはURI構文に従う必要があります。

UDDIプラグインが適用されているタイプの場合、UDDIサービス・セクションの下の「技術的」タブにある「サービス・キー」フィールドを使用できます。このフィールドに移入されている場合、サービス・キーはOracle Service Registryに同期されます。ただし、このサービスが公開された場合、このフィールドは編集できなくなります。

Oracle Enterprise Repositoryでは、サービスの公開先であるUDDIレジストリの存在により、公開済ステータスを確認します。

注意:

UDDIレジストリ表が削除機能を使用してすべてのエンドポイントまたはサービスから除去されると、サービス・キーは書込み可能になります。ただし、サービス・キーを変更し、UDDIレジストリに再公開すると、サービス・キーが同期しなくなります。これはサポートされていません。サービス・キーを変更する場合は、UDDIレジストリ内の対応するサービスを削除して再公開する必要があります。

これを確認するために、サービスに属するエンドポイント用として、UDDIレジストリが表示される表が用意されています。この表は、「技術的」タブにあります。ただし、Oracle Enterprise Repository内にローカルに格納されているWSDLによってサービスが定義される場合、エンドポイントはUDDIレジストリに公開されません。このため、この表は、「技術的」タブ内のサービス・アセットにあります。

Exchange Utility構成でエンドポイント・アセット・タイプが使用されていない場合は、UDDIレジストリ・プラグインを手動で追加する必要があります。これを行うには、タイプ・マネージャに移動し、使用されているアセット・タイプを選択します。目的のタブを選択し、「要素」の下の「追加」を選択します。リストから、「UDDIレジストリ」を選択します。また、このプラグインは必ず「ビューア」タブに追加してください。

アセット・タイプの変更の詳細は、『Oracle Fusion Middleware Oracle Enterprise Repositoryユーザーズ・ガイド』を参照してください。

10.3.2.1.3 エンドポイント

次に示すように、公開されるサービス・アセットに、1つ以上の関連するエンドポイント・アセットがあるかどうかを確認します。

- 該当する場合は、UDDIバインディング・テンプレートを作成します(初回のみ)。以前に同期されている場合は、既存のバインディング・テンプレートを更新します。UDDIアクセス・ポイントに到達するには、エンドポイント・アセットでエンドポイントURIを使用します。エンドポイント・アセットのファイル情報にアタッチされるWSDLからポートを導出します。WSDLがOracle Enterprise Repositoryにローカルで格納されている場合、Oracle Service Registry内の既存のバインディング・テンプレートは更新されません。

- 該当しない場合は、サービス・アセットのファイル情報にアタッチされるWSDLに基づいてバインディング・テンプレートを作成します(WSDLにポート情報が含まれる場合)。バインディング・テンプレートは、リモート(http://)に位置するWSDLに対してのみ作成されます。Oracle Enterprise Repositoryにローカルで格納されるWSDLは含まれません。

- アセット・ライフサイクルがエンドポイントにアタッチされる場合や、エンドポイント・アセット・ライフサイクル問合せが使用される場合は、アセット・ライフサイクルに基づいてエンドポイントをフィルタ処理します。たとえば、ステージング・エンドポイントをステージング・レジストリに公開し、本番エンドポイントを本番レジストリに公開できます。

10.3.2.1.4 カテゴリ分け

次に示すように、カテゴリ分けがサービス・アセットとエンドポイント・アセットに適用されるかどうかを確認します。

- 該当する場合は、適用される各カテゴリ分け用のカテゴリ分けマッピングをUDDIMappings.xmlファイルからロードします。

- マッピングが見つかった場合は、カテゴリ・バッグへのエントリをビジネス・サービスまたはバインディング・テンプレートに追加します。

- t-modelがOracle Service Registryに見つからない場合は、t-modelを自動的に作成します。

- 該当しない場合、カテゴリ分けはOracle Service Registryのサービスに適用されません。

10.3.2.1.5 登録およびアクティブ・ステータス

登録およびアクティブ・ステータスは、カテゴリ・バッグに追加されます。図10-8は、Oracle Service Registryで参照がどのように表示されるかを示しています。

図10-8 Oracle Service RegistryのWSDLサービスのt-modelカテゴリ

図10-9は、Oracle Enterprise Repositoryのサービスにリンクされる2つのエンドポイントがOracle Service Registryでどのように表示されるかを示しています。

図10-9 Oracle Service RegistryでのWSDLバインディング

図10-10および図10-11は、異なるエンティティとそれらのリレーションシップがOracle Enterprise Repository Navigatorでどのように表示されるかを示しています。

図10-10 Oracle Enterprise Repository Navigatorでのエンティティのリレーションシップ

図10-11 Oracle Enterprise Repository Navigatorでの別のエンティティのリレーションシップ

10.3.2.1.6 Oracle Enterprise RepositoryからOracle Service Registryへのメタデータのフロー例

図10-12は、この項で説明した、Oracle Enterprise RepositoryからOracle Service Registryへのメタデータの同期を示しています。

図10-12 Oracle Enterprise RepositoryからOracle Service Registryに公開されるメタデータのフロー

10.3.2.2 Oracle Service RegistryからOracle Enterprise Repositoryに移動するメタデータの同期

この項では、Oracle Service Registryからアセットを受け取ってリポジトリに格納する場合のメタデータの同期方法について説明します。内容は次のとおりです。

- 10.3.2.2.1項「ビジネス・エンティティ」

- 10.3.2.2.2項「エンドポイント」

- 10.3.2.2.3項「カテゴリ分け」

- 10.3.2.2.4項「Oracle Service RegistryからOracle Enterprise Repositoryへのメタデータのフロー例」

10.3.2.2.1 ビジネス・エンティティ

次に示すように、受け取るサービス・アセットが存在し、そのアセットがビジネス・エンティティ・アセットに関連付けられているかどうかを確認します。

- 該当する場合は、同じビジネス・エンティティのリレーションシップが使用されます。

- 該当しない場合は、Oracle Service Registry側のビジネス・エンティティが使用されます。Oracle Enterprise Repositoryにビジネス・エンティティが存在しない場合は、作成されます。

サービス・アセットが新しく作成される場合は、UDDIビジネス用のデフォルトのビジネス・エンティティのアセット・タイプをOracle Enterprise Repositoryの構成から取得します。

- 見つかる場合は、システム設定から

- 見つからない場合は、orrxu.propertiesファイルから

次に示すように、その名前とタイプのアセットが存在するかどうかを確認します。

- 該当する場合は、構成済のリレーションシップを使用して、その既存のアセットを新しく作成されるサービス・アセットに関連付けます。

- 該当しない場合は、新しいアセットを作成し、構成済のリレーションシップを使用して、そのアセットを新しく作成されるサービス・アセットに関連付けます。

10.3.2.2.2 エンドポイント

次に示すように、受け取るサービス・アセットに、1つ以上の関連するエンドポイント・アセットがあるかどうかを確認します。

- 該当する場合は、UUIDを使用して、エンドポイント・アセットが既存のバインディング・テンプレートと同じであるかどうかを確認します。同じ場合は、エンドポイントを更新します。

- 該当しない場合は、各バインディング・テンプレート用のエンドポイントを作成し、それらをサービス・アセットに関連付けます。

10.3.2.2.3 カテゴリ分け

次に示すように、カテゴリ分けがカテゴリ・バッグに存在するかどうかを確認します。

- 該当する場合は、適用される各カテゴリ分け用のカテゴリ分けマッピングをUDDIMappings.xmlファイルからロードします。

- マッピングが見つかった場合は、サービス・アセットのカテゴリ分けを設定します。

10.3.2.2.4 Oracle Service RegistryからOracle Enterprise Repositoryへのメタデータのフロー例

図10-13は、この項で説明した、Oracle Service RegistryからOracle Enterprise Repositoryへのメタデータの同期を示しています。

図10-13 Oracle Service Registryから受け取ったメタデータのフロー

10.3.3 Oracle Enterprise Repository内のOracle Service Registryの交換されるメタデータの検索

Oracle Registry Repository Exchange Utilityでは、公開されたサービスおよび受け取ったサービスごとに、問合せに使用できる次のような情報がタグ付けされます。

- 公開または受取りの日時

- ソースと宛先のレジストリ

公開されたサービスまたは受け取ったサービスの情報に対する問合せを実行するには、次の手順に従って、Oracle Enterprise Repositoryの「詳細な検索オプション」機能を使用します。

1. Oracle Enterprise Repository Webコンソールで、「アセット」ページを開きます。

2. サイドバーにある「検索」ボックスで、「詳細な検索オプション」リンクをクリックします。「詳細な検索オプション」ダイアログが表示されます。

3. 追加基準によるフィルタ・オプションを選択して、フィルタ処理基準の追加のオプションを表示します。

4. 「フィールドの選択」リストで、「internal.alrr.exchange.store」オプションを選択します。

5. 図10-14に示すように、「追加」ボタンの横にあるフィールドに、メタデータが交換された日付を入力します。

図10-14 「詳細な検索オプション」ダイアログ

6. ダイアログの一番下にある「検索」ボタンをクリックします。
Oracle Enterprise Repositoryの検索オプションの使用の詳細は、『Oracle Fusion Middleware Oracle Enterprise Repositoryユーザーズ・ガイド』を参照してください。

10.3.4 Oracle Registry Repository Exchange Utilityのログ・ファイルの確認

Oracle Registry Repository Exchange Utilityでは、実行される詳細なタスクのロギングにlog4jを使用します。ログ・ファイルは、<ExhangeUtility Tool Home>ディレクトリに格納されます。ロギング・オプションの変更は、<ExhangeUtility Tool Home>ディレクトリにあるlog4fl.propertiesファイルを更新して行うことができます。

10.3.5 既知の問題

この項では、Oracle Registry Repository Exchange Utilityの使用時の既知の問題について説明します。内容は次のとおりです。

- 10.3.5.1項「Oracle Service Registryサービスの再同期」

- 10.3.5.2項「サービスのOracle Service Registryへの公開」

- 10.3.5.3項「不適切なバージョンのJavaの実行」

10.3.5.1 Oracle Service Registryサービスの再同期

以前に同期されたサービスをOracle Service Registryと同期するときに、Oracle Service Registryブラウザ・インスタンスがすでに開いている場合、Oracle Service Registryでは更新された値が表示されないという既知の問題があります。そのため、更新された値を参照するには、すべてのOracle Service Registryブラウザ・インスタンスを閉じてから再起動する必要があります。

10.3.5.2 サービスのOracle Service Registryへの公開

1. サービスがOracle Enterprise RepositoryからOracle Service Registryに公開されると、Oracle Service RegistryでサービスのWSDLの場所を示すURLを開こうとするときにエラーが発生する可能性があります。
回避策:

Oracle Enterprise Repositoryコンソールのログイン先の同じブラウザ・インスタンスに、WSDLの場所を示すURLをコピー・アンド・ペーストします。

2. Oracle Enterprise Repository Registry Exchange Utilityを使用してサービスをOracle Service Registryに公開した場合、サービス・レジストリでこのサービスに対して新しいサービス・キーが生成されます。サービス・キーはすべて、サービス・アセットとすべてのサービス・レジストリ・インスタンス間で一貫性のある状態で保持されています。Oracle Enterprise Repository Exchange Utilityでは複数のレジストリに対するサービス・エンドポイントの同時公開がサポートされるため、このサービス・キーはすべてのレジストリにわたるサービスに対して一貫性のある状態で保持されます。
回避策:

ありません。

3. サービス・キーが含まれないOracle Enterprise RepositoryサービスがOracle Service Registryに発行されると、サービス・アセットのUUIDからサービス・キーが作成されます。このサービスが複数のレジストリに発行されると、このサービス・キーがすべてのレジストリにわたって保持されます。
回避策:

ありません。

10.3.5.3 不適切なバージョンのJavaの実行

Oracle Enterprise Repository Registry Exchange Utilityを実行するときに、最小限必要なJDK 1.6バージョンを使用していない場合、次のエラー・メッセージが表示されます。

Exception in thread "main" java.lang.UnsupportedClassVersionError: Bad
version number in .class file
at java.lang.ClassLoader.defineClass1(Native Method)
at java.lang.ClassLoader.defineClass(ClassLoader.java:620)
at
java.security.SecureClassLoader.defineClass(SecureClassLoader.java:124)
@         at java.net.URLClassLoader.defineClass(URLClassLoader.java:260)
@         at java.net.URLClassLoader.access$100(URLClassLoader.java:56)
@         at java.net.URLClassLoader$1.run(URLClassLoader.java:195)
at java.security.AccessController.doPrivileged(Native Method)

11 プリスクリプティブな再利用の構成

この章では、コンプライアンス・テンプレートの概要およびそのプリスクリプティブな再利用での役割について説明します。

この章の内容は、次のとおりです。

- 11.1項「概要」

- 11.2項「コンプライアンス・テンプレート・タイプの作成」

- 11.3項「コンプライアンス・テンプレートの作成」

- 11.4項「コンプライアンス・テンプレートのプロジェクトへの適用」

- 11.5項「コンプライアンス・テンプレートに関連付けられているアセット(規定のアセット)の使用」

- 11.6項「プロジェクト・コンプライアンス・レポートの実行」

11.1 概要

Oracle Enterprise Repositoryは、プロジェクトの評価に関連するステークホルダーと、プロジェクトの実装に関連する開発者の間の通信メカニズムとして機能します。ビジネス・アナリストや設計者は、プロジェクト要件の確認を担当します。このプロセスでは、これらのスタッフがプロジェクトの機能、および機能以外の要件を満たす既存のサービスや機能を特定します。

Oracle Enterprise Repositoryでは、このようなステークホルダーが、プロジェクトに関連すると考えられる既存のアセットのリストを含むコンプライアンス・テンプレートを構築します。このプロセスはプリスクリプティブな再利用と呼ばれ、請負組織にとっては特に大きな価値があります。請負組織はプロジェクトの仕様定義または入札を行いますが、入札が顧客から受諾されるのはそれから数か月後になる可能性があります。このような組織は、プロジェクト入札の際に前提を把握するための1つの方法としてコンプライアンス・テンプレートを使用できます。落札すると、関連するチームは再利用可能と想定されるアセットを把握できるようになります。

コンプライアンス・テンプレートという用語は、Oracle Enterprise Repositoryアーティファクトの特定のファミリを表します。具体的なコンプライアンス・テンプレート・タイプの例には、次のものがあります。

- プロジェクト・プロファイル

- アーキテクチャ・ブループリント

コンプライアンス・テンプレートは、アセット要件セットまたはアセット・ソリューション・セットを内部またはアウトソーシングされたプロジェクト・チームに示すために使用されます。プロジェクト・プロファイルは、通常、個々のプロジェクトに対して作成されますが、アーキテクチャ・ブループリントは複数のプロジェクトで使用できる再利用可能なソリューション・セットです。

コンプライアンス・テンプレートは通常、アセット・ポートフォリオおよびプロジェクト・ポートフォリオを担当する個人またはチームが生成します。

- プロジェクトの計画担当者がポートフォリオの各プロジェクトのプロジェクト・プロファイルを生成し、計画と見通しの概要をまとめます。

- プロジェクト設計者がプロジェクト・プロファイルを生成し、プロジェクトのビジネス要件を満たすアセットを特定します。

- 企業の設計者がアーキテクチャ・ブループリントを生成し、これによって新しいプロジェクトで使用する標準のフレームワークとサーバーを指定します。

- サービス指向アーキテクチャの担当者がアーキテクチャ・ブループリントを生成し、特定のビジネス機能を編成するサービスを特定します。

- 製品ラインの設計者がアーキテクチャ・ブループリントを生成し、これによって特定の製品ラインで使用するアセットを指定します。

以前の製品バージョンからアップグレードする場合、コンプライアンス・テンプレートのサンプルは、ポリシー管理データパックでインポート/エクスポート・ツールを使用してインストールすると取得できます。インポート/エクスポート・ツールの詳細は、『Oracle Fusion Middleware Oracle Enterprise Repositoryユーザーズ・ガイド』のインポート/エクスポート・ツールに関する項を参照してください。

11.2 コンプライアンス・テンプレート・タイプの作成

この手順は、タイプ・マネージャで実行されます。この例では、プロジェクト・プロファイルのコンプライアンス・テンプレート・タイプの作成を示します。

注意:

コンプライアンス・テンプレートを追加すると、Oracle Enterprise Repositoryシステムの構成が永続的に変更されます。

データベースの整合性を維持するため、アセットが現在関連付けられていないコンプライアンス・テンプレートのみを削除できます。

タイプ・マネージャでコンプライアンス・テンプレート・タイプが使用可能な場合は、次の手順を実行します。

1. 「ファイル」メニューで「新規」を選択します。図11-1に示すように、「新しいタイプの作成」ダイアログが表示されます。

図11-1 「新しいタイプの作成」ダイアログ

2. タイプ名テキスト・ボックスに適切な情報を入力します。

3. デフォルトのタイプ・リストでは、リストからコンプライアンス・テンプレート・タイプを選択します。

4. 「OK」をクリックします。図11-2に示すように、タイプ・マネージャのサイドバーのツリーに新しいタイプが表示されます。

図11-2 タイプ・マネージャ

タイプ・マネージャでコンプライアンス・テンプレート・タイプが使用可能でない場合は、次の手順を実行します。

コンプライアンス・テンプレートとサンプルは、Oracle Enterprise Repository Baseデータパックからインポート/エクスポート・ツールを使用して入手できます。

別の方法を使用する場合は、手動で新しいコンプライアンス・テンプレート・タイプを生成できます。

1. 「ファイル」メニューで「新規」を選択します。「新しいタイプの作成」ダイアログが表示されます。

2. タイプ名テキスト・ボックスに適切な情報を入力します。

3. デフォルトのタイプ・リストでは、リストから任意のタイプを選択します。

4. 「OK」をクリックします。タイプ・マネージャのサイドバーのツリーに新しいタイプが表示されます。

5. タイプ・マネージャで新しいコンプライアンス・テンプレート・タイプを開きます。

6. 新しいコンプライアンス・テンプレート・タイプの「エディタ」タブをクリックします。

7. 図11-3に示すように、「エディタ」タブの「一般」セクションでアーキタイプ・リストからコンプライアンス・テンプレート・タイプを選択します。

図11-3 「エディタ」タブ

8. 「ファイル」メニューの「保存」をクリックします。

9. 図11-4に示すように、「タブ」セクションにリストされているタブのいずれかを選択します。

図11-4 「タブ」セクション

そのタブに割り当てられている要素が「要素」セクションのリストに表示されます。

10. 「要素」セクションで、「追加」ボタンをクリックします。図11-5に示すように、「追加する要素タイプの選択」ダイアログが表示されます。

図11-5 「追加する要素タイプの選択」ダイアログ

11. 「追加する要素タイプの選択」ダイアログで、リストからテンプレートを適用するプロジェクトを選択します。

12. 「OK」をクリックします。追加する要素タイプの選択が閉じます。

13. 図11-6に示すように、プロンプトに従って新しい要素のラベルを入力します。

図11-6 「テンプレートを適用するプロジェクトの編集」ダイアログ

14. 「OK」をクリックします。「要素」セクションのリストに新しい要素が表示されます。

15. 「ファイル」メニューの「保存」をクリックします。

16. 新しいコンプライアンス・テンプレート・タイプの「ビューア」タブをクリックします。

17. 図11-7に示すように、非表示要素のリストで新しい要素を検索し、選択します。

図11-7 非表示要素セクション

18. グループで表示ボタンをクリックします。図11-8に示すように、「要素の移動」ダイアログが表示されます。

図11-8 「要素の移動」ダイアログ

19. 「要素の移動」ダイアログ内のリストを使用して、新しい要素の場所を選択します。

20. 「OK」をクリックします。「ビューア」タブの「要素」セクションのリストに新しい要素が表示されます。

図11-9 「要素」セクション

21. 「ファイル」メニューの「保存」をクリックします。

11.3 コンプライアンス・テンプレートの作成

この手順はアセット・エディタで実行するものであり、『Oracle Fusion Middleware Oracle Enterprise Repositoryユーザーズ・ガイド』で説明されている、高度なアセット発行に非常に類似しています。

1. 「ファイル」メニューで「新規」を選択します。図11-10に示すように、「アセットの新規作成」ダイアログが表示されます。

図11-10 「アセットの新規作成」ダイアログ

2. 「名前」テキスト・ボックスと「バージョン」テキスト・ボックスに適切な情報を入力します。

3. 「タイプ」のリストから適切なテンプレートを選択します。

4. 「OK」をクリックします。図11-11に示すように、新しいコンプライアンス・テンプレートがアセット・エディタに表示されます。

図11-11 アセット・エディタ

5. 分類タブをクリックし、「リレーションシップ」のセクションで「追加」をクリックしてリレーションシップを追加します。

6. プロジェクトで使用する必要のあるアセットを選択します。

7. 適切なリレーションシップ(規定のアセット、規定のプロセス、および規定の環境)をそれぞれ割り当てます。

8. アセット・エディタで「ファイル」メニューの「保存」をクリックします。

レビューと登録を行うアセットが発行されます。

詳細は、『Oracle Fusion Middleware Oracle Enterprise Repositoryユーザーズ・ガイド』の登録プロセスに関する項を参照してください。

この手順を実行して、プロジェクト・プロファイル、アーキテクチャ・ブループリント、またはその他の種類のコンプライアンス・テンプレートを作成します。

11.4 コンプライアンス・テンプレートのプロジェクトへの適用

この手順は、Oracle Enterprise Repositoryの「アセット」画面で開始されます。

1. 「検索」または他の方法を使用して、プロジェクトに適用するコンプライアンス・テンプレートを特定します。(「検索」セクションの「タイプ」リストから目的のコンプライアンス・テンプレートを選択し、検索結果をフィルタ処理します。)

2. プロジェクトに適用をクリックします。図11-12に示すように、「プロジェクトに適用」ダイアログが表示されます。

図11-12 「プロジェクトに適用」ダイアログ

3. すべてのプロジェクトをリストをクリックするか「検索」を使用して、プロファイルの適用先のプロジェクトを見つけます。使用可能なプロジェクト列にリストが表示されます。

4. プロファイルの適用先のプロジェクトを選択します。

5. 右向き矢印ボタンをクリックし、使用可能なプロジェクト列から適用先プロジェクト列にプロジェクトを移動します。プロジェクトが使用可能なプロジェクトから適用先プロジェクトに移動します。

6. 「保存」をクリックします。図11-13に示すように、確認ダイアログが表示されます。

図11-13 プロジェクトに適用確認ダイアログ

7. 「閉じる」をクリックします。

8. Oracle Enterprise Repositoryのメニュー・バーで「プロジェクト」リンクをクリックします。「プロジェクト」画面が表示されます。

9. 「検索」または他の方法を使用して、プロジェクト・プロファイルを適用したコンプライアンス・テンプレートを特定します。

10. 「プロジェクトの詳細」でコンプライアンス・テンプレート・タブをクリックします。適用したコンプライアンス・テンプレートがコンプライアンス・テンプレート・タブにリストされます。

注意:

Eclipseまたは.Netのエンタープライズ・リポジトリ・プラグインがインストールされている場合、コンプライアンス・テンプレートで識別されたアセットも自動的にプロジェクトの開発環境に表示されます。

11.5 コンプライアンス・テンプレートに関連付けられているアセット(規定のアセット)の使用

コンプライアンス・テンプレートは、そのコンプライアンス・テンプレートが適用されるプロジェクトに固有のアセットの規定に使用できます。この項では、規定アセットを使用するプロセスについて簡単に説明します。

この手順は、Oracle Enterprise Repositoryの「プロジェクト」画面で開始されます。

1. 図11-14に示すように、「検索」または他の方法を使用してプロジェクトを見つけます。

図11-14 「プロジェクト」画面

2. プロジェクトに適用されるコンプライアンス・テンプレートは、図11-15に示すように、プロジェクト詳細のコンプライアンス・テンプレート・セクションにリストされます。

図11-15 コンプライアンス・テンプレート

3. リストされているコンプライアンス・テンプレート名の右側にあるアセットの使用をクリックします。図11-16に示すように、「使用 - ダウンロード」ダイアログが表示されます。

図11-16 「使用 - ダウンロード」ダイアログ

注意:

プロジェクトに割り当てられているユーザーにのみ「アセットの使用」ボタンが表示されます。

4. 「使用」列のオプションを使用して、ダウンロードするアセットを選択します。

5. 「次」ボタンをクリックします。図11-17に示すように、使用/ダウンロード・ダイアログでアセットの選択を確認します。

図11-17 「使用 - ダウンロード」ダイアログ

6. 下向き矢印をクリックして、選択したアセットのペイロードをダウンロードします。

7. 終了したら、「閉じる」をクリックします。ダウンロードしたアセットは、図11-18に示すように、プロジェクト詳細の使用されるアセット・セクションにリストされます。

図11-18 「使用されるアセット」タブ

規定アセットは、VS .NetおよびEclipseの環境でも使用されます。プロセスの詳細は、『Oracle Fusion Middleware Oracle Enterprise Repository統合ガイド』のVS .NETおよびEclipseに関する項を参照してください。

11.6 プロジェクト・コンプライアンス・レポートの実行

プロジェクト・コンプライアンス・レポートでは、コンプライアンス・テンプレートの使用に対して規定されているアセットへのプロジェクトの準拠を検証する手段を提供しています。

この手順は、Oracle Enterprise Repositoryの「レポート」画面で実行します。

1. 図11-19に示すように、「レポート」サイドバーのプロジェクト・コンプライアンス・リンクをクリックします。

図11-19 「レポート」セクション

図11-20に示すように、プロジェクト・コンプライアンスのレポート・フォームがメイン・ペインで開きます。

図11-20 プロジェクト・コンプライアンスのレポート・フォーム

2. 「日付範囲」、「ソート順」、および「出力形式」リストを使用してレポート・パラメータを設定します。

注意:

「日付範囲」はプロジェクト作成日を基準とします。

3. 「レポートの実行」ボタンをクリックします。レポートは選択した形式で表示され、図11-21に示すように、各プロジェクトをリストし、使用中のコンプライアンス・テンプレート、規定アセット、規定アセットの使用ステータス、およびプロジェクトで使用されるその他のアセットを示します。

図11-21 プロジェクト・コンプライアンスのレポート

12 進行中のアセットの構成

この章では、開発中でも使用可能なアセットの進行状況と可用性を追跡する、進行中のアセット機能の使用方法について説明します。

この章は次の項で構成されています:

- 12.1項「概要」

- 12.2項「進行中のアセットの表示」

- 12.3項「進行中のアセットの有効化」

- 12.4項「進行中のアセットの無効化」

- 12.5項「IDEによる進行中のアセットの表示の有効化」

12.1 概要

Oracle Enterprise Repositoryの進行中のアセット機能では、ユーザーが開発途中のアセットの進行状況と可用性を追跡できます。これにより、組織はコラボレーション・プロセスでアセットの作成者、コンシューマ、およびメンテナンス・チームを展開して複合的な生産性の増大を実現し、ソフトウェア・エンジニアリングの自然な経過におけるアセット・ポートフォリオの価値を高めることができます。この機能により、組織は余分な開発が行われる前にこれを排除できます。開発途中のアセットを公開することにより、プロジェクト計画の段階でプロジェクトにこれらのアセットの使用を含めることができるため、余分な開発による無駄な時間と労力を回避できます。

進行中のアセットはOracle Enterprise Repositoryでは登録解除済アセットとして表示されます。進行中のアセットの実際の「登録状態」(検索結果およびアセット詳細の「ステータス」列に表示される)は、アセット発行時に決定されます。

進行中のアセット機能が有効な場合は、Oracle Enterprise Repositoryの「アセット」画面の「アセットの発行」リンクから発行されるアセットに「登録解除」ステータスが自動的に割り当てられます。検索では、登録解除済アセットとしてフィルタ処理されます。

図12-1 Oracle Enterprise Repositoryの「アセット」画面

図12-1はOracle Enterprise Repositoryの「アセット」画面を示します。「アセットの発行」で発行したアセットは、図12-2に示すように、アセット・エディタのファイル・ツリーで「発行済 - レビュー保留中」フォルダに入力されます。

図12-2 アセット・エディタ - ファイル・ツリー

アセット・エディタで発行したアセットは、図12-3に示すように、初期状態リストで未発行または「発行済 - レビュー保留中」を指定できます。

図12-3 アセットの新規作成

いずれかの状態のアセットが、Oracle Enterprise Repositoryに登録解除済アセットとして入力され、登録解除済アセットでフィルタ処理され検索に表示されます。

12.2 進行中のアセットの表示

すべての進行中のアセットのリストを表示します。

この手順は、Oracle Enterprise Repositoryの「アセット」画面で実行されます。

1. 「検索文字列の入力」テキスト・ボックスは空白のままにします。

2. 「タイプ」リストで「すべてのタイプ」を選択します。

3. アセット機能リストですべてのアセット機能を選択します。

4. 図12-4に示すように、「登録状態」リストから「登録解除」を選択します。

図12-4「検索」ダイアログ

5. 「検索」をクリックします。進行中のアセットのすべてのリストがメイン・ペインの上部のフレームに表示されます。

12.3 進行中のアセットの有効化

進行中のアセットを有効にするため、2つのプロパティを有効化する必要があります。この手順は、Oracle Enterprise Repositoryの「管理」画面で実行します。

1. 左のペインで「システム設定」をクリックします。

2. 「検索」フィールドにAssets in Progressを入力します。図12-5に示すように、機能設定ペインに「進行中のアセット」設定が表示されます。

3. プロパティがTrueに設定されていることを確認します。

4. 「保存」をクリックします。

5. 「新しいシステム設定の有効化」テキスト・ボックスにcmee.asset.in-progress.visibleプロパティを入力します。

6. 「有効化」をクリックします。図12-5に示すように、機能設定ペインに「進行中のアセットの表示」プロパティが表示されます。

図12-5 進行中のアセットのプロパティ

7. プロパティがTrueに設定されていることを確認します。

8. 「保存」をクリックします。図12-6に示すように、「登録状態」リストがOracle Enterprise Repositoryの「アセット」画面の「検索」セクションに表示されます。

図12-6「検索」ダイアログ

12.3.1 デフォルトのアセット・ステータスの設定

oer.newasset.initial.stateを有効にしてデフォルトのアセット・ステータスを設定します。

1. 新しいシステム設定の有効化テキスト・ボックスにoer.newasset.initial.stateプロパティを入力します。

2. 「有効化」をクリックします。

3. 使用可能なステータス・オプションを1つ選択し、「保存」をクリックします。

12.4 進行中のアセットの無効化

この手順は、Oracle Enterprise Repositoryの「管理」画面で実行します。

注意:

進行中のアセット機能を無効にすると、アセット・エディタで未発行状態のアセットにアクセスできなくなります。アセット・エディタで「発行済 - レビュー保留中」状態のアセットは引き続きアクセス可能です。進行中のアセットを無効にする前に、必要なアセットをすべて未発行から「発行済 - レビュー保留中」に昇格しておくことをお薦めします。

1. 「システム設定」をクリックします。

2. メイン・ペインの設定リストにある進行中のアセットを見つけます。

3. 「進行中のアセット」プロパティをFalseに設定します。

4. メイン・ペインの設定リストにある進行中のアセットの表示を見つけます。

5. 進行中のアセットの表示プロパティをFalseに設定します。

6. 「保存」をクリックします。

12.5 IDEによる進行中のアセットの表示の有効化

Oracle Enterprise RepositoryのオープンAPI (Oracle Enterprise Repository Extensibility Frameworkの一部)では、IDEでの検索結果に登録済および登録解除済の両方のアセットが表示されるようにできます。

必要なプロパティは、Oracle Enterprise Repositoryの「管理」ページで次の手順を実行すると有効化できます。

1. 左のペインで「システム設定」をクリックします。

2. 「新しいシステム設定の有効化」テキスト・ボックスにプロパティcmee.asset.in-progress.openapi.visibleを入力します。

3. 「有効化」をクリックします。図12-7に示すように、進行中のアセットの表示 - オープンAPIがメイン・ペインのプロパティのリストに表示されます。

図12-7 進行中のアセットの表示

4. プロパティがTrueに設定されていることを確認します。

5. 「保存」をクリックします。

13 使用状況の自動検出の構成

この章では、Oracle Enterprise Repositoryでのアセット使用を自動的に増分するSoftware File Identification (SFID)とその使用方法について説明します。

この章には、次のセクションがあります。

- 13.1項「概要」

- 13.2項「SFIDの有効化」

- 13.3項「タイプへのSFID要素の追加」

- 13.4項「アセットへのSFIDの追加」

- 13.5項「SFIDツール・キット」

- 13.6項「SFIDマネージャ」

- 13.7項「プログラムによるSFIDの計算」

- 13.8項「SFIDの制限事項」

13.1 概要

Oracle Enterprise Repositoryでは、複数の方法でアセットの使用状況を追跡できます。Oracle Enterprise Repositoryは開発者に対して可能なかぎりガバナンスをシームレスにしているため、使用状況の自動検出(SFID)をEclipse環境および.Net環境から使用できます。このような環境では、開発者はwsdl、スキーマ、または他のアーティファクトのコピーを受け取ります。組織でこのようなアーティファクトの使用状況を自動的に追跡する場合、Oracle Enterprise RepositoryではこれにSFIDのタグを付けます。開発者の環境にアーティファクトが表示されると、Oracle Enterprise Repositoryでそのアーティファクトが認識され、使用状況が増分されます。つまり、開発者がリポジトリからアーティファクトを取り込む必要がありません。これはデスクトップから、またはバージョン制御システムから取り込めます。Oracle Enterprise Repositoryではソースに関係なく、合致を認識し、使用状況を増分します。使用状況追跡は、Oracle Enterprise Repositoryが再利用ROIの生成に使用する主なメソッドです。

Software File Identification (SFID)は、Oracle Enterprise Repositoryの手動のアセット(「使用 - ダウンロード」プロセス)とは別のアセットの使用状況を判断する機能を提供します。SFIDプロセスは、アセット内で選択したファイルを一意のSFIDフィンガープリントとタグ付けします。アセットがOracle Enterprise Repositoryの「使用 - ダウンロード」ボタン以外の方法で取得された場合でも、このタグは、アセットが使用された時間と場所を検出するために使用されます。アセット内でタグ付けされたファイルを開発者のIDEで開いたときに、使用状況のインスタンスがOracle Enterprise Repositoryによって記録されます。

SFIDでは、Eclipse用またはVisual Studio .NET用のOracle Enterprise Repositoryプラグインのインストールが必要です。サポートされているIDEからのリポジトリ・アクセスの機能の詳細は、次のドキュメントを参照してください。

- 『Oracle Fusion Middleware Oracle Enterprise Repository統合ガイド』のWorkSpace Studioを使用したEclipseでのリポジトリ・アクセスに関する項

- 『Oracle Fusion Middleware Oracle Enterprise Repository統合ガイド』のVisual Studio .NETとのOracle Enterprise Repositoryの統合に関する項

13.2 SFIDの有効化

この手順は、Oracle Enterprise Repositoryの「管理」画面で実行します。

1. 左のペインで「システム設定」をクリックします。

2. 「新しいシステム設定の有効化」テキスト・ボックスに「cmee.usagedetection.enable」と入力します。

3. 「有効化」をクリックします。図13-1に示すように、メイン・ペインのプロパティ・リストに「使用状況の自動検出の有効化」オプションが表示されます。

図13-1 機能設定

4. プロパティがTrueに設定されていることを確認します。

5. 「保存」をクリックします。これで、SFIDが有効になりました。

- 新しくSFID要素がタイプ・マネージャのタイプに追加されます。

- SFID要素がアセット・タイプに追加されると、アセット・エディタでそのタイプを表示したときにSFIDのセクションがアセットに表示されるようになります。そのセクション内では、ファイルをSFIDフィンガープリントに選択できます。

図13-2 使用状況の自動検出の構成

- SFID機能は現在、Oracle Enterprise Repository REXで使用可能です。

注意:

REXの詳細は、『Oracle Fusion Middleware Oracle Enterprise Repository統合ガイド』のリポジトリ拡張性フレームワークに関する項を参照してください。

13.3 タイプへのSFID要素の追加

SFID要素をタイプに追加すると、そのタイプのアセットを自動的に検出できるようになります。

注意:

また、SFIDを追跡対象の個々のアセットに追加する必要があります。

この手順は、タイプ・マネージャで実行されます。

1. 図13-3に示すように、SFID要素を追加するタイプを選択します。

図13-3 タイプ・マネージャ・ウィンドウ

2. デフォルトでは「エディタ」タブが表示されます。表示されない場合は「エディタ」タブをクリックします。

3. 図13-4に示すように、「タブ」セクションのリストから、SFID要素を追加するタブを選択します。

図13-4 「タブ」リスト

そのタブの要素のリストが「要素」セクションに表示されます。

4. 「要素」セクションで、「追加」ボタンをクリックします。「追加する要素タイプの選択」ダイアログが表示されます。

5. 図13-5に示すように、「要素タイプ」リストから「SFID」をクリックします。

図13-5 「追加する要素タイプの選択」ダイアログ

6. 「OK」をクリックします。図13-6に示すように、「追加する要素タイプの選択」ダイアログが終了し、「使用状況の自動検出の編集」ダイアログが表示されます。

7. SFID要素名を入力します。

図13-6 「使用状況の自動検出の編集」ダイアログ

8. 「OK」をクリックします。図13-7に示すように、「要素」セクションに新しい要素がリストされます。

図13-7 「要素」セクション

9. 「ファイル」、「保存」をクリックして変更したアセット・タイプを保存します。

10. タイプ・マネージャを終了します。

11. アセット・エディタでは、SFID要素を追加したタイプのアセットを開きます。
「SFID」セクションがその割当先のタブに表示されます。

13.4 アセットへのSFIDの追加

IDEを介してアセットを追跡するには、そのアセットを表す一意のアーティファクト・ファイルを選択します。ファイルにはSFIDが割り当てられ、IDEプロジェクトでそのファイルが検出されるたびに使用状況が増分されます。この手順は、アセット・エディタで実行されます。

1. SFIDが追加されるアセットを選択します。

2. 「使用状況の自動検出」セクションで、「追加」ボタンをクリックします。

3. 図13-8に示すように、「追加」ダイアログのリストからフィンガープリントするファイルを選択します。

図13-8 「追加」ダイアログ

4. 「OK」をクリックします。
選択したファイルがダウンロードされ、SFIDが計算され、その後、ファイルのローカルの(ダウンロードした)コピーが削除されます。選択したファイルのフィンガープリントが失敗した場合は、警告メッセージが表示されます。

13.4.1 SFIDファイルの更新

この手順は、アセット・エディタで実行されます。

1. 「使用状況の自動検出」セクションのリストから更新するSFIDファイルを選択します。

2. 「更新」ボタンをクリックします。更新の進捗を示す「操作の実行」ウィンドウが表示されます。

13.4.2 SFIDファイルの削除

この手順は、アセット・エディタで実行されます。

1. 「使用状況の自動検出」セクションのリストから削除するSFIDファイルを選択します。

2. 「削除」ボタンをクリックします。ファイルがリストから削除されます。

13.5 SFIDツール・キット

SFIDツール・キットでは、サード・パーティ開発者向けに、SFID候補を発行するためにOracle Enterprise RepositoryのREXサブシステムと統合するアプリケーションを開発できるフレームワークを提供します。SFIDツール・キットでは、指定されたディレクトリの各ファイルにSFID候補を作成し、そのSFID候補を保管および分析するためにOracle Enterprise Repositoryシステムに発行するアプリケーションを提供します。

注意:

REXサブシステムの詳細は、『Oracle Fusion Middleware Oracle Enterprise Repository統合ガイド』のサブシステムの概要に関する項を参照してください。

SFIDの計算に関する注意点

- ファイルにASCIIコード128を超える文字がない場合、そのファイルはテキスト・ファイルとみなされます。

- テキスト・ファイルの内容はSFIDハッシュの計算前に正規化されます。

- CR、LF、およびタブ文字はすべて除去されます。

- テキストはすべて小文字に変換されます。

- XMLファイルはW3C正規化標準(http://www.w3.org/TR/xml-c14n)によりSFIDハッシュの計算前に正規化されます。

13.5.1 インストールおよび構成

この項では、SFIDツール・キットのインストールと構成の手順について説明します。この項には次のトピックが含まれます:

- 13.5.1.1項「認識されないSFIDの収集の有効化」

- 13.5.1.2項「オブジェクト・モデル」

- 13.5.1.3項「サンプル・ディレクトリ・クローラの説明」

13.5.1.1 認識されないSFIDの収集の有効化

組織によっては、デプロイされたSOAアセットがすべてOracle Enterprise Repositoryに存在することが必須条件になります。企業は認識されないSFIDを収集し、この条件への準拠をモニターできます。たとえば、企業は認識されないSFIDのビルド・スクリプトをモニターできます。さらに、サービス・モニタリング・ツールではOracle Enterprise Repositoryに存在しないサービスを検出できます。このような「規定外のサービス」はSFIDに割り当てられ、アセットの候補としてOracle Enterprise Repositoryに収集されます。Oracle Enterprise Repositoryへ収集されたサービスは、詳細に評価され、処理されます。

この手順は、Oracle Enterprise Repositoryの「管理」画面で実行します。

1. 左のペインで「システム設定」をクリックします。メイン・ペインに「システム設定」ページが表示されます。

2. 「新しいシステム設定の有効化」テキスト・ボックスに「cmee.sfid.harvesting.enable」と入力します。

3. 「有効化」ボタンをクリックします。システム設定のリストに「認識されないSFID収集の有効化」プロパティが表示されます。

図13-9 認識されないSFID収集の有効化

4. プロパティがTrueに設定されていることを確認します。

5. 「保存」をクリックします。これで、プロパティが有効になりました。

13.5.1.2 オブジェクト・モデル

図13-10はSFIDのオブジェクト・モデルを説明しています。

図13-10 オブジェクト・モデル

13.5.1.3 サンプル・ディレクトリ・クローラの説明

- 指定したフォルダ内のすべてのファイルとフォルダを反復処理します。

- 各候補に対してSFIDCandidateをインスタンス化します。

- パスおよびsfidなどの一般的なメタデータを移入します。
それぞれのSFIDCandiateに、Eclipse Workspaceなど、取得する任意のデータを示すSFIDAttributesを作成します。

- SFIDCandidateオブジェクトの配列を渡し、Oracle Enterprise Repository REXメソッドsfidCandidateSubmitを呼び出します。

- AlerUtilオブジェクト

- AlerUtilオブジェクトをインスタンス化してOracle Enterprise Repositoryに接続します。

String lUrl = "http://localhost:9080/oer/services/FlashlineRegistry";
String lUserName = "username";
String lPassword = "password";
lAlerUtil = new AlerUtil(lUrl, lUserName, lPassword);

- AlerUtilオブジェクトを使用してOracle Enterprise Repository REXメソッドを呼び出します。

lAlerUtil.getFlashlineRegistry().sfidCandidateSubmit(lAlerUtil.getAuthToken(), lSfidCandidates);

- AlerUtilオブジェクトは一連の便利なメソッドを提供します。

- getAuthToken
現在のユーザー名およびパスワードの有効なauthTokenを取得します。authTokenが失効した場合は、新しいauthTokenを取得します。そうでない場合は、UserValidationExceptionがスローされます。

- calculateSfidValue
ファイルまたはパスのSFIDを計算し、ハッシュを文字列として返します。

- sfidCandiateListToArray
リストのSFIDCandidatesを配列のSFIDCandidatesに変換します。

- sfidAttributeListToArray
リストのSFIDAttributesを配列のSFIDAttributesに変換します。

- sfidAttributeValueListToArray
リストのSFIDAttributeValuesを配列のSFIDAttributeValuesに変換します。

- createCandidate(File)
ファイルに標準のSFIDCandidateを作成します。SFIDCandidateフィールドのファイルパス、ホストIP、ホスト名およびSFIDが事前移入されます。Filelengthという名前のファイル長の値を保持するSFIDAttributeがSFIDCandidateにアタッチされます。

- createCandidate(File, Map)
createCandidate(File)メソッドの指定に従って、ファイルの標準のSFIDCandidateを作成します。マップのそれぞれの(文字列)キー/(文字列)値により、このキーと値に一致する追加のSFIDAttributeがSFIDCandidateにアタッチされます。

- createCandidate(File, List)
createCandidate(File)メソッドの指定に従って、ファイルの標準のSFIDCandidateを作成します。リストで渡されたそれぞれのSFIDAttributeをSFIDCandidateにアタッチします。

- sendCandidate
収集対象となる単一のSFIDCandidateを送信します。

- sendCandidates
収集対象となるSFIDCandidatesのリストを送信します。

13.6 SFIDマネージャ

SFIDマネージャでは、Oracle Enterprise Repositoryで収集されたSFID候補を簡単に表示する方法を提供します。

SFIDマネージャを使用するには、システム管理者権限が必要です。

この項には次のトピックが含まれます:

- 13.6.1項「SFIDマネージャの有効化」

- 13.6.2項「SFIDマネージャの使用」

13.6.1 SFIDマネージャの有効化

この手順は、Oracle Enterprise Repositoryの「管理」画面で実行します。

1. 左のペインで「システム設定」をクリックします。図13-11に示すように、メイン・ペインに「システム設定」ページが表示されます。

図13-11 Oracle Enterprise Repositoryの「システム設定」ページ

2. 「新しいシステム設定の有効化」テキスト・ボックスに「cmee.sfid.harvesting.enable」と入力します。

3. 「有効化」ボタンをクリックします。図13-12に示すように、SFIDマネージャがシステム設定のリストに表示されます。

図13-12 SFIDマネージャ

4. 「True」オプションが選択されていることを確認します。

5. 「保存」をクリックします。

6. Oracle Enterprise Repositoryのメニュー・バーの「管理」をクリックして「管理」画面をリフレッシュします。
左側のペインにSFIDマネージャ・セクションが表示されます。

13.6.2 SFIDマネージャの使用

この手順は、Oracle Enterprise Repositoryの「管理」画面で実行します。

1. 左側のペインのSFIDマネージャをクリックします。

2. 図13-13に示すように、SFIDマネージャ・セクションのすべてをリストをクリックして、使用可能なSFID候補のリストを表示します。

図13-13 SFIDマネージャ

この操作が完了するまでの時間は、使用可能な候補の数によって決まります。SFID候補は、SFIDマネージャの検索機能を使用して探すこともできます。検索された候補は、図13-14に示すように、メイン・ペインの上部にリストされます。

図13-14 「名前」 - 「SFID」リスト

リストされているSFIDが検出された回数(出現回数)が#列に表示されます。

3. 図13-15に示すように、リストされた任意の候補をクリックし、メイン・ペインの下部に詳細情報を表示します。

図13-15 SFID候補のプロパティ

表示される情報は、すべての候補に共通の一連の主要な属性で構成されます。

- 表示名
候補の名前です。通常は、単純なファイル名です。

- 生成者
候補を生成したユーザーのユーザー名です。

- 生成日
候補を作成した日付です。

- 更新日
前回データベース内で候補レコードを変更した日時です。

- ファイル・パス
候補を収集したマシン上のファイルへの絶対パスです。

- ホスト名/IP
候補を収集したマシンのホスト名またはIPアドレスです。

- 出現回数
このコンテキストで、この候補が表示された回数です。このメトリックはファイル使用の頻度を示し、このコンテキスト内でのファイル値の指標を示します。

- ソース
Eclipse、Antなどのコンテキストの説明です。

表示には一連の詳細な属性も含まれ、それらは候補の収集元となったコンテキストに基づいて異なります。

13.7 プログラムによるSFIDの計算

ArtifactFingerprinter javaライブラリは、クライアント側のコードでSFIDフィンガープリントをプログラムによって計算する機能を提供します。

インストール

components-flashtrax.jarファイルがあり、それがインストールのjavaクラスパス内にあることを確認します。

使用方法

com.oracle.artifact.ArtifactAlgorithmクラスには、複数の静的インスタンスがあり、それぞれが特定のファイル・タイプのフィンガープリント・アルゴリズムをカプセル化します。

サポートされているアルゴリズム

- DEFAULT: ファイルの内容に基づくフィンガープリントで、変換はありません。

- XML: XMLコンテンツを正規化して空白スペースを削除し、ネームスペース略称を正規化します。

- XSD: XMLと同様のものにXSDインポートとインクルードをインライン化します。

- WSDL: XSDと同様のものにWSDLインポートとインクルードをインライン化し、ドキュメントを削除し、WSDL要素を名前順に並べ替えます。

- WSDL_ABSTRACTING: WSDLと同様のもので、エンドポイントとバインド情報を削除します。

例

プログラムによるSFIDの計算を示す例は次のとおりです。

ArtifactFingerprinter fp = ArtifactAlgorithm.WSDL.newFingerprinter();

String sfid = fp.getFingerprint(new File("mytest.wsdl"));

13.8 SFIDの制限事項

SFIDシステムの制限事項は、次のとおりです。

- SFIDを生成するには、ファイルがアクセス可能である必要があります。
クライアント・マシン/ユーザーにはファイルへのパス(URI)を提供する必要があります。URIは認証情報のリクエストなど)ユーザーの介入なしでクライアント・システムからアクセス可能である必要があります。

- SFIDはファイル(1:1)に関連付けられ、ファイルはアセット(n:n)に関連付けられます。

- SFIDはアセット・エディタまたはREXを介してファイルに追加できます。

- SFIDはOracle JDeveloperでサポートされていません。VS .NetおよびEclipseでのみサポートされます。

アセット・エディタの制限事項(SFID生成)

- SFIDは抽出可能なファイルにのみ関連付けられます。

- SFIDはクライアントにアクセス可能なファイルに対してのみ生成できます。

ANT統合の制限事項(SFID比較)

- SFIDはアクセス可能なすべてのファイルに対して(比較用に)生成できます。

14 ポリシー管理の構成

この章では、ポリシー管理の様々な局面と、Oracle Enterprise Repositoryでのポリシーの使用方法について説明します。

この章には次の項が含まれます:

- 14.1項「概要」

- 14.2項「ポリシー管理機能のアクティブ化」

- 14.3項「ポリシー・タイプの作成」

- 14.4項「ポリシー・タイプへのポリシー・アサーション要素の追加」

- 14.5項「ポリシーの作成」

- 14.6項「タイプへの適用対象アセット・ポリシー要素の追加」

- 14.7項「アセットへのポリシーの適用」

- 14.8項「ポリシー・ステータスの表示」

- 14.9項「ポリシー・アサーションの検証」

- 14.10項「Oracle Enterprise Repositoryポリシー・レポートの実行」

14.1 概要

ポリシーは、設計および開発の段階で考慮する必要があるアセットの要件を示し、管理者にガバナンス、アーキテクチャおよびその他の組織の標準にアセットを準拠させ、これを実施およびモニターする手段を提供するために、アセットに適用されます。たとえば、アセットを実行するプラットフォームや許容される不具合密度レートを指定して、企業の品質標準を規定するポリシーなどがあります。

ポリシーは複数のアセットに適用できます。複数のポリシーを任意のアセットに適用できます。各ポリシーは、少なくとも1つのアサーション文から構成されます。

- 各アサーションには名前と説明があり、技術的な定義が含まれています。技術的な定義には、サード・パーティのテスト・ツールや検証ツールを使用して、アサーションを自動的に検証する場合に必要な、追加のメタデータが含まれています。このメタデータは、Webサービス固有のポリシー情報、XML、または外部システムで読取り可能な他の形式のいずれかである場合があります。

- たとえば、問題発生率に対するアサーション文は、問題発生率が1%未満である必要があることを示す場合があります。

Oracle Enterprise Repositoryベース・データパックにはサンプル・ポリシーが含まれており、Oracle Enterprise Repositoryインスタンスにインポートされます。Oracle Enterprise Repositoryのインポート/エクスポート機能の詳細は、『Oracle Fusion Middleware Oracle Enterprise Repositoryユーザーズ・ガイド』のインポート/エクスポート・ツールに関する項を参照してください。

14.2 ポリシー管理機能のアクティブ化

ポリシー管理機能をアクティブ化するには、次の手順を実行します。

手順1: ポリシー管理システム設定の有効化

この手順は、Oracle Enterprise Repositoryの「管理」画面で実行します。

1. 左のペインで「システム設定」をクリックします。

2. 図14-1に示すように、「システム設定」の「検索」テキスト・ボックスにポリシーを入力します。

図14-1 「システム設定」の「検索」

図14-2に示すように、「ポリシー管理」グループが表示されます。

図14-2 ポリシー管理

3. アセット・ポリシーの有効化プロパティがTrueに設定されていることを確認します。

4. オプションを使用して、「ポリシー・アサーションの縮小」プロパティを適切に選択します。

- 「True」は、アサーションのデフォルトのアセット詳細表示を縮小します。

- 「False」は、アサーションのデフォルトのアセット詳細表示を展開します。

5. アセット・ポリシー・リレーションシップ・リストで、ポリシーの適用先を選択します。

6. 完了後、「保存」ボタンをクリックします。これで、ポリシー管理機能がアクティブ化されます。

注意:

この設定は、インストール時にデフォルトで表示およびオフになっています。ユーザーがドキュメントに記載されている正しい値にプロパティを設定して、この機能をオンにする必要があります。

手順2: ポリシー管理ソリューション・パックのインポート

ポリシー管理のシステム設定を構成した後、<ORACLE_HOME>/repositoryXXX/core/tools/solutionsからPolicy-Management-Solution-Pack.zipをインストールして、「インポート/エクスポート」ツールを使用してご使用の環境にインポートすると、サンプルのポリシー・タイプとポリシーの例を入手できます。

14.3 ポリシー・タイプの作成

ベース・データにあるポリシー・テンプレートを使用するかわりに、独自のポリシーを作成する必要がある場合、それを可能にする手順をこの項で説明します。ポリシー・タイプ・テンプレートは、任意の既存のアセット・タイプまたはコンプライアンス・テンプレート・タイプを基礎として使用して作成できます。ポリシー管理ソリューション・パックには、1つのポリシー・タイプが含まれています。

1. Oracle Enterprise Repositoryの「アセット」画面でアセットの編集/管理をクリックして、アセット・エディタを起動します。

図14-3 「アセット」セクション

2. アセット・エディタで「アクション」メニューを開きます。

3. 「タイプの管理」をクリックして、タイプ・マネージャを起動します。

4. 「ファイル」メニューを開き、「新規」をクリックします。「新しいタイプの作成」ダイアログが表示されます。

5. 「タイプ名」フィールドに「Policy」と入力して、図14-4に示すように、デフォルトのタイプ・リストからテンプレートを選択します。

図14-4 「新しいタイプの作成」ダイアログ

6. 「OK」をクリックします。

7. タイプ・マネージャの「エディタ」タブにあるアーキタイプ・リストから、「ポリシー・タイプ」を選択します。

図14-5 タイプ・マネージャ

独自のポリシー・タイプが正常に作成されます。

14.4 ポリシー・タイプへのポリシー・アサーション要素の追加

ポリシー・アサーションは、アセットが満たす必要のある条件を示します。たとえば、ポリシー・アサーションは問題発生率が1%未満である必要があることを示す場合があります。各アサーションは個別に検証されます。アセットがすべてのアサーションを満たしている場合(つまり、すべてのアサーションがOracle Enterprise Repositoryで「パス」ステータスになっている場合)、そのアセットは適用済ポリシーに準拠しています。新しいポリシー・テンプレートが正常に機能するには、ポリシー・アサーション要素を追加する必要があります。この単純な手順は、タイプ・マネージャで実行します。

ポリシー・アサーション要素は、ポリシー・テンプレートの任意のタブに追加できます。次の手順では、ポリシー・アサーション要素を「概要」タブに追加します。

1. タイプ・マネージャの「タブ」セクションで、「概要」を選択します。
図14-6に示すように、「概要」タブにすでに割り当てられているすべての要素がタイプ・マネージャの「要素」セクションに表示されます。

図14-6 「要素」セクション

2. 「追加」をクリックします。「追加する要素タイプの選択」ダイアログが表示されます。

3. 図14-7に示すように、「要素タイプ」リストからポリシー・アサーションを選択します。

図14-7 追加する要素タイプの選択

4. 「OK」をクリックします。図14-8に示すように、「ポリシー・アサーションの編集」ダイアログが表示されます。

5. 「表示名」テキスト・ボックスにポリシー・アサーションの名前を入力します。(次の例では、要素の名前として「Policy Assertions」を使用しています。)

図14-8 ポリシー・アサーションの編集

6. 「OK」をクリックします。ポリシー・アサーション要素が「要素」リストに表示されます。

注意:

ポリシーに関連付けられたアセットを含むアセット・タイプのすべてに対して、ポリシー・アサーション要素が必要です。

14.5 ポリシーの作成

ポリシーは非常に特殊なタイプのアセットであり、他のアセットと一意のリレーションシップを持ちます。ポリシーは、ポリシー・タイプを使用して作成されます。

この手順は、アセット・エディタで実行されます。

1. 「ファイル」メニューを開き、「新規」をクリックします。「アセットの新規作成」ダイアログが表示されます。

2. 図14-9に示すように、「名前」テキスト・ボックスにポリシーの名前を入力します。

図14-9 「アセットの新規作成」ダイアログ

3. バージョン番号を入力します(オプション)。

4. 「タイプ」プルダウンから適切なポリシー・タイプを選択します。

5. そのプルダウンから、適切な初期状態を選択します。

6. 「OK」をクリックします。アセット・エディタでポリシーが開きます。

図14-10 「概要」タブ

7. ポリシー・アサーション・セクションで「追加」をクリックします。「編集」ダイアログが表示されます。

8. 「名前」、「説明」および「技術的な定義」セクションに適宜入力します。

図14-11 「編集」ダイアログ

注意:

「名前」と「説明」は人間が判読可能な情報です。技術的な定義は、検証のためにアサーションを他のプロセスやツールに渡すことができる、マシンが判読可能な(XMLまたはそれに類似した)情報である必要があります。

9. 「OK」をクリックします。新しいポリシー・アサーションが、ポリシー・アサーション・セクションに表示されます。

図14-12 ポリシー・アサーション

10. この手順を繰り返して、追加のアサーションをポリシーに追加します。

14.6 適用対象アセット・ポリシー要素のタイプへの追加

ポリシーは、適用対象アセット・ポリシー要素が追加されたタイプのアセットにのみ適用できます。たとえば、企業品質ポリシーがすべてのサービスに適用可能である場合、このポリシーを適用するには、適用対象アセット・ポリシー要素を「サービス」アセット・タイプに追加する必要があります。

適用対象アセット・ポリシー要素を追加する手順は、タイプ・マネージャで実行され、ポリシー・アサーション要素をポリシー・タイプに追加する手順とほぼ同じです。

注意:

Oracle Enterprise Repositoryでポリシーを有効にする前に、次の手順を記載されている順に実行します。

1. 「手順1: ポリシー管理システム設定の有効化」ですでに実行したように、「ポリシーの有効化」システム設定を「True」に設定します。

2. ハーベスタ・ソリューション・パックをインポートします。ハーベスタ・ソリューション・パックのインポート方法の詳細は、『Oracle Fusion Middleware Oracle Enterprise Repositoryインストレーション・ガイド』を参照してください。

3. 「手順2: ポリシー管理ソリューション・パックのインポート」ですでに実行したように、ポリシー管理パックと修正パックをインポートします。

1. 選択したアセット・タイプを開きます。右側のパネルで、「エディタ」タブを選択します。

2. 「タブ」セクションで、適用対象アセット・ポリシー要素が追加されたタブを選択します。

3. 「要素」セクションで、「追加」をクリックします。「追加する要素タイプの選択」ダイアログが表示されます。

4. 「要素タイプ」リストから、適用対象アセット・ポリシー・オプションを選択します。

5. 「OK」をクリックします。「適用対象アセット・ポリシーの編集」ダイアログが表示されます。

6. 「表示名」テキスト・ボックスに適切な名前を入力します。

7. 「OK」をクリックします。適用対象アセット・ポリシー要素が、割り当てられた名前で「要素」セクションのリストに表示されます。

8. 右側のパネルの表示を「ビューア」タブに変更します。

9. 非表示要素セクションで、適用対象アセット・ポリシー要素を選択します。「要素の移動」ダイアログが表示されます。

10. 「適用対象アセット・ポリシーの移動先」リストから、適切な適用対象アセット・ポリシー要素を選択します。

11. アセット・タイプを保存します。

14.7 アセットへのポリシーの適用

注意:

ユーザーは、ポリシーの基本アクセス設定でポリシー適用権限を割り当てられている必要があります。

ポリシーをアセットに追加する手順は、アセット詳細表示で実行します。

1. Oracle Enterprise Repositoryの「検索」または他の方法を使用して、ポリシーを追加するアセットを探します。

2. 図14-13に示すように、アセット詳細表示でポリシー適用ボタンをクリックします。

図14-13 概要

3. 図14-14に示すように、すべてのポリシーをリストをクリックして、使用可能なアセット・ポリシー・ボックスにリストを表示します。

図14-14 ポリシー適用

4. 「>>」ボタンまたは「すべて >>」ボタンを使用して、選択したポリシーを適用対象アセット・ポリシー・ボックスに移動します。
前述の例では、Sample Policy - Corporate Quality Standardsポリシーが適用されています。

5. 「保存」をクリックします。

6. 図14-15に示すように、確認メッセージが表示されます。

図14-15 ポリシー適用

7. 「閉じる」をクリックします。

8. アセット詳細フレームをリフレッシュします。

9. 図14-16に示すように、アセット詳細の「概要」セクションにアイコンが表示されている場合、これはポリシーが適用されていることを示しています。(同じアイコンの小さいバージョンは、検索結果にリストされたアセットに対するポリシー割当てを示しています。)

図14-16 「概要」のSample Policy - Corporate Quality Standards

図14-17に示すように、Sample Policy - Corporate Quality Standardsは、アセット詳細の「リレーションシップ」セクションで適用済ポリシーとして識別されます。リストされている任意のポリシーのテキスト・リンクをクリックして、その詳細を表示します。

図14-17 Sample Policy - Corporate Quality Standards

ポリシー詳細の「リレーションシップ」セクションには、Sample Policy - Corporate Quality Standardsが適用されたアセットがリストされます。Sample Service - Account Detail (2.0)のリンクをクリックして、そのアセットの詳細表示に戻ります。

注意:

複数のポリシーを任意の適切なアセットに適用できます。

14.8 ポリシー・ステータスの表示

ポリシー・ステータスは、アセット詳細表示と検索結果に表示される、特定のアイコンによって示されます。(ポリシー・ステータスは、オプションのナビゲータにも示されます。)

ポリシー・ステータスは、適用済ポリシー内のアサーション文にアセットが準拠しているかどうかによって決定されます。複数のポリシーが適用されている場合、各適用済ポリシーに準拠している場合にのみ、アセットが可ステータスになります。

同様に、ポリシーは複数のアサーション文で構成されることがあるため、すべての適用済ポリシー内のすべてのアサーション文に準拠している場合にのみ、アセットが可ステータスになります。

イメージ

説明

ステータス: 適用

1つ以上のポリシーがアセットに適用されたことを示し、その「パス」または「失敗」ステータスは不確定です。

合格したアサーション文と不確定なアサーション文が混在する場合、アセットのステータスは不確定になります。

ステータス: 合格

アセットがすべての適用済ポリシー内のすべてのアサーション文に準拠していることを示します。

ステータス: 失敗

アセットが必ずしもすべての適用済ポリシー内のアサーション文に準拠しているわけではないことを示します。

いずれかの適用済ポリシー内のいずれかのアサーション文に準拠していない場合、ステータスが「失敗」になります。

14.9 ポリシー・アサーションの検証

ポリシー・アサーションは、Oracle Enterprise Repositoryを介して手動で、またはテスト・ツールや検証ツールを使用して自動的に検証できます。このドキュメントでは、ポリシー・アサーションの手動検証について説明します。自動検証プロセスについては、ご使用の各テスト・ツールおよび検証ツールのドキュメントを参照してください。

ポリシー・アサーションの手動検証は、アセット・エディタで実行します。

1. 更新するアセットを探します。

2. そのアセット内の適用対象アセット・ポリシー・セクションに移動します。
このセクションの特定のラベルと場所は、タイプ・テンプレート内のポリシー要素の構成によって決定されます。

3. 図14-18に示すように、更新するポリシーを選択します。

図14-18 適用対象アセット・ポリシー

4. 「詳細」をクリックします。図14-19に示すように、「ポリシーの表示」ダイアログが表示されます。

図14-19 「ポリシーの表示」ダイアログ

「ポリシーの表示」セクションにリストされるポリシーへのアセットの準拠ステータスは、「結果」列に示されます。前述の例におけるステータス「不明」は、ポリシーがアセットに適用されたが、そのポリシーの(1つ以上の)アサーション文への準拠は評価されていないことを示しています。

5. 更新するアサーション文を選択します。

6. 「編集」をクリックします。図14-20に示すように、「アサーション結果の編集」ダイアログが表示されます。

図14-20 「アサーション結果の編集」ダイアログ

7. 図14-21に示すように、評価値リストをクリックして、適切なステータスを選択します。

図14-21 評価値リスト

この例では、「パス」ステータスが選択されています。その他の詳細は、評価情報に入力できます。

8. 「OK」をクリックします。図14-22に示すように、「ポリシーの表示」ダイアログの「結果」列に更新されたステータスが表示されます。

図14-22 「ポリシーの表示」ダイアログ

注意:

アサーションの値を「不明」に戻すには、アサーションを選択して「クリア」をクリックします。

9. 引き続き、同じ方法で残りのアサーションを検証します。

10. 完了したら、「OK」をクリックして、「ポリシーの表示」ダイアログを閉じます。

11. アセットへの変更を保存します。

12. 図14-23に示すように、アセット詳細に緑のチェック・マークのアイコンが表示されます。

図14-23 Sample Service - Account Detail (2.0)

ポリシーへの準拠を示す同じアイコンが、図14-24に示すように、検索結果のアセット名の横にも表示されます。

図14-24 検索結果

14.10 Oracle Enterprise Repositoryポリシー・レポートの実行

この項では、2種類の異なるポリシー・レポートについて説明します。

- アセット・ポートフォリオ・ポリシー・ステータス

- ポリシー・ステータス・レポート

アセット・ポートフォリオ・ポリシー・ステータス

このレポートは、組織のアセット・ポートフォリオ全体に関して、ポリシー・ステータス(可、不可、不明)の概要を示します。このレポートを使用すると、ユーザーは、各ステータスのアセットのリスト(たとえば、不可となるすべてのアセット)を表示できます。詳細なレポートには、各アセットに適用されるすべてのポリシーと、すべてのポリシー・アサーションのステータスがリストされます。

ポリシー・ステータス・レポート

このレポートは、組織のポリシー・ポートフォリオのすべてのポリシーの概要と、ステータスが可、不可、不明のアセットの数を示します。このレポートは、各ポリシーで管理されるアセットの詳細リストと、ステータスが可、不可または不明のアサーションの数も示します。

Oracle Enterprise Repositoryレポートを実行するには、次の手順を実行します。

1. Oracle Enterprise Repositoryレポート・ページで、レポート名をクリックします。図14-25に示すように、BI Publisherで、「レポート」タブが新しいブラウザ・ウィンドウに開きます。

図14-25 「レポート」タブ

2. 「View」ボタンをクリックします。図14-26に示すように、選択したレポートの詳細が表示されます。

図14-26 「レポート」タブ - 詳細ビュー

3. 図14-27に示すように、「テンプレート」の横に表示される2つ目のリストから、異なるフォーマットを選択できます。

図14-27 フォーマットのリスト

4. アセット・ポートフォリオ管理セクションで、アセット・ポートフォリオ・ポリシー・ステータス・オプションをクリックします。図14-28に示すように、アセット・ポートフォリオ・ポリシー・ステータス・ページが表示されます。

図14-28 アセット・ポートフォリオ・ポリシー・ステータス・ページ

5. 一連のアセットの詳細を表示するには、適切なポリシー・ステータスのアイコンの横にある番号をクリックします。図14-29に示すように、アセット・ポートフォリオ・ポリシー・ステータスのステータス詳細レポートが表示されます。

図14-29 アセット・ポートフォリオ・ポリシー・ステータスのレポート・ページ

6. アセット・ポートフォリオ管理セクションで、「ポリシー・ステータス」オプションをクリックします。図14-30に示すように、ポリシー・ステータス・レポート・ページが表示されます。

図14-30 ポリシー・ステータス・レポート・ページ

15 契約管理の構成

この章では、Oracle Enterprise Repositoryで契約管理ソリューション・パックを使用する方法について説明します。

この章には、次のセクションがあります。

- 15.1項「概要」

- 15.2項「契約管理ソリューション・パックのインポート」

- 15.3項「サービス・プロバイダ向けの手順」

- 15.4項「サービス・コンシューマ向けの手順」

15.1 概要

契約管理では、サービス・プロバイダとコンシューマの間の契約交渉をサポートします。ここでは、使用条件(サービスを提供または使用するための条件など)も提供され、使用条件に関するランタイム・ポリシーを施行します。

どのような環境でも、本番サービスへのアクセスが不可欠な場合、サービスを使用する正式な契約をお薦めします。コンシューマの本番サービスへのアクセスの意図を事前通知されることにより、プロバイダはすべてのコンシューマに対して明示的にアクセスの認証、容量の拡大計画、ポリシーの施行、およびサービス・レベルの管理を容易に実行できます。

契約管理では、次のことが可能になります。

- サービス・プロバイダとコンシューマは、サービス・レベルとアクセス要件を明確にし、交渉することによって、サービス使用における想定の不確定さを回避できます。

- サービス・プロバイダはサービスの再利用を開始するコンシューマに関連するサービス・レベル、スケーラビリティ、およびセキュリティ・リスクを管理できます。

- サービス・プロバイダは、お客様の取得、契約交渉、権限のプロビジョニング、ポリシー施行を必要とする複雑な手順を自動化できます。

- ポリシー管理者には、契約で指定したとおり、ビジネスで必要となるポリシーの施行が通知されます。

15.1.1 前提条件

- ハーベスタ・ソリューション・パック(11.1.1.x.x-OER-Harvester-Solution-Pack.zip)

- ポリシー・ソリューション・パック(Policy-Management-Solution-Pack.zip)

15.2 契約管理ソリューション・パックのインポート

Oracle Enterprise Repository Baseデータパックにはサンプル契約が含まれており、使用しているOracle Enterprise Repositoryインスタンスにインポートされます。Oracle Enterprise Repositoryのインポート/エクスポート機能の詳細は、『Oracle Fusion Middleware Oracle Enterprise Repositoryユーザーズ・ガイド』のインポート/エクスポート・ツールに関する項を参照してください。

15.3 サービス・プロバイダ向けの手順

コンシューマがプロバイダからの指定サービス・エンドポイントへのアクセスをリクエストする場合に使用できる標準の契約です。この契約は、[サービス名] Webサービスへのアクセスに必要な[コンシューマ]と[プロバイダ]の間の契約を表します。

15.3.1 契約の作成

Oracle Enterprise Repositoryのアセット・エディタで「コピーと移行」オプションを使用し、このサンプルに基づいて契約を新規作成します。

1. 契約を選択し、「編集」をクリックします。アセット・エディタが表示されます。

2. 「ファイル」→コピーと移行を選択します。「コピーと移行」ダイアログが表示されます。

3. 新しい契約の名前とバージョン番号を入力します。

4. 「タイプ」リストから「契約」を選択し、初期状態を選択します。

15.3.2 契約の編集

「概要」タブでプロバイダ情報および契約に関する追加情報を入力します。コンシューマ情報フィールドは変更しないでください。

1. 「概要」タブを選択し、プロバイダ、目的、サービス料金などの情報を入力します。

2. 「説明」フィールドのカッコ([])で囲まれているプレースホルダ・テキストを変更します。

3. 変更を保存します。

15.3.3 リレーションシップの作成

分類タブで契約書1通ごとに、契約対象のサービス、WSDL、およびエンドポイントのアセットへの規定のアセット・リレーションシップを作成します。

1. 分類タブを選択し、「リレーションシップ」セクションで「追加」をクリックします。「関係の追加」ダイアログが表示されます。

2. 「関連タイプ: 規定のアセット」を選択します。

3. 検索する用語を入力するか、「関連付けるアセット検索」セクションですべてのアクティブ・アセットをリストを選択します。

4. サービス、WSDL、およびエンドポイント・アセットを選択してリレーションシップを確認します。

15.3.3.1 使用条件

プロバイダは契約リクエストを受信すると、承認のためコンシューマに返送する前にさらに詳細を入力する必要があります。

この契約対象となるサービス・エンドポイントに対する使用条件(ポリシー)を適用します。

1. エンドポイントに対してコンシューマにアクセス権を付与する前に、このエンドポイントがセキュアであることを確認します。

2. 定型のサービス契約のEasyLink URLのコピー(このアセットのコピー)を作成します。

3. サービス・アセットに進み、EasyLink URLを"{クリックしてサービス・エンドポイント仕様の契約をリクエスト}"フィールドに貼り付けます。

4. オプション: 契約のコンシューマ・バージョン用のプロバイダ向けの手順を削除します。コンシューマ向けの手順は削除しないでください。

5. 「概要」タブで「説明」フィールドを編集して「プロバイダ向けの手順」テキストを削除します。

15.4 サービス・コンシューマ向けの手順

この契約のコピーを作成します。Oracle Enterprise Repositoryのアセット・エディタでコピーと移行を使用してこの契約のコピーを独自に作成します。

この手順は、アセット・エディタで実行されます。

1. 契約を選択し、「編集」をクリックします。アセット・エディタが表示されます。

2. 「ファイル」→コピーと移行を選択します。「コピーと移行」ダイアログが表示されます。

3. 「概要」タブでコンシューマ・フィールドに情報を入力します。プロバイダ情報フィールドは変更しないでください。

契約を送信します。この契約は承認と登録のためプロバイダに送信されます。

- 「管理」タブで「発行」をクリックします。

プロバイダがサービスへのアクセス権を付与すると、電子メールで通知が送信されます。

16 BI Publisherによるレポートの構成

この章では、Oracle Enterprise RepositoryでのレポートのためのBusiness Intelligence (BI) Publisherを構成する方法について説明します。

この章には、次のセクションがあります。

- 16.1項「Oracle Enterprise Repository事前構成BI Publisherコンテンツのデプロイ」

- 16.2項「セキュリティ・モデル」

- 16.3項「Oracle Enterprise Repository JDBCデータ・ソースの構成」

- 16.4項「BI Publisherサーバーの構成 - キャッシュ有効期限」

- 16.5項「レポートを有効化するためのOracle Enterprise Repositoryシステム設定の構成」

16.1 Oracle Enterprise Repository事前構成BI Publisherコンテンツのデプロイ

Oracle Enterprise Repositoryは、すべてのレポートのエントリ・ポイントです。レポートをホストするには、BI PublisherとOracle Enterprise Repositoryが相互に対話できるよう構成する必要があります。

注意:

次に示す手順は、Oracle Enterprise Repositoryレポートのホスト専用として使用されるBI Publisher 11gがインストールされていることを前提としています。

BI PublisherではBI Publisherへの内部リポジトリを使用して、BI Publisherのユーザー、ロール、レポート、および構成をホストします。このリポジトリは、Oracle Enterprise Repositoryとの統合用として開発されたBI Publisherコンテンツで置き換えられます。

16.1.1 Oracle Enterprise RepositoryによるBI Publisherの構成

注意:

10gのレポートは11gに移行しないでください。

Oracle Enterprise Repository-BI Publisherコンテンツをデプロイするには、次の手順を実行します。

1. データベース用のパッケージ済コンテンツ・アーカイブを検索します。Oracle Enterprise Repositoryデプロイメントのレポートは<ORACLE_HOME>/repositoryXXX/core/tools/solutions/reportsディレクトリにあります。
このディレクトリには、11.1.1.7.0-OER-BIP11gReports.zipがあります。これには各データベースに対応する3つのフォルダが含まれています。各フォルダには、OERレポートのみが含まれます。

2. BI Publisherアプリケーション・サーバーを停止します。

3. 該当するデータベース・フォルダから次に記載のBI PublisherレポートのディレクトリにOERフォルダをコピーします。
domain/config/bipublisher/repository/Reports

4. BI Publisherアプリケーション・サーバーを再起動します。

5. Webコンソールhttp://hostname:port/xmlpserverを開いてBI Publisher構成を確認します。Shared Foldersディレクトリに表示されるOERフォルダを確認します。

16.2 セキュリティ・モデル

BI Publisherでは、独自のセキュリティ・モデルではなくEnterprise Managerを使用してユーザーおよびロールを管理します。セキュリティ・モデルの詳細は、『Oracle Fusion Middleware Oracle Business Intelligence Publisher管理者ガイド』を参照してください。

16.2.1 管理者ユーザー

管理者ユーザーとパスワードは、インストール時に決定されます。このユーザーとパスワードは、OERへのデータベース接続の設定、およびOERユーザーとロールの構成、BI Publisherでのデータ・ソースの設定に必要になります。

注意:

BI Publisherでは、パスワードの大/小文字が区別されます。

16.2.2 OERユーザーおよびOER_REPORTSロール

BI Publisher WLSコンソールを使用してOERユーザーを作成します。BIグループをこのユーザーに適用します。OERユーザー資格証明を使用してBI Publisherコンソールにログインし、ユーザー・アカウントを検証します。「共有フォルダ」→OERフォルダに移動してレポートを表示します。

16.2.3 レポート・フッターのローカル・タイム・ゾーンの設定

正しいタイム・ゾーンをレポート・フッターに表示するため、OERユーザー・アカウントに対してBI Publisherのタイム・ゾーンを設定します。

- OERユーザーとしてサインインし、「アカウント」リンクを選択してBI Publisherコンソールの右上の「次としてサインイン」<username>リンクにある「タイムゾーン」の設定を変更します。

16.3 Oracle Enterprise Repository JDBCデータ・ソースの構成

JDBC情報を更新するには、次の手順を実行します。

1. BI Publisherに管理者としてログインします。

2. 「管理」タブをクリックします。

3. 「データソース」セクションでOER - 「JDBC接続」リンクを選択します。

注意:

これは大文字と小文字が区別されます。

4. 「データ・ソースを更新します」画面で、接続文字列がOracle Enterprise Repositoryのデータベースを指すように変更します。Oracle Enterprise Repositoryのdatabase.propertiesファイルに表示されるものと同じConnectStringを使用します。Oracle Enterprise Repositoryと同じデータベース認証を使用します。
WebLogicドメインでは、database.propertiesファイルは<domain>/applications/oer_11.1.1.x.0/oer-app/WEB-INF/classesにあります。

次の項では、各データベースのためのデータベース構成について説明します。

- 「Oracle」

- 「SQL Server」

- 「UDB」

5. 「接続のテスト」ボタンをクリックして、BI Publisherがデータベースにアクセスできることを確認します。

6. 「適用」をクリックして変更を保存します。

Oracle

ご使用のOracleデータベース・バージョンに応じて、Oracle Databaseの次のいずれかのドライバ・タイプを選択できます。JDBCライブラリ・ファイル(JAR)がBI Publisherサーバー・インストールの一部としてインストールされているため、他にjarファイルは必要ありません。

- Oracle 11g

- Oracle 10g

- Oracle 9i

Oracle JDBC接続の例を次に示します。

データベース・ドライバ・クラス

oracle.jdbc.OracleDriver

接続文字列

jdbc:oracle:thin:@[HOST]:[PORT]:[DB_NAME]

例

jdbc.oracle.thin:@machine.example.com:1521:oer

SQL Server

ご使用のSQL Serverデータベース・バージョンに応じて、SQL Serverデータベースの次のいずれかのドライバ・タイプを選択できます。JDBCライブラリ・ファイル(JAR)がBI Publisherサーバー・インストールの一部としてインストールされているため、他にjarファイルは必要ありません。

- Microsoft SQL Server 2005

- Microsoft SQL Server 2000

SQL Server JDBC接続の例を次に示します。

データベース・ドライバ・クラス

hyperion.jdbc.sqlserver.SQLServerDriver

接続文字列

jdbc:hyperion:sqlserver://[HOST]:[PORT];DatabaseName=[DB_NAME]

例

jdbc:hyperion:sqlserver://machine.example.com;databaseName=oer

UDB

ご使用のDB2データベース・バージョンに応じて、IBM DB2 Universal Databaseの次のいずれかのドライバ・タイプを選択できます。JDBCライブラリ・ファイル(JAR)がBI Publisherサーバー・インストールの一部としてインストールされているため、他にjarファイルは必要ありません。

- IBM DB2 Universal Database v9

- IBM DB2 Universal Database v8

UDB JDBC接続の例を次に示します。

データベース・ドライバ・クラス

hyperion.jdbc.db2.DB2Driver

接続文字列

jdbc:hyperion:db2://[hostHOST]:[portPORT];DatabaseName=[dbnameDB_NAME]

例

jdbc:hyperion:db2://machine.example.com;DatabaseName=oer

16.4 BI Publisherサーバーの構成 - キャッシュ有効期限

デフォルトでは、レポート・データの生成におけるデータベースのラウンドトリップを削減するため、すべてのOracle Enterprise Repositoryレポートでドキュメント・キャッシュを使用します。データがキャッシュされている間は、表示されるレポートの内容が常にOracle Enterprise Repositoryの最新のアクティビティであるとはかぎりません。キャッシュ有効期限の設定は、BI Publisherがデータをリフレッシュする必要のある頻度(秒)とその後のレポートの表示によって異なります。BI Publisherでのキャッシュ有効期限のデフォルト値は30です。この値を変更するには、次の手順を実行します。

1. BI Publisherに管理者としてログインします。

2. 「管理」タブをクリックします。

3. 「システム・メンテナンス」セクションで、「サーバー構成」リンクを選択します。

4. 「キャッシュ」セクションで「キャッシュ有効期限」を(分単位で)指定し、「適用」をクリックして変更内容を適用します。

注意:

BI Publisherでレポートを表示する場合、その結果はレポート用に検出されたデータによって異なります。データが最新の状態になるまでは、BI Publisherから返されるレポートには不整合が発生している場合があります。

16.5 レポートを有効化するためのOracle Enterprise Repositoryシステム設定の構成

Oracle Enterprise Repositoryには、一連のレポートへの各種リンクを含むレポート・ページがあります。これらのレポートは、レポートのホスト用としてインストールされ、構成されているBI Publisherインスタンスでホストされています。Oracle Enterprise Repositoryの「レポート」ページのすべてのリンクは、Oracle Enterprise Repositoryのインストール直後は不完全です。すべてのレポート・リンクについて、プロトコル、ホスト名、ポート、Webアプリケーション名、および親ディレクトリを提供するシステム設定が必要です。システム設定は、レポートの実行前に構成する必要があります。

システム設定の構成

1. Oracle Enterprise Repositoryにシステム管理者、または管理ロールを持つユーザーとしてログインします。

2. Oracle Enterprise Repositoryの「管理」ページで「システム設定」をクリックします。

3. 「検索」テキスト・ボックスに「report」と入力し、システム設定のリストをフィルタ処理します。

4. 「レポート」セクションで「レポートの有効化」 (cmee.reports.enabled)をTrueに設定します。

5. レポート・サーバーURL (oracle.reports.server.url)をhttp:/</HOSTNAME>:<PORT>/xmlpserver/OERに設定します。ここでホスト名とポートはBI Publisherインストールと一致しています。
レポート・サーバーURLプロパティが正しく構成されていない場合、「レポート」ページに次のメッセージが表示されます。

レポート・サーバーURLのシステム設定を実行してください。これが正しく設定されるまでレポートは実行できません。

6. レポート・サーバー・エンドポイントURLのシステム設定(oracle.reports.server.endpoint.url)をhttp:/<HOSTNAME>:<PORT>/xmlpserver/services/PublicReportServiceに設定し、追加の資格証明がなくてもOERユーザーがBI Publisherレポートにアクセスできるようにします。
OERユーザーのレポートへのアクセス権は、1.6項「アクセス設定」に示すとおり、基本アクセス設定で設定されます。

7. レポート・サーバー・ユーザー名およびレポート・サーバー・パスワードのシステム設定には、16.2.2項「OERユーザーおよびOER_REPORTSロール」で作成したOER BI Publisherアカウントのユーザー名とパスワードを設定します。

8. システム設定を保存します。

9. 「レポート」セクションに移動し、システム設定が正しく構成されていることを確認してください。

10. いずれかのレポートを実行します。
ブラウザがBI Publisherへのアクティブ・セッションを保持していない場合、BI Publisherのログイン画面が表示されます。BI Publisherへログインすると、レポートが表示されます。

レポートを実行すると、BI PublisherへのURLが指定されたブラウザ・ウィンドウが新たに開きます。Oracle Enterprise Repositoryで生成されたURLをBI Publisherで生成されたURLと比較すると、レポート・サーバーURLシステム設定の構成エラー診断に役立ちます。

11. レポートが正常に実行されるまで、この項で説明した手順を繰り返します。レポートから「検索結果が見つかりません」とメッセージが返される場合、Oracle Enterprise Repositoryの「アセット」タブでなんらかのキーワード検索を実行します。

注意:

Internet Explorerからリクエストしたものとは別のレポートが返される場合、「インターネット一時ファイル」を変更して、表示ごとの変更を確認します。

17 システム設定の概要

この章では、管理者が基本的な操作および特定の機能を構成するために使用するOracle Enterprise Repositoryのシステム設定について説明します。

この章には、次のセクションがあります。

- 17.1項「システム設定へのアクセス」

- 17.2項「システム設定の検索」

- 17.3項「システム設定プロパティの有効化」

- 17.4項「データベースへの設定の移動」

- 17.5項「Oracle Enterprise Repositoryのシステム設定」

- 17.6項「既知の問題」

17.1 システム設定へのアクセス

システム設定にアクセスするには、次の手順を実行します。

1. Oracle Enterprise Repositoryの「管理」画面上のサイドバーにある「システム設定」をクリックします。

図17-1 Oracle Enterprise Repositoryの「システム設定」ページ

メイン・ペインで「システム設定」セクションが開きます。

システム設定は、カテゴリに分けられています。各カテゴリは、さらに機能グループに分けられます。

図17-2 機能設定

2. プラス・アイコンをクリックすると、カテゴリまたは機能グループの表示が展開されます。

3. マイナス・アイコンをクリックすると、表示が縮小します。

17.2 システム設定の検索

「システム設定」の「検索」を使用して、特定の機能のシステム設定を探すことができます。

1. 「システム設定」の「検索」ボックスに、検索語句を入力します。関連するカテゴリのセクションが展開され、関連するシステム設定が表示されます。

図17-3 機能設定

2. 検索結果をクリアするには、「クリア」ボタンをクリックします。

17.3 システム設定プロパティの有効化

場合によっては、特定のオプションのOracle Enterprise Repository機能をアクティブ化するために、特定のプロパティを有効にする必要がある場合があります。これらのプロパティはOracleサポートから提供されます。

1. 必要なシステム設定プロパティを入手します。

2. 「新しいシステム設定の有効化」テキスト・ボックスにシステム設定プロパティを入力します。

3. 「有効化」をクリックします。下部のペインに適切なシステム設定カテゴリが開きます。

4. 必要に応じて、システム設定プロパティを編集します。

5. 完了したら、「保存」をクリックします。

17.4 データベースへの設定の移動

このオプションを実行すると、プロパティ・ファイルに格納されたシステム設定がすべてデータベースに移動されます。このアクションを取り消すことはできません。

1. データベースへの設定の移動をクリックします。すべてのシステム設定がデータベースに保存されます。この機能はクラスタ環境用です。クラスタ環境内のすべてのサーバーに対し、システム設定の単一のソースが保持されます。

詳細は、『Oracle Fusion Middleware Oracle Enterprise Repositoryインストレーション・ガイド』のデータベースへのアプリケーション・プロパティの移動に関する項を参照してください。

17.5 Oracle Enterprise Repositoryのシステム設定

この項では、Oracle Enterprise Repositoryで使用可能なすべてのシステム設定について説明します。

この項には次のトピックが含まれます:

- 17.5.1項「機能設定」

- 17.5.2項「サーバー設定」

- 17.5.3項「エンタープライズ認証設定」

- 17.5.4項「オープンAPI設定」

- 17.5.5項「外部統合設定」

- 17.5.6項「インポート/エクスポートおよびイントロスペクション設定」

17.5.1 機能設定

この項には次のトピックが含まれます:

- 17.5.1.1項「一般的なユーザー・インタフェース」

- 17.5.1.2項「検索」

- 17.5.1.3項「PDFを介したアセット詳細の出力」

- 17.5.1.4項「プロジェクトおよびナビゲータ」

- 17.5.1.5項「進行中のアセット」

- 17.5.1.6項「ポリシー管理」

- 17.5.1.7項「通知」

- 17.5.1.8項「アクセス制御」

- 17.5.1.9項「Software File Identification (SFID)」

- 17.5.1.10項「使用 - ダウンロード」

- 17.5.1.11項「カスタム・リンク」

- 17.5.1.12項「レポート」

- 17.5.1.13項「その他」

17.5.1.1 一般的なユーザー・インタフェース

図17-4 一般的なユーザー・インタフェース

プロパティ

- デフォルトの参照カテゴリ分け

- cmee.assettab.default-categorization

- リストで選択した項目によって、「アセット」画面の参照ツリーの最初のアセット・カテゴリ分けが決まります。

図17-5 アセット機能リスト

結果は次のとおりです。

図17-6 参照ツリー

- デフォルトの参照タイプ

- cmee.assettab.default-categorization-show-assettype

- 「True」および「False」オプションにより、「アセット」画面の参照ツリーのアセットのタイプ別のデフォルト表示が切り替わります(デフォルトの参照カテゴリ分けのシステム設定に応じて変わります)。
「True」の結果は次のとおりです。

図17-7 参照ツリー

- スティッキー・レジストラ・キュー

- cmee.registrar.stickyqueues

- 「True」および「False」オプションにより、アセットの参照時に選択したアセット・エディタ・タブのデフォルト表示が切り替わります。

- True: 各アセットはアセット・エディタ・タブで以前に選択したアセットのビューで開きます。

- False: アセット・エディタで表示される各アセットの「概要」タブにデフォルト設定されます。

- 表ズーム

- cmee.assettab.multiplegroupelement.force-zoom

- 「True」および「False」オプションにより、表の要素を固有のウィンドウで開く機能が切り替わります。

- 表ヘッダーの繰返し

- cmee.assettab.multiplegroupelement.show-header-interval

- テキスト・ボックスに入力した数値により、大きい表で表ヘッダーが繰り返される間隔(行数)が決まります。

- 値が0の場合の結果は、次のとおりです。

図17-8 コスト・カテゴリ

- 値が2の場合の結果は、次のとおりです。

図17-9 コスト・カテゴリ

- タブ内のすべての詳細を表示

- cmee.framework.show-as-tabs

- 「True」および「False」オプションにより、アセット詳細のデフォルト表示が切り替わります。

- 「True」の場合、結果がタブ化されたビューになります。

図17-10 「概要」タブ

- 「False」の場合、結果が通常のビューになります。

図17-11 サンプル・アプリケーション

- 長い日付書式仕様

- cmee.server.date.format.long.default

- 完全な日付情報の表示で日付書式(yyyy-MM-dd HH:mm:ss z)を指定します。
結果は次のとおりです。

図17-12 「管理」タブ

- 短い日付書式仕様

- cmee.server.date.format.short.default

- 簡略な日付情報の表示で日付書式(yyyy-MM-dd)を指定します。

- 長い日付書式仕様と似ています。

- フルネーム書式

- enterprise.defaults.fullname.format

- ユーザー名の表示書式を指定します。文字列"{prefix}"、"{first}"、"{middle}"、"{suffix}"およびそれらの名前部分の直後に付加される句読点を任意の順番で含めることができます。余分なスペースは削除されます。

- 注意: この設定を変更すると、サーバーの再起動が必要になります。

結果は次のとおりです。

図17-13 フルネーム書式

- システム提供のリレーションシップの表示

- cmee.show-system-supplied-relationships

- 「True」および「False」オプションにより、アセット・エディタ・タブおよびアセットの詳細でシステムが提供するリレーションシップの表示が切り替わります。「False」設定に設定すると、アセット・エディタの「リレーションシップ」タブおよびアセットの詳細で、システムが提供するリレーションシップが非表示になります。ただし、アセット・エディタの「リレーションシップの構成」ダイアログではそれらが表示されたままになります。
システムが提供するリレーションシップは、アセットの更新時により複雑な照合を許可する場合など、Oracle Enterprise Repository内部のシステム固有のリレーションシップに使用されます。このため、システムが提供するリレーションシップをユーザーが作成または削除したり、システムが提供するリレーションシップの方向を変更することはできません。これは常に読取り専用です。

- 表示名フィールド

- enterprise.defaults.displayname.field

- リストで選択した項目により、ユーザーに表示される情報が決まります。
注意: この設定を変更すると、サーバーの再起動が必要になります。

図17-14 表示名フィールド

結果は次のとおりです。

図17-15 フルネーム書式

- 表示名 - フルネームおよびイニシャル

- enterprise.defaults.fullname.middleasinitial

- ユーザーのミドル・ネームが指定されている場合に、「True」および「False」オプションにより、ミドル・ネームの表示がフルネームまたはイニシャルで切り替わります。

「True」の結果は次のとおりです。

図17-16 フルネームおよびイニシャル

「False」の結果は次のとおりです。

図17-17 フルネームおよびイニシャル

17.5.1.2 検索

図17-18 検索

プロパティ

- 検索の保存

- cmee.asset.registry.saved.searches

- 「True」および「False」オプションにより、「検索の保存」機能が切り替わります。この機能では、検索基準を保存して再利用できます。
「True」の場合、次に示すように、「アセット」画面のサイドバーに「検索の保存」セクションが表示されます。

図17-19 「保存済の検索」ダイアログ

- 索引付きフィールドの検索

- cmee.search.general.include.indexedfields

- 「True」および「False」オプションにより、通常のアセット検索に索引付きフィールドが含まれるかどうかが切り替わります。

- カテゴリ分けの検索

- cmee.search.general.include.categorizations

- 「True」および「False」オプションにより、通常のアセット検索にカテゴリ分けが含まれるかどうかが切り替わります。

- 詳細な検索オプションのカテゴリ分けのデフォルト表示

- cmee.search.advanced.categorizations.visible

- 「True」および「False」オプションにより、「詳細な検索オプション」ダイアログのカテゴリ分けツリーのデフォルト表示が展開と縮小で切り替わります。

「False」の結果は次のとおりです。

図17-20 「詳細な検索オプション」のカテゴリ分けツリーが展開されていない状態

「True」の結果は次のとおりです。

図17-21 「詳細な検索オプション」のカテゴリ分けツリーが展開された状態

- 特定のフィールドの検索

- cmee.search.specific.field

- 「True」および「False」オプションにより、標準の検索時に「キーワード」テキスト・ボックス内の検索対象フィールドを識別して特定のフィールドを検索する機能が切り替わります。
次に示すように、文字列description:MyAssetでは、リポジトリ内のすべてのアセットに対して「説明」フィールドのキーワードMyAssetが検索されます。

図17-22 検索

- 空の検索の確認

- cmee.empty.search.confirm

- 「True」および「False」オプションにより、ユーザーが空の文字列で検索を実行した場合の警告メッセージの表示が切り替わります。
「True」の場合、警告メッセージが表示されます。

- ユーザー検索の最小文字数

- cmee.users.min.text.search

- テキスト・ボックスに入力した数値により、ユーザー情報の検索を実行するために必要な最小文字数が決まります。
最小文字数に満たない文字数でユーザー検索の実行を試みると、警告メッセージが表示されます。

- ロギングの検索

- cmee.log.searches will log search criteria for keyword searches only.

- cmee.log.complete.searchesにより、検索に入力した任意の基準について検索基準が記録されます。

17.5.1.3 PDFを介したアセット詳細の出力

図17-23 PDFを介したアセット詳細の出力

プロパティ

- アセット・タイプにデフォルトのXSLTを使用

- cmee.asset.pdf.xslt.default

- 「True」および「False」オプションにより、アセットをPDFにエクスポートする際にデフォルトのアセット・タイプを使用するかどうかを指定します。存在しない場合は、エラーが表示されます。

- PDFアセットのエクスポートの宛先

- cmee.asset.xml.paths.export-destination

- テキスト・ボックスに入力したテキストにより、PDFアセットのエクスポートの宛先が識別されます。

- PDFアセットのエクスポートの宛先URL

- cmee.asset.xml.paths.export-destination-url

- テキスト・ボックスに入力したテキストにより、PDFアセットのエクスポートの宛先URLが識別されます。

- PDFアセットのXSLディレクトリ

- cmee.asset.xml.paths.xsl-source

- テキスト・ボックスに入力したテキストにより、PDFアセットのXSLディレクトリが識別されます。

- PDFアセットで生成されたPDFの宛先

- cmee.asset.xml.paths.out-destination

- テキスト・ボックスに入力したテキストにより、PDFアセットで生成されたPDFの宛先が識別されます。

- PDFアセットで生成されたPDFの宛先URL

- cmee.asset.xml.paths.out-destination-url

- テキスト・ボックスに入力したテキストにより、PDFアセットで生成されたPDFの宛先URLが識別されます。

- PDFアセットのエクスポートのWebApp URL

- cmee.asset.xml.paths.webapp-url

- テキスト・ボックスに入力したテキストにより、PDFアセットのエクスポートのWebApp URLが識別されます。

17.5.1.4 プロジェクトおよびナビゲータ

図17-24 プロジェクトおよびナビゲータ

プロパティ

- プロジェクトの有効化

- cmee.projects.enabled

- 「True」および「False」オプションにより、複数のプロジェクトのサポートが切り替わります。

- ナビゲータおよびプロジェクト階層

- cmee.projecttool.advanced

- 「True」および「False」オプションにより、ナビゲータやプロジェクト階層などの拡張プロジェクトのオプションが切り替わります。

- Microsoft JDKに対するナビゲータ・サポート

- cmee.navigator.force-msjdk-support

- 「True」および「False」オプションにより、Internet Explorer対応のMicrosoftのアプレット・プラグインと互換性のある代替のナビゲータ・アプレットの使用が切り替わります。

- ユーザー定義プロジェクト

- cmee.extraction.user-projects.enable

- 「True」および「False」オプションにより、アセットの「使用/ダウンロード」プロセス中にユーザーによる即時のプロジェクトの作成を許可する機能が切り替わります。

「True」の結果は次のとおりです。

図17-25 使用 - ダウンロード

「False」の結果は次のとおりです。

図17-26 使用 - ダウンロード

- ユーザー定義プロジェクト - 接頭辞

- cmee.extraction.user-projects.prefix

- 次に示すように、プロパティ・テキスト・ボックスに入力したテキストが任意のユーザー定義プロジェクトの接頭辞になります。これは、レポートでのビジュアルなグループ化に便利な機能です。(ユーザー定義プロジェクトを有効にする必要があります。)

図17-27 例

結果は次のとおりです。

図17-28 使用 - ダウンロード

- プロジェクトの作成

- cmee.project.producing.enabled

- 「True」および「False」オプションにより、「アセットの発行」ダイアログの「プロジェクトの作成」セクションの表示が切り替わります(Oracle Enterprise Repositoryの「アセット」画面の「アセットの発行」リンクを介した標準発行)。

「True」の結果は次のとおりです。

図17-29 アセットの発行

「False」の結果は次のとおりです。

図17-30 アセットの発行

- 拡張プロジェクト・オプション - カテゴリ分け

- cmee.projecttool.categorizations

- 「True」および「False」オプションにより、プロジェクトへのカテゴリの割当てが切り替わります。

- プロジェクトのレポート済アセット値の有効化

- cmee.projecttool.assetvalue.enabled

- 「True」および「False」オプションにより、プロジェクトのレポート済アセット値のメトリックが切り替わります。

17.5.1.5 進行中のアセット

図17-31 進行中のアセット

プロパティ

- 進行中のアセットの表示

- cmee.asset.in-progress.visible

- アセット・エディタの外部で進行中のアセットの表示機能を有効にするには、「True」を選択します。

17.5.1.6 ポリシー管理

図17-32 ポリシー管理

図17-33 ポリシー管理

プロパティ

- コンプライアンス・テンプレートの有効化 (図17-33を参照)

- cmee.compliance-template.enable

- コンプライアンス・テンプレート・システムを有効にします。

- アセット・ポリシーの有効化

- cmee.asset-policy.enable

- ポリシー管理システムを有効にします。

- ポリシー・アサーションの縮小

- cmee.asset-policy.collapse.assertions

- アセットの詳細で適用されているポリシーを表示する際にデフォルトでアサーションの表示を縮小します。

- アセット・ポリシー・リレーションシップ

- cmee.asset-policy.relationship

- システム内でポリシー割当てのために使用するリレーションシップ・タイプを定義します。これは、順序が重要な双方向リレーションシップである必要があります。

17.5.1.7 通知

図17-34 通知

プロパティ

- アセット使用通知

- cmee.extraction.notify-maintainer

- 「True」および「False」オプションにより、アセットの使用時にアセットのリストにある通知アドレス宛てに電子メールを自動送信する機能が切り替わります。

図17-35 その他

- 電子メールの送信時は、次のアルゴリズムを使用して宛先のアドレスが決定されます。

- アセットに通知アドレスがある場合は、それを電子メールの宛先として使用します。

- それ以外の場合、システム設定cmee.extraction.default.maintainer.emailに値がある場合は、その値を宛先アドレスとして使用します。

- それ以外の場合、電子メール・アドレスを持つ発行元ユーザーが存在する場合は、その電子メール・アドレスを使用します。

- それ以外の場合、電子メール・アドレスを持つ作成元ユーザーが存在する場合は、その電子メール・アドレスを使用します。

- それ以外の場合、使用状況の通知メールを送信しません。

- アセット使用通知用のデフォルトの電子メール・アドレス

- cmee.extraction.default.maintainer.email

- このシステム設定は、システムにより送信された使用状況に関する通知のデフォルトの宛先電子メール・アドレスを指定するために使用されます。

- システム・レジストラの電子メール

- cmee.registrar.email

- 自動生成の電子メール・メッセージで使用するレジストラの電子メール・アドレスをテキスト・ボックスに入力します。

- システム・レジストラの代替通知

- cmee.registrar.email.enable

- アセットに通知メールが設定されていない場合に、システム・レジストラの電子メール・アドレスへの通知メールの送信を許可します。

- アクセス管理者の電子メール・アドレス

- cmee.security-admin.email

- ユーザー関連およびアクセス関連の自動生成された電子メールの送信先となるユーザーの電子メール・アドレスをテキスト・ボックスに入力します。これには、未承認のLDAPユーザーがユーザー・ディレクトリに追加された場合に送信される通知が含まれます。

- リマインダ電子メールの有効化

- cmee.extraction.notification.enabled

- アセットの使用状態と値のメトリックを更新するための電子メールによる通知を有効にします。

- リマインダ遅延

- cmee.extraction.initial.delay

- ユーザーがアセットをダウンロードした後、「ステータスの更新」フォーム(次を参照)を完了するためのリマインダが送信されるまで待機する日数を示す数値をテキスト・ボックスに入力します。

図17-36 ステータスの更新

- リマインダ遅延 - 続き

- cmee.extraction.subsequent.delay

- 最初の使用ステータスのリマインダ・メッセージの後、続きのリマインダが送信されるまで待機する日数を示す数値をテキスト・ボックスに入力します。

17.5.1.8 アクセス制御

プロパティ

- カスタム・アクセス設定

- cmee.customaccesssettings.enabled

- 拡張カスタム・アクセス設定を有効にします。

- アセットのカスタム・アクセス設定

- cmee.customaccesssettings.asset

- アセットの拡張カスタム・アクセス設定を有効にします。

- ファイルのカスタム・アクセス設定

- cmee.customaccesssettings.file

- ファイルのカスタム・アクセス設定を有効にします。

- すべての権限を切り替える機能

- cmee.security.gui.toggleall

- 管理者が同時に1つのロールのすべての権限を切り替えることができるGUIコントロールを有効にします。

図17-37 アクセス制御

17.5.1.9 Software File Identification (SFID)

プロパティ

- 使用状況の自動検出の有効化

- cmee.usagedetection.enable

- SFIDを管理する使用状況の自動検出プラグインを有効にし、使用可能な使用状況の自動検出を可能にします。

- 未認識SFIDの収集の有効化

- cmee.sfid.harvesting.enable

- まだシステムに登録されていない、検出されたSFIDに関連する情報の収集を有効にします。

図17-38 Software File Identification (SFID)

17.5.1.10 使用 - ダウンロード

プロパティ

- アセット使用状況のカスタム・フィールド・リスト

- cmee.extraction.exported-custom-field.

- この一意の設定により、カスタム・アセット使用状況フィールドの作成を可能にします。

注意:

このプロパティには、末尾にピリオドが表示されます。このプロパティを「検索」フィールドに入力する場合は、プロパティとともにピリオドを入力してください。

カスタム使用状況フィールドの作成

1. 「新しいシステム設定の有効化」ボックスにプロパティ名を入力し、[Enter]を押します。

2. 必要に応じて、「追加」をクリックして追加のテキスト・ボックスを開きます。

図17-39 使用 - ダウンロード

3. 追加した各カスタム使用状況フィールドの名前を対応するテキスト・ボックスに入力します。

4. 完了後、「保存」をクリックします。新しいカスタム使用状況フィールドが「使用 - ダウンロード」ダイアログに表示されます。

図17-40 使用 - ダウンロード

17.5.1.11 カスタム・リンク

図17-41 カスタム・リンク

この設定グループは、Oracle Enterprise Repositoryのメニュー・バーの右側にあるカスタム・リンクの構成と表示を制御します。

プロパティ

- カスタム・リンク1

- cmee.tool.show-marketplace

- 「True」および「False」オプションにより、カスタム・リンク1の表示が切り替わります。

図17-42 カスタム・リンク

図17-43 カスタム・リンク1とカスタム・リンク2

(カスタム・リンク1とカスタム・リンク2の両方が「True」に設定されている場合を示します。)

- カスタム・リンク1のラベル

- cmee.tool.marketplace.label

- テキスト・ボックスに入力したテキストがOracle Enterprise Repositoryのメニュー・バーのカスタム・リンク1のラベルとして表示されます。

- カスタム・リンク1のURL

- cmee.tool.marketplace.url

- カスタム・リンク1のURLを入力します。

- カスタム・リンク1のターゲット・フレーム

- cmee.tool.marketplace.target

- カスタム・リンク1を表示するフレームを指定します。

- カスタム・リンク2

- cmee.tool.show-marketplace

- 「True」および「False」オプションにより、カスタム・リンク2の表示が切り替わります。

- カスタム・リンク2のラベル

- cmee.tool.marketplace.label

- テキスト・ボックスに入力したテキストがOracle Enterprise Repositoryのメニュー・バーのカスタム・リンク2のラベルとして表示されます。

- カスタム・リンク2のURL

- cmee.tool.marketplace.url

- カスタム・リンク2のURLを入力します。

- カスタム・リンク2のターゲット・フレーム

- cmee.tool.marketplace.target

- カスタム・リンク2を表示するフレームを指定します。

- カスタム・ヘルプURL

- cmee.tool.help.url

- ヘルプ・リンクのカスタムURLを指定します。
注意: Oracle Enterprise Repositoryのヘルプ・ファイルはデフォルトではリモートでホストされます。必要な場合はヘルプ・ファイルをローカル環境でホストできます。ヘルプ・ファイルの場所が反映されるようにこの設定を変更します。

17.5.1.12 レポート

図17-44 レポート

プロパティ

- レポート・サーバーURL

- oracle.reports.server.url

- レポート・サーバー・リンクのカスタムURLを指定します。

- レポート・サーバー・エンドポイントURL

- oracle.reports.server.endpoint.url

- レポート・サーバーに対して認証するためのWebサービス・エンドポイントのカスタムURLを指定します。

- レポート・サーバー・ユーザー名

- oracle.reports.server.username

- レポート・サーバーのユーザー名の資格証明を指定します。

- レポート・サーバー・パスワード

- oracle.reports.server.password

- レポート・サーバーのパスワードの資格証明を指定します。

- レポートのPDF出力の有効化

- oracle.reports.pdf.enable

- レポートのPDF出力を有効にします。

- レポートのExcel出力の有効化

- oracle.reports.excel.enable

- レポートのExcel出力を有効にします。

17.5.1.13 その他

図17-45 その他

プロパティ

- アセット発行ファイル要件

- cmee.submission.file.required.enable

- 有効な場合、標準アセット発行を実行するユーザーはファイルの場所のURLを指定するか、ファイルをアップロードする必要があります。

- コンシューマ・アンケート

- cmee.extraction.consumer-survey.enable

- 「True」および「False」オプションにより、My Stuffページのアセット使用状況セクションにリストされている任意のアセットで使用可能なアセットの使用状況を示すアンケートの更新の完全な表示が切り替わります。
「True」の場合、完全なアンケートが表示されます。

図17-46 ステータスの更新

「False」の場合、ステータス・リストのみが表示されます。

図17-47 ステータスの更新

- デフォルトの使用状況の拒否理由

- cmee.default.usage.rejection.reason

- My Stuffセクションでアセットの使用状態を更新する場合に、アセットの拒否時に記録されるデフォルトのアセット拒否理由をリストを使用して選択します。

図17-48 デフォルトの使用状況の拒否理由

図17-49 使用されるアセット

- タイプ・マネージャの有効化

- cmee.typemanager.enabled

- 「True」および「False」オプションにより、タイプ・マネージャを表示する機能が切り替わります。
「True」の場合、アセット・エディタで「タイプの管理」オプションを選択するとタイプ・マネージャが表示されます。「False」の場合、タイプ・マネージャは表示されません。

- Microsoft Excelスプレッドシートへのアセットのエクスポート

- cmee.asset.registry.export.excel

- 「True」および「False」オプションにより、アセットの詳細情報を外部のMicrosoft Excelスプレッドシートにエクスポートする機能が切り替わります。

「True」の場合、アセット検索結果フレームに「Excelにエクスポート」というメニュー選択項目が表示され、アセットの詳細にExcelボタンが表示されます。

図17-50 アセットのエクスポート

「False」の場合、メニュー選択項目とボタンが表示されません。

アフィニティ設定

Oracle Enterprise Repositoryのコンテキスト内では、アフィニティは、2つ以上のアセットが同じプロジェクトにデプロイされる場合に生じる条件になります。アフィニティ要素は、この条件を満たす各アセットのアセット詳細に表示され、(デプロイされた)共通のプロジェクトが存在する他のアセットをリストします。

次のアフィニティ・システム設定は、アフィニティ要素とそのコンテンツの特定の動作を決定します。

- アフィニティしきい値

- cmee.assettab.affinity.threshold

- アフィニティの一致する項目数がこの設定で入力した数値を超えた場合は、アセットの詳細のアフィニティ要素に「すべてのアフィニティ・アセットの表示」リンクが表示されます。

- アフィニティのプロジェクトの最小数

- cmee.assettab.affinity.minimum

- このフィールドに入力された数値によって、「アセット詳細」ページの「アフィニティ」セクションにアセットが表示されるために含める必要があるプロジェクトの最小数が決まります。

図17-51 アフィニティ

アセットを使用したプロジェクトの数が指定の数値に満たない場合、アフィニティ要素では表示の基準が満たされていないことが示されます。

17.5.2 サーバー設定

この項には次のトピックが含まれます:

- 17.5.2.1項「一般」

- 17.5.2.2項「サーバー・リソース」

- 17.5.2.3項「電子メール」

- 17.5.2.4項「アップロード領域」

- 17.5.2.5項「監査」

- 17.5.2.6項「キャッシュ」

注意:

17.5.2.1 一般

図17-52 一般

- 管理ロール

- enterprise.security.roletype.admin

- このボックスに入力した名前により、Oracle Enterprise Repository内で無制限の管理権限と他の権限を持つロールに適用される名前が指定されます。

- 会社名

- cmee.enterprisetab.homepageselection.enabled

- 「True」および「False」オプションにより、ユーザー・ロールまたは部門割当てに基づいて特定のホームページを割り当てる機能が切り替わります。

「True」の場合、ユーザー・ロールまたは部門に基づいて特定のホームページが割り当てられます。「False」の場合、デフォルトのホームページが表示されます。

- ホームページ選択の有効化

- cmee.server.companyname

- テキスト・ボックスに会社名を入力します。

- ホームページ

- cmee.enterprisetab.homepage

- デフォルトのURLはデフォルトのOracle Enterprise Repositoryホームページを指し、メイン(右側)のフレームに表示されます。

図17-53 SOAガバナンス

Oracle Enterprise Repositoryホームページとして異なるページをロードするには、必要に応じてこのURLを変更します。

- デフォルトの文字エンコーディング

- cmee.server.defaultencoding

- システムで使用するデフォルトの文字エンコーディング(デフォルト値はJVMのデフォルト)。

- たとえば、UTF-8やISO-8859-1などです。UTF-16はサポートされていません。

- カスタム一意要素の有効化

- cmee.unique-element.enable

- 「True」および「False」オプションにより、デフォルトで使用される名前/バージョンのペアに加えて一意の制約を定義する、タイプの追加プラグインを有効にする機能が切り替わります。

- タイプごとの一意の要素

- cmee.unique-element.per-assettype

- 「True」および「False」オプションにより、タイプごとに個別に一意の要素プラグインを関連付ける機能が切り替わります。

- アセット・エディタのツリーの自動リフレッシュの無効化

- cmee.asseteditor.disable-autorefresh-tree

- 「True」および「False」オプションにより、ユーザーが「受入れ」、「発行」または「登録」をクリックしたときのツリーの自動リフレッシュを無効にする機能が切り替わります。

17.5.2.2 サーバー・リソース

図17-54 サーバー・リソース

プロパティ

- データベース接続名

- enterprise.dbaccess.connectionname

- データベース接続に割り当てられた名前。

- WebApp JSPパス

- enterprise.server.paths.jsp

- JSPが格納されているアプリケーション・サーバー上の場所へのファイルパス。

- WebAppサーブレット・パス

- enterprise.server.paths.servlet

- 製品サーブレットが格納されているアプリケーション・サーバー上の場所へのファイルパス。

- Webリソース・パス

- cmee.server.paths.resource

- Webリソースが格納されている場所へのWebサーバー・パス。

- Webイメージ・パス

- cmee.server.paths.image

- 製品イメージが格納されているWebサーバー上の場所へのファイルパス。この設定には、Webリソース・パスの*imagesサブディレクトリが含まれている必要があります。

- Web JNLPパス

- cmee.server.paths.jnlp-tool

- JNLPツールjarが格納されているWebサーバー上の場所へのファイルパス。Java Web Startとの互換性の問題のため、このパスがSSL対応のサービスを指すことはできません。

- WebApp JSPパス

- cmee.server.paths.jsp

- JSPが格納されているアプリケーション・サーバー上の場所へのファイルパス。

- WebAppサーブレット・パス

- cmee.server.paths.servlet

- 製品サーブレットが格納されているアプリケーション・サーバー上の場所へのファイルパス。

- アセット詳細パス

- cmee.assettab.asset-detail-page

- アセットの詳細をロードする統合によって使用されるアプリケーション・サーバーのパス。

17.5.2.3 電子メール

図17-55 電子メール

プロパティ

- 電子メール配信リストの許可

- cmee.email.cc

- 「True」および「False」オプションにより、電子メール配信リスト機能が切り替わります。これにより、アセット登録プロセスの一部として送信される特定の電子メール通知のコピーが自動的にリストのメンバーに送信されるように、ユーザーが配信リストを作成できます。

- 配信リスト内の外部電子メールの許可

- cmee.email.nonuser.cc

- 「True」および「False」オプションにより、配信リストに外部の電子メール・アドレスを指定する機能が決まります。「True」の場合、配信リストで外部の電子メール・アドレスが許可されます。「False」の場合、配信リストがOracle Enterprise Repositoryの内部ユーザーに制限されます。

- SMTPサーバー

- cmee.server.smtp

- 自動生成の電子メール・メッセージで使用するSMTPサーバーのホスト名またはIPアドレス。

- 外部の電子メール・システムの使用

- cmee.server.smtp.send-with-cron

- 「True」および「False」オプションにより、自動化されたOracle Enterprise Repositoryメッセージの電子メール・メカニズムの選択が決まります。「True」の場合、外部のメカニズムが有効になります。「False」の場合、Oracle Enterprise Repository内部の電子メール送信メカニズムが有効になります。
注意: この設定を変更すると、サーバーの再起動が必要になります。

- 電子メールの送信間隔

- cmee.server.smtp.send-interval

- この設定により、自動的なOracle Enterprise Repository電子メール・メッセージの送信間隔の分数が決まります。

- システム電子メールをHTMLとして送信

- cmee.server.smtp.send.format-html

- 「True」および「False」オプションにより、自動的なOracle Enterprise RepositoryメッセージのHTMLまたはプレーンテキスト形式の選択が切り替わります。

- 「True」の場合、HTML形式が有効になります。

- 「False」の場合、プレーンテキスト形式が有効になります。

- 返信先ヘッダーを使用してシステム電子メールを送信

- cmee.server.smtp.send.replyto-required

- 「True」および「False」オプションにより、自動化されたOracle Enterprise Repositoryメッセージに返信先ヘッダーを含めるオプションが切り替わります。返信先ヘッダーには送信元アドレスが含まれます。
「True」の場合、返信先ヘッダーが有効になります。

- 通知電子メールのデリミタ

- cmee.email.delimiter

- リストを使用して、デフォルトの電子メール・クライアントで決定された複数の電子メール・アドレスに使用する適切なデリミタ(カンマまたはセミコロン)を選択します。(たとえば、Microsoft Outlookではセミコロンが使用され、Outlook Expressではカンマが使用されます。)

- Oracleへの診断データの送信

- cmee.server.smtp.senddiag

- 「True」および「False」オプションにより、内部情報のみを目的とする、Oracleへの毎月の自動診断メールが切り替わります。

17.5.2.4 アップロード領域

図17-56 アップロード領域

プロパティ

- 発行アップロード・ディレクトリ

- cmee.server.paths.upload

- HTTP・ファイル・アップロード・プロセスを直接経由してアプリケーション・サーバー上にファイルをアップロードするためにローカルに参照されるオペレーティング・システム・パスを定義します。このプロパティにより、次の機能が有効になります。

- 「アセットの発行」フォームの「添付ファイルの即時追加」オプションが有効になります。(発行プロセス中にアセットにファイルを添付する場合に必要です。)

- アセット・エディタのアップロードされた発行ファイル・オプションが有効になります。

- レジストラ発行アップロード・パス

- cmee.server.paths.upload-registrar

- アセット・エディタを使用したファイル参照が有効になります(オプション)。

- UNCでホストされる場合、パスにはWindows OS、SambaまたはSharityが必要です。

- アセット・エディタのアップロードされた発行ファイルにある「参照」ボタンの表示が有効になります。

- 発行アップロード用のアーティファクト・ストア

- cmee.server.paths.upload-repository

- 発行されたファイルへの直接的なパブリック・アクセスを許可する構成済アーティファクト・ストアを設定します。このプロパティは、アセット・エディタでの発行ファイルのワンステップ受入れに使用されます。このプロパティを設定すると、次のようになります。

- 使用可能またはダウンロード可能なアセット・ファイルが表示されます。

- アセット・エディタのアップロードされた発行ファイル・セクションに、「Accept」ボタンが表示されます。

17.5.2.5 監査

図17-57 監査

プロパティ

- アセット保存のエクスポート・ファイル名

- cmee.asset.logging.filenamep

- テキスト・ボックスに入力したテキストにより、(アーカイブと監査の目的のため)毎回の保存時にアセット・データの保存に使用されるファイル名が識別されます。

- アセット保存のエクスポートがエラーで失敗

- cmee.asset.logging.failonerror

- なんらかの理由でアセットのエクスポート・ファイル名に書き込むことができない場合に監査の保存を中止する機能を有効にするには、「True」オプションを選択します。

17.5.2.6 キャッシュ

図17-58 キャッシュ

プロパティ

- 起動時にアセットのキャッシュを事前ロード

- cmee.assets.preload.at-startup

- アプリケーション・サーバーの起動時にアセットのキャッシュを事前ロードするには、「True」オプションを選択します。
「True」の場合、アセットのキャッシュが事前ロードされます。

- アセットのキャッシュを個別スレッドとして事前ロード

- cmee.assets.preload.as-seperate-thread

- アプリケーション・サーバーの起動時に、事前ロードされたアセットのキャッシュを異なるスレッドとして生成するには、「True」オプションを選択します。

17.5.3 エンタープライズ認証設定

この項には次のトピックが含まれます:

- 17.5.3.1項「一般」

- 17.5.3.2項「認証トークン」

- 17.5.3.3項「パスワード設定」

- 17.5.3.4項「プラグイン・ログイン設定」

- 17.5.3.5項「LDAPおよびアクティブ・ディレクトリ設定」

- 17.5.3.6項「シングル・サインオン(SSO)設定」

- 17.5.3.7項「コンテナ・ログイン設定」

- 17.5.3.8項「Cookieログイン設定」

17.5.3.1 一般

図17-59 一般

- デフォルトの電子メールの接尾辞

- enterprise.defaults.email.suffix

- このテキスト・ボックスに入力する情報は、デフォルトのユーザーの電子メール・アドレスを形成するためにユーザー名の接尾辞として自動的に追加されます。

- 承認されていないユーザーのログイン

- enterprise.security.unapproveduser.allowlogin

- 「True」および「False」オプションにより、未承認のユーザーがシステムにログインする機能が切り替わります。これは、LDAP認証またはコンテナ管理認証を使用する場合に便利です。

- ログイン・ダイアログの表示

- enterprise.security.showloginpopup

- 「True」および「False」オプションにより、Oracle Enterprise Repositoryのログイン・ダイアログのデフォルト表示が切り替わります。ダイアログではユーザーが識別され、ログイン情報が表示されます。

図17-60 Oracle Enterprise Repositoryのログイン・ページ

- 失敗したログイン試行の最大数

- enterprise.security.loginattempt.max

- テキスト・ボックスに入力した数値により、ログインに失敗したユーザーがロックアウトされるまでのログイン試行回数が決まります。0または負の値の場合、ロックアウトが無効になります。

図17-61 Oracle Enterprise Repositoryのログイン・ページ

- ユーザー当たりの同時ログイン数

- enterprise.security.concurrentuser.max

- テキスト・ボックスに入力した数値により、各ユーザーに許可された同時ログインの最大数が決まります。0または負の値の場合、同時実行のユーザー・ログインが無制限に許可されます。

- ログイン猶予期間

- enterprise.security.password.expiration.gracelogins

- テキスト・ボックスに入力した数値により、パスワードの期限が切れた後にログインが許可される回数が決まります。

- LDAPログインの有効化

- enterprise.authentication.ldap.enabled

- 認証用のLDAPログイン・モジュールを有効にします。

- コンテナ・ログインの有効化

- enterprise.authentication.container.enabled

- 認証用のコンテナ・ログイン・モジュールを有効にします。

- 拡張コンテナ・ログインの有効化

- enterprise.authentication.advancedcontainer.enabled

- 認証用の拡張コンテナ・ログイン・モジュールを有効にするには、「True」オプションを選択します。

- コンテナ・ロールの同期

- enterprise.authentication.container.synchroles.enabled

- 既存のJava EEコンテナ・ロールの同期を有効にします。

- デフォルトの電子メールの接尾辞

- enterprise.defaults.email.suffix

- デフォルトの電子メール・アドレスを決定するためユーザー名に追加される接尾辞。

- 未承認の新規ユーザー通知

- cmee.new.unapproved.users.notify

- 「True」および「False」オプションにより、LDAPまたはJava EEコンテナなどの外部認証を通じて新規ユーザーが作成された場合に、セキュリティ管理者に電子メールが自動的に送信される機能が切り替わります。

LDAP設定とその説明を次に示します。

LDAP設定

説明

ldap.ssl.enabled

LDAP用のSSL接続を有効にします(デフォルトはfalse)

ldap.host

LDAPサーバーのホスト名(必須)

ldap.port

LDAPサーバーのポート番号(デフォルトは389、オプション)

ldap.mask

LDAPマスク(認証バインドまたは検索基準のいずれか、必須)

ldap.allow-user-creation

未承認のユーザー・アカウントを作成できるかどうかを決定します(デフォルトはtrue、オプション)

ldap.version

使用するLDAPバージョン(2または3のいずれか、デフォルトは2、オプション)

ldap.bindDN

管理者アカウントの識別名(オプション)

ldap.bindPassword

管理者アカウントのパスワード(オプション)

ldap.baseDN

検索を定義するためにldap.maskおよびldap.scopeで使用される検索の開始場所(オプション)

ldap.scope

検索のスコープを決定します(オプション)

ldap.uniqueIDAttrib

検索エントリを識別する属性名

ldap.emailAttrib

検索エントリの電子メール属性名

ldap.givennameAttrib

検索エントリの名前属性名

ldap.surnameAttrib

検索エントリの姓属性名

ldap.telephoneAttrib

検索エントリの電話番号属性名

ldap.middlenameAttrib

検索エントリのミドル・ネーム属性名

ldap.enable-sync-depts

trueの場合、ログイン時にLDAPからユーザーの部門を取得します

ldap.enable-synch-roles

trueの場合、ログイン時にLDAPからユーザーのロールを取得します

ldap.deptAttrib

見つかったエントリの部門の属性名

ldap.rbac.roleAttrib

見つかったエントリのロールの属性名

ldap.redirectDnAttrib

ユーザー情報を取得する2次レベルの参照を識別する属性(dn (識別名)である必要があります。オプション)

ldap.retrieve-data-as-admin

管理者アカウントを使用してデータを取得

ldap.assign-default-roles

trueの場合、ユーザーにデフォルトのロールが割り当てられます

ldap.follow-referrals

trueの場合、照会先を追跡します

ldap.auto-create-missing-roles

trueの場合、欠落しているロールを自動作成します

ldap.auto-create-missing-depts

trueの場合、欠落している部門を自動作成します

17.5.3.2 認証トークン

図17-62 認証トークン

- 認証トークンの有効期限

- enterprise.defaults.authtokens.expiration.value

- テキスト・ボックスに入力した数値により、認証トークンが期限切れになり、パージ対象になるまでの期間が決まります(時間の単位は「認証トークンの期限切れ単位」メニュー項目で決定されます)。

- 認証トークンの期限切れ単位

- enterprise.defaults.authtokens.expiration.period

- 図17-63に示すリストを使用して、認証トークンの有効期限設定で使用される時間の単位を選択します。

図17-63 認証トークンの期限切れ単位リスト

- 期限切れの認証トークンのパージ頻度

- enterprise.defaults.authtokens.purgefrequency.value

- テキスト・ボックスに入力した数値により、期限切れになった認証トークンのパージ間隔が決まります(時間の単位は「期限切れの認証トークンのパージ頻度単位」メニュー項目で決定されます)。

- 期限切れの認証トークンのパージ頻度単位

- enterprise.defaults.authtokens.purgefrequency.period

- リストを使用して、期限切れの認証トークンのパージ頻度設定で使用される時間の単位を選択します。

17.5.3.3 パスワード設定

図17-64 パスワード設定

- パスワード - 最小文字数

- enterprise.security.password.composition.minimumlength

- テキスト・ボックスに入力した数値により、有効なパスワードに必要な最小文字数が決まります。
注意: この設定は、「管理」ロールの個々のユーザーが作成したパスワードには適用されません。

- パスワード - 必要なアルファベット文字

- enterprise.security.password.composition.require.alpha

- 「True」オプションを選択した場合、パスワードに最低1つのアルファベット文字が含まれる必要があります。
注意: この設定は、「管理」ロールの個々のユーザーが作成したパスワードには適用されません。

- パスワード - 必要な数字

- enterprise.security.password.composition.require.numeric

- 「True」オプションを選択した場合、パスワードに最低1つの数字が含まれる必要があります。
注意: この設定は、「管理」ロールの個々のユーザーが作成したパスワードには適用されません。

- パスワード - 必要な特殊文字

- enterprise.security.password.composition.require.special

- 「True」オプションを選択した場合、パスワードに最低1つの特殊文字が含まれる必要があります。パスワードに使用される特殊文字のリストは、次のとおりです。
` ~ ! @ # $ % ^ & * ( ) - _ = + [ { ] } \ \ | ; : ' \ " , < . > / ?

注意: この設定は、「管理」ロールの個々のユーザーが作成したパスワードには適用されません。

- パスワードの有効期限

- enterprise.security.password.expiration.days

- テキスト・ボックスに入力した数値により、パスワードの有効期限までの日数が決まります。
0または負の値の場合、パスワードの有効期限が無効になります。

- パスワード履歴の追跡

- enterprise.security.password.history.count

- テキスト・ボックスに入力した数値により、システムに記憶される以前使用したパスワードの数が決まります。パスワード履歴はパスワードが再利用されることを防ぐために使用されます。

- パスワード履歴 - 最小追跡時間

- enterprise.security.password.history.minagehours

- テキスト・ボックスに入力した数値により、パスワードがパスワード履歴に追加される前に有効である必要がある時間の最小値が決まります。この機能は、パスワードの頻繁な変更によってパスワード履歴を欺こうとする試みを防止するのに便利です。

17.5.3.4 プラグイン・ログイン設定

図17-65 プラグイン・ログイン設定

- プラグイン・ログイン・モジュール・クラス名

- enterprise.loginmodules.pluggableloginmodule.classname

- テキスト・ボックスに入力したテキストにより、プラグイン・ログイン・モジュールのクラス名が識別されます。
必要に応じて+追加をクリックして、他のプラグイン・ログイン・モジュールのクラス名を追加します。

- プラグイン・ログイン・モジュール表示名

- enterprise.loginmodules.pluggableloginmodule.displayname

- テキスト・ボックスに入力したテキストがプラグイン・ログイン・モジュールの表示名として表示されます。
必要に応じて+追加をクリックして、他のプラグイン・モジュールの表示名を追加します。

- プラグイン・ログイン・モジュール

- enterprise.loginmodules.pluggableloginmodule.enabled

- プラグイン・ログイン・モジュールを有効にするには、テキスト・ボックスに「true」と入力します。
必要に応じて+追加をクリックして、他のプラグイン・モジュールを追加し、有効または無効にします。

- プラグイン・ログイン・モジュール - 内部チェック

- enterprise.loginmodules.pluggableloginmodule.internalchecking

- 構成したプラグイン・ログイン・モジュールでのパスワード有効期限の内部チェックとログイン猶予期間を有効にするには、テキスト・ボックスに「true」と入力します。
LDAPベース、SSOベース、コンテナ管理などの外部ログイン・モジュールを使用して、この種のチェックを外部認証システムに委ねる場合は、テキスト・ボックスに「false」と入力します。

必要に応じて+追加をクリックして、他のプラグイン・モジュールの内部チェックを追加し、有効または無効にします。

17.5.3.5 LDAPおよびアクティブ・ディレクトリ設定

図17-66 LDAPおよびアクティブ・ディレクトリ設定

- LDAPサーバーのホスト名

- ldap.host

- LDAPサーバーのホスト名を入力します。これは必須フィールドです。

- LDAPサーバーのポート番号

- ldap.port

- LDAPサーバー・ポート番号を入力します。デフォルトは389です。これはオプションのフィールドです。

- LDAPマスク

- ldap.mask

- LDAPマスク(認証バインドまたは検索基準のいずれか)を入力します。これは必須フィールドです。

- 未承認ユーザー・アカウントの作成

- ldap.allow-user-creation

- 未承認のユーザー・アカウントを作成できるようにするには、「True」を選択します。デフォルト値はtrueです。これはオプションのフィールドです。

- デフォルト・ロールのユーザーへの割当て

- ldap.assign-default-roles

- ユーザーにデフォルトのロールを割り当てるには、「True」を選択します。

- 不足ロールの自動作成

- ldap.auto-create-missing-roles

- 欠落しているロールの自動作成を有効にするには、「True」を選択します。

- 不足部門の自動作成

- ldap.auto-create-missing-depts

- 欠落している部門の自動作成を有効にするには、「True」を選択します。

- LDAPのバージョン

- ldap.version

- 使用するLDAPバージョン(2または3のいずれか)。デフォルト値は2です。これはオプションのフィールドです。

- 管理者アカウントの識別名

- ldap.bindDN

- 管理者アカウントの識別名。これはオプションのフィールドです。

- 管理者アカウントのパスワード

- ldap.bindPassword

- 管理者アカウントのパスワード。これはオプションのフィールドです。

- SSL接続の使用

- ldap.ssl.enabled

- LDAPへのSSL接続を有効にします。デフォルトはfalseです。

- 照会先を追跡

- ldap.follow-referrals

- trueの場合、照会先を追跡します。

- 管理者アカウントを使用してデータを取得

- ldap.retrieve-data-as-admin

- trueの場合、bindDNを設定する必要があります。デフォルトはfalseです。

- 検索開始場所

- ldap.baseDN

- 検索を定義するためにldap.maskおよびldap.scopeで使用される検索の開始場所。これはオプションのフィールドです。

- 検索範囲

- ldap.scope

- 検索のスコープを決定します。これはオプションのフィールドです。

- 検索エントリを識別する属性名

- ldap.uniqueIDAttrib

- 識別名を使用する方法以外で見つかったエントリを識別する属性名。指定されていない場合、UIDにデフォルト設定されます。これは必須フィールドです。

- 検索エントリの電子メール属性名

- ldap.emailAttrib

- 見つかったエントリの電子メール属性名。これはオプションのフィールドです。

- 検索エントリの名前属性名

- ldap.givennameAttrib

- 見つかったエントリの名前属性名。これはオプションのフィールドです。

- 検索エントリのミドル・ネーム属性名

- ldap.middlenameAttrib

- 見つかったエントリのミドル・ネーム属性名。これはオプションのフィールドです。

- 検索エントリの姓属性名

- ldap.surnameAttrib

- 見つかったエントリの姓属性名。これはオプションのフィールドです。

- 検索エントリの電話番号属性名

- ldap.telephoneAttrib

- 見つかったエントリの電話番号属性名。これはオプションのフィールドです。

- LDAP部門の使用

- ldap.enable-synch-depts

- trueの場合、ログイン時にLDAPからユーザーの部門を取得します。

- 部門属性

- ldap.deptAttrib

- 見つかったエントリの部門の属性名。

- LDAPロールの使用

- ldap.enable-synch-roles

- trueの場合、ログイン時にLDAPからユーザーのロールを取得します。

- ロール属性

- ldap.rbac.roleAttrib

- 見つかったエントリのロールの属性名。

- 第2レベル参照属性

- ldap.redirectDnAttrib

- ユーザー情報を取得する2次レベルの参照を識別する属性(dn (識別名)である必要があります)。これはオプションのフィールドです。

- ブリッジ・クラス名

- ldap.bridge.classname

- このフィールドは必須です。このプロパティのテキストは、使用するブリッジのクラス名を表します。

17.5.3.6 シングル・サインオン(SSO)設定

図17-67 シングル・サインオン(SSO)設定

- ユーザー名のヘッダー名

- enterprise.container.auth.username

- テキスト・フィールドに入力した値は、ユーザーのユーザー名が含まれるヘッダーの名前を表します。

- 名のヘッダー名

- enterprise.container.auth.firstname

- テキスト・フィールドに入力した値は、ユーザーの名前が含まれるヘッダーの名前を表します。

- ミドルネームのヘッダー名

- enterprise.container.auth.middlename

- テキスト・フィールドに入力した値は、ユーザーのミドルネームが含まれるヘッダーの名前を表します。

- 姓のヘッダー名

- enterprise.container.auth.lastname

- テキスト・フィールドに入力した値は、ユーザーの姓が含まれるヘッダーの名前を表します。

- ステータスのヘッダー名

- enterprise.container.auth.status

- テキスト・フィールドに入力した値は、ユーザーのステータスが含まれるヘッダーの名前を表します。

- 電子メールのヘッダー名

- enterprise.container.auth.email

- テキスト・フィールドに入力した値は、ユーザーの電子メールが含まれるヘッダーの名前を表します。

- 電話のヘッダー名

- enterprise.container.auth.phone

- テキスト・フィールドに入力した値は、ユーザーの電話番号が含まれるヘッダーの名前を表します。

- ロールのヘッダー名

- enterprise.container.auth.roles

- テキスト・フィールドに入力した値は、ユーザーのロールが含まれるヘッダーの名前を表します。

- 部門のヘッダー名

- enterprise.container.auth.depts

- テキスト・フィールドに入力した値は、ユーザーの部門が含まれるヘッダーの名前を表します。

- コンテナが渡す部門を使用

- enterprise.container.auth.enable-synch-depts

- コンテナからユーザーの部門を取得するには、「True」オプションを選択します。

- 単一のヘッダーで渡される部門

- enterprise.container.auth.depts-single-header

- 部門を単一のヘッダーで渡すには、「True」オプションを選択します。

- 部門のデリミタ

- enterprise.container.auth.depts-delimiter

- テキスト・フィールドに入力した値は、部門名の間のデリミタを表します。

- コンテナが渡すロールを使用

- enterprise.container.auth.enable-synch-roles

- コンテナからユーザーのロールを取得するには、「True」オプションを選択します。

- 単一のヘッダーで渡されるロール

- enterprise.container.auth.roles-single-header

- ロールを単一のヘッダーで渡すには、「True」オプションを選択します。

- ロールのデリミタ

- enterprise.container.auth.roles-delimiter

- テキスト・フィールドに入力した値は、ロール名の間のデリミタを表します。

- デフォルト・ロールのユーザーへの割当て

- enterprise.container.auth.assign-default-roles

- ユーザーにデフォルトのロールを割り当てるには、「True」オプションを選択します。

- 不足ロールの自動作成

- enterprise.container.auth.auto-create-missing-roles

- 欠落しているロールを自動作成するには、「True」オプションを選択します。

- 不足部門の自動作成

- enterprise.container.auth.auto-create-missing-depts

- 欠落している部門を自動作成するには、「True」オプションを選択します。

- すべてのCookieを渡す - JWS

- cmee.jws.pass-all-cookies

- アセット・エディタで使用するため現在のCookieをすべてユーザーのブラウザからJava Web Startに渡すには、「True」オプションを選択します。

- 認可ヘッダーの抑制 - JWS

- cmee.jws.suppress-authorization-header

- JWSが起動したユーティリティによって認可ヘッダーが伝播されるのを防ぐには、「True」オプションを選択します。

SSO設定とその説明を次に示します。

SSO設定

説明

enterprise.container.auth.username

ユーザーのユーザー名が含まれるヘッダーの名前

enterprise.container.auth.firstname

ユーザーの名前が含まれるヘッダーの名前

enterprise.container.auth.middlename

ユーザーのミドルネームが含まれるヘッダーの名前

enterprise.container.auth.lastname

ユーザーの姓が含まれるヘッダーの名前

enterprise.container.auth.status

ユーザーのステータスが含まれるヘッダーの名前。値には、0=ACTIVE、10=UNAPPROVED、20=LOCKED_OUT、30=INACTIVEがあります。

enterprise.container.auth.email

ユーザーの電子メールが含まれるヘッダーの名前

enterprise.container.auth.phone

ユーザーの電話番号が含まれるヘッダーの名前

enterprise.container.auth.roles

ユーザーのロールが含まれるヘッダーの名前

enterprise.container.auth.depts

ユーザーの部門が含まれるヘッダーの名前

enterprise.container.auth.enable-synch-depts

trueの場合、コンテナからユーザーの部門を取得します

enterprise.container.auth.enable-synch-roles

trueの場合、コンテナからユーザーのロールを取得します

enterprise.container.auth.assign-default-roles

trueの場合、ユーザーにデフォルトのロールが割り当てられます

enterprise.container.auth.auto-create-missing-roles

trueの場合、欠落しているロールを自動作成します

enterprise.container.auth.auto-create-missing-depts

trueの場合、欠落している部門を自動作成します

enterprise.container.auth.roles-single-header

trueの場合、ロールが単一のヘッダーで渡されます

enterprise.container.auth.roles-delimiter

ロール名の間のデリミタ

enterprise.container.auth.depts-single-header

trueの場合、部門が単一のヘッダーで渡されます

enterprise.container.auth.depts-delimiter

部門名の間のデリミタ

17.5.3.7 コンテナ・ログイン設定

図17-68 コンテナ・ログイン設定

- フォールバック認証

- enterprise.loginmodules.fallbackauthentication

- フォールバック認証を有効にします。

- コンテナ・ログイン・モジュール・クラス名

- enterprise.loginmodules.containerloginmodule.classname

- テキスト・ボックスに入力したテキストにより、コンテナ・ログイン・モジュールのクラス名が識別されます。

- コンテナ・ログイン・モジュール表示名

- enterprise.loginmodules.containerloginmodule.displayname

- テキスト・ボックスに入力したテキストがコンテナ・ログイン・モジュールの表示名として表示されます。

- コンテナ・ログイン・モジュール

- enterprise.loginmodules.containerloginmodule.enabled

- コンテナ・ログイン・モジュールを有効にするには、「True」オプションを選択します。

- コンテナ・ログイン・モジュール - 内部チェック

- enterprise.loginmodules.containerloginmodule.internalchecking

- コンテナ・ログイン・モジュールの内部チェックを有効にするには、「True」オプションを選択します。

17.5.3.8 Cookieログイン設定

図17-69 Cookieログイン設定

- Cookieログインの許可

- enterprise.security.cookielogin.allow

- Cookieを使用した自動ログインを有効にするには、「True」オプションを選択します。無効な場合は、手動ログインが必要です。

- Cookieログインをデフォルトに設定

- enterprise.security.cookielogin.default

- Oracle Enterprise Repositoryのログイン・ダイアログで「自動ログインの有効化」をデフォルトとして設定するには、「True」オプションを選択します。

図17-70 Oracle Enterprise Repositoryのログイン・ページ

- Cookieログイン・モジュール・クラス名

- enterprise.loginmodules.cookieloginmodule.classname

- テキスト・ボックスに入力したテキストにより、Cookieログイン・モジュールのクラス名が識別されます。

- Cookieログイン・モジュール表示名

- enterprise.loginmodules.cookieloginmodule.displayname

- テキスト・ボックスに入力したテキストがCookieログイン・モジュールの表示名として表示されます。

- Cookieログイン・モジュール

- enterprise.loginmodules.cookieloginmodule.enabled

- Cookieログイン・モジュールを有効にするには、「True」オプションを選択します。

- Cookieログイン・モジュール - 内部チェック

- enterprise.loginmodules.cookieloginmodule.internalchecking

- Cookieログイン・モジュールの内部チェックを有効にするには、「True」オプションを選択します。

17.5.3.9 ゲスト・ログイン設定

図17-71 ゲスト・ログイン設定

- ゲスト・ユーザーの許可

- enterprise.guest.allow

- ゲスト・ログイン・アカウントの使用を有効にするには、「True」オプションを選択します。

- ゲスト・ユーザー名

- enterprise.guest.username

- テキスト・フィールドに入力したテキストは、ゲスト・ログイン・アカウントのユーザー名を表します。

- ゲスト・ユーザー・パスワード

- enterprise.guest.password

- テキスト・フィールドに入力したテキストは、ゲスト・ログイン・アカウントのパスワードを表します。

17.5.4 オープンAPI設定

この項には、次のオープンAPI設定が含まれます。

17.5.4.1 オープンAPI

図17-72 オープンAPI

プロパティ

- オープンAPI

- cmee.extframework.enabled

- オープンAPIを有効にします。

- オープンAPIのテスト機能

- cmee.extframework.test.enabled

- オープンAPIに組み込まれたテスト機能を有効にします。

- オープンAPI - 最大アセット数

- cmee.extframework.assets.max

- オープンAPIを介して問合せから返されるアセットの最大数。

- オープンAPI - 最大プロジェクト数

- cmee.extframework.projects.max

- オープンAPIを介して問合せから返されるプロジェクトの最大数。

- オープンAPI - 最大ユーザー数

- cmee.extframework.users.max

- オープンAPIを介して問合せから返されるユーザーの最大数。

- オープンAPI - 一時エクスポート・ファイルの場所

- cmee.extframework.export.tempfile

- 一時エクスポート・ファイルのパス。

注意:

REXオープンAPIの詳細は、『Oracle Fusion Middleware Oracle Enterprise Repository統合ガイド』の「リポジトリ拡張性フレームワーク」を参照してください。

17.5.5 外部統合設定

この項には次のトピックが含まれます:

- 17.5.5.1項「UDDI」

- 17.5.5.2項「ファイル・ストア」

- 17.5.5.3項「Rational ClearCase」

- 17.5.5.4項「イベンティング」

17.5.5.1 UDDI

図17-73 UDDI

- UDDI

- cmee.uddi.enabled

- UDDI Webサービス・プラグインを有効にします。

- UDDI - デフォルト・ビジネス

- cmee.uddi.default.business

- リストを使用して、ビジネスが割り当てられていないUDDIサービスに割り当てるデフォルトのビジネス・エンティティを選択します。

- ビジネス・サービス・リレーションシップ名

- cmee.uddi.business.service.relationship

- リストを使用して、UDDIビジネス・サービスをUDDIビジネス・エンティティにリンクするリレーションシップを選択します。

- UDDI

- cmee.uddi.server.enabled

- Oracle Enterprise Repositoryが選択されたアプリケーションのUDDIレジストリとして機能することを許可するには、「True」オプションを選択します。

- インポート- デフォルトのUDDIサービス・タイプ

- cmee.import.uddi.service.assettype

- リストを使用して、インポートされたUDDIサービスに割り当てるデフォルトのアセット・タイプを指定します。

17.5.5.2 ファイル・ストア

図17-74 ファイル・ストア

- 拡張アクセス・ファイル・ストア

- registry.advanced.filestores.enabled

- 拡張ファイル・ストア・オプションを設定するには、「True」オプションを選択します。

17.5.5.3 Rational ClearCase

図17-75 Rational ClearCase

- 構成仕様

- cmee.config-spec.enabled

- アセットに対する構成仕様ファイルのアタッチメントを有効にするには、「True」オプションを選択します。

17.5.5.4 イベンティング

図17-76 イベンティング

- イベント・マネージャの有効化

- cmee.eventframework.enabled

- 拡張登録フロー・サブシステムを有効にするには、「True」オプションを選択します。

- イベント・マネージャ通知サービス・スレッド・スリープ(秒)

- cmee.eventframework.notifier.sleep

- エンドポイントが使用できない場合に、通知サービスがイベントの送信を再試行するまで待機する必要のある時間を秒単位で指定します。

- イベント・マネージャ・ストア・スレッド・スリープ(秒)

- cmee.eventframework.store.sleep

- イベント・マネージャのストア・マネージャ・スレッドが、メモリーに格納されている次に使用可能なイベントをポーリングするまでスリープする必要がある時間を秒単位で指定します。

- イベント・マネージャ配信スレッド・スリープ(秒)

- cmee.eventframework.delivery.sleep

- イベント・マネージャの配信マネージャ・スレッドが、JMSサーバーから次に使用可能なイベントを選択するまでスリープする必要がある時間を秒単位で指定します。

17.5.6 インポート/エクスポートおよびイントロスペクション設定

この項には次のトピックが含まれます:

- 17.5.6.1項「インポート/エクスポート」

- 17.5.6.2項「WSDLおよびXSD」

17.5.6.1 インポート/エクスポート

図17-77 インポート/エクスポート

- クライアントのインポート/エクスポート

- cmee.importexport.enabled

- クライアントのインポート/エクスポートを有効にするには、「True」オプションを選択します。

- インポート/エクスポート・ジョブ・モニターの最大アイドル時間(ミリ秒)

- cmee.extframework.impexp.monitor.maxidle

- テキスト・フィールドに入力した値は、インポート/エクスポート・ジョブがジョブ・モニターによって自動的に中断されるまでアイドル状態を維持できる最大時間(ミリ秒)を表します。

- インポート/エクスポート・ジョブ・モニターのRexトランザクションの最大アイドル時間(ミリ秒)

- cmee.extframework.impexp.monitor.rex.maxidle

- テキスト・フィールドに入力した値は、Rexトランザクションがジョブ・モニターによって自動的に中断されるまでアイドル状態を維持できる最大時間(ミリ秒)を表します。

- インポート/エクスポート・ジョブ・モニターの最大実行時間(ミリ秒)

- cmee.extframework.impexp.monitor.maxruntime

- テキスト・フィールドに入力した値は、インポート/エクスポート・ジョブがジョブ・モニターによって自動的に中断されるまで動作できる最大時間(ミリ秒)を表します。

- インポート/エクスポート・ジョブ・モニターの間隔(ミリ秒)

- cmee.extframework.impexp.monitor.period

- テキスト・フィールドに入力したテキストは、ジョブ・モニターのスキャンの間隔(ミリ秒)を表します。

- インポート/エクスポート・ジョブ・モニターの自動クリーンアップ(ミリ秒)

- cmee.extframework.impexp.monitor.autocleanup

- テキスト・フィールドに入力した値は、インポート/エクスポート・ジョブの結果がジョブ・モニターによって自動的にクリーンアップされるまでシステム内に残る時間(ミリ秒)を表します。

- インポート/エクスポート・ジョブ・プロキシの間隔(ミリ秒)

- cmee.extframework.impexp.proxy.period

- テキスト・フィールドに入力したテキストは、他のクラスタ・ノードのジョブ・ステータスに関するジョブ・プロキシによるチェックの間隔(ミリ秒)を表します。

- インポート/エクスポート・ジョブ・プロキシのタイムアウト(ミリ秒)

- cmee.extframework.impexp.proxy.timeout

- テキスト・フィールドに入力したテキストは、他のクラスタ・ノードのリモート・ジョブ・ステータスのモニタリングをジョブ・プロキシが停止するまでの時間(ミリ秒)を表します。

- インポート/エクスポート監査一時ファイルの場所

- cmee.extframework.impexp.audit.dir

- テキスト・フィールドに入力したテキストは、一時ファイルが作成時に格納されるディレクトリを表します。これらのファイルは、処理後にクリーンアップされます。

17.5.6.2 WSDLおよびXSD

図17-78 WSDLおよびXSD

- WSDLイントロスペクション要素の有効化

- cmee.wsdl-introspection.enabled

- WSDLサマリー情報を表示するアセット詳細プラグイン要素を有効にするには、「True」オプションを選択します。

17.6 既知の問題

この項では、Oracle Enterprise Repositoryのシステム設定プロパティで見つかった問題について説明します。

システム設定プロパティの重複

Oracle Enterprise Repositoryの「システム設定」ページで、次のプロパティ名が2回表示されます。

「サーバー設定」で、サーバー・リソース設定セクションに次の重複プロパティがあります。

WebApp JSPパス

enterprise.server.paths.jsp = {%cmee.server.paths.jsp%}

WebAppサーブレット・パス

enterprise.server.paths.servlet = {%cmee.server.paths.servlet%}

これら2つの設定は、静的のままであるとともに、対応するプロパティであるcmee.server.paths.jspおよびcmee.server.paths.servletをそれぞれ参照している必要があります。

A Oracle Enterprise Repositoryワークフローの構成

この章では、Oracle Enterprise Repositoryワークフローを設定および構成する方法、および登録プロセスを使用してOracle Enterprise Repositoryのアセットを管理する方法について説明します。

この章には、次のセクションがあります。

- A.1項「Oracle Enterprise Repositoryワークフローの概要」

- A.2項「Oracle Enterprise Repository自動ワークフローの概要」

- A.3項「Oracle Enterprise RepositoryワークフローのOracle BPM 10.3へのインストール」

- A.4項「Oracle Enterprise Repositoryイベント・マネージャの構成」

- A.5項「Oracle Business Process Managementプロセスの管理」

- A.6項「自動ワークフローの構成」

- A.7項「Oracle Enterprise Repository用のJMSサーバーの構成」

- A.8項「イベントのモニタリングおよび管理」

- A.9項「Webサービス・エンドポイントのイベント・マネージャの拡張」

- A.10項「OERワークフローの操作」

- A.11項「自動ワークフローを使用する前に」

- A.12項「「コミュニティ・フロー」ユースケース」

A.1 Oracle Enterprise Repositoryワークフローの概要

再使用に適していると確認されたアセットは、リポジトリに発行されます。発行されたアセットはレジストラによってレビューされ、登録プロセスを進めるアセットが決定されます。

図A-1 Oracle Enterprise Repositoryワークフロー

図A-1に示すように、レジストラによって受け入れられたアセットは登録ワーク・キューに入ります。発行者は、My Stuffページの「個人の発行」フォルダを使用して、登録に向けたアセットの進捗状況を追跡できます。発行者は、拒否されたアセットおよび拒否の理由(たとえば、重複したアセット)に関する通知を受信します。

Oracle Business Process Management (Oracle BPM)およびOER

プロセスにより、ビジネスが推進されます。注文の実行、雇用決定のエスカレーション、保持するレコードの決定、または製品の価格設定方法の決定を行う場合、暗黙的または明示的にビジネス・プロセス内で行動していることになります。Oracle Business Process Managementは、ビジネス・プロセスを作成、実行および最適化するツールの完全なセットです。Oracle BPMでは、既存のIT投資が活用されます。また、Oracle BPMは、ライン・オブ・ビジネスの所有者用として特別にチューニングされます。

Oracle Enterprise Repositoryには、登録プロセスとガバナンス・プロセスを自動化するために事前に構築されたBPMアセット登録フローがバンドルされています。事前に構築されたBPMアセットの登録フローは、インストールに固有のアセット・タイプ、ライフサイクル・ステージ、カテゴリ分け、ユーザーおよび他のOER構成を使用するように構成できます。登録フローの連鎖により、即時利用可能な幅広い種類のユースケースをサポートできます。事前に構築されたフローが目的に対して十分ではない場合は、事前定義されたOracle BPMエンドポイントを使用するか、独自のWebサービス・エンドポイントを作成してOracle Enterprise Repositoryイベントをサブスクライブすることができます。Oracle BPMデザイナを使用して、新しいガバナンス・ワークフローを作成できます。また、トラブルシューティングおよびチューニングを目的としたイベント・モニタリング・ツールやロギング・ツールも用意されています。

Oracle Business Process Managerでのワークフローの開発の詳細は、『Oracle Fusion Middleware Oracle Business Process Managementモデリングおよび実装ガイド』を参照してください。

A.2 Oracle Enterprise Repository自動ワークフローの概要

Oracle Enterprise Repositoryには、アセットの発行、受入れ、登録、Oracle Enterprise RepositoryとOracle Service Registryの同期、および他のガバナンス・プロセスなどの一般的なOracle Enterprise Repositoryタスクを自動化するために設計された一連の事前定義済フローが用意されています。

このセクションでは、次のトピックについて説明します。

- A.2.1項「ソフトウェア・コンポーネント」

- A.2.2項「自動ワークフロー」

- A.2.3項「イベント管理ツール」

A.2.1 ソフトウェア・コンポーネント

自動ワークフローには、次のソフトウェア・コンポーネントが含まれます。

Oracle Enterprise Repositoryイベント・マネージャ

イベント・マネージャは、アセット登録イベントをWebサービス・メッセージの形式で発行します。これらのイベントにより、Oracle Enterprise Repositoryアセットの発行、受入れ、登録、および他のガバナンス・プロセスなどを自動化する事前定義済のフローがトリガーされます。

詳細は、A.4項「Oracle Enterprise Repositoryイベント・マネージャの構成」を参照してください。

サブスクリプション・マネージャ

サブスクリプション・マネージャは、一致するイベントが配信されるWebサービス・エンドポイント(事前定義済のALPBMまたはユーザー定義のエンドポイント)によるイベント・サブスクリプションを管理するXMLベースの構成ファイルです。イベント・マネージャは、EndPointEventSubscription.xmlファイルを使用して、イベントを配信する必要があるエンドポイントに関する情報をロードします。

詳細は、A.4項「Oracle Enterprise Repositoryイベント・マネージャの構成」を参照してください。

JMSサーバー

イベント・マネージャは、デフォルトで有効になっているApache ActiveMQ JMSサーバーの組込みバージョンを使用します。組込みJMSサーバーは、追加構成なしで即時利用可能な状態で実行できるよう構成されています。ただし、Weblogic Server JMSやIBM MQSeriesなどの外部JMSサーバーを使用するようにイベント・マネージャを構成することもできます。

詳細は、A.7項「Oracle Enterprise Repository用のJMSサーバーの構成」を参照してください。

Event Monitor

イベント・マネージャによって生成されたイベントをモニターするためのツールです。Event Monitorは、イベント・トラフィックをモニターし、イベント本体やイベント・プロパティなどの情報を出力します。

詳細は、A.8項「イベントのモニタリングおよび管理」を参照してください。

Oracle Business Process Management

Oracle Business Process Managementは、購入したOracle Enterprise Repositoryに含まれています。Oracle Business Process Managementを使用して、事前に構築された登録フローの実行、Oracle Enterprise Repositoryとともに提供されている既存のワークフローの変更、および新しいリポジトリ集中型ワークフローの実装を行うことができます。

A.2.2 自動ワークフロー

自動ワークフローは、追加設定なしで実行することも、使用環境に合うように調整することもできます。詳細は、A.6項「自動ワークフローの構成」を参照してください。

次の自動ワークフローが提供されます。

- コミュニティ割当てフロー: 自動割当てルールの構成を可能にすることによってアセットの受入れ、割当て、登録プロセスを自動化する方法を提供するとともに、様々な機関の間のフェデレーテッド・レジストラに関する概念を提供します。詳細は、A.6.4.1項「コミュニティ・フローの構成」を参照してください。

- 自動受入れおよび自動登録フロー: コミュニティ・フローを使用したアセットの自動的な受入れおよび登録に加えて、複数のユーザー・ロールを使用したアセットの受入れおよび登録が可能です。詳細は、A.6.4.2項「自動受入れおよび自動登録フローの構成」を参照してください。

- 複数層承認フロー: 層と呼ばれる複数の手順でタブ承認プロセスを構築します。アセット承認タブは層単位にグループ化できます。また、複数層承認フローでは、指定した承認者によってすべてのタブが承認されているかどうかを確認するために各層が追跡されます。層内の最後のタブが承認されると同時に、フロー内では、指定した承認者の次のレベルにアセットを割り当てることによって次の層が開始されます。詳細は、A.6.5項「複数層自動割当てフロー」を参照してください。

- メタデータ変更フロー: 状態変更またはメタデータ変更をアクションにワイヤリングできる柔軟なフレームワークを公開します。メタデータ変更フローには、事前にバンドルされた一連のアクションが用意されています。新しいアクションは、Oracle Enterprise Repositoryフローの形式で開発し、プラグインできます。詳細は、A.6.6項「メタデータ変更フロー」を参照してください。

- 時間ベースのエスカレーション・フロー: 様々な状態のアセットを追跡し、すべての当事者に通知します。時間ベースのエスカレーション・フローには4種類があり、各種を個別に構成できます。詳細は、A.6.7項「時間ベースのエスカレーション・フロー」を参照してください。

- 有効期限の検証フロー: 指定した有効期限より前に期限が切れたアセットや、期限日に期限が切れたアセットを追跡し、すべての当事者に警告通知を送信します。詳細は、A.6.8項「有効期限の検証フロー」を参照してください。

- AutoSyncAlerToUddiフロー: アセット・ライフサイクル・ステージがステージ4 - 構築からステージ5 -本番に変更されたときに、サービスをOracle Enterprise RepositoryからOracle Service Registryに移動します。詳細は、10.3.1.1項「ワークフローを使用したOracle Registry Repository Exchange Utilityの起動」を参照してください。

A.2.3 イベント管理ツール

トラブルシューティングおよびチューニングを目的としたイベント・モニタリング・ツールやロギング・ツールが用意されています。

A.2.3.1 Webベースのプロセス・アドミニストレータ

Oracle Business Process Management Process Execution Administratorは、アセット登録イベントの編成をWebサービス・メッセージの形式でアクティブに管理します。詳細は、A.5項「Oracle Business Process Managementプロセスの管理」を参照してください。

A.2.3.2 ログ・ビューア

Oracle Business Process Managementログ・ビューアを使用すると、プロセス実行エンジンによって記録された情報を読み取ることができます。定義するプロジェクトごとに一連のログ・ファイルが作成されます。Studioログ・ビューアにより、ファイルが読み取られて表示されるため、エンジンの実行をモニターして追跡できます。詳細は、A.5.5項「Oracle Business Process Managementログ・ビューアの使用」を参照してください。

A.2.3.3 電子メール通知テンプレート

自動登録フローでは、多くの状況下で電子メール通知が自動的に送信されます。管理者は、他の電子メール・テンプレートの場合と同じ方法で電子メールの件名や本文などをカスタマイズできます。A.6.9項「電子メール通知テンプレートのカスタマイズ」を参照してください。

A.2.3.4 ワークフロー構成ツール

新しい構成ファイルの生成、既存のファイルのリフレッシュ、およびパスワードの暗号化を行うためのワークフロー構成ツールが用意されています。詳細は、A.8項「イベントのモニタリングおよび管理」を参照してください。

A.2.3.5 新規構成ファイルの生成

Oracle Enterprise Repository管理者によるフローの構成およびカスタマイズが必要になる場合がありますが、これは、新しいアセット・タイプ、プロジェクト、カテゴリ分けなどが存在するためです。構成XMLの生成ツールを使用すると、Oracle Enterprise Repositoryにアクセスし、カスタマイズ可能な新しいファイルを作成できます。

A.2.3.6 既存の構成ファイルのリフレッシュ

構成XMLのリフレッシュ・ツールを使用すると、イベント・マネージャを再起動せずに構成XMLファイルをリフレッシュできます。

A.2.3.7 構成ファイルのパスワードの暗号化

セキュリティ暗号化パスワード・ツールを使用すると、セキュリティ上の理由により、パスワードを暗号化できます。

A.3 Oracle Enterprise RepositoryワークフローのOracle BPM 10.3へのインストール

Oracle Enterprise Repositoryには、A.10項「OERワークフローの操作」に定義されている、登録プロセスとガバナンス・プロセスを自動化するために事前に構築されたBPMアセット登録フローがバンドルされています。使い勝手を向上させるために、事前定義されたOracle BPMエンドポイントを使用するか、独自のWebサービス・エンドポイントを作成してOracle Enterprise Repositoryイベントをサブスクライブすることができます。Oracle BPMデザイナを使用して、新しいガバナンス・ワークフローを作成できます。また、トラブルシューティングおよびチューニングを目的としたイベント・モニタリング・ツールやロギング・ツールも用意されています。

The Oracle BPMワークフロー・アーカイブは、OERにバンドルされており、<OER_HOME>/core/tools/solutionsにあります。このアーカイブには、主にOracle BPMでOERワークフロー・エンジンを初期化することを目的としたOSおよびAntスクリプト(build.xml)とともにworkflow.xmlが含まれています。特に、Antスクリプトは、別のファイルであるbuild.propertiesに依存しています。このファイルは、Oracle BPMのインストール、サーバーおよびデータベースの場所を識別します。

ワークフロー関連の別のユーティリティは、<OER_HOME>/core/workflow-toolsにあります。通常、これらのツールは、OERイベント・キューのクリアや、最新のワークフロー構成を使用したOBPMのリフレッシュなどのワークフロー・メンテナンスをサポートすることを目的としています。

この項では、Oracle Enterprise Repository WorkflowをOracle BPM 10.3.2にインストールする方法について説明します。内容は次のとおりです。

- A.3.1項「要件」

- A.3.2項「手順1: Oracle BPM 10.3.2のインストール」

- A.3.3項「手順2: Oracle Enterprise Repositoryワークフロー・インストーラの解凍」

- A.3.4項「手順3: build.propertiesファイルの構成」

- A.3.5項「手順4: setenvファイルの構成」

- A.3.6項「手順5: workflow.xmlファイルの生成(再生成)」

- A.3.7項「手順6: workflow.xmlファイルの編集」

- A.3.8項「手順7: workflow.xmlファイルの暗号化」

- A.3.9項「手順8: JDBC jarのコピー」

- A.3.10項「手順9: 権限の検証」

- A.3.11項「手順10: 設定スクリプトの実行」

- A.3.12項「手順11: 設定スクリプトの検証」

A.3.1 要件

Oracle Enterprise Repositoryワークフローをインストールする前に、次の要件について検討してください。

- Apache Antバージョン1.6.5以上

- Oracle BPM 10.3.2 Enterpriseインストール

- Oracle Enterprise Repository 11g

- Oracle Enterprise RepositoryのURLおよびポート番号

- 選択したデータベース・サーバー内でユーザー、表、索引を作成できるDBAユーザー・アカウント

- 選択したデータベース・サーバーに適したJDBCドライバ

- インストールの実行に必要なDB権限の識別

- JDKバージョン1.6以上(非GUIモードでのインストールの場合はJDKバージョン1.5)

- 最新のホットフィックス・ビルドのダウンロードおよびOracle BPMインストールへの適用

A.3.2 手順1: Oracle BPM 10.3.2のインストール

Oracle BPM 10.3.2をインストールするには、次の手順を実行します。

1. Oracle Business Process Management (Enterprise) 10gR3 (10.3.2)をhttp://www.oracle.com/technetwork/middleware/bpm/downloads/index-100737.htmlからダウンロードします。

2. Ps4JDKを指すようにJAVA_HOMEを設定します。

3. BPMインストール・ウィザードを実行し、デフォルトのままにします。インストール・ディレクトリとして/Oracle/Middleware/obpm/enterpriseを入力します。

4. インストール・ウィザードが終了したら、インストーラの終了を選択し、ウィザードを閉じます。
図A-2に示すように、/Oracle/Middleware/obpm/enterprise/binディレクトリには、BPMエンジンを起動するためのスクリプトがすべて格納されています。

図A-2 /Oracle/Middleware/obpm/enterprise/binディレクトリの例

A.3.3 手順2: Oracle Enterprise Repositoryワークフロー・インストーラの解凍

Oracle Enterprise Repositoryワークフロー・インストーラを解凍するには、次の手順を実行します。

1. Oracle Enterprise Repositoryがインストールされている場所で、ORACLE_HOME/repositoryXXX/core/tools/solutions/11.1.1.x.x-OBPM-Workflow-Management-Scripts.zipディレクトリ内にあるOracle Enterprise Repositoryワークフロー・インストーラを検索します。

2. Oracle BPMがインストールされているサーバー上でzipファイルを/Oracle/Middleware/obpmディレクトリに解凍します。
このzipファイルから、OBPM_SetupScriptsとworkflowの2つのディレクトリが作成されます。また、build.txtファイルも作成されます。

A.3.4 手順3: build.propertiesファイルの構成

ORACLE_HOME\obpm\OBPM_SetupScripts\build.propertiesファイルに正しい値を入力します。

表A-1に、build.propertiesファイルにリストされているプロパティと、各プロパティの説明および例を示します。build.propertiesファイルでは、@は、置き換える必要がある値を示します。各スクリプトでは、このプロパティ・ファイルの値が使用されます。

注意:

パス要素を区切るには、プラットフォームに関係なくフォワード・スラッシュ文字を使用します。

データベース・スキーマをAntタスクで正しく作成するには、Oracle Enterprise RepositoryワークフローをホストするDBAユーザー・アカウントをbuild.propertiesファイルのfuego.fdi.db.admin.id設定で指定する必要があります。このDBAユーザー・アカウントは、Antタスクによってデータベース内に作成される新しいユーザーです。

表A-1 build.propertiesファイルのプロパティ値

プロパティ

説明

bea.home

このプロパティは、Oracleホーム・ディレクトリの場所を指定します。

例: c:/oracleまたは/Oracle/Middleware

oer.uri

このプロパティは、Oracle Enterprise RepositoryインストールのURIを指定します。また、URIの一部としてservices/FlashlineRegistryが存在する必要があります。

例: http://localhost:1111/oer/services/FlashlineRegistry

fuego.basedir

このプロパティは、Oracle BPMインストールの場所を指定します。

例: c:/oracle/obpm/enterpriseまたは/opt/oracle/obpm/enterprise

fuego.project

このプロパティは、Oracle BPMプロジェクトの場所を指定します。推奨どおりにOracle BPMインストールの場所を採用した場合、次の値は変更されません。

fuego.project=${basedir}/../workflow/aler_workflow

注意: {basedir}は、build.propertiesファイル内のfuego.basedirパラメータの値を参照しています。

fuego.fdi.id

これは、Fuegoディレクトリ・プロパティ(FDI)です。build.propertiesファイルで示される値を変更しないでください。

例: fuego.fdi.id=aler_fdi

fuego.fdi.organization

これは、Fuegoディレクトリ・プロパティ(FDI)です。build.propertiesファイルで示される値を変更しないでください。

例: fuego.fdi.organization=BEA

fuego.fdi.admin.id

Oracle BPMインストールの新しい管理ユーザーを作成します。このユーザー・アカウントは、Oracle BPM Webコンソール・アプリケーションにアクセスするために使用されます。

例: oer_bpm_admin

fuego.fdi.admin.password

Oracle BPMインストールの新しい管理パスワードを定義します。

注意: 管理ユーザー名およびパスワードは同じものにしないでください。

fuego.fdi.db.host

このプロパティは、Oracle BPM FDI (ディレクトリ)データベースをインストールするマシンを指定します。

例: localhost

fuego.fdi.db.port

このプロパティは、Oracle BPM FDIデータベース・ポートを指定します。

fuego.fdi.db.admin.id

このプロパティは、Oracle BPM FDIデータベースのデータベース管理ユーザーを指定します。インストーラでは、このプロパティを使用してFDIスキーマがインストールされます(次を参照)。

fuego.fdi.db.admin.password

このプロパティは、Oracle BPM FDIデータベースのデータベース・ユーザーのパスワードを指定します。

fuego.fdi.db.type

このプロパティは、Oracle BPM FDIデータベースのデータベース・タイプを指定します。

例: oracle、mssqlserver、db2

fuego.fdi.db.sid

このプロパティは、Oracle BPM FDIデータベースのSIDを指定します。このプロパティは、Oracleデータベース・タイプに対してのみ適用されます。

fuego.fdi.db.schema

このプロパティは、データベースによって作成されるOracle BPM FDIスキーマのデータベース・ユーザー名を指定します。このプロパティは、実行時にOracle BPMによって使用される、Oracleデータベース・タイプに固有のプロパティです。

新しいユーザー・データベース・アカウントが作成されます。

例: oer_bpm_fdi

fuego.fdi.db.schema.password

このプロパティは、Oracle BPM FDIスキーマのデータベース・パスワードを指定する、Oracleデータベース・タイプに固有のプロパティです。

fuego.server.db.host

これら4つのプロパティは、データベースのFuegoエンジン・プロパティを定義します。

このプロパティは、Oracle BPMプロセス・エンジン・データベースをインストールするシステムを指定します。

例:

fuego.server.db.host=localhost

fuego.server.db.port=1111

fuego.server.db.admin.id=oer_bpm_engine

fuego.server.db.admin.password=oracle

fuego.server.db.port

このプロパティは、Oracle BPMプロセス・エンジン・データベースのポートを指定します。

fuego.server.db.admin.id

このプロパティは、Oracle BPMプロセス・エンジン・データベースのデータベース管理ユーザーを指定します。インストーラでは、このプロパティを使用してFDIスキーマがインストールされます(次を参照)。

fuego.server.db.admin.password

このプロパティは、Oracle BPMプロセス・エンジン・データベースのデータベース・ユーザーのパスワードを指定します。

fuego.server.db.type

このプロパティは、Oracle BPMプロセス・エンジン・データベースのデータベース・タイプを指定します。

例: oracle、mssqlserver、db2

fuego.server.db.sid

このプロパティは、Oracle BPMプロセス・エンジン・データベースのSIDを指定します。このプロパティは、Oracleデータベース・タイプに対してのみ適用されます。

例: XE

fuego.fdi.db.user.id

mssqlserverおよびdb2データベース・タイプに対してのみ適用できます。

このプロパティは、データベースによって作成されるOracle BPM FDIスキーマのデータベース・ユーザー名を指定します。このプロパティは、実行時にOracle BPMによって使用されます。

fuego.fdi.db.user.password

mssqlserverおよびdb2データベース・タイプに対してのみ適用できます。

このプロパティは、Oracle BPM FDIスキーマのデータベース・パスワードを指定します。

fuego.fdi.db.database

mssqlserverおよびdb2データベース・タイプに対してのみ適用できます。

このプロパティは、Oracle BPM FDIデータベースのデータベース名を指定します。

fuego.server.db.user.id

mssqlserverおよびdb2データベース・タイプに対してのみ適用できます。

このプロパティは、作成されるプロセス・エンジン・スキーマのデータベース・ユーザー名を指定します。このプロパティは、実行時にOracle BPMによって使用されます。

fuego.server.db.user.password

mssqlserverおよびdb2データベース・タイプに対してのみ適用できます。

このプロパティは、Oracle BPMプロセス・エンジン・スキーマのデータベース・パスワードを指定します。

fuego.server.db.database

mssqlserverおよびdb2データベース・タイプに対してのみ適用できます。

このプロパティは、Oracle BPMプロセス・エンジン・データベースのデータベース名を指定します。

fuego.server.db.schema

このプロパティは、Oracle BPMプロセス・エンジン・データベースのデータベース管理ユーザー名を指定します。インストーラでは、このプロパティを使用してOracleデータベースのFDIスキーマがインストールされます。

fuego.server.db.schema.password

このプロパティは、Oracleデータベース・タイプのOracle BPMプロセス・エンジン・データベースのデータベース・パスワードを指定します。

警告:

build.propertiesファイルのバックアップ・コピーを作成してください。build.propertiesファイルは、Antスクリプトの実行後に削除されます。

A.3.5 手順4: setenvファイルの構成

ORACLE_HOME\obpm\OBPM_SetupScripts\setenv.batファイル(Windows)または/setenv.shファイル(UNIX)ファイルに正しい値を入力します。表A-2に、setenvファイルのプロパティとその説明を示します。

注意:

パス要素を区切るには、フォワード・スラッシュ文字(/)を使用します。

ヒント:

setenvスクリプトをLinuxまたはUNIX環境で実行する場合、正しいプロパティ値を使用してこのスクリプトを編集した後にこのスクリプトに対してdos2unixコマンドを実行してください。

表A-2 setenvファイルのプロパティ値

プロパティ

説明

BEA_HOME

このプロパティは、Oracleホーム・ディレクトリの場所を指定します。

例: /Oracle/Middleware

OBPM_INSTALL_DIR

このプロパティは、Oracle BPMがインストールされている親ディレクトリを指定します。

例: BEA_HOME/obpm

FUEGO_HOME

このプロパティは、Oracle BPMがインストールされている場所を指定します。

例: BEA_HOME/obpm/enterprise

JAVA_HOME

このプロパティは、システム上のJavaランタイムの場所を指定します。

例: ORACLE_HOME/obpm/j2eewl/jre

ANT_HOME

このプロパティは、マシン上のApache ANTインストールの場所を指定します。

例: C:/oracle/modules/org.apache.ant-1.6.5または/opt/oracle/modules/org.apache.ant-1.6.5

A.3.6 手順5: workflow.xmlファイルの生成(再生成)

新しいnew workflow.xmlファイルを生成し、新しいユーザー資格証明を使用して編集する必要があります。新しいアセット・タイプを作成するか、ユーザー(aleridがユーザーです)を追加する場合、workflow.xmlにこれらの変更を取得するためにワークフローを再生成する必要があります。また、再生成により、workflow.xmlファイル内のOER URIも更新されます。

注意:

実行するには、OERが稼働している必要があります。

workflow.xmlファイルは、ワークフロー構成の生成ツール(config_gen.bat)を使用して生成できます。このツールにより、Oracle Enterprise Repositoryに接続し、カスタマイズ可能なブートストラップ・ファイルを作成します。

workflow.xmlファイルはOracleによって提供されます。このファイルのバックアップ・コピーを作成してください。OERをインストールしたディレクトリに移動し、スクリプトを実行し、生成されたスクリプトをSetupscriptsフォルダにコピーします。

workflow.xmlファイルを生成または再生成するには、次の手順を実行します。

1. コマンド・プロンプトから、次のように、repository111/core/workflow-tools/にあるワークフロー構成の生成ツールを実行します。

> config_gen.bat URI User Password ConfigDir

意味は次のとおりです。

- URI = OER URI (次の形式を使用)
http://<host>:<port>/<oer web app name>/services/FlashlineRegistry

例: http://localhost:7001/alerbuild/services/FlashlineRegistry

- User = Oracle Enterprise Repositoryのユーザー名

- Password = Oracle Enterprise Repositoryのパスワード

- ConfigDir = workflow.xmlファイルが作成されたディレクトリ

2. 新しく生成したworkflow.xmlファイルを<Oracle Business Process Management Enterprise Edition>/enterprise/server/aler_engineディレクトリにコピーします。

3. 任意のXMLエディタを使用してworkflow.xmlファイルを開きます。

workflow.xmlファイルの生成の詳細は、A.8.4項「ワークフローの構成」を参照してください。

A.3.7 手順6: workflow.xmlファイルの編集

初回の編集では、正しいパスワードとURLをファイルに記載します。後で組織のニーズに合うようにワークフロー・ファイルを構成します。

1. ORACLE_HOME/obpm/OBPM_SetupScripts/workflow.xmlにあるworkflow.xmlファイルを編集し、このURIをOracle Enterprise RepositoryインストールのURIと一致するよう変更します。

2. パス参照の末尾にある/services/FlashlineRegistryは変更しません。

3. workflow.xmlファイル内のすべてのユーザー資格証明を正しい値に変更します。

注意:

BPM JDKを1.6に更新した際に設定したものと同じJDKパスを必ず使用してください。詳細は、A.3.2項「手順1: Oracle BPM 10.3.2のインストール」を参照してください。

A.3.8 手順7: workflow.xmlファイルの暗号化

Oracle Enterprise Repositoryワークフロー構成ファイルworkflow.xmlを暗号化するには、次の手順を実行します。

1. http://<host>:<port>/oer/diag/encryptstrings.jspに移動します。

2. workflow.xmlファイルに対して暗号化を実行します。

3. workflow.xmlファイルを/obpm/enterprise/server/aler_engineにコピーします。

workflow.xmlファイルを暗号化するための別の方法は、5.3.3項「ワークフロー構成ファイル」を参照してください。

A.3.9 手順8: JDBC jarのコピー

データベースのJDBC jarを$Oracle_HOME\OBPM_SetupScripts\extディレクトリにコピーします。

A.3.10 手順9: 権限の検証

OBPM_SetupScriptsおよびworkflowフォルダの権限を検証し、これらが書込み可能であることを確認してください。

A.3.11 手順10: 設定スクリプトの実行

ヒント:

Antスクリプトが正常に実行されたら、build.propertiesファイル内に格納されているパスワードに関するセキュリティ上の懸念により、このファイルは削除されます。これを回避することはできないため、予防策としてバックアップを作成します。fuego.fdi.admin.idおよびfuego.fdi.admin.passwordプロパティは、Oracle BPM Webコンソール・アプリケーションに後でログインするために記録する必要があります。

setenv.shを使用している場合、このファイル内にDOS文字が存在しないようにdos2unixコマンドを実行する必要がある可能性があります。このファイル内にDOS文字が含まれる場合、問題が発生します。

setenv.shは、BASHシェルで. ./setenv.shという形式で実行する必要があります。ANT_homeが設定されていることを確認してください。

setenv.batまたはsetenv.shファイルを実行するには、次の手順を実行します。

1. コマンドまたはシェル・ウィンドウを開きます。

2. $Oracle_HOME\OBPM_SetupScriptsディレクトリに移動します。

3. 次のコマンドを実行します。
setenv.bat (Windows)

setenv.sh (UNIX) BASHシェルを使用する場合は、. ./setenv.shを実行します。Antホームが設定されていることを確認してください。

ant create-fdiを実行してOBPMデータベースを初期化してから、ant install-workflowを実行してOBPMワークフロー・エンジン(aler_engineという名前)を初期化します。

4. 次のコマンドを実行します。
ant create-fdi

5. 次のコマンドを実行します。
ant install-workflow

A.3.12 手順11: 設定スクリプトの検証

設定スクリプトが成功したことを確認するには、次の手順を実行します。

1. Enterprise/binディレクトリで、obpmadmcenterを起動します。
Oracle BPM Admin Centerアプリケーションを開きます。

2. BPMアプリケーションの起動をクリックします。

3. プロセス・アドミニストレータの起動をクリックします。

4. WebコンソールのWebインタフェースにアクセスし、Oracle BPM Webコンソール・アプリケーションの資格証明を使用してログインします。
これらの資格証明は、build.propertiesファイル内のfuego.fdi.admin.idおよびfuego.fdi.admin.passwordプロパティに指定されています。

5. 左側のメニューの「エンジン」リンクを選択します。
aler_engineエンジンが、ステータス「停止中」で表示されます。

6. エンジン・アクション列の一番左のアイコンをクリックし、エンジンを起動します。
エンジンが実行されると、エンジンのステータスが「準備完了」になります。

7. Oracle BPMサービス・エンドポイントが適切にリスニングしていることを確認します。Webブラウザを使用して、ポート9000 (たとえば、http://localhost:9000/albpmServices/aler_engine/ws)でOracle BPMサーバーに接続します。

8. albpmServices/oer_engine/wsリンクをクリックします。
リンク先では、StatusChangeEndpointServiceListenerとRefreshConfigServiceListenerの2つのサービスがリストされています。

ヒント:

ワークフローのAntデプロイメント中にビルドの失敗またはエラーが表示された場合、次の手順に従います。

1. データベースからFDIスキーマ・ユーザーを削除します(build.propertiesファイル内のfuego.fdi.db.schemaに対して指定されているとおり)。

2. データベースからFDIエンジン・ユーザーを削除します(build.propertiesファイル内のfuego.server.db.schemaに対して指定されているとおり)。

3. BPMアプリケーションが実行されておらず、obpmadmcenter.exeが閉じられていることを確認します。

4. setenv.batまたはsetenv.shを実行します。

5. ant create-fdiコマンドを実行します。

6. ant install-workflowコマンドを実行します。

WEB-INF/classes/EndPointEventSubscription.xmlファイル内のOracle Enterprise Repositoryインストールをクリックし、Oracle BPMがインストールされているサーバーのIPアドレスまたは完全修飾ホスト名が含まれるように<sub:host>要素を変更します。

これで、Oracle Enterprise Repositoryワークフローがデプロイされます。

ワークフローを正常に実行するには、xmlファイル内のパスワードを暗号化してから、Oracle Enterprise Repositoryサーバーを再起動する必要があります。EndPointEventSubscription.xml内にクリア・テキストのパスワードがある場合、イベントはOracle BPMに配信されません。

パスワードが暗号化されていない場合、<ORACLE_HOME>\user_projects\domains\<oer_domain>\eventing.logファイルに次のログ・メッセージが表示されます。

サブスクリプション・データが不十分です。[<ENDPOINT_NAME>]という名前を持つエンドポイントには暗号化パスワードが必要です。

A.4 Oracle Enterprise Repositoryイベント・マネージャの構成

この項では、自動ワークフローを使用する前に完了する必要があるイベント・マネージャの構成について説明します。

この項には次のトピックが含まれます:

- A.4.1項「Oracle Enterprise Repositoryイベント・マネージャとは」

- A.4.4項「イベント・マネージャのシステム設定の構成」

- A.4.5項「サブスクリプション・マネージャの構成」

- A.4.6項「イベント・マネージャ・イベントのロギングの構成」

A.4.1 Oracle Enterprise Repositoryイベント・マネージャとは

イベント・マネージャはOracle Enterprise Repositoryに埋込みのコンポーネントであり、イベント・サブスクリプション、イベント永続性、イベントのフィルタ処理、およびイベント配信を管理します。Webサービス・エンドポイントはイベント・マネージャのサブスクリプション・マネージャをサブスクライブでき、Oracle Enterprise Repository内で生成されたアセット登録イベントはWebサービス・エンドポイントに配信されます。

図A-3に、関連する様々なコンポーネントを示します。

図A-3 自動ワークフロー・コンポーネント

イベント・マネージャは、デフォルトで有効になっているApache ActiveMQ JMSサーバーの組込みバージョンを使用します。組込みJMSサーバーは、追加構成なしで即時利用可能な状態で実行できるよう構成されています。ただし、WebLogic ServerやIBM WebSphereなどの外部JMSサーバーを使用するようにイベント・マネージャを構成することもできます。

この項では、自動ワークフローを使用する前に完了する必要があるイベント・マネージャの構成について説明します。

自動ワークフローの構成の詳細は、A.4項「Oracle Enterprise Repositoryイベント・マネージャの構成」を参照してください。

A.4.2 イベント・マネージャの構成

イベント・マネージャを構成するには、次の手順を実行します。

1. イベント・マネージャが外部Webサービス・エンドポイントにイベントを送信できるようにするには、イベント・マネージャをOracle Enterprise Repository内で有効にする必要があります。次のいずれかを実行できます。

- <OER Domain>\WEB-INF\classesディレクトリ内のeventing.propertiesファイルでcmee.eventframework.enabled=trueプロパティを有効にします。
または

- 3-2ページの「イベント・マネージャのシステム設定の構成」で説明されているように、Oracle Enterprise RepositoryのWebベースのコンソールのシステム設定を使用して有効にします。

2. デフォルトのcmee.eventframework.delivery.sleepおよびcmee.eventframework.store.sleepイベンティング・プロパティ値をチューニングして、Oracle Enterprise RepositoryおよびWebサービス・エンドポイントの全体的なパフォーマンスを制御することもできます。これらのプロパティは、イベント・マネージャによって毎秒トリガーされるイベントの数に直接影響します。たとえば、テストを目的としてレスポンス速度の向上が必要になる場合は、cmee.eventframework.store.sleepのデフォルト値である7200秒をテストのための適切な値に変更する必要があります。

3. イベント・マネージャでは、Oracle Enterprise Repositoryと同じロギング・フレームワークが使用されます。デフォルトでは、ファイルに記録するようにロギングが有効化されていますが、デバッグ文をコンソールに表示するには、<OER Domain>\WEB-INF\classesディレクトリにあるlog4fl.propertiesファイルに次のカテゴリを追加します。

例A-1 デバッグ文のコンソールへの表示

# eventing subsystem
log4j.category.com.bea.infra.event.core= debug,eventingLog,stdout
log4j.category.com.bea.infra.event.dm= debug,eventingLog,stdout
log4j.category.com.bea.infra.event.facade= debug,eventingLog,stdout
log4j.category.com.bea.infra.event.notifier= debug,eventingLog,stdout
log4j.category.com.bea.infra.event.store= debug,eventingLog,stdout
log4j.category.com.bea.infra.event.sub= debug,eventingLog,stdout

4. イベント・マネージャのサブスクリプション・マネージャを使用してWebサービスのサブスクリプションを構成します。

注意:

Oracle Business Process Managementプロセス・エンジンがOracle Enterprise Repositoryと同じマシン上で動作している場合、サブスクリプション・マネージャはその提供時点ではOracle Business Process Managementプロセス・エンジンと連携して動作するよう構成されています。この場合は、デフォルト設定のまま実行できるため、この手順はスキップできます。

要件によっては、<OER Domain>\WEB-INF\classesディレクトリの下にあるEndPointEventSubscription.xmlファイル内の次の情報の変更が必要になる場合があります。

- Host: Webサービス・エンドポイントがOracle Enterprise Repository以外のホストで動作している場合。
同じホストである場合、デフォルトのままにします。

- Port: Webサービス・エンドポイントのポートを指定します。
Oracle Business Process Managementがプロセス・エンジンとして使用されている場合、デフォルトのままにします。

- URI: WebサービスのURIを指定します。
Oracle Business Process Managementがプロセス・エンジンとして使用されている場合、デフォルトのままにします。

- Operation Name: Oracle Business Process Managementがプロセス・エンジンとして使用されている場合、デフォルトのままにします。使用可能な操作は、<OER Webapp path>/WEB-INF/libにあるmodules.eventing-11.1.1.x.x.jarファイル内のWSDLを参照してください。

- User Name/Password: Oracle Business Process Managementがプロセス・エンジンとして使用されている場合のみ、使用されます。
OBPMのデフォルトのユーザー名/パスワードは、aler_workflow_user/<encrypted_password>です。使用されるデフォルトのパスワード・テキストは、aler_workflow_passです。

- Expression: デフォルトは空です。つまり、すべてのイベントが配信されます。

5. Oracle Enterprise Repositoryを再起動して構成の変更内容を反映します。

A.4.3 アセット・イベントのトリガー

イベント・マネージャの構成後にイベントがトリガーされることを確認するには、次の手順を実行します。

1. WebベースのコンソールからOracle Enterprise Repositoryのアセット・エディタを起動します。Oracle Enterprise Repositoryのアセット・エディタの使用の詳細は、『Oracle Fusion Middleware Oracle Enterprise Repositoryユーザーズ・ガイド』を参照してください。

2. 図A-4に示すように、新しいアセットを作成します。

図A-4 Oracle Enterprise Repositoryのアセット・エディタ - 新規アセットの作成

注意:

アセット・タイプは「サービス」にする必要があります。

3. 「OK」をクリックし、アセットを発行します。

4. アセットが発行された後、Oracle Enterprise Repositoryコンソールに切り替え、図A-5に示すように、コンソールに出力される次のロギング文を確認します。

図A-5 イベント・モニタリング・コンソール

5. イベント・モニタリング・ツールを使用して、配信されるイベントのペイロードを表示できます。イベントのモニターおよび管理方法の詳細は、A.8項「イベントのモニタリングおよび管理」を参照してください。

必要に応じて、HarvesterSettings.xmlファイルを構成することにより、<triggerEvent>タグをtrueまたはfalseに設定し、ハーベスタ・タスクごとにBPMワークフロー・イベンティングを有効または無効にできます。

A.4.4 イベント・マネージャのシステム設定の構成

Oracle Enterprise Repositoryのシステム設定セクションを使用して、Oracle Enterprise Repositoryの基本操作を構成、および特定の機能を有効または無効にします。イベント・マネージャ関連の設定は、「External Integrations」カテゴリの「Eventing」グループの下にあります。

システム設定の詳細は、17.5.5項「外部統合設定」を参照してください。

WebLogic ServerやIBM WebSphereなどの外部のJMSサーバーを構成するために追加の「イベンティング」プロパティも用意されています。これらのプロパティの詳細は、A.7項「Oracle Enterprise Repository用のJMSサーバーの構成」を参照してください。

A.4.4.1 イベント・マネージャの有効化

イベント・マネージャが外部Webサービス・エンドポイントにイベントを送信できるようにするには、イベント・マネージャをOracle Enterprise Repository内で有効にする必要があります。

1. Oracle Enterprise Repositoryの「管理」画面上のサイドバーにある「システム設定」をクリックします。

2. 「システム設定」の「検索」ボックスに「Event」と入力し、イベント・マネージャ関連の設定をすべて表示します。

3. 「イベント・マネージャの有効化」プロパティcmee.eventframework.enabledの横にある「True」をクリックします。

4. 「保存」をクリックします。

5. Oracle Enterprise Repositoryを再起動して構成の変更内容を反映します。

A.4.4.2 オプションのイベント・マネージャ設定の構成

次の各項では、イベント・マネージャのパフォーマンスをチューニングするために使用できるオプションの"Eventing"プロパティについて説明します。

注意:

Eventingプロパティの変更後に変更を有効にするには、Oracle Enterprise Repositoryを再起動する必要があります。

この項には次のトピックが含まれます:

- A.4.4.2.1項「イベント・マネージャ通知サービス・スレッド・スリープ(秒)」

- A.4.4.2.2項「イベント・マネージャ・ストア・スレッド・スリープ(秒)」

- A.4.4.2.3項「イベント・マネージャ・ストア配信スリープ(秒)」

- A.4.4.2.4項「イベント・マネージャ配信のバッチ・サイズ」

A.4.4.2.1 イベント・マネージャ通知サービス・スレッド・スリープ(秒)

1つ以上のイベントをエンドポイントに発行する必要があるときにエンドポイントが使用可能でない場合、イベント・マネージャ通知サービスは、エンドポイントが使用可能になるまでイベントの配信を再試行します。cmee.eventframework.notifier.sleepプロパティは、通知サービスがイベントの配信を再試行するまで待機する時間を秒単位で構成します。

A.4.4.2.2イベント・マネージャ・ストア・スレッド・スリープ(秒)

イベントがトリガーされると同時に、イベント・マネージャは、Oracle Enterprise Repositoryスレッドがブロックされないように、イベントをJMSサーバーにプッシュする前にメモリーに格納します。cmee.eventframework.store.sleepプロパティは、イベント・マネージャのストア・マネージャ・スレッドが、メモリーに格納されているイベントの次に使用可能なバッチをポーリングするまでスリープする時間を秒単位で指定します。デフォルトのポーリング遅延は16秒です。

A.4.4.2.3イベント・マネージャ・ストア配信スリープ(秒)

デフォルトでは、イベント・マネージャは、イベントをバッチ単位で配信します。cmee.eventframework.delivery.sleepプロパティは、イベント・マネージャの配信マネージャ・スレッドが、JMSサーバーから次に使用可能なイベントを選択するまでスリープする時間を秒単位で指定します。バッチ間のデフォルトの遅延は13です。

ヒント:

デフォルトのcmee.eventframework.store.sleepおよびcmee.eventframework.delivery.sleepプロパティ値をチューニングして、Oracle Enterprise RepositoryおよびWebサービス・エンドポイントの全体的なパフォーマンスを制御することもできます。これらのプロパティは、イベント・マネージャによって毎秒トリガーされるイベントの数に直接影響します。たとえば、テストを目的としたレスポンス速度の向上が必要になる場合は、必要に応じて、cmee.eventframework.delivery.sleepのデフォルト値である13秒をテストのための適切な値に変更する必要があります。

A.4.4.2.4 イベント・マネージャ配信のバッチ・サイズ

イベント・マネージャがイベントをバッチ単位で配信する場合、配信されるバッチ・サイズはcmee.eventframework.delivery.batch.sizeプロパティを使用して構成できます。デフォルトのバッチ・サイズは100イベントです。配信対象のイベント数が少ないことをイベント・マネージャが検出すると、使用可能なイベントを配信してから、cmee.eventframework.delivery.sleepプロパティに構成されている時間の間スリープします。

A.4.5 サブスクリプション・マネージャの構成

サブスクリプション・マネージャは、一致するイベントが配信されるWebサービス・エンドポイントによるイベント・サブスクリプションを管理します。

サブスクリプション・マネージャ構成ファイルは、<oer webapp name>\WEB-INF\classes\EndPointEventSubscription.xmlにあります。

A.4.5.1 Webサービス・エンドポイントの構成

イベント・マネージャは、EndPointEventSubscription.xmlファイルを使用して、イベントを配信する必要があるWebサービス・エンドポイントに関する情報をロードします。例A-2に示すように、事前定義済のALPBMエンドポイントまたはユーザー定義のWebサービス・エンドポイントのホスト、ポート、URI、ユーザーおよびパスワードを構成する必要があります。

例A-2 Webサービス・エンドポイントの例

<sub:EventSubscriptionData xmlns:sub="http://www.bea.com/infra/events/subscription"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<sub:eventSubscription>
<!--The name should be unique within this file since this name is passed as the Durable subscriber name to the JMS Server-->
<sub:endPoint name="ALBPMEndpoint">
<!--The host of the Webservice Endpoint -->
<sub:host>localhost</sub:host>
--The port of the Webservice Endpoint -->
<sub:port>9000</sub:port>
<!--The URI of the Webservice Endpoint -->
<!--If you are using ALBPM5.7 uncomment the following line and comment the line
after -->
<!-- <sub:uri>fuegoServices/ws/StatusChangeEndpointServiceListener</sub:uri> --><sub:uri>albpmServices/aler_engine/ws/StatusChangeEndpointServiceListener</sub:uri>
<!--Unless a custom WSDL Contract is used, the namepsace should not be changed -->
<sub:targetNamespace>http://www.bea.com/infra/events</sub:targetNamespace>
<!--The Webservice operation that is invoked. Please refer to the WSDL in WEB-INF\lib\modules.eventing-11.1.1.x.x.jar for all the available operations-->
-Unless a Custom Webservice is implemented, the operation should not be changed if it's ALBPM -->
<sub:operationName>newEvent</sub:operationName>
<!--Protocol for the Webservice Endpoint.  -->
<sub:protocol>HTTP</sub:protocol>
<!--The user and password to authenticate the ALBPM Webservice. -->
<sub:authenticationData>
<sub:basicAuthentication>
<sub:username>aler_workflow_user</sub:username>
<sub:password>******</sub:password>
</sub:basicAuthentication>
</sub:authenticationData>
</sub:endPoint>
<!--The Java class that serializes the Event Data. Unless a custom class is written, this value should not be changed.-->
<sub:notifierClass>com.bea.infra.event.notifier.plugin.http.DefaultHTTPEventNotifier</sub:notifierClass>
<!--This expression filters the Event data and only the matched events are delivered to the Endpoint. The dafault is all the events are delivered. -->
<!--Example:- asset_id BETWEEN 50000 AND 50100 -->
<sub:expression></sub:expression>
</sub:eventSubscription>
</sub:EventSubscriptionData>

エンドポイントは必要な数を追加でき、様々なホストまたはポート内に配置できます。また、イベントはロード・バランシングできます。事前定義済の拡張登録フローには、"StatusChangeEndpoint"と呼ばれる1つのエンドポイントのみが含まれます。

A.4.5.2 イベントをフィルタ処理するための式の設定

イベントは、式要素に入力した値に基づいてフィルタ処理できます。この項には次のトピックが含まれます:

- A.4.5.2.1項「すべてのイベントを1つのエンドポイントに配信」

- A.4.5.2.2項「イベント・タイプによってフィルタ処理されたイベントを1つのエンドポイントに配信」

- A.4.5.2.3項「JMSメッセージ・セレクタを使用してフィルタ処理されたイベントを1つのエンドポイントに配信」

- A.4.5.2.4項「JMSメッセージ・セレクタの例」

A.4.5.2.1 すべてのイベントを1つのエンドポイントに配信

デフォルトの設定では、すべてのイベントが1つのエンドポイントに配信されます。式要素が空である場合、Oracle Enterprise Repository内でトリガーされたすべてのイベントがOOTBエンドポイントに配信されます。

<sub:expression></sub:expression>

A.4.5.2.2 イベント・タイプによってフィルタ処理されたイベントを1つのエンドポイントに配信

次のXMLスニペットは、タイプAssetSubmissionのイベントを1つのエンドポイントに配信する方法を示しています。

<sub:expression> eventdata_name ='urn:com:bea.aler:events:type:AssetSubmission'</sub:expression>

また、"OR"演算子を使用して複数のイベント・タイプをフィルタ処理することもできます。

eventdata_name ='urn:com:bea.aler:events:type:AssetSubmission'
OR
eventdata_name ='urn:com:bea.aler:events:type:AssetAccepted'

次のイベント・タイプがサポートされています。

- urn:com:bea:aler:events:type:AssetSubmission

- urn:com:bea:aler:events:type:AssetAccepted

- urn:com:bea:aler:events:type:AssetTabApproved

- urn:com:bea:aler:events:type:AssetAllTabApproved

- urn:com:bea:aler:events:type:AssetRegister

- urn:com:bea:aler:events:type:PolicyAssertionChanged

- urn:com:bea:aler:events:type:MetaDataChange:name

- urn:com:bea:aler:events:type:AssetUnSubmission

- urn:com:bea:aler:events:type:AssetUnAccept

- urn:com:bea:aler:events:type:AssetUnregister

- urn:com:bea:aler:events:type:AssetStatusChanged

- urn:com:bea:aler:events:type:MetaDataChange:version

- urn:com:bea:aler:events:type:MetaDataChange:description

- urn:com:bea:aler:events:type:CategorizationChanged:assetLifecycleStage

- urn:com:bea:aler:events:type:CategorizationChanged:classification

- urn:com:bea:aler:events:type:MetaDataChange:supported

- urn:com:bea:aler:events:type:MetaDataChange:organizational ownership

- urn:com:bea:aler:events:type:MetaDataChange:usagefee

A.4.5.2.3 JMSメッセージ・セレクタを使用してフィルタ処理されたイベントを1つのエンドポイントに配信

セレクタは、コンテンツ・ベースのルーティングを実行するためにサブスクリプションにフィルタをアタッチする手段です。セレクタは、SQL 92構文を使用して定義します。例A-3は、イベントをフィルタ処理するためのフィルタ式を作成するために使用できるフィールドの完全なリストです。これらのフィールドはイベント・マネージャによってJMSメッセージにプロパティとして追加されます。また、イベントをフィルタ処理するために、これらのフィールドにアクセスするJMSメッセージ・セレクタを作成できます。

例A-3 フィルタ式を作成するために使用されるフィールド

submittedby_emailaddress = mrsmith@bea.com
asset_description = Test Asset
submittedby_name = aler_workflow_user
submittedby_id = 99
asset_community = Java
eventdata_description = new aler event
eventsource_componentname = OER
asset_name = TestAsset
eventsource_componenttype = OER 10.3
asset_typeid = 154
eventdata_eventid = d0cdac55-c78f-4a29-8aec-6ea9ba8d31f1
eventdata_name = urn:com:bea:aler:events:type:MetaDataChange:name
asset_activestatus = ACTIVE
eventsource_location = ALERCore
asset_id = 50100
eventdata_version = ver1.0
asset_version = 1

JMSメッセージ・セレクタの詳細は、次のWebサイトを参照してください。

- http://java.sun.com/j2ee/1.4/docs/api/javax/jms/Message.html

- http://activemq.apache.org/selectors.html

A.4.5.2.4 JMSメッセージ・セレクタの例

次に、JMSメッセージ・セレクタの使用例を示します。

- asset_id BETWEEN 50000 AND 50100

- eventdata_name = 'urn:com:bea:aler:events:type:AssetSubmission' AND asset_id BETWEEN 50000 AND 50100

- asset_name LIKE 'Inventory'

- asset_id &gt; 500

ヒント:

「次より小さい/次より大きい」を表すために使用される"< >"などの記号は、有効なXMLコンテンツではありません。式はXMLファイルで作成され、イベント・マネージャによって解析されるため、使いにくいXML文字はXMLルールを使用して管理する必要があります。たとえば、"asset_id > 500"と等しい"id &gt; 500"を使用する必要があります。

A.4.6 イベント・マネージャ・イベントのロギングの構成

イベント・マネージャでは、Oracle Enterprise Repositoryと同じロギング・フレームワークが使用されます。デフォルトでは、ファイルに記録するようにロギングが有効化されていますが、デバッグ文をコンソールに表示するには、<OER Domain>\WEB-INF\classesディレクトリにあるlog4fl.propertiesファイルに、例A-4に示すカテゴリを追加します。

例A-4イベント・マネージャ・イベントのロギングの構成

# eventing subsystem
log4j.category.com.bea.infra.event.core= debug,eventingLog,stdout
log4j.category.com.bea.infra.event.dm= debug,eventingLog,stdout
log4j.category.com.bea.infra.event.facade= debug,eventingLog,stdout
log4j.category.com.bea.infra.event.notifier= debug,eventingLog,stdout
log4j.category.com.bea.infra.event.store= debug,eventingLog,stdout
log4j.category.com.bea.infra.event.sub= debug,eventingLog,stdout

A.5 Oracle Business Process Managementプロセスの管理

この項では、Oracle Business Process Managementプロセスの管理タスクについて説明します。

この項には次のトピックが含まれます:

- A.5.1項「概要」

- A.5.2項「Oracle Business Process Management Webアプリケーションの管理」

- A.5.3項「Oracle Business Process Management自動ワークフロー・エンジンのチューニング」

- A.5.4項「フェイルオーバー用のスタンドアロン・プロセス・エンジンの構成」

- A.5.5項「Oracle Business Process Managementログ・ビューアの使用」

A.5.1 概要

イベント・マネージャでイベントを送信する準備が完了したら、イベントを処理するようプロセス・エンジンを構成する必要があります。Oracle Enterprise Repositoryがインストールされると、Oracle Business Process Managementプロセス・エンジンをインストールおよび構成するためのオプションが使用可能になります。この項では、Oracle Business Process Managementプロセス・エンジンが正常にインストールされていることを前提としています。

A.5.2 Oracle Business Process Management Webアプリケーションの管理

Oracle Business Process Managementプロセス・エンジンを起動し、参加者を定義するには、Oracle Business Process Management管理センターを起動する必要があります。

A.5.2.1 Oracle Business Process Management管理センターの起動

Oracle Business Process Management管理センターを起動するには、次の手順に従います。

1. <ORACLE_HOME>\obpm\enterprise\binディレクトリに移動し、次のファイルの1つをダブルクリックします。

- obpmadmcenter.exe (WindowsまたはUNIX GUIベース)

- ./startwebconsole.sh (UNIXコンソール・ベース)。次に、ブラウザでhttp://<host>:8585/webconsole (たとえば、http://localhost:8585/webconsole)を指定します。

2. 図A-6に示すように、Admin Centerページで、BPM Webアプリケーションの起動オプションをクリックします。

図A-6 Oracle Business Process Management管理センター

3. 使用可能になったら、プロセス・アドミニストレータの起動オプションをクリックします。

4. 必要な資格証明を入力するよう求められたら、インストール・プロセス中にFDIユーザー資格証明パネルで使用したBPM管理ユーザー名およびパスワードを入力します。これらの資格証明として推奨される例では、ユーザー名およびパスワードにbpm_adminを使用します。

A.5.2.2 Oracle Business Process Managementプロセス・エンジンの起動

Oracle Business Process Managementプロセス・エンジンを起動するには、次の手順に従います。

1. Oracle Business Process Managementプロセス・アドミニストレータ・ページで、図A-7に示すように、ページの左側にある「エンジン」リンクをクリックし、aler_engineプロセス・エンジンを開きます。

図A-7 Oracle Business Process Managementプロセス・アドミニストレータ - 起動/停止

2. ページの右側にあるエンジン・アクションの下の「起動」アイコンをクリックし、aler_engineを起動します。エンジンが完全に起動するまでに数分かかる場合があります。エンジンのステータスが「準備完了」であることを確認します。

Oracle Business Process Managementプロセス・エンジンが実行されていることを確認したら、これを停止してから再起動すると、最新のworkflow.xmlの変更をロードできます。

A.5.2.3 Oracle Business Process Managementの参加者の定義

この項では、Oracle Business Process Managementプロセス・エンジンの参加者を定義する方法について説明します。

A.5.2.3.1 Oracle Business Process Managementの管理者

FDIユーザー資格証明を使用して、Oracle Business Process Managementプロセス・アドミニストレータにログインし、プロセス・エンジンを起動/停止、および他のユーザーを作成できます。

A.5.2.3.2 拡張登録フローの参加者

Oracle Business Process Managementプロセス・エンジンがOracleの製品インストーラによってインストールされると、拡張登録フロー・ユーザーとしてaler_workflow_userが作成されます。デフォルトでは、パスワードはaler_workflow_passとして設定されていますが、図A-8に示すように、ナビゲータで「参加者」を選択し、「拡張プロパティ」セクションで「パスワードの変更」をクリックすることにより、プロセス・アドミニストレータでパスワードを変更できます。

図A-8 Oracle Business Process Managementプロセス・アドミニストレータ - パスワードの変更

新しい参加者を管理者のロールで登録することもできます。この新しい参加者は、イベント・マネージャのサブスクリプション・マネージャ・ファイルで構成できます。詳細は、A.4.5項「サブスクリプション・マネージャの構成」を参照してください。

A.5.3 Oracle Business Process Management自動ワークフロー・エンジンのチューニング

次のパラメータは、Oracle Business Process Managementプロセス・アドミニストレータを使用してチューニングする必要があります。

A.5.3.1 拡張プロパティ

「エンジン」、「<エンジン名>」、エンジン・ノード、「拡張プロパティ」ページに移動します。図A-9は、Oracle Business Process Managementプロセス・アドミニストレータ - 「拡張プロパティ」ページを示しています。

図A-9 Oracle Business Process Managementプロセス・アドミニストレータ - 拡張プロパティ

A.5.3.2 データベース・ランタイム・プロパティ

「エンジン」、「<エンジン名>」、「エンジン・データベース構成の編集」ページに移動します。図A-10は、Oracle Business Process Managementプロセス・アドミニストレータ - データベース・ランタイム・ページを示しています。

図A-10 Oracle Business Process Managementプロセス・アドミニストレータ - データベース・ランタイム

A.5.3.3 メモリーおよび実行スレッド・プロパティ

「エンジン」、「<エンジン名>」、「実行」ページに移動します。図A-11は、Oracle Business Process Managementプロセス・アドミニストレータ - メモリーおよびスレッド・ページを示しています。

図A-11 Oracle Business Process Managementプロセス・アドミニストレータ - メモリーおよびスレッド

A.5.4 フェイルオーバー用のスタンドアロン・プロセス・エンジンの構成

Oracle Business Process Managementスタンドアロン・プロセス・エンジンのフェイルオーバーをサポートするには、環境内でバックアップ・エンジンを構成します。このフェデレーション内のエンジンの1つがPRIMARYとしてマークされ、他のエンジンはこのプライマリ・エンジンのバックアップになります。複数のエンジンをバックアップとして機能するように構成できます。指定したプライマリに障害が発生した場合、これらのバックアップ・エンジンのいずれかがプライマリになります。障害が発生したサーバーがオンラインに戻ると、プライマリとして機能しているサーバーのバックアップとして加わります。

バックアップ・エンジンの構成に関する詳細な手順は、次の場所にあるOracle Business Process Management管理ガイドのエンジンのフェイルオーバーの構成に関する項を参照してください。

http://download.oracle.com/docs/cd/E13165_01/bpm/docs65/admin_guide/index.html

A.5.5 Oracle Business Process Managementログ・ビューアの使用

Oracle Business Process Managementログ・ビューアを使用すると、プロセス実行エンジンによって記録された情報を読み取ることができます。定義するプロジェクトごとに一連のログ・ファイルが作成されます。Studioログ・ビューアにより、ファイルが読み取られて表示されるため、エンジンの実行をモニターして追跡できます。

ログ・ビューアを起動するには、<Oracle Business Process Management Enterprise Home>\binディレクトリ内のobpmlogviewer.exeファイルをダブルクリックします。

A.5.5.1 Oracle Enterprise Repositoryフローのイベント・ログ・メッセージのフィルタ処理

ログ・メッセージをフィルタ処理することにより、自動ワークフローで情報メッセージ、デバッグ・メッセージおよび致命的メッセージが記録されるようにすることができます。

プロセス・アドミニストレータのプリファレンス設定を使用してプロセス・エンジンの「ログ」ページで「デバッグ」レベルをオンにします。デフォルトでは、このレベルは「警告」に設定されています。

「エンジン」、「<エンジン名>」、「ログ」ページに移動します。図A-12は、Oracle Business Process Managementプロセス・アドミニストレータ - ロギング・プリファレンス・ページを示しています。

図A-12 Oracle Business Process Managementプロセス・アドミニストレータ - ロギング・プリファレンス

デバッグ・レベルをオンにすると、Oracle Enterprise Repository自動ワークフローに関する情報のみでなく、他のプロセス・エンジン情報も含む多くの情報が出力されることがわかります。デバッグ・ロギングをフィルタ処理してOracle Enterprise Repositoryフロー関連の情報のみが表示されるようにするには、図A-13に示すように、次の手順に従います。

1. ログ・ビューアで、一番左側にあるリスト・ボックス内の「メッセージ」を選択します。

2. 横のリスト・ボックスで「次で始まる」を選択します。

3. テキスト・ボックスに「OER」と入力します。

4. 「フィルタの適用」ボタンをクリックします。

次に示すように、記録されているすべてのイベント・メッセージに接頭辞の「ALER:」が表示されます。

図A-13 OERフィルタが適用されたログ・ビューア

A.6 自動ワークフローの構成

この項では、OER自動ワークフローの開始方法を示すとともに、様々な高度なユースケースにおけるワークフローの使用について説明します。

この項には次のトピックが含まれます:

- A.6.1項「自動ワークフローの概要」

- A.6.2項「ワークフロー構成ファイルの作成およびカスタマイズ」

- A.6.3項「アセット・イベントのフローへのワイヤリング」

- A.6.4項「自動アセット登録フロー」

- A.6.5項「複数層自動割当てフロー」

- A.6.6項「メタデータ変更フロー」

- A.6.7項「時間ベースのエスカレーション・フロー」

- A.6.8項「有効期限の検証フロー」

- A.6.9項「電子メール通知テンプレートのカスタマイズ」

- A.6.10項「電子メール通知のユースケース」

- A.6.11項「既知の問題」

A.6.1 自動ワークフローの概要

ヒント:

開始する前に、Oracle Business Process Managementプロセス・エンジンと連携して動作するよう構成されてバンドルされたOracle Business Process Management Webサービス・エンドポイントを使用した拡張登録フロー機能を素早く使用開始できるよう、A.2項「Oracle Enterprise Repository自動ワークフローの概要」を参照してください。

Oracle Enterprise Repositoryには、Oracle Enterprise Repositoryアセットの発行、受入れ、登録、および他のガバナンス・プロセスなどのOracle Enterprise Repositoryプロセスの自動化を試行する事前定義済のOracle Business Process Managementフローがバンドルされています。この項では、Oracle Enterprise Repositoryによってトリガーされるアセット・イベントを処理するためにOracle Business Process Managementプロセス・エンジンを起動する前に必要な構成について説明します。フローをトリガーするためのプロセス・エンジンの構成の詳細は、A.4項「Oracle Enterprise Repositoryイベント・マネージャの構成」を参照してください。

また、これらのフローは、フレキシブルに使用できるよう設計されており、ワークフロー構成ファイル(workflow.xml)またはOracle Business Process Managementを使用してカスタマイズすることもできます。この項では、各フローについて詳しく説明するとともに、環境に合うようにフローを調整する方法の例も示します。

この項では、拡張登録フローを構成する方法について説明します。新しいワークフローを作成するには、次の手順に従います。

1. IDEで既存のOracle Business Process Managementプロセスを開きます。

2. 新しいワークフローを追加します。この手順の詳細は、Oracle Business Process Managementのドキュメントを参照してください。

3. プロジェクトをアンデプロイしてからデプロイします。

4. A.6.3項「アセット・イベントのフローへのワイヤリング」の手順に従い、ワークフローをイベントにワイヤリングします。

A.6.2 ワークフロー構成ファイルの作成およびカスタマイズ

この項では、ワークフロー構成XMLファイルを作成およびカスタマイズする方法について説明します。

A.6.2.1 Oracle Enterprise Repository接続およびレジストラの定義

ワークフロー構成ファイルにより、Oracle Enterprise Repository接続およびレジストラ情報が次のXMLデータからロードされます。

<alerconnection>
<uri>http://localhost.7001/aler/services/FlashlineRegistry</uri>
<registrar>
<user>admin</user>
<password>******</password>
</registrar>
</alerconnection>

A.6.2.2 レジストラ・ユーザーのパスワードの暗号化

セキュリティ暗号化パスワード・ツール(runWfSecurity.bat)を使用すると、ワークフロー構成ファイルに格納されているレジストラのパスワードを暗号化できます。このツールでは、ファイルが再帰的にスキャンされ、検出されたすべてのパスワード要素が暗号化されます。

詳細は、A.8.5項「パスワードの暗号化」を参照してください。

A.6.3 アセット・イベントのフローへのワイヤリング

自動ワークフローは、図A-14に示すように、アセット・イベントのトリガー時に実行される1つ以上のフローにイベントをワイヤリングできるフレキシブルなフレームワークを使用して設計されています。

A-14 アセット・イベントのフローへのワイヤリング

注意:

- イベントはすべて即時利用可能な事前定義済のフローにワイヤリングされます。ワイヤリングを変更する必要があるのは、新しいフローのカスタマイズが設計される場合のみです。

- この図には、すべてのイベントやアクションが含まれているわけではありません。すべてのアクションまたはイベントのリストは、A.6.6.2.1項「使用可能なメタデータ変更イベント/状態」およびA.6.6.2.2項「アクションにワイヤリング可能なフロー」を参照してください。

- コミュニティ・ワークフローの詳細は、A.6.4.1項「コミュニティ・フローの構成」を参照してください。

アセット・イベントのフローへのワイヤリングは、ワークフロー構成ファイル内で構成します。たとえば、次の構成スニペットは、"Asset Submitted"イベントがトリガーされたときに、ワークフロー構成ファイルに構成されているルールに基づいてアセットを自動的に受け入れるフローがトリガーされることを示しています。

<!--Community Flows-->
<state name="urn:com:bea:aler:events:type:AssetSubmission">
<action>CommunityAccept</action>
</state>
<!--The Multi_tier Flows-->
<state name="urn:com:bea:aler:events:type:AssetAccepted">
<action>MultiTier_Tier1_Assign</action>
</state>
<state name="urn:com:bea:aler:events:type:AssetTabApproved">
<action>MultiTier_NextTier_Assign</action>
</state>
<!--Asset Registration Status Flows-->
<state name="urn:com:bea:aler:events:type:AssetAllTabApproved">
<action>AllTabApproved_Register</action>
</state>

この例の構成では、次のイベントが様々なフローにワイヤリングされています。<action>要素には、実行されたフローの名前が含まれます。

1. アセットの「submitted」イベントがトリガーされたら、Community Acceptフローを実行します。

2. アセットの「accepted」イベントがトリガーされたら、MultiTier1フローを実行します。

3. タブの「approved」イベントがトリガーされたら、Multi-Tier Next Tierフローを実行します。

4. 「all the tabs approved」イベントがトリガーされたら、Automatic Registrationフローを実行します。

一部のフローには、入力として必要なパラメータが使用されます。フローごとに異なるパラメータが渡されます。たとえば、ChangeCAS (Change Custom Access Settings)フローには、<customAccessSettings>がパラメータとして使用されます。次に、アセットが登録されたときにMyCASおよびMyCAS2カスタム・アセット設定が自動的に割り当てられるワイヤリングの例を示します。

<state name="urn:com:bea:aler:events:type:AssetRegister">
<action>ChangeCAS</action>
<customAccessSettings>
<customAccessSetting>MyCAS</customAccessSetting>
<customAccessSetting>MyCAS2</customAccessSetting>
</customAccessSettings>
</state>

A.6.4 自動アセット登録フロー

この項では、Oracle Enterprise Repositoryのアセット・エディタを使用して実行される手動でのアセット受入れおよび登録プロセスを自動ワークフローで自動化する方法について説明します。Oracle Enterprise Repositoryのアセット・エディタおよびアセット登録プロセスの使用の詳細は、『Oracle Fusion Middleware Oracle Enterprise Repositoryユーザーズ・ガイド』を参照してください。

注意:

リポジトリ・ユーザーが「アセットの発行」リンクを介してアセットを発行する場合は、コミュニティ受入れまたは自動受入れフローを有効にしないでください。現在、この構成はOracle Enterprise Repositoryではサポートされていません。

A.6.4.1 コミュニティ・フローの構成

コミュニティ・フローは、自動割当てルールの構成を可能にすることによってアセットの受入れ、割当て、登録プロセスを自動化する方法を提供するとともに、様々な機関の間のフェデレーテッド・レジストラに関する概念を示します。すべてのコミュニティにわたって(システム・レジストラ通知を介して)多数のレジストラを送信するかわりに、システム・レジストラの数を1人または2、3人の個人に制限し、コミュニティの管理レジストラのかわりに自動受入れフローでアセットを受け入れるようにすることができます。コミュニティ・フロー機能により、コミュニティのためにアセット発行を承認する権限を持つ個人にアセット発行を分散できます。

コミュニティ・フローを使用して、次のシナリオに対応できます。

- 新しく発行されたアセットに関する多くの通知を単一のレジストラが受け取るのとは対照的に、自動フェデレーテッド・レジストラが受入れをサポートします。

- アセット受入れが手動であっても、コミュニティ・フローを使用して、事前定義済の承認者へのアセット承認の割当てを自動化できます。事前定義済の承認者の作成は、次の2つの方法で行うことができます。

- そのアセット内のすべてのタブに対する事前定義済の承認者のリストを作成します。

- 複数層割当て(これは複数層フローと同じですが、コミュニティ内で動作します)を使用します。

- 登録プロセスの自動化。次の条件が満たされると、アセットは自動的に登録されます。

1. すべてのタブが承認される場合

2. 複数層プロセス内の最後の層が完了した場合

3. またはどちらかが最初に起こった場合

コミュニティはフロー構成内で構成され、アセット・タイプ、プロジェクトの作成などがコミュニティを指すことができます。

図A-14に、アセットのコミュニティをフローによって特定する方法、および自動受入れのルールをフローによって特定する方法を示します。

図A-15 自動アセット受入れのフローチャート

注意:

自動登録の場合も同じフローチャートが適用されます。単純にautoAcceptをautoRegisterに置き換えてください。

A.6.4.1.1 Oracle Enterprise Repositoryプロジェクトに対するコミュニティの設定

プロジェクトに対してコミュニティを定義するには、<producingProjectSettings>要素を使用します。次の例は、IDが「40000」である「SOA Center of Excellence」コミュニティに対して「Registry」という名前のプロジェクトを作成する方法を示しています。

<producingProjectSettings>
<producingProject name="Registry" community="SOA Center of Excellence
id="40000"/>
</producingProjectSettings>

A.6.4.1.2 アセット・タイプに対するコミュニティの設定

アセット・タイプに対してコミュニティを定義するには、<assetType>要素を使用します。次の例は、IDが「158」である「SOA Center of Excellence」コミュニティに対して「Application」という名前のアセット・タイプを作成する方法を示しています。

<assetType name="Application" community="SOA Center of Excellence
id="158">
<allTabs>

A.6.4.1.3 タイプ・マネージャおよびアセット・エディタを使用したアセット・タイプに対するコミュニティの設定

workflow.xml内でアセットに対してコミュニティを設定するかわりに、タイプ・マネージャおよびアセット・エディタを使用してアセット・タイプに対してコミュニティを設定できます。

タイプ・マネージャで、次の手順に従います。

1. 「コミュニティ」フィールドを有効にするアセット・タイプを選択し、「ビューア」タブをクリックします。

2. 図A-16に示すように、「グループで表示」ボタンをクリックします。

図A-16 タイプ・マネージャでのアセット・タイプに対するコミュニティの設定

次に、アセット・エディタで、次の手順に従います。

1. タイプ・マネージャで選択したアセット・タイプのアセットを選択します。

2. 図A-17に示すように、「概要」タブの「コミュニティ」フィールドで、そのアセットに使用するコミュニティ名を設定します。

図A-17 アセット・エディタの「コミュニティ」フィールドでのコミュニティ名の設定

A.6.4.1.2項「アセット・タイプに対するコミュニティの設定」でコミュニティを設定するための手順に従った後、アセット・エディタでアセットのコミュニティ名を設定した場合、アセット・エディタでアセットに設定したコミュニティ名により、workflows.xmlファイルに設定されているコミュニティ名がオーバーライドされます。

A.6.4.1.4 アセットを自動的に受け入れるためのコミュニティの構成

次の例は、アセットを自動的に受け入れるために「SOA Center of Excellence」コミュニティを設定する方法を示しています。

<communities name="SOA Center of Excellence autoAccept="true">

注意:

リポジトリ・ユーザーが「アセットの発行」リンクを介してアセットを発行する場合は、コミュニティ受入れまたは自動受入れフローを有効にしないでください。現在、この構成はOracle Enterprise Repositoryではサポートされていません。

A.6.4.1.5 タブ承認を目的としたアセット割当てのためのコミュニティの構成

AssetSubmittedイベントがコミュニティ・フローにワイヤリングされている場合、<approvers>要素には、コミュニティ・フローによって自動的に割り当てられる承認者がリストされます。

<communities name="Java" autoAccept="true">
<approvers>
<alerid>5003</alerid>
<alerid>5004</alerid>
</approvers>

タブ承認フローで<alerid>を使用する手順は、A.6.5.2項「タブ承認のための<alerid>の使用」を参照してください。

A.6.4.1.6 複数層を使用したタブ承認を目的としたアセット割当てのためのコミュニティの構成

複数層割当ては複数層フローと同じですが、コミュニティ内で動作します。複数層フローの詳細は、A.6.5項「複数層自動割当てフロー」を参照してください。

注意:

コミュニティの複数層構成内で提供されるタブは、すべてのアセット・タイプ内に存在する共通タブである必要があります。

A.6.4.1.7 アセットを自動的に登録するためのコミュニティの構成

次の例は、アセットを自動的に受け入れて登録するために「SOA Center of Excellence」コミュニティを設定する方法を示しています。

<communities name="SOA Center of Excellence autoAccept="true"
autoRegister="true">

A.6.4.1.8 専用レジストラを使用するためのコミュニティの構成

アセットの受入れ、割当ておよび登録を行うには、レジストラのユーザー名およびパスワードが必要です。コミュニティ・フローでは、アセットが属するコミュニティからレジストラ情報がロードされます。アセットがコミュニティに属していない場合、またはレジストラ情報がコミュニティ内にない場合は、グローバル・レジストラがコミュニティ・フローによって使用されます。

コミュニティ・フローによってコミュニティ・タグが取得される優先順位を次に示します(図A-13を参照)。

- 受信イベント内のコミュニティ・タグ

- 受信アセットが属するアセット・タイプ内のコミュニティ・タグ

- 受信アセットが属する、プロジェクトの作成内のコミュニティ・タグ

A.6.4.2 自動受入れおよび自動登録フローの構成

コミュニティ・フローを使用してアセットの受入れおよび登録を自動的に行う以外に、図A-13に示すように、次のルールを使用してアセットの受入れおよび登録を行うことができます。

注意:

リポジトリ・ユーザーが「アセットの発行」リンクを介してアセットを発行する場合は、コミュニティ受入れまたは自動受入れフローを有効にしないでください。現在、この構成はOracle Enterprise Repositoryではサポートされていません。

A.6.4.2.1 アセット・タイプ

AssetType要素内のautoAcceptおよびautoRegisterフラグを使用して、アセットの受入れおよび登録を自動的に行うことができます。

<assetType name="Application" autoAccept="true" autoRegister="true"
id="158">
<allTabs>
<tab name="Overview"/>
<tab name="Application Lifecycle"/>
</allTabs>

A.6.4.2.2 カテゴリ分け設定

デフォルトでは、フローではautoAcceptおよびautoRegisterフラグは検索されません。理由は、これらの参照によってパフォーマンスに影響が及ぶ可能性があるからです。ただし、これは、<action>フラグの使用によって有効にすることができます。

次の例に示すように、フローでカテゴリ分け設定の使用が必要になる場合は、<action>フラグをtrueに設定する必要があります。しない場合、カテゴリ分け設定は無視されます。

<catgorizationTypeSettings action="true">
<catgorizationType name="AssetFunction" type "100">
<catgorizations name="Application Adapters" autoAccept="false"/>
<catgorizations name="Customer Information Acquisition" autoAccept="false"/>
<catgorizations name="eCommerce Frameworks" autoAccept="false"/>
</catgorizationType>

A.6.4.2.3 発行者ロール

発行者ロールを使用して、アセットの受入れおよび登録を自動的に行うことができます。次の構成に指定されているロールが発行者ロールと一致する場合、アセットは自動的に受け入れられます。

<automation>
<autoRoles>
<role>admin</role>
<role>accesAdminstrator</role>
</autoRoles>
<autoApprovalTabs>
<tab name="Documentation"/>
</autoApprovalTabs>
</automation>

A.6.4.2.4 競合解決および優先度

場合によっては、図A-13に示すように、特定のイベント・トリガーについて一致するルールが複数存在するため、受入れや登録のために自動受入れフローおよび自動登録フローで各ルールを評価する方法に関する階層が存在します。フローでは、次のメタデータ部分がスキャンされ、次の優先度でいずれかのメタデータが検出されると、フローは中断され、そのメタデータ内の設定が使用されます。

- フロー構成ファイル内のAssetType設定

- 受信アセットで検出されたコミュニティ・タグ

- フロー構成ファイル内のAssetType設定で検出されたコミュニティ・タグ

- フロー構成ファイル内のProducingProject設定で検出されたコミュニティ・タグ

- フロー構成ファイル内のカテゴリ分け設定

- フロー構成ファイル内のカテゴリ分け設定

- フロー構成ファイル内のSubmitterRole設定

A.6.5 複数層自動割当てフロー

複数層承認フローにより、層と呼ばれる複数の手順でアセット・タブ承認プロセスを構築します。アセット承認タブは層にグループ化できます。また、複数層フローでは、指定した承認者によってすべてのタブが承認されているかどうかを確認するために各層が追跡されます。層内の最後のタブが承認されると同時に、複数層フロー内では、指定した承認者の次のレベルにアセットを割り当てることによって次の層が開始されます。

A.6.5.1 ユースケース

- 場合によっては、層と呼ばれる複数の手順でタブ承認用のタブを割り当てる方が望ましいことがあります。たとえば、文書タブを承認する前にアーキテクチャ・タブを承認する方が望ましいことがあります。理由は、アーキテクチャに関する問題は、文書の専門家が着目する前に修正する必要があるからです。

- 以前のリリースでは、タブ承認は、レジストラが各タブ承認のステータスを手動で追跡してからこのタブを次の層レベルの承認のために割り当てることにより、手動で行われていました。複数層フローの場合、このプロセスはフローによって自動化されます。

図A-18に、複数層プロセスのフローを示します。

図A-18 複数層自動割当てフローチャート

A.6.5.2 タブ承認のための<alerid>の使用

workflow.xmlファイルが生成されると、<allAssetSettings>セクションの下に次のXMLセクションが作成されます。これらが、Oracle Enterprise Repository内に作成されるすべてのユーザーです。

<alerUsers>
<user name="admin" alerid="99"/>
<user name="allpriv" alerid="50000"/>
<user name="nopriv" alerid="50001"/>
<user name="tier1" alerid="50002"/>
<user name="tier2" alerid="50003"/>
<user name="mrsmith" alerid="50004"/>
</alerUsers>

ワークフロー管理者としては、アセット・タブの承認に使用する名前別にユーザーを識別し、対応する<alerid>を使用する必要があります。これにより、この<alerid>を、次の複数層承認フローのようにワークフローXMLで使用できます。

<tiers>
<tier name="Tier1">
<approvers>
<alerid>50001</alerid>
</approvers>
<tabs>
<tab name="Overview"/>
<tab name="Technical"/>
<tab name="Documentation"/>
</tabs>
</tier>

A.6.5.3 複数層タブ承認のためのコミュニティの設定

次の例は、タブを自動的に受け入れるために「SOA Center of Excellence」コミュニティでタブ承認者のために複数層フローを構成する方法を示しています。

<communities name="SOA Center of Excellence autoAccept="true">
<tiers>
<tier name="Tier1">
<approvers>
<alerid>5002</alerid>
</approvers>
<tabs>
<tab name="Overview"/>
<tab name="Taxonomy"/>
</tabs>
</tier>
<tier name="Tier2">
<approvers>
<alerid>5003</alerid>
</approvers>
<tabs>
<tab name="Architecture/">
</tabs>
</tier>
</tiers>
</communities>

注意:

コミュニティの複数層構成内で提供されるタブは、すべてのアセット・タイプ内に存在する共通タブである必要があります。

A.6.5.4 複数層タブ承認のためのアセット・タイプの設定

次の例は、複数層承認のためにアセット・タイプ「Application」のタブを構成する方法を示しています。

<assetType name="Application" id="158">
<allTabs>
<tab name="Oveview"/>
<tab name="Application Lifecycle"/>
<tab name="License Information"/>
<tab name="Certification Tracking"/>
<tab name="Taxonomy"/>
<tab name="Documentation"/>
<tab name="Relationships"/>
<tab name="Support"/>
<tab name="Cost Categories"/>
<tab name="Ownership"/>
<tab name="Technology Stack"/>
<tab name="Operational Information"/>
<tab name="Miscellaneous"/>
</allTabs>
<tiers>
<!--Please change "_CHANGE_TIER1_NAME_" to the name of the Tier-->
<!--Example:- "Tier1"-->
<tier name="Tier1">
<approvers>
<alerid>99</alerid>
</approvers>
<tabs>
<!--Please change "_CHANGE_TABNAME_" to the name of the Tab-->
<!--Example:- "Documentation"-->
<tab name="Overview"/>
<tab name="Taxonomy"/>
</tabs>
</tier>
</tiers>

A.6.6 メタデータ変更フロー

メタデータ・フローは、アセットのメタデータ要素が変更されるときに1つ以上のアクションを実行するフローのグループです。変更されるメタデータ要素は、1つ以上のフローにワイヤリングされたイベントをトリガーします。イベントをフローにワイヤリングする手順は、A.6.3項「アセット・イベントのフローへのワイヤリング」を参照してください。

A.6.6.1 ユースケース

メタデータ変更フローを適用できるいくつかのユースケースを次に示します。

- アセットの「Asset Lifecycle Stage」メタデータ要素を「Build」から「Release」に変更する場合は、アセットに対するアクセス制御をより制限するようにカスタム・アクセス設定を変更できます。

- アセットの「Name」を変更する場合は、サブスクライバに通知できます。

- 要素のメタデータ要素を変更する場合は、アセットを「Change Management」承認プロセスで処理できます。「Change Management」には次の処理が含まれます。

- 「Change Management」という名前のタブの承認を解除します。図A-19に、アセット・エディタの「変更の管理」タブを示します。

図A-19 アセット・エディタの「変更の管理」タブ

- アセットをレジストラに割り当てます。

- 「再割当ての理由」フィールドに変更の種類を追加してレジストラをサポートします。

A.6.6.2 メタデータ変更フローの構成

この項では、メタデータ変更フローの構成について説明します。この項には次のトピックが含まれます:

- A.6.6.2.1項「使用可能なメタデータ変更イベント/状態」

- A.6.6.2.2項「アクションにワイヤリング可能なフロー」

- A.6.6.2.3項「メタデータ変更構成の例」

- A.6.6.2.4項「メタデータ値をチェックするメタデータ変更構成の例」

- A.6.6.2.5項「ChangeClassification」

- A.6.6.2.6項「ChangeCAS」

- A.6.6.2.7項「ChangeAssetLifecycle」

- A.6.6.2.8項「ApproveTabAction」

- A.6.6.2.9項「UnapproveTabAction」

- A.6.6.2.10項「AutoApproveTabAction」

- A.6.6.2.11項「UnapproveChangeManagementTab」

- A.6.6.2.12項「ResetChangeManagementTab」

- A.6.6.2.13項「NotifyCustomUser」

- A.6.6.2.14項「名前付きタブの承認に基づくフローの呼出し」

A.6.6.2.1 使用可能なメタデータ変更イベント/状態

メタデータ変更フローにワイヤリングできる状態を次に示します。

注意:

これらのイベント以外にも、カスタム・カテゴリ分けを含む任意のカテゴリ分け変更をワイヤリングできます。

<state name="urn:com:bea:aler:events:type:MetaDataChange:name">
<state name="urn:com:bea:aler:events:type:MetaDataChange:version">
<state name="urn:com:bea:aler:events:type:MetaDataChange:description">
<state name="urn:com:bea:aler:events:type:CategorizationChanged:
assetLifecycleStage"/>
<state name="urn:com:bea:aler:events:type:CategorizationChanged:classification">
<state name="urn:com:bea:aler:events:type:MetaDataChange:supported">
<state
name="urn:com:bea:aler:events:type:MetaDataChange:organizationalOwnership">
<state name="urn:com:bea:aler:events:type:MetaDataChange:usageFee">

ほとんどのアセット・タイプの場合、usageFeeフィールドはアセット・エディタの「その他」タブにあります。

A.6.6.2.2 アクションにワイヤリング可能なフロー

アクションにワイヤリング可能な事前定義済のフローを次に示します。これらのフロー名は、<action>要素内のコンテンツとして表示され、これがイベントの発生時に実行する必要のあるアクションであることを示します。<action>以外のすべての要素は、特定のフローによって使用されるパラメータです。

- ChangeCAS: アセットへの1つ以上のカスタム・アクセス設定に適用されます。

- ChangeAssetLifecycle: アセットのアセット・ライフサイクル・ステージを設定します。

- ChangeClassification: アセットの分類を設定します。

- ReAssignAssetToRegistrar: アセットをレジストラに割り当てます。

- AddCommunityTag: アセットの「Community」をOracle Enterprise Repositoryに保存します。

- NotifySubscriber: メタデータ変更をサブスクライバに通知します。

- NotifyRegistrationActors: メタデータ変更についてレジストラ、サブスクライバ、所有者などに通知します。

- NotifyCustomUser: メタデータ変更について構成済のカスタム・ユーザーに通知します。

- UnapproveChangeManagementTab: 変更管理プロセスをトリガーします。

- ResetChangeManagementTab: 「変更の管理」タブが承認されるとすぐに、「変更の管理」タブの「再割当ての理由」フィールドをリセットします。

- CommunityAccept: アセットの発行時に使用されるコミュニティ受入れフローを呼び出します。

- CommunityAssign: アセットの受入れ時に使用されるコミュニティ割当てフローを呼び出します。

- MultiTier_Tier1_Assign: アセットの受入れ時に使用される多層フローを呼び出します。

- MultiTier_NextTier_Assign: タブの承認時に使用される多層フローを呼び出します。

- ApproveTabAction: 1つ以上のタブを承認します。

- UnapproveTabAction: 1つ以上のタブの承認を解除します。

- AutoApproveTabAction: 発行者のロールに基づいて1つ以上の構成済のタブを承認します。

- AllTabsApproval_Register: すべてのタブが承認されたときにアセットを登録するためのフローを呼び出します。

- ReAssignAssetToRegistrar: アセットをレジストラに割り当てて承認します。このフローでは、コミュニティ・レジストラ(構成されている場合)を使用します。構成されていない場合は、グローバル・レジストラを使用します。

- ResetFlowState: タイマー・ベースのフローで使用される状態情報をリセットします。これは、未発行のアセットをタイマー・フローで追跡する場合や、状態が未発行から発行済に変更された場合に役立ちます。これにより、状態情報をリセットできるようになります。リセットしない場合、アセットの状態が未発行に戻ると、ワークフローでは以前に設定されたものと同じ状態を使用します。これは必ずしも望ましい設定とはかぎりません。ResetFlowStateアクションを適切なイベントまたは状態で使用して、状態情報をリセットできます。

- UnRegisterAssetAction: アセットが登録済の状態の場合に、そのアセットの登録を解除します。

- autoSyncAlerToUddi: サービスをOracle Enterprise RepositoryからOracle Service Registryに移動するタイマーベースのワークフローです。

- autoSyncUddiToAler: サービスをOracle Service RegistryからOracle Enterprise Repositoryに移動するタイマーベースのワークフローです。

- PublishAssetToUddi: 個々のサービスが登録されるとき、またはサービスのライフサイクルが変更されるときにトリガーされるイベントをワイヤリングして、これらのサービスとそのメタデータをOracle Service Registryに移動します。

このワークフローの詳細は、10.3.1.1項「ワークフローを使用したOracle Registry Repository Exchange Utilityの起動」を参照してください。

A.6.6.2.3 メタデータ変更構成の例

次の構成例では、アセットが登録されたときに「NotifySubscriber」と「ChangeCAS」という名前の2つのフローを呼び出すよう指定しています。<customAccessSettings>要素は、適用する必要のあるCASの名前をフローに通知するChangeCASフローのパラメータです。

<state name="urn:com:bea:aler:events:type:AssetRegister">
<action>NotifySubscriber</action>
<action>ChangeCAS</action>
<customAccessSettings>
<customAccessSetting>MyCAS</customAccessSetting>
<customAccessSetting>MyCAS2</customAccessSetting>
</customAccessSettings>
</state>
<state name="urn:com:bea:aler:events:type:AssetUnAccept">
<action>NotifySubscriber</action>
<action>ChangeClassification</action>
<classification>Approved</classification>
</state>

A.6.6.2.4 メタデータ値をチェックするメタデータ変更構成の例

メタデータ要素の変更時のみでなく、メタデータ要素が特定の値を使用する場合にもフローを呼び出すことができます。たとえば、アセットの「Asset Lifecycle Stage」メタデータ要素を「Build」から「Release」に変更する場合は、カスタム・アクセス設定の1つのセットを適用できます。さらに、この値を「Plan」から「Build」に変更する場合は、別のセットを適用できます。次はその例です。

<state
name="urn:com:bea:aler:events:type:CategorizationChanged:AssetLifecycleStage"
value="Stage 4 - Release">
<action>ChangeCAS</action>
<customAccessSettings>
<customAccessSetting>MyCAS</customAccessSetting>
</customAccessSettings>
</state>
<state
name="urn:com:bea:aler:events:type:CategorizationChanged:AssetLifecycleStage"
value="Stage 3 - Build">
<action>ChangeCAS</action>
<customAccessSettings>
<customAccessSetting>MyCAS2</customAccessSetting>
</customAccessSettings>
</state>

A.6.6.2.5 ChangeClassification

アセットの分類を設定します。ChangeClassificationでは、次の要素を使用して分類を設定します。

<state name="urn:com:bea:aler:events:type:AssetRegister">
<action>ChangeClassification</action>
<classification>Approved</classification>
</state>

A.6.6.2.6 ChangeCAS

1つ以上のカスタム・アクセス設定をアセットに適用します。ChangeCASでは、次の要素を使用してカスタム・アクセス設定を行います。

<state name="urn:com:bea:aler:events:type:AssetRegister">
<action>ChangeCAS</action>
<customAccessSettings>
<customAccessSetting>MyCAS</customAccessSetting>
<customAccessSetting>MyCAS2</customAccessSetting>
</customAccessSettings>
</state>

A.6.6.2.7 ChangeAssetLifecycle

アセットのアセット・ライフサイクル・ステージを設定します。ChangeAssetLifeCycleでは、次の要素を使用してアセット・ライフサイクルを設定します。

<state name="urn:com:bea:aler:events:type:AssetRegister">
<action>ChangeAssetLifeCycle</action>
<assetLifeCycle>Stage 3 - Build</assetLifeCycle>
</state>

A.6.6.2.8 ApproveTabAction

ApproveTabActionフローでは、アセットの1つ以上のタブを承認します。次の構成では、「Overview」および「Taxonomy」タブを承認します。

<state name=?urn:com:bea:aler:events:type:MetaDataChange:name?>
<action>ApproveTabAction</action>
<approveTabs>
<tab name="Overview"/>
<tab name="Taxonomy"/>
</approveTabs>
</state>

A.6.6.2.9 UnapproveTabAction

次の要素では、タブのリストを構成して、UnapproveTabActionフローで承認が解除されるようにします。

<state name="urn:com:bea:aler:events:type:MetaDataChange:name">
<action>UnApproveTabAction</action>
<unapproveTabs>
<tab name="Overview"/>
<tab name="Taxonomy"/>
</unapproveTabs>
</state>

A.6.6.2.10 AutoApproveTabAction

AutoApproveTabActionフローでは、発行者のロールに基づいてタブを承認します。たとえば、<allAssetSettings>の下にある次の要素では、発行者のロールに基づいて自動的に承認する必要のあるタブのリストを構成します。この場合、受入れ可能なロールも構成されます。

<automation>
<autoRoles>
<role>admin</role>
<role>accesAdminstrator</role>
</autoRoles>
<autoApprovalTabs>
<tab name="Documentation"/>
</autoApprovalTabs>
</automation>

フローを呼び出すための構成を次に示します。

<state name="urn:com:bea:aler:events:type:AssetRegister">
<action>AutoApproveTabAction</action>
</state>

A.6.6.2.11 UnapproveChangeManagementTab

要素のメタデータ要素を変更する場合は、アセットを「Change Management」承認プロセスで処理できます。このプロセスには次の処理が含まれます。

- 「変更の管理」タブの承認を解除します。図A-19に、アセット・エディタの「変更の管理」タブを示します。

- アセットをレジストラに割り当てます。

- 「再割当ての理由」フィールドに変更の種類を追加してレジストラをサポートします。

<state name="urn:com:bea:aler:events:type:MetaDataChange:name">
<action>UnApproveChangeManagementTab</action>
</state>

A.6.6.2.12 ResetChangeManagementTab

このフローでは、「変更の管理」タブが承認されるとすぐに、「変更の管理」タブの「再割当ての理由」フィールドをリセットします。

<state name="urn:com:bea:aler:events:type:AssetTabApproved">
<action>MultiTier_NextTier_Assign</action>
<action>ResetChangeManagementTab</action>
</state>

A.6.6.2.13 NotifyCustomUser

メタデータ変更について構成済のカスタム・ユーザーに通知します。次に示すように、ユーザーの電子メール・アドレスは、<allAssetSettings>の下にある<customNotification>要素内で構成されます。

<allAssetSettings>
<notification timerInterval="id">
<customNotification>
<emailAddress>smith@bea.com</emailAddress>
</customNotification>
</notification>

A.6.6.2.14 名前付きタブの承認に基づくフローの呼出し

次に示すように、メタデータ変更フローは、特定のタブの承認に基づいて実行できます。

<state name="urn:com:bea:aler:events:type:AssetTabApproved" value ="Overview">
<action>MultiTier_NextTier_Assign</action>    <action>ChangeAssetLifecycle</action>
<assetLifecycle>Stage 3 - Build</assetLifecycle>
</state>

A.6.7 時間ベースのエスカレーション・フロー

時間ベースのエスカレーション・フローでは、様々な状態のアセットを追跡し、すべての当事者に通知します。次の項では、時間ベースのエスカレーション・フローを構成する方法について説明します。時間ベースのエスカレーション・フローには4種類があり、次の各項で説明するように、各種を個別に構成できます。

workflow.xml構成ファイルを開き、<notification>要素を探します。

<notification timerInterval="1d">
<numTimesNotify>10</numTimesNotify>
<daysBeforeNextNotification>2</daysBeforeNextNotification>

- timerInterval要素は、フローがトリガーされるまでの間隔を指定します。本番環境では、この要素を"1d"に設定する必要があります。この場合、フローは1日に1回トリガーされます。ただし、テストを行う場合は、"1m"または"5m"に設定してフローを毎分または5分ごとにトリガーすることができます。また、リフレッシュ・ツールを使用してリフレッシュできる他のフィールドの変更とは異なり、このフィールドが変更されるたびにイベント・エンジンを再起動する必要があります。

- numTimesNotify要素は、時間ベースのエスカレーション・フローで通知を送信する回数を指定します。

- daysBeforeNextNotification要素は、通知を送信する間隔を日数で指定します。

注意:

テストの目的で分単位の間隔でフローをトリガーするようにtimerInterval要素が分単位で構成されている場合は、daysBeforeNextNotificationに指定された間隔も分単位であると解釈されます。

図A-20に、時間ベースのエスカレーション・フローを示します。

図A-20 時間ベースのエスカレーション・フローチャート

A.6.7.1 未発行のアセットの追跡

このフローでは、「未発行」ステータスのアセットを追跡し、アクションを実行するために所有者に通知を送信します。

<owner_resubmit action="false" days="0" regressOnInaction="true" queryOperator="eq"/>

- action="true"はフローを有効にし、action="false"はフローを無効にします。

- days="10"は、10日前に未発行ステータス状態になったアセットを追跡します。時間ベースのエスカレーション・フローでは、今日の日付を使用して、この属性から値を減算します。

- regressOnInaction="true"は、アクションが実行されていないアセットを元の状態に戻します。たとえば、未発行のアセットを削除できます。

- queryOperator="eq"の場合は、問合せに日付が使用される場合に等価演算子を使用します。指定可能なその他の値は"lte"、"gte"などです。

A.6.7.2 未受入れのアセットの追跡

このフローでは、「未受入れ」ステータスのアセットを追跡し、アクションを実行するためにレジストラに通知を送信します。

<registrar_accept action="false" days="0" regressOnInaction="true" queryOperator="eq"/>

- action="true"はフローを有効にし、action="false"はフローを無効にします。

- days="10"は、10日前に未発行ステータス状態になったアセットを追跡します。時間ベースのエスカレーション・フローでは、今日の日付を使用して、この属性から値を減算します。

- regressOnInaction="true"は、アクションが実行されていないアセットを元の状態に戻します。たとえば、発行済のアセットを未発行にすることができます。

- queryOperator="eq"の場合は、問合せに日付が使用される場合に等価演算子を使用します。指定可能なその他の値は"lte"、"gte"などです。

A.6.7.3 未承認のアセットの追跡

このフローでは、「未承認」ステータスのアセットを追跡し、アクションを実行するために承認者に通知を送信します。

<assignees_approve action="false" days="0" regressOnInaction="true" queryOperator="eq"/>

- action="true"はフローを有効にし、action="false"はフローを無効にします。

- days="10"は、10日前に未発行ステータス状態になったアセットを追跡します。時間ベースのエスカレーション・フローでは、今日の日付を使用して、この属性から値を減算します。

- regressOnInaction="true"は、アクションが実行されていないアセットを元の状態に戻します。たとえば、受入れ済のアセットを未受入れにすることができます。

- queryOperator="eq"の場合は、問合せに日付が使用される場合に等価演算子を使用します。指定可能なその他の値は"lte"、"gte"などです。

A.6.7.4 未登録のアセットの追跡

このフローでは、「未登録」ステータスのアセットを追跡し、アクションを実行するために承認者に通知を送信します。

registrar_register action="false" days="0" regressOnInaction="true"
queryOperator="eq"/>

- action="true"はフローを有効にし、action="false"はフローを無効にします。

- days="10"は、10日前に未発行ステータス状態になったアセットを追跡します。時間ベースのエスカレーション・フローでは、今日の日付を使用して、この属性から値を減算します。

- regressOnInaction="true"は、アクションが実行されていないアセットを元の状態に戻します。たとえば、登録済のアセットを未登録にすることができます。

- queryOperator="eq"の場合は、問合せに日付が使用される場合に等価演算子を使用します。指定可能なその他の値は"lte"、"gte"などです。

A.6.8 有効期限の検証フロー

有効期限の検証フローでは、有効期限より前に期限が切れたアセットや、期限日に期限が切れたアセットを追跡し、すべての当事者に警告通知を送信します。有効期限のX日後に、アセットの登録を解除します。有効期限のY日後に、アセットを非アクティブにします。有効期限のZ日後に、アセットを削除します。

<notification timerInterval="1d">
<numTimesNotify>10</numTimesNotify>
<daysBeforeNextNotification>2</daysBeforeNextNotification>

- timerInterval属性は、フローがトリガーされるまでの間隔を構成します。この属性は"1d"に設定する必要があります。この場合、間隔は1日です。ただし、テストを行う場合は、"1m"または"5m"に設定して毎分または5分ごとにトリガーすることができます。また、リフレッシュ・ツールを使用してリフレッシュできる他のフィールドの変更とは異なり、このフィールドが変更されるたびにイベント・エンジンを再起動する必要があります。

- numTimesNotify要素は、有効期限の検証フローで通知を送信する回数を指定します。

- daysBeforeNextNotification要素は、通知を送信する間隔を日数で指定します。

<expiration>
<expiration_warning action="false" days="10" owner="false" subscriber="false" contact="99"/>
<unregister_after_expire action="true" days="10" queryOperator="eq"/>
<inactive_after_expire action="true" days="10" queryOperator="eq"/>
<delete_after_expire action="true" days="10" queryOperator="eq"/>
</expiration>

図A-21に、有効期限の検証フローを示します。

図A-21 有効期限の検証フローチャート

アセットの有効期限を設定するには、図A-22に示すように、アセット・エディタの「その他」タブにある「有効期限(yyyy-MM-dd)」フィールドに日付を指定します。

図A-22 アセット・エディタの「その他」タブにある「有効期限(yyyy-MM-dd)」フィールド

A.6.8.1 アセット有効期限の警告の通知

次の行では、警告の通知を有効にして、その通知を受け取るユーザーを指定します。

<expiration_warning action="false" days="10" owner="false" subscriber="false" contact="99"/

注意:

days要素により、警告を送信する必要のある、有効期限までの日数を構成します。

A.6.8.2 有効期限後のアセットの登録の解除

次の行では、メタデータ変更フローを有効にして、有効期限の10日後にアセットの登録を解除します。

<unregister_after_expire action="true" days="10" queryOperator="eq"/>

A.6.8.3 有効期限後の非アクティブ化

次の行では、メタデータ変更フローを有効にして、有効期限の10日後にアセットを非アクティブにします。

<inactive_after_expire action="true" days="10" queryOperator="eq"/>

A.6.8.4 有効期限後のアセットの削除

次の行では、メタデータ変更フローを有効にして、有効期限の10日後にアセットを削除します。

<delete_after_expire action="true" days="10" queryOperator="eq"/>

A.6.9 電子メール通知テンプレートのカスタマイズ

自動登録フローでは、多くの状況下で電子メール通知が自動的に送信されます。新しいフローのための新しい電子メール・テンプレートは5つあります。電子メール・テンプレートはOracle Enterprise Repository内に格納され、フローでは名前と値のペアを渡してOracle Enterprise Repository APIを呼び出します。この名前と値のペアは、後でOracle Enterprise Repositoryによって置き換えられます。

管理者は、他の電子メール・テンプレートの場合と同じ方法で電子メールの件名や本文などをカスタマイズできます。自動ワークフローで使用されるテンプレートを次に示します。

- アセットのメタデータが変更されました: アセットに割り当てられたレジストラとユーザーに、メタデータが変更されたことを通知します。

- 登録ステータスが変更されていません: アセットに割り当てられたレジストラとユーザーに、登録ステータス<%asset.reg.status%>が<%action.pending.days%>日を超えて変更されていないことを通知します。

- 期限切れのアセットのステータスが変更されました: 期限切れのアセットに割り当てられたレジストラとユーザーに、ステータスが変更されたことを通知します。

- 有効期限が近づいています: アセットに割り当てられたレジストラとユーザーに、アセットの有効期限が近づいていることを通知します。

- アセットが期限切れになりました: アセットに割り当てられたレジストラとユーザーに、アセットの有効期限が切れたことを通知します。

電子メール・テンプレートの詳細は、第8章「電子メール・テンプレートの使用」を参照してください。

A.6.10 電子メール通知のユースケース

この項では、電子メール通知ユースケースを示し、次の電子メール・テンプレートをトリガーする方法について説明します。

- アセットが期限切れになりました: アセットに割り当てられたレジストラとユーザーに、アセットの有効期限が切れたことを通知します。
この電子メール・テンプレートは、アセットが期限切れになるたびにトリガーされます。この電子メール・テンプレートは、拡張ワークフロー構成の一部として作成されます。アセットの有効期限を設定するには、アセット・エディタの「その他」タブにある「有効期限(yyyy-MM-dd)」フィールドに日付を指定します。workflow.xmlには、アセットが期限切れになったときに実行する処理内容を指定するための要素があります。

- アセットのステータスが戻されました: アセットに割り当てられたレジストラとユーザーに、アセット登録ステータスが<%action.pending.days%>日を超えて変更されていないことを通知します。
この電子メール・テンプレートは、拡張ワークフロー構成の一部としても作成されます。たとえば、<notification timerInterval="1d">の下には、<registrar_accept action="false" days="5" regressOnInaction="true" queryOperator="eq"/>があります。このフローでは、指定した日数の間「受入れ済」ステータスであるアセットを追跡し、アクションを実行するためにレジストラに通知を送信します。

regressOnInaction="true"である場合、アクションが実行されていないアセットを元の状態に戻します。たとえば、受入れ済のアセットを未受入れにすることができます。

- アセットが使用されています: アセットの通知電子メール・フィールドに指定されている連絡先に、アセットが使用されていることを通知します。
この電子メール・テンプレートは、アセットがプロジェクト内で使用されるたびにトリガーされます。この電子メール・テンプレートにより、アセットの「その他」の下にある通知電子メール・テキスト・フィールドに指定されている電子メール・アドレスに通知が送信されます。

- コンプライアンス・テンプレートが適用されました: コンプライアンス・テンプレートがプロジェクトに適用されたときにプロジェクト・リーダーに通知します。
この電子メール・テンプレートは、コンプライアンス・テンプレート・タイプがプロジェクトに割り当てられるたびにトリガーされます。コンプライアンス・テンプレート・タイプは、アセット・タイプのアーキタイプの一部です。

- アセットのメタデータが変更されました: アセットに割り当てられたレジストラとユーザーに、メタデータが変更されたことを通知します。
この電子メール・テンプレートは、拡張ワークフロー構成の一部でもあり、メタデータが変更されるたびにトリガーされます。メタデータ変更フローは複数存在します。詳細は、A.6.6項「メタデータ変更フロー」を参照してください。

- 新しいアセット・バージョンが開発中です: アセットの新しいバージョンが開発されるたびにサブスクライバに通知します。
この電子メール・テンプレートは、新しいアセット・バージョンが開発されるたびにサブスクライバに通知します。新しいバージョンは、「次のバージョン」または「前のバージョン」というリレーションシップに基づいて識別されます。

- 新しいバージョンが登録されました: アセットの新しいバージョンが登録されるたびにサブスクライバに通知します。
この電子メール・テンプレートは、新しいアセット・バージョンが登録されるたびにサブスクライバに通知します。新しいバージョンは、「次のバージョン」または「前のバージョン」というリレーションシップに基づいて識別されます。

- 有効期限が近づいています: アセットに割り当てられたレジストラとユーザーに、アセットの有効期限が近づいていることを通知します。
この電子メール・テンプレートは、拡張ワークフロー構成でも使用され、アセットの有効期限が近づくたびにトリガーされます。たとえば、<expiration_warning action="false" days="5" owner="false" subscriber="false" contact="admin@example.com" queryOperator="eq"/>などです。

- 登録ステータスが変更されていません: アセットに割り当てられたレジストラとユーザーに、登録ステータス'<%asset.reg.status%>'が<%action.pending.days%>日を超えて変更されていないことを通知します。
この電子メール・テンプレートは、ワークフロー構成でも使用され、登録ステータスがワークフロー構成に指定された日数の間変更されない場合にトリガーされます。たとえば、<registrar_register action="false" days="5" regressOnInaction="false" queryOperator="eq"/>などです。

- 期限切れのアセットのステータスが変更されました: 期限切れのアセットに割り当てられたレジストラとユーザーに、ステータスが変更されたことを通知します。
この電子メール・テンプレートは、拡張ワークフロー構成でも使用され、期限切れのアセットのステータスが変更されるたびにトリガーされます。

- 使用方法が再割当てされました: アセット使用レコードが再割当てされたことをユーザーに通知します。
この電子メール・テンプレートは、複数の場所からトリガーされます。

「プロジェクトの詳細」で、次の手順を実行します。

1. プロジェクトの詳細に移動します。

2. ユーザー/使用方法の再割当てをクリックします。

3. 使用方法のみ再割当てを選択します。

4. 現在のまたは別のプロジェクトを選択します。

5. 「次」をクリックします。そのプロジェクトに対応するユーザーのリストが表示されます。

6. 使用方法の転送先のユーザーを選択します。
この電子メール・テンプレートは、使用方法が転送されたユーザーに通知を送信します。

「プロジェクトの編集」で、次の手順に従います。

1. 「プロジェクトの編集」をクリックします。

2. 「ユーザーの編集」をクリックします。

3. 使用レコードがあるユーザーを削除します。使用方法を転送できるユーザーの「割当て」オプションが表示されます。
この電子メール・テンプレートは、使用方法が転送されたユーザーに対する通知をトリガーします。

A.6.11 既知の問題

この項では、Oracle Enterprise Repositoryワークフローに関する次の既知の問題について説明します。

- workflow-tools/refresh_workflows.shファイルには、ハードコード化されたJDKへのパスが含まれていますが、このパスは無効です。別のJDKを使用している場合、refresh_workflows.shファイルを手動で編集してそのJDKにマップする必要があります。

- Windowsでファイルを変更し、UNIXでCR/NL文字を処理する方法を理解しないエディタでこのファイルを保存する場合、次のコマンドを実行してLF文字を<file.sh>ファイルから削除する必要があります。
cat filename.sh | tr -d '\015' > filename.sh.tmp; mv filename.sh.tmp filename.sh

A.7 Oracle Enterprise Repository用のJMSサーバーの構成

この項では、Oracle Enterprise Repository用のJMSサーバーを構成する方法について説明します。

この項には次のトピックが含まれます:

- A.7.1項「イベント・マネージャ用のJMSの概要」

- A.7.2項「外部JMSサーバー用の接続プロパティの構成」

- A.7.3項「データベースを使用するための組込みActiveMQ JMSサーバーの構成」

- A.7.4項「Oracle Enterprise Repositoryクラスタ内のJMSサーバーの構成」

- A.7.5項「WebSphere 6.1.0.5でのJMSプロバイダの構成」

A.7.1 イベント・マネージャ用のJMSの概要

イベント・マネージャは、デフォルトで有効になっているApache ActiveMQ JMSサーバーの組込みバージョンを使用します。組込みJMSサーバーは、追加構成なしで即時利用可能な状態で実行できるよう構成されています。ただし、OracleのWeblogic Server JMSまたはIBM WebSphere Application Serverなどの外部JMSサーバーを使用する場合は、Oracle Enterprise Repositoryの複数のシステム設定を構成する必要があります。

注意:

Oracle Enterprise RepositoryがWebSphere 6.xにデプロイされている場合、ActiveMQとOracle Enterprise Repositoryによって使用されるクラスの競合のため、組込みApache ActiveMQ JMSサーバーは使用できません。したがって、WebSphere 6.xのユーザーは、WebSphere 6.xに用意されているデフォルトのJMS実装を使用する必要があります。A.7.5項「WebSphere 6.1.0.5でのJMSプロバイダの構成」を参照してください。

A.7.2 外部JMSサーバー用の接続プロパティの構成

Oracle Enterprise Repositoryのシステム設定セクションを使用して、Oracle Enterprise Repositoryの基本操作を構成、および特定の機能を有効/無効にできます。イベント・マネージャのJMS関連の設定は、外部統合カテゴリのイベンティング・グループの下にあります。システム設定の詳細は、『Oracle Fusion Middleware Oracle Enterprise Repository統合ガイド』を参照してください。追加の「イベンティング」プロパティは、A.4項「Oracle Enterprise Repositoryイベント・マネージャの構成」を参照してください。

A.7.2.1 外部JMSサーバーの有効化および構成

外部JMS製品を構成するには、内部のApache ActiveMQ JMSサーバーを無効にする必要があります。また、外部JMS用のJNDIおよびJMSプロパティも構成する必要があります。

注意:

次の手順は、単一の外部JMSサーバーを構成するためのものです。クラスタ内の複数のJMSサーバーを構成する手順は、A.7.4項「Oracle Enterprise Repositoryクラスタ内のJMSサーバーの構成」を参照してください。

1. Oracle Enterprise Repositoryの「管理」画面上のサイドバーにある「システム設定」をクリックします。

2. 「システム設定」の「検索」ボックスに「Event」と入力し、イベント・マネージャ関連の設定をすべて表示します。

3. 「イベント・マネージャ組込みJMS有効化」プロパティの横にある「False」をクリックし、内部JMSサーバーのプロパティcmee.eventframework.embedded.jms.enabledを無効にします。これにより、イベント・マネージャが外部JMSサーバーを使用するようにします。

注意:

cmee.eventframework.embedded.jms.enabledプロパティはデフォルトでは表示されません。このプロパティを有効にするには、「システム設定の有効化」ボックスにこのプロパティ名を入力し、「有効化」をクリックします。

4. eventing.propertiesファイルで、次の必須JNDIプロパティを構成します。

- JNDI URL: cmee.eventframework.jndi.provider.url
JNDI URLを指定します。たとえば、t3://localhost:7001などです。

- JNDI User Name: cmee.eventframework.jndi.user
JNDIユーザー名を指定します。

- JNDI Password: cmee.eventframework.jndi.password
JNDIユーザー名のパスワードを指定します。

- JNDI Context Factory: cmee.eventframework.jndi.context.factory
JNDI初期コンテキスト・ファクトリを指定します。たとえば、weblogic.jndi.WLInitialContextFactoryなどです。

注意:

JNDIプロパティはデフォルトでは表示されません。これらのプロパティを有効にするには、「システム設定の有効化」ボックスに各プロパティ名を入力し、「有効化」をクリックします。

5. eventing.propertiesファイルで、次のJMSプロパティを構成します。

- JMS Connection Factory: cmee.eventframework.jms.connection.factory
JMSクライアントによるJMS接続の作成を可能にするためにJMS接続ファクトリを指定します。たとえば、weblogic.examples.jms.TopicConnectionFactoryなどです。

- JMS Topic: cmee.eventframework.jms.topic
JMSサーバーの公開/サブスクライブの宛先タイプであるJMSトピックを指定します。たとえば、weblogic.examples.jms.TopicConnectionFactoryなどです。

注意:

JMSプロパティはすべてデフォルトでは表示されません。これらのプロパティを有効にするには、「システム設定の有効化」ボックスに各プロパティ名を入力し、「有効化」をクリックします。

6. 「保存」をクリックします。

7. Oracle Enterprise Repositoryを再起動して構成の変更内容を反映します。

A.7.2.2 JMSメッセージ・ヘッダーのプロパティの構成

すべてのJMSメッセージには、デフォルトで挿入され、メッセージ・コンシューマで利用できる標準のヘッダー・フィールドがあります。Message ExpirationおよびDelivery Modeヘッダーは、Oracle Enterprise Repositoryのシステム設定を使用して構成できます。

1. A.7.2.1項「外部JMSサーバーの有効化および構成」で説明されているように、「イベンティング」システム設定にアクセスします。

2. eventing.propertiesファイルで、JMSメッセージ・ヘッダーのプロパティを構成します。

- JMS Message Expiration: JMSメッセージの有効期限を秒単位で設定します。設定されている場合、指定した秒数内に未処理のイベントが期限切れになります。デフォルトは0秒です。この場合、メッセージは期限切れになりません。ただし、一部の環境では、JMSメッセージがなんらかの理由によって選択されていない場合、これらのメッセージを恒久的に格納できないようにすることを要求するポリシーが設定されています。このプロパティを有効にし、プロパティ値をcmee.eventframework.jms.expirationに設定してください。

- JMS Delivery Mode: JMSメッセージ配信モードをPERSISTENTまたはNON-PERSISTENT値に設定します。PERSISTENTに設定されている場合、JMSサーバーはイベントを基礎となるストアに書き込みます。イベントをストアに対して永続化すると信頼性が高くなりますが、パフォーマンスに影響する可能性があります。デフォルトはPERSISTENTです。このプロパティを有効にし、プロパティ値をcmee.eventframework.jms.deliverymodeに設定してください。

3. 「保存」をクリックします。

4. Oracle Enterprise Repositoryを再起動して構成の変更内容を反映します。

A.7.2.3 その他のJMSプロパティ

注意:

Eventingプロパティの変更後に変更を有効にするには、Oracle Enterprise Repositoryを再起動する必要があります。

次のその他のシステム設定を構成することもできます。

- イベント・マネージャJMSサブスクライバの有効化: Falseに設定されている場合、内部JMSサブスクライバは有効になりません。この目的は、組込みJMSサーバーを起動するが、外部ツールを使用して特定の永続サブスクライバ名を使用して組込みサーバーに接続し、格納されているイベントをクリーンアップできるようにすることにあります。

- JMSサブスクライバ・クライアントID: JMS永続サブスクライバIDを指定します。たとえば、ALER_JmsSubscriberなどです。プロパティ名はcmee.eventframework.jms.subscribers.client.idです。

- JMSプロデューサ・クライアントID: JMSプロデューサのクライアントIDを指定します。たとえば、ALER_DeliveryManagerなどです。プロパティ名はcmee.eventframework.jms.producers.client.idです。

- イベント・エンジンの遅延初期化: 有効な場合、イベントが初めて生成されるときにイベント・マネージャが初期化されます。このプロパティを有効にする必要があるのは、次のいずれかの場合です。

- JMSサーバーによって多数のイベントが格納されており、Oracle Enterprise Repositoryが起動すると同時にこれらのイベントを処理しないほうがよい場合

- 組込みJMSサーバーを初期化するタイミングが原因で起動に関する問題が発生する場合

プロパティ名はcmee.eventframework.lazy.loadです。

A.7.2.4 外部JMS Jarファイルの構成

外部JMSサーバーが使用されている場合、外部JMSサーバー関連のJARファイルをWEB-INF\libディレクトリにコピーする必要があります。

A.7.3 データベースを使用するための組込みActiveMQ JMSサーバーの構成

デフォルトでは、ActiveMQ JMSサーバーではファイルベースのストアを使用してイベントが格納されます。ただし、イベントをデータベースに格納するよう指定することもできます。データベース・パラメータを使用するには、単純にWEB-INF\classesディレクトリ内のactivemq.xmlファイルを構成します。

次に例を示します。

<persistenceAdapter>
<journaledJDBC journalLogFiles="5" dataDirectory="../activemq-data"
dataSource="#oracle-ds" />
<!-- To use a different datasource, use the following syntax : -->
<!-- <journaledJDBC journalLogFiles="5" dataDirectory="../activemq-data"
dataSource="#postgres-ds"/> -->
<!--  Oracle DataSource Sample Setup  -->
- <bean id="oracle-ds" class="org.apache.commons.dbcp.BasicDataSource"
destroy-method="close">
<property name="driverClassName" value="oracle.jdbc.driver.OracleDriver" />
<property name="url" value="jdbc:oracle:thin:@localhost:1521:AMQDB" />
<property name="username" value="scott" />
<property name="password" value="*****" />
<property name="poolPreparedStatements" value="true" />
</bean>

A.7.3.1 Webサービス・エンドポイント用のJMS永続サブスクライバの構成

サブスクリプション・マネージャのXMLファイル内でWebサービス・エンドポイントが検出されるたびに、1つの永続サブスクライバが作成されます。これにより、エンドポイントがオンラインでない場合にイベントが格納され、エンドポイントが再度オンラインになったときにイベントを確実に配信できるようになります。JMS仕様に従い、永続サブスクライバ名はJMSサーバー全体にわたって一意である必要があります。イベント・マネージャは、永続サブスクライバ名を次の例に示すようにEndPointEventSubscription.xmlファイル内にある名前フィールドから取得します。

<sub:EventSubscriptionData
xmlns:sub="http://www.bea.com/infra/events/subscription"
<sub:eventSubscription>
<sub:endPoint name="ALBPMEndpoint">

注意:

JMSサーバーは永続サブスクライバ名をメッセージ・セレクタに関連付けます。したがって、メッセージ・セレクタが変更される場合、新しい永続サブスクライバ名を指定するか、既存の永続サブスクライバ名を削除する必要があります。7-4ページの「格納されているイベントのクリーンアップ」で説明されているように、Oracle Enterprise Repositoryのイベント・クリーンアップ・ツールを使用できます。また、JMS固有のツールを使用してこれを行うこともできます。

A.7.4 Oracle Enterprise Repositoryクラスタ内のJMSサーバーの構成

注意:

クラスタ環境におけるOracle Enterprise Repositoryの構成の詳細は、『Oracle Fusion Middleware Oracle Enterprise Repositoryインストレーション・ガイド』を参照してください。

A.7.4.1 JMSクラスタリング・モードの有効化

Oracle Enterprise Repositoryがクラスタ・モードでデプロイされている場合、使用されているJMSサーバーのタイプ(組込みまたは外部)とは関係なく、Oracle Enterprise Repositoryインスタンスごとにクラスタリングを有効にする必要があります。

1. Oracle Enterprise Repositoryの「管理」画面上のサイドバーにある「システム設定」をクリックします。

2. cmee.eventframework.clustering.enabledを「新しいシステム設定の有効化」ボックスに入力し、「有効化」をクリックして、この非表示のプロパティを表示します。

3. 「有効クラスタリング」プロパティをTrueに設定します。

4. 次の各項で説明されているように、JMSサーバーのタイプに基づいて他の必要なプロパティを設定します。

A.7.4.2 クラスタリング用の組込みJMSサーバーの構成

クラスタ環境では、クラスタ内のOracle Enterprise Repositoryのメンバー・インスタンスごとに1つの組込みJMSサーバーが設定されます。たとえば、2ノード・クラスタの場合、server01やserver02などのOracle Enterprise Repositoryインスタンスが2つ存在し、それぞれに1つの組込みJMSサーバーがあります。組込みJMSサーバーに対してクラスタリングが有効になったら、server01およびserver02上の組込みJMSサーバーに対して接続URL情報を指定する必要があります。

1. Oracle Enterprise Repositoryの「管理」画面上のサイドバーにある「システム設定」をクリックします。

2. cmee.eventframework.embedded.jms.urlを「新しいシステム設定の有効化」ボックスに入力し、「有効化」をクリックして、この非表示のプロパティを表示します。

3. 「組込みJMSサーバーURL」プロパティで、次の形式を使用して、クラスタリングされたOracle Enterprise Repositoryサーバー上の組込みJMSサーバーの接続URLを指定します。

failover:(tcp:// $SERVER_DNS_NAME_OR_IP$:61700,tcp://$SERVER_DNS_NAME_OR_IP$:61700, …)

意味は次のとおりです。

$SERVER_DNS_NAME_OR_IP$は、実際のサーバーのDNS名またはIPアドレスによって置き換えられます。これらの入力は、指定したクラスタ内のOracle Enterprise Repositoryサーバーごとに繰り返す必要があります。

前述の例を使用して、これは、failover:(tcp://server01:61700,tcp://server02:61700)のように設定できます。

注意:

ポート61700は組込みJMSサーバーのデフォルトのポートであるため、組込みJMSサーバーに別のポートが構成されていないかぎり、Oracle Enterprise Repositoryサーバー上の他のアプリケーションによって使用されないようにする必要があります。

4. 「保存」をクリックします。

5. 指定したクラスタ内のOracle Enterprise Repositoryインスタンスごとに手順1-4を繰り返します。前述の例を使用して、組込みブローカのURLは、failover:(tcp://server01:61700,tcp://server02:61700)のように設定できます。

ヒント:

cmee.eventframework.embedded.jms.enabledプロパティをTrueに設定することにより、各組込みJMSサーバーが有効であることを確認してください。

A.7.4.3 クラスタリング用の外部JMSサーバーの構成

外部JMSサーバーの場合、追加構成は必要ありません。ただし、次のように、組込みJMSサーバーが無効であることを確認する必要があります。

1. Oracle Enterprise Repositoryの「管理」画面上のサイドバーにある「システム設定」をクリックします。

2. イベント・マネージャ組込みJMS有効化プロパティをFalseに(つまり、cmee.eventframework.embedded.jms.enabledをFalseに)設定します。

A.7.5 WebSphere 6.1.0.5でのJMSプロバイダの構成

Oracle Enterprise RepositoryがWebSphere Application Server 6.1.0.5にデプロイされている場合、組込みApache ActiveMQ JMSサーバーは使用できません。したがって、WebSphere 6.1.0.5実装では、WebSphere 6.1.0.5に用意されているデフォルトのJMSプロバイダを使用する必要があります。

WebSphere 6.1.0.5でOracle Enterprise Repository用のJMSプロバイダを構成するには、WebSphere管理コンソールとOracle Enterprise Repositoryアプリケーションで次の手順をすべて実行します。

1. 新しいサービス統合バスを作成します。

1. ナビゲーション・ペインで、「Service Integration」を展開し、「Buses」をクリックします。

2. 「Buses」ページで、「New」をクリックします。

3. 「Create a new bus」ページで、新しいバスの名前として「alerbus」を入力します。

4. 「Bus security」オプションの選択を解除します。

5. 「次へ」をクリックして、「完了」をクリックします。

2. 新たに作成されたalerbusにバス・メンバーを追加します。

1. 「Buses」ページで、「alerbus」リンクをクリックします。

2. 「Topology」カテゴリの下で、「Bus members」をクリックします。

3. 「Bus members」ページで、「Add」をクリックします。

4. 「Add a new bus member > Select Server, Cluster or WebSphere MQ server」ページで、デフォルトの「Server」オプションをそのまま使用して、「Next」をクリックします。

5. 「Add a new bus member > Select the type of message store」ページで、デフォルトの「File store」オプションをそのまま使用して、「Next」をクリックします。

6. 「Add a new bus member > Provide the message store properties」ページで、デフォルト値をそのまま使用して、「Next」をクリックします。

7. 「Add a new bus member > Confirmation」ページで、「Finish」をクリックします。

8. 「Buses」ページで、「Save」をクリックします。

3. デフォルトのメッセージ・プロバイダでJMSトピック接続ファクトリを作成します。

1. ナビゲーション・ペインで、「JMS」を展開し、「JMS providers」をクリックします。

2. 「Default messaging provider」オプションをクリックします。「Scope」は「Node=<nodename>, server=server1」にします。

3. 「JMS providers > Default messaging provider」ページで、「Additional Properties」の下にある「Topic connection factories」オプションをクリックします。

4. 「JMS providers > Default messaging provider > Topic connection factories」ページで、「New」をクリックします。

5. 「Administration」ページで、次のようにトピック接続ファクトリを構成します。
*) Name: alerEventingTopicCFDefault

*) JNDI name: jms.alerEventingTopicCFDefault

*) Bus name: alerbus

*) Client identifier: ALER_JmsProducer

*) Durable subscription home: <nodename>.server1-alerbus

6. 「Apply」をクリックし、「Save」をクリックします。

4. デフォルトのメッセージ・プロバイダでJMSトピックを作成します。

1. 「JMS providers > Default messaging provider」ページにもう一度移動します。

2. 「Additional Properties」の下にある「Topics」オプションをクリックします。

3. 「JMS providers > Default messaging provider > Topic」ページで、「New」をクリックします。

4. 「Administration」ページで、次のようにトピックを構成します。
*) Name: alerEventingTopicCFDefault

*) JNDI name: jms.alerEventingTopicCFDefault

*) Topic name: alerEventingTopicDefault

*) Bus name: alerbus

*) Topic space: Default.Topic.Space

5. 「Apply」をクリックし、「Save」をクリックして変更を保存します。

5. 次のように、aler.earアプリケーション・ファイルをデプロイします。

1. ナビゲーション・ペインで、「Applications」を展開し、「Enterprise Applications」をクリックします。

2. 「Enterprise Applications」ページで、「Install」をクリックします。

3. 「Preparing for the application install」ページで、「Browse」をクリックし、aler.earファイルをパスに指定して、「Next」をクリックします。

4. 「Select installation options」ページで、「Next」をクリックします。

5. 「Map modules to servers」ページで、「Next」をクリックします。

6. 「Map resources to resource references」ページで、「Target Resource JNDI Name」列の「Browse」をクリックします。

7. 「Enterprise application > Available resources」ページで、「alerEventingTopicCFDefault」を選択し、「Apply」をクリックします。

8. 「ensuing Map resources to resource references」ページで、「Next」をクリックします。

9. 「Map resource environment entry references to resources」ページで、「Target Resource JNDI Name」に「jms/aler/alerEventingTopicDefault」と入力し、「Next」をクリックします。

10. 「Summary」ページで「Finish」をクリックします。

11. アプリケーションがインストールされたら、「Save」をクリックし、アプリケーションをマスター構成に保存します。

6. 『Oracle Fusion Middleware Oracle Enterprise Repositoryインストレーション・ガイド』のOracle Business Process Managementプロセス・エンジンおよび自動ワークフローの手動インストールの手順に関する項に従い、web-inf/classesディレクトリにある追加のファイルとOracle Enterprise Repositoryアプリケーションで必要なデータベース・ドライバをデプロイします。

7. WebSphere設定用のOracle Enterprise Repositoryのeventing.propertiesファイルを構成します。

1. <OER Domain>\WEB-INF\classesディレクトリに移動します。

2. テキスト・エディタを使用して、次のようにeventing.propertiesファイルを変更します。

cmee.eventframework.jms.topic=jms.alerEventingTopicDefault
cmee.eventframework.jndi.provider.url=iiop\://localhost:2809
cmee.eventframework.embedded.jms.enabled=false
cmee.eventframework.jndi.context.factory=com.ibm.websphere.naming.WsnIniti
alContextFactory
cmee.eventframework.jms.connection.factory=jms.alerEventingTopicCFDefault

3. ファイルを保存します。

8. WebSphereアプリケーション・サーバーを再起動して、変更した設定を有効にします。

9. WebSphereログの\WebSphere\AppServer\profiles\AppSrv01\logs\server1で、可能性があるエラーについて確認します。

A.8 イベントのモニタリングおよび管理

この項では、Oracle Enterprise Repositoryでイベントをモニターおよび管理する手順について説明します。

この項には次のトピックが含まれます:

- A.8.1項「概要」

- A.8.2項「イベントのモニタリング」

- A.8.3項「格納されたイベントのクリーンアップ」

- A.8.4項「ワークフローの構成」

- A.8.5項「パスワードの暗号化」

A.8.1 概要

この項では、Oracle Enterprise Repositoryの一部として用意されている管理ツールについて説明します。拡張登録フロー管理ツールを使用して、次を行います。

- コマンド行インタフェースを使用したイベントのモニター

- イベントのクリーンアップおよびJMS永続サブスクライバのサブスクライブ解除

- ワークフロー構成ファイルの生成

- 最新のワークフロー構成ファイルを使用したOracle Business Process Managementエンジンのリフレッシュ

- ワークフロー構成ファイルおよびサブスクリプション・マネージャ・ファイルに格納されているパスワードの暗号化

管理ツールは、次のディレクトリにインストールされます。

<ORACLE_HOME>/repositoryXXX/core/workflow-tools

A.8.2 イベントのモニタリング

イベント・マネージャには、イベント・マネージャによって生成されたイベントをモニタリングするためのツールが用意されています。このツールは、イベント・トラフィックを監視し、この項に示すイベント本体やイベント・プロパティなどの情報を出力します。

A.8.2.1 前提条件

モニタリング・ツールを起動する前に、次の前提条件を満たす必要があります。

- デフォルトの組込みJMSサーバーを使用する場合、cmee.eventframework.enabledシステム設定がtrueに設定された状態でOracle Enterprise Repositoryを実行する必要があります。これにより、Oracle Enterprise Repository内に組み込まれたJMSブローカが実行され、モニタリング・ツールがJMSブローカに接続してイベントをモニターできるようにします。

- 外部JMSサーバーが使用される場合、外部JMSサーバーが実行されている必要があり、外部JMSサーバーに接続するために必要なJNDI関連のeventing.propertiesが構成されている必要があります。

詳細は、A.7.2項「外部JMSサーバー用の接続プロパティの構成」を参照してください。

A.8.2.2 使用方法

次のように、コマンド・プロンプトからイベント・モニタリング・ツールを実行します。

> event_monitor.bat <Path of WEB-INF\classes>

たとえば、Oracle Enterprise Repositoryが、D:\bea816\user_projects\domains\oerdomainの下にあるoerdomainという名前のドメインにデプロイされているとします。

この場合、<Path of WEB-INF\classes>は次のようになります。

<Oracle_HOME>\user_projects\applications\base_domain\applications\oer_11.1.1.4.0\oer-app\WEB-INF\classes

Oracle_HOMEは、OER_HOMEインストールの場所を表します。

このパスは、このツールがJMSサーバーに接続できるようeventing.propertiesファイルからJMS構成を取得するために必要です。

図A-23 イベント・モニター・コンソール

A.8.3 格納されたイベントのクリーンアップ

場合によっては、イベント・エンジンによって格納されたすべてのイベントを削除し、永続サブスクリプションのサブスクライブ解除も必要になります。これを行うには、イベント・クリーンアップ・ツールを使用します。

A.8.3.1 前提条件

このツールを起動する前に、次の前提条件を満たす必要があります。

- Oracle Enterprise Repositoryのcmee.eventframework.jms.subscribers.enabledシステム設定をfalseに設定し、Oracle Enterprise Repositoryイベント・マネージャが永続サブスクライバを起動しないようにします。理由は、これは、イベント・クリーンアップ・ツールによってサブスクライブ解除されるからです。

- cmee.eventframework.jms.subscribers.enabledプロパティがfalseに設定された状態でOracle Enterprise Repositoryを再起動します。

A.8.3.2 使用方法

次のように、コマンド・プロンプトからイベント・クリーンアップ・ツールを実行します。

> event_clean.bat <Path of WEB-INF\classes> <Name of Durable Subscriber> <Message Selector>

たとえば、Oracle Enterprise Repositoryが、D:\bea816\user_projects\domains\oerdomainの下にあるoerdomainという名前のドメインにデプロイされているとします。

この場合、<Path of WEB-INF\classes>は次のようになります。

<Oracle_HOME>\user_projects\applications\base_domain\applications\oer_11.1.1.4.0\oer-app\WEB-INF\classes

このパスは、このツールがJMSサーバーに接続できるようeventing.propertiesからJMS構成を取得するために必要です。

<Name of Durable Subscriber>は、次のように、EndPointEventSubscription.xml内のイベントのクリーンアップが必要なエンドポイント内の名前属性にあります。

<sub:eventSubscription>
<!--The name should be unique within this file since
<sub:endPoint name="ALBPMEndpoint">

<Message Selector>は、EndPointEventSubscription.xmlファイル内のクリーンアップが必要なエンドポイント内の式属性にあります。

注意:

メッセージ・セレクタが設定されていないか空である場合、このパラメータは省略できます。

A.8.3.3 イベントのクリーンアップの例

前述の例を使用して、workflow-toolsディレクトリに移動します。

> cd D:\bea816\repositoryXXX\core\workflow-tools>

コマンド・プロンプトで、次を入力します。

> event_clean.bat <ORACLE_HOME>\user_projects\applications\base_domain\applications\oer_11.1.1.4.0\oer-app\WEB-INF\classes ALBPMEndpoint

イベント・クリーンアップ・ツールによってコンソールに表示される出力は、次のとおりです。

図A-24 イベント・クリーンアップ・コンソール

A.8.4 ワークフローの構成

ワークフロー構成の生成ツールを使用して、Oracle Enterprise Repositoryに接続してワークフロー構成ファイル(workflow.xml)を生成します。このツールにより、アセット・タイプやカテゴリ分けなどをOracle Enterprise Repositoryから読み取り、これらのエンティティの構成をworkflow.xmlに移入します。これにより、要件に応じてワークフロー構成ファイルをカスタマイズできるようになります。たとえば、フローを構成およびカスタマイズして新しいアセット・タイプ、プロジェクト、カテゴリ分けなどの追加が必要になる場合があります。

自動ワークフローの構成の詳細は、A.6項「自動ワークフローの構成」を参照してください。

次のように、コマンド・プロンプトからワークフロー構成の生成ツールを実行します。

> config_gen.bat URI User Password ConfigDir

意味は次のとおりです。

URI = OER URI (例: http://localhost:7001/alerbuild/services/FlashlineRegistry)

User = OERユーザー名

Password = OERパスワード

ConfigDir = 構成XMLファイルが作成されたディレクトリ。このファイルが存在する場合は、名前がworkflow.xml.bakに変更されます。

図A-25 ワークフロー構成の生成ツール

workflow.xmlファイルは次のディレクトリに生成する必要があります。

<OBPM Enterprise Home>/server/<OER Workflows Project>/workflow.xml

A.8.4.1 ワークフロー構成ファイルのリフレッシュ

ワークフロー構成XMLのリフレッシュ・ツールを使用すると、Oracle Business Process Managementエンジンを再起動せずにワークフロー構成ファイルをリフレッシュできます。たとえば、ワークフロー構成XMLファイルが開発中に更新された場合、このツールを実行すると、Oracle Business Process Managementエンジンを再起動しなくてもエンジンで更新バージョンを使用できるようになります。

注意:

このツールの実行時には、Oracle Business Process Managementエンジンが実行されている必要があります。

次のように、コマンド・プロンプトからワークフロー構成のリフレッシュ・ツールを実行します。

> refresh_workflows.bat URI User Password

意味は次のとおりです。

URI = Oracle Business Process ManagementのURI (たとえば、http://localhost:9000/albpmServices/aler_engine/ws/RefreshConfigServiceListener)

User = Oracle Business Process Managementのユーザー名(たとえば、aler_workflow_user)

Password = Oracle Business Process Managementのパスワード(たとえば、aler_workflow_pass)

注意:

aler_workflow_userは、Oracle製品インストーラによって作成されます。これが、このツールで使用できるデフォルトのユーザーです。

図A-26 ワークフロー構成のリフレッシュ・ツール

A.8.5 パスワードの暗号化

セキュリティを高めるために、セキュリティ暗号化パスワード・ツール(runWfSecurity.bat)を使用して、ワークフロー構成ファイルおよびサブスクリプション・サービス・ファイルに格納されているパスワードを暗号化できます。

次のように、コマンド・プロンプトからセキュリティ暗号化パスワード・ツールを実行します。

> runWfSecurity.bat srcFileName destFileName

意味は次のとおりです。

srcFileName = 平文パスワードが含まれるソース構成ファイル

destFileName = 暗号化パスワードが含まれる宛先構成ファイル

図A-27 セキュリティ暗号化パスワード・ツール

A.9 Webサービス・エンドポイントのイベント・マネージャの拡張

この項では、Webサービス・エンドポイントのイベント・マネージャを拡張する方法について説明します。

この項には次のトピックが含まれます:

- A.9.1項「概要」

- A.9.2項「Webサービス・エンドポイントの開発」

- A.9.3項「Webサービスの操作」

- A.9.4項「互換性のない契約を持つエンドポイントの開発」

A.9.1 概要

この項では、イベント・マネージャによって発行されるイベントを使用するためにWebサービス・エンドポイントを開発する方法について説明するとともに、他の通知サービス・プラグインを使用するためにイベント・マネージャを拡張する方法について説明します。イベント・マネージャの構成の詳細は、第A章「Oracle Enterprise Repositoryイベント・マネージャの構成」を参照してください。

A.9.2 Webサービス・エンドポイントの開発

図A-28に、Oracle Enterprise Repositoryイベント・マネージャによって発行されたイベントを受け取るためにWebサービス・エンドポイントをプラグインする方法を示します。

図A-28 Webサービス・エンドポイントのプラグイン

新しいWebサービス・エンドポイントを作成し、イベントの取得を開始するには、次の手順を実行します。

1. イベント・マネージャによって定義されたWSDL契約を選択します。これは、<oer Webapp path>/WEB-INF/libディレクトリにあるmodules.eventing-11.1.1.x.x.jarファイルにバンドルされています。

2. jarファイルを開き、"EventListener.WSDL"という名前のWSDLを探し、このWSDLをファイル・システムに抽出します。このWSDLは、イベント・マネージャによって定義された抽象契約であり、新しいWebサービス・エンドポイントでは、WSDLに定義されている操作を実装する必要があります。
図A-29に、WSDLファイルのスナップショットを示します。

図A-29 WSDLファイルの例

3. 要件に応じて、ツールまたはテクノロジを使用してWebサービス・エンドポイントの開発を完了させます。たとえば、WSDLファイルを指すことによってWebサービスベースのプロキシ・サービスを作成するための機能が用意されているOracle Service Busを使用して、プロキシ・サービスを開発できます。Webサービスの開発を完了させ、Webサービスを実行できるようにします。

4. Webサービス・エンドポイントのホスト、ポートおよびURIなどをサブスクリプション・マネージャ・ファイルに入力できるようイベント・マネージャを構成します。イベント・マネージャの構成の詳細は、第A章「Oracle Enterprise Repositoryイベント・マネージャの構成」を参照してください。

5. Oracle Enterprise Repositoryを起動し、アセット・エディタを使用してイベントをトリガーします。これにより、Webサービス・エンドポイントによるイベントの取得が開始されます。

6. Oracle Enterprise Repositoryにバンドルされているイベント・モニタリング・ツールを使用して、イベント・マネージャによって生成されたイベントをデバッグおよびモニタリングできます。

A.9.3 Webサービスの操作

この項では、新しいWebサービス・エンドポイントに対して使用可能な操作や、イベント・マネージャで操作を指定する方法について説明します。

A.9.3.1 使用可能なWebサービスの操作

Oracle Enterprise Repositoryイベント・マネージャは、次の操作をサポートしています。

newEventRequestResponse

この操作では、XMLスキーマ・セクションに定義されているイベント・オブジェクトが入力として使用され、ステータスが出力として返されます。ステータスは文字列型として定義されます。また、ステータスの文字列の先頭がFailureの場合、例外がスローされ、成功するまでイベントの再配信が試行されます。それ以外の場合、レスポンスが記録され、トランスポートの例外が発生しないかぎり、次のイベントが配信されます。

newEventRequestResponseString

この操作では、文字列形式のイベント・データが入力として使用され、ステータスが出力として返されます。ステータスは文字列型として定義されます。また、ステータスの文字列の先頭がFailureの場合、例外がスローされ、成功するまでイベントの再配信が試行されます。それ以外の場合、レスポンスが記録され、トランスポートの例外が発生しないかぎり、次のイベントが配信されます。

newEventRequest

この操作では、XMLスキーマ・セクションに定義されているイベント・オブジェクトが入力として使用され、一方向の操作として定義されます。

newEventRequestString

この操作では、文字列形式のイベント・データが入力として使用され、一方向の操作として定義されます。

newEvent

この操作は、プロセス・エンジンがOracle Business Process Managementである場合にのみ使用する必要があります。この操作では、内部的にstartSession操作を呼び出してセッションが開始され、Oracle Business Process Managementが認証されます。また、この呼出しの後にdiscardSessionも呼び出されます。

A.9.3.2 Webサービスの操作の選択

イベント・マネージャのサブスクリプション・マネージャを次のように構成することにより、operationName要素に指定されている優先Webサービスの操作を選択できます。

<sub:EventSubscriptionData xmlns:sub="http://www.bea.com/infra/events/subscription"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<sub:eventSubscription>
<sub:endPoint name="ALBPMEndpoint">
<sub:host>localhost</sub:host>
<sub:port>9000</sub:port>
<sub:uri>albpmServices/aler_
engine/ws/StatusChangeEndpointServiceListener</sub:uri>
<sub:targetNamespace>http://www.bea.com/infra/events</sub:targetNamespace>
<sub:operationName>newEvent</sub:operationName>
<sub:protocol>HTTP</sub:protocol>
<sub:authenticationData>
<sub:basicAuthentication>
<sub:username>aler_workflow_user</sub:username>
<sub:password>*****</sub:password>
</sub:basicAuthentication>
</sub:authenticationData>
</sub:endPoint>     <sub:notifierClass>com.bea.infra.event.notifier.plugin.http.DefaultHTTPEventNotifier</sub:notifierClass>
<sub:expression></sub:expression>
</sub:eventSubscription>
</sub:EventSubscriptionData>

A.9.3.3 通知サービス・プラグインの開発

Oracle Enterprise Repositoryイベント・マネージャには、デフォルトのSOAP/HTTP通知サービスが含まれます。追加の要件が存在する場合は、図A-30に示すように、新しいプラグインを開発してプラグインできます。

図A-30 通知サービス・プラグイン

新しいプラグインがイベント・マネージャと連携して機能するようにするには、次の手順に従います。

1. Oracle Enterprise Repositoryイベント・マネージャにバンドルされているJavaクラスAbstractEventNotifierを拡張して、新しい通知サービス・プラグインを開発します。このクラスは、<oer Webapp path>-app/WEB-INF/libディレクトリにあるmodules-eventing-<oer.version>.jarにバンドルされています。init()およびsendNotification()メソッドをオーバーライドする必要があります。
これらのメソッドの詳細は、Javadoc (EventManagerPublicAPIdoc.zip)を参照してください。handle()メソッドは、XML Bean形式でイベント・データを渡します。これにより、イベント・データを外部Webサービスに送信できるようになります。

2. 開発されたクラスを指すようにサブスクリプション・マネージャ・ファイルを構成します。notifierClass要素を次のように変更します。

<sub:EventSubscriptionData xmlns:sub="http://www.bea.com/infra/events/subscription"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<sub:eventSubscription>
<sub:endPoint name="ALBPMEndpoint">
<sub:host>localhost</sub:host>
<sub:port>9000</sub:port>
<sub:uri>albpmServices/aler_
engine/ws/StatusChangeEndpointServiceListener</sub:uri>
<sub:targetNamespace>http://www.bea.com/infra/events</sub:targetNamespace>
<sub:operationName>newEvent</sub:operationName>
<sub:protocol>HTTP</sub:protocol>
<sub:authenticationData>
<sub:basicAuthentication>
<sub:username>aler_workflow_user</sub:username>
<sub:password>*****</sub:password>
</sub:basicAuthentication>
</sub:authenticationData>
</sub:endPoint>     <sub:notifierClass>com.bea.infra.event.notifier.plugin.http.DefaultHTTPEventNotifier</sub:notifierClass>
<sub:expression></sub:expression>
</sub:eventSubscription>
</sub:EventSubscriptionData>

3. JARファイルのクラスをバンドルし、<oer Webapp path>/WEB-INF/libディレクトリにコピーして、クラスパスで選択されるようにします。

4. イベント・マネージャを再起動し、アセット・エディタを使用してイベントをトリガーします。

5. 新しい通知サービス・プラグインのinit()およびhandle()メソッドが呼び出されます。

A.9.4 互換性のない契約を持つエンドポイントの開発

Oracle Enterprise Repositoryイベント・マネージャとの互換性のないインタフェースまたは契約を持つエンドポイントが存在する可能性があります。これは、エンドポイントの開発に使用されるツールにOracle Enterprise Repositoryイベント・マネージャで提供されるWSDLの使用制限があるか、他の相互運用性の問題が存在する可能性があるためです。そのような状況では、次のアプローチを使用できます。

- イベントXMLデータを受信するイベント通知サービス・プラグインを開発し、サブスクリプション・マネージャに登録します。

- リモートWebサービスが想定する形式にイベント・データを変換する、新しい通知サービス・プラグインのコードを記述します。

- リモート・エンドポイントでサポートされているAPIでリモートWebサービスを呼び出します。

A.9.5 OBPM 11gでのカスタム・ワークフローの作成

独自のカスタム・ワークフローを記述する場合は、OERのREX APIを使用できます。Jdeveloperのワークフロー・デザイナで、REX Webサービスを呼び出す場合は、次を使用します。

http://<host>:<port>/<oer web app name>/services/RexAPI

A.10 OERワークフローの操作

アセット・エディタを使用して、アセットを管理し、値リスト、カテゴリ、リレーションシップ、拒否理由、アーティファクト・ストアおよびベンダーなどのアセットに関連付けられたリソースを構成します。通常、アセット・エディタはWebコンソールから起動します。

登録プロセスを経るアセットは、図A-31に示すアセット・エディタ内のファイル・ツリーに表示されているように、複数のフォルダを介して編成および管理されます。

図A-31 アセット・エディタ - ファイル・ツリー

アセットの登録プロセスは、「発行済」フォルダの下にあるレビュー保留中フォルダから開始されます。アセットは、レジストラによって受け入れられるか拒否されると、「発行済」の下にあるレビュー中フォルダに移動します。

アセット・エディタのタブにあるデータについて、レジストラによるレビューと承認を待機中の場合、そのアセットは、レビュー中から「登録済」フォルダに移動します。「検索」機能を使用して発行済、未発行および登録済アセットにアクセスするか、My Stuffを使用することで、アセットの進捗状況を追跡できます。

登録プロセスには、次のアクションが含まれます。

発行

アセットがユーザーによって発行され、「発行済」の下のレビュー保留中フォルダに表示されます。発行キューに新しいアセットが入ったことを知らせる自動電子メール・メッセージがレジストラに送信されます。

レビュー

レジストラがアセットと関連情報を検証し、受け入れを決定します。これにより、アセットは作業キューに入ります。レジストラがアセットの拒否を選択する場合もあります。

拒否

- アセットを拒否する場合、レジストラは拒否の理由を入力します。

- 発行フォルダから拒否されたアセットは、アセット・エディタから削除され、発行者のMy Stuff内の「個人の発行」フォルダ内で拒否済としてマークされます。

受入れ

アセットが受け入れられたら、処理と承認のために1人以上のレジストラに割り当てることができます。レジストラは自分に割り当てられたアセットをMy Stuffから表示できます。登録のために受け入れられたアセットはレビュー中フォルダに移動し、レジストラまたは上級発行者が登録プロセスを開始します。必要な情報が収集され、アセット・エディタの適切なタブに入力されます。レジストラは、各タブを検証し、ワークフローをモニターします。ワークフローの特定のステージの情報が受入れ可能な場合、レジストラは該当するタブのデータを承認します。承認プロセスに規定の順序はありません。レジストラは任意の順序で任意のステージを承認できます。また、レジストラは、プロセスの任意のステージの情報を編集することもできます。

承認

レジストラは、様々なタブのそれぞれに入力された情報について、「管理」タブで組織の基準に基づいて最終的な承認を行います。任意のアセットに関するアセット・エディタのタブの特定の構成は、アセットが発行時に割り当てられるタイプ・テンプレートによって決まります。各タブには、アセットを記述、およびアセットの使用を容易にするために使用されるメタデータの様々な要素があります。

この項には次のトピックが含まれます:

- A.10.1項「自動ワークフローを使用した自動アセット登録」

- A.10.2項「発行の受入れ」

- A.10.3項「アセットの登録」

- A.10.4項「タブ承認プロセスの完了」

- A.10.5項「監査ログ、レビューおよびノート」

A.10.1 自動ワークフローを使用した自動アセット登録

Oracle Enterprise Repositoryには、登録プロセスの理解に定義されている、登録プロセスとガバナンス・プロセスを自動化しようとする、事前に構築されたBPMアセット登録フローがバンドルされています。使い勝手を向上させるために、事前定義されたOBPMエンドポイントを使用するか、独自のWebサービス・エンドポイントを作成してOracle Enterprise Repositoryイベントをサブスクライブすることができます。OBPMデザイナを使用して、新しいガバナンス・ワークフローを作成できます。また、トラブルシューティングおよびチューニングを目的としたイベント・モニタリング・ツールやロギング・ツールも用意されています。

自動ワークフロー機能の使用の詳細は、A.6項「自動ワークフローの構成」を参照してください。

A.10.2 発行の受入れ

この手順は、アセット・エディタで実行されます。(適切な権限が必要です。)

1. 「発行済」フォルダを開きます。

2. レビュー保留中を開きます。

3. 図A-32に示すように、登録するアセットを選択します。

図A-32 アセット・エディタ

4. オプション:

1. 「受入れ」をクリックします。アセットがツリー内の「レビュー中」フォルダに移動し、アセットの下にある各ワークフロー・フォルダにも表示されます。ワークフロー・フォルダは、アセット・エディタのタブに相当します。

2. 「受入れおよび割当て」をクリックします。図A-33に示すように、「ユーザーの割当て」ダイアログが表示されます。

図A-33 「ユーザーの割当て」ダイアログ

5. 「<<」および「>>」ボタンを使用して、「使用可能なユーザー」列と「選択したユーザー」列の間で項目を移動します。

6. 「OK」をクリックします。
アセットがツリー内のレビュー中フォルダに移動し、選択したユーザーに割り当てられます。このユーザーが、アセット・エディタの各タブに必要な情報を入力します。割り当てられたユーザーは、このアセットに割り当てられたことを通知する電子メールを受信することもできます。

A.10.3 アセットの登録

いくつかのタブはすべてのアセット・タイプに共通ですが、任意のアセットに関するアセット・エディタの特定のタブは、アセットが発行時に割り当てられるタイプ・テンプレートの構成によって決まります。

「概要」タブ

1. 「概要」タブをクリックします。図A-34に示すように、「概要」タブが表示されます。

図A-34 「概要」タブ

2. 各フィールドに適切な情報を入力します。

3. 図A-35に示すように、「承認」をクリックします。

図A-35 「概要」タブ - 「承認」ボタン

「概要」タブのテキストの色が変更され、「承認」ボタンは「非承認」に変わります。

注意:

アセット・エディタの「承認」ボタンは、適切な権限を持つユーザーにのみ表示されます。

分類タブ

1. 「分類」タブをクリックします。図A-36に示すように、分類タブが表示されます。

図A-36 分類タブ

いくつかのカテゴリが表示されます。

2. 「分類」セクションの「割当て」ボタンをクリックします。「分類の割当て」ダイアログが表示されます。

3. オプションを使用して、適切な分類を選択します。

- 承認済
プロジェクトでの使用がレジストラによって承認されています。

- 教育
学習または情報提供のみを目的とします。プロジェクトでの使用は承認されていません。

- 必須
アセットが提供する機能がプロジェクトに必要な場合に必ず使用します。(これは、顧客データへのアクセスや支払処理などを行うWebサービスに特に関係があります。)

- Raw
品質または完全性は保証されません。

- 推奨
承認済、少なくとも1つのプロジェクトでデプロイに成功しています。

4. 「OK」をクリックします。選択内容が「分類」セクションにリストされます。

注意:

使用環境を反映するように、デフォルトのカテゴリをカスタマイズできます。

5. 分類タブの各セクションについて、このプロセスを繰り返します。

6. 「キーワード」セクションのテキスト・ボックスに適切なキーワードを入力します。

7. 「追加」をクリックします。図A-37に示すように、この新しいキーワードが「キーワード」リストに表示されます。

図A-37 「キーワード」リスト

必要に応じて、他のキーワードを追加します。

8. 分類タブが完了したら、「承認」をクリックします。
「概要」タブのテキストの色が変更され、「承認」ボタンは「非承認」に変わります。

「ドキュメント」タブ

1. 「Documentation」タブをクリックします。図A-38に示すように、「ドキュメント」タブが表示されます。

図A-38 「ドキュメント」タブ

提案される多数のドキュメント・タイトルが「ドキュメント」ウィンドウにリストされます。これらの各タイトルに、適切なドキュメントを関連付けることができます。また、新しいドキュメントをリストに追加できます。

新しいドキュメントを追加するには、次の手順を実行します。

2. 「追加」をクリックします。図A-39に示すように、「編集」ダイアログが表示されます。

図A-39 「編集」ダイアログ

3. 「名前」テキスト・ボックスに適切な情報を入力します。

4. 「URL」テキスト・ボックスの横にある「編集」ボタンをクリックします。図A-40に示すように、「URLの編集」ダイアログが表示されます。

図A-40 「URLの編集」ダイアログ

5. 必要に応じて、アーティファクト・ストア・ファイルまたは「外部ファイル」を選択します。

6. 使用可能なテキスト・ボックスに必要な情報をすべて入力します。

7. 「OK」をクリックします。図A-41に示すように、この新しいドキュメントがリストに表示されます。

図A-41 「ドキュメント」タブ - NewDocument

8. 既存のドキュメントのファイル情報を編集するには、ドキュメントを選択し、「編集」をクリックして、手順4から7を繰り返します。

9. 終了したら、図A-42に示すように、「承認」をクリックします。

図A-42 「ドキュメント」タブ - 「承認」ボタン

「リレーションシップ」タブ

1. 「リレーションシップ」タブをクリックします。

2. 「追加」ボタンをクリックします。図A-43に示すように、「リレーションシップの追加」ダイアログが表示されます。

図A-43 「リレーションシップの追加」ダイアログ

3. 「検索」ボタンまたは「アクティブなすべてを表示」ボタンを使用して、ダイアログの「アセット」セクションにアセットを表示します。

4. リストからアセットを選択します。

5. 「リレーションシップ・タイプ」リストを使用して、2つのアセット間の適切なリレーションシップを選択します。

注意:

必要に応じて、リレーションシップの反転ボタンをクリックして、リレーションシップを逆にします。

6. 終了したら、「OK」をクリックします。

7. 必要に応じてこの手順を繰り返して、他のアセットのリレーションシップを追加します。

8. 終了したら、「承認」をクリックします。
リレーションシップの構成の詳細は、Oracle Enterprise Repository管理ガイドを参照してください。

「管理」タブ

Oracle Enterprise Repositoryのすべてのアセットに「管理」タブがあります。「管理」を使用して、次のことを行います。

- アセットの作成済、発行済、受入れ済のワークフローを追跡します。

- 他のタブの情報をレビューおよび承認するユーザーを割り当てます。

- アセットのステータスを変更します。

- アクティブ

- 非アクティブ

- リタイア

- 削除済

- アセットのノートとレビューを表示します。

- 図A-44に示すように、「登録」ボタンをクリックして登録プロセスを完了します。

図A-44 「管理」タブ

登録されたアセットに未承認のタブが含まれる場合があります。

タブが承認されると、必ずTabApprovedEventがトリガーされます。このイベントと、タブ名およびその他特定のメタデータが、ワークフローに送られ処理されます。このイベントは、多層ワークフローによって使用されます。この場合、承認されたタブと構成に応じて、承認プロセスの次の層を割り当てる必要があるかどうかがワークフローによって決定されます。

また、ユーザーは、TabApprovedEventイベントを、ChangeAssetLifecycleなどの事前定義済ワークフローにワイヤリングできます。そのため、これはタブ名にも関連付けられます。

A.10.4 タブ承認プロセスの完了

いくつかのタブはすべてのアセット・タイプに共通ですが、任意のアセットに関するアセット・エディタの特定のタブは、アセットが発行時に割り当てられるタイプ・テンプレートの構成によって決まります。同様に、タブに表示されるメタデータ要素も、タイプ構成によって決まります。特定のタブと要素はタイプによって異なる場合がありますが、どのタブの承認プロセスも、各要素の情報の入力たはレビュー(あるいはその両方)が必要です。タブの「承認」をクリックするたびに、変更の保存を確認するメッセージが表示されます。

特定のタイプの構成のタブを承認するプロセス

1. 「Oracle Enterprise Repository」画面で、My Stuffリンクをクリックします。My Stuffセクションが表示されます。

2. 割当済アセットを選択し、タブを承認するアセットを選択します。

3. ページの右下のペインの「編集」ボタンをクリックします。アセット・エディタ・ダイアログが表示されます。

4. 承認するタブを選択します。

5. そのタブの情報を確認します。

図A-45 アセット・エディタ・ウィンドウ

6. 「承認」ボタンをクリックします。変更の保存を促すプロンプトが表示されます。

7. 「オプションの選択」ダイアログの「OK」をクリックします。

8. 割当済アセット・ページに戻り、リフレッシュして変更内容を確認します。図A-46に示すように、タブ承認ステータス・ペインで、「承認」に1つの項目が表示されます。

図A-46 「承認」ステータス・ペイン

A.10.5 監査ログ、レビューおよびノート

アセットが更新されると、ユーザー、日付およびアクションのレコードが監査ログに表示されます。ログに記録される変更は、次のとおりです。

- アセットの作成

- アセットの更新

- アセットの登録ステータスの変更

- アセットのアクティブ・ステータスの変更

- 承認タブの完了

アセットの「管理」タブにある「ログ」セクションのリストにログ・エントリが追加されます。(「ログ」セクションの「リフレッシュ」ボタンのクリックが必要になる場合があります。)

注意:

カスタム・データ・フィールドに変更が加えられると、フィールドが変更されたことを示すログが作成されます。ただし、その変更の具体的な詳細は空です。

ノートのアセットへの追加

1. 「ファイル」メニューの「ノートの追加」をクリックします。図A-47に示すように、「...のノートの追加」ダイアログが表示されます。

図A-47 「...のノートの追加」ダイアログ

2. テキスト・ボックスに適切な情報を入力します。

3. 「OK」をクリックします。アセットの「管理」タブにある「ログ」セクションのリストにノートが追加されます。(「ログ」セクションの「リフレッシュ」ボタンのクリックが必要になる場合があります。)

A.11 自動ワークフローを使用する前に

この項では、Oracle Business Process Managementプロセス・エンジンと連携して動作するよう構成されてバンドルされたOracle Business Process Management Webサービス・エンドポイントを使用した拡張登録フロー機能の使用を素早く開始する方法について説明します。ただし、この機能は拡張性が高く、環境に合うように調整できます。

A.11.1 Oracle Enterprise Repositoryイベント・マネージャの構成の手順

イベント・マネージャはOracle Enterprise Repositoryに埋込みのコンポーネントであり、イベント・サブスクリプション、イベント永続性、イベントのフィルタ処理、およびイベント配信を管理します。Webサービス・エンドポイントはイベント・マネージャのサブスクリプション・マネージャをサブスクライブでき、Oracle Enterprise Repository内で生成されたイベントはWebサービス・エンドポイントに配信されます。

図A-48に、関連する様々なコンポーネントを示します。

図A-48 拡張登録フローのコンポーネント

イベント・マネージャは、デフォルトで有効になっているApache ActiveMQ JMSサーバーの組込みバージョンを使用します。組込みJMSサーバーは、追加構成なしで即時利用可能な状態で実行できるよう構成されています。ただし、Weblogic Server JMSやIBM MQSeriesなどのJavaベースの外部メッセージ・ブローカを使用するようにイベント・マネージャを構成することもできます。

イベント・マネージャの構成の詳細は、A.4項「Oracle Enterprise Repositoryイベント・マネージャの構成」を参照してください。

A.11.2 ユースケース

この項では、Oracle Enterprise Repositoryイベント・マネージャの構成のユースケースについて説明します。

- Oracle Enterprise Repositoryには、事前にバンドルされたOracle Business Process Managementフローと、デフォルトでイベント・マネージャのサブスクリプション・マネージャに登録されるWebサービス・エンドポイントが用意されています。トリガーされたすべてのイベントはこのOracle Business Process Managementエンドポイントに配信されます。エンドポイントでは、Oracle Enterprise Repositoryプロセス(アセット登録プロセス、メタデータ変更の追跡、事前に定義されたアクションの実行など)の自動化が試行されます。

- また、独自のWebサービス・エンドポイントを記述してイベント・マネージャでサブスクライブし、イベントを固有のビジネス上のニーズに対応させることもできます。

A.11.3 Oracle Business Process Managementプロセス・エンジンの構成および実行手順

Oracle Enterprise Repositoryのインストール時には、Oracle Business Process Managementのインストールと構成を求められます。この項では、Oracle Business Process Managementが正常にインストールされていることを前提としています。

イベント・マネージャでイベントを送信できるようになったら、Oracle Business Process Managementプロセス・エンジンを構成してイベントを処理できるようにする必要があります。Oracle Enterprise Repositoryをインストールすると、プロセス・エンジンをインストールして構成するためのオプションが使用可能になります。この項では、次の手順を実行する前にプロセス・エンジンが正常にインストールされていることを前提としています。

Oracle Business Process Management管理センターを起動するには、<OBPM Enterprise Home>\binディレクトリ内のobpmadmcenter.exeファイルをダブルクリックします。

A.11.3.1 ユースケース

Oracle Enterprise Repositoryには、プロセス・エンジンにデプロイされる、事前にバンドルされた自動ワークフローが用意されています。Oracle Enterprise Repository内でトリガーされたイベントは、プロセス・エンジンに配信され、Oracle Enterprise Repositoryプロセス(アセットの発行、受入れ、登録、その他の管理プロセスなど)の自動化を試行する自動ワークフローを実行します。

使用可能な自動ワークフローの詳細は、A.6項「自動ワークフローの構成」を参照してください。

A.11.3.2 発行イベントを処理するための自動ワークフローの構成

Oracle Business Process Managementプロセス・エンジンがインストールされたら、次の手順に従います。

1. ワークフロー構成の生成ツール(config_gen.bat)を使用して、ワークフロー構成ファイル(workflow.xml)を生成します。このツールにより、Oracle Enterprise Repositoryに接続し、カスタマイズ可能なブートストラップ・ファイルを作成します。workflow.xmlファイルの生成の詳細は、A.8.4項「ワークフローの構成」を参照してください。

2. ワークフロー構成ファイル(workflow.xml)を暗号化します。詳細は、第5章「ワークフロー構成ファイル」を参照してください。

3. 新しく生成されたworkflow.xmlファイルを<OBPM Enterprise Edition>/enterprise/server/aler_engineディレクトリにコピーします。

4. 任意のXMLエディタを使用してworkflow.xmlファイルを開きます。

5. Oracle Enterprise Repository接続情報(URIやレジストラのユーザー名およびパスワードなど)が次に示すように正しく構成されていることを確認します。

<alerconnection>
<uri>http://server01.amer.bea.com:7005/aler/services/FlashlineRegistry </uri>
<registrar>
<user>admin</user>
<password>*****</password>
</registrar>
</alerconnection>

URIには次の形式を使用する必要があります。

http://<host>:<port>/<oer web app name>/services/FlashlineRegistry

6. workflow.xmlファイル内で、次に示すように、アセット・タイプが「Service」であるassetTypeの設定を探します。

<assetType name="Service" community="_CHANGE_COMMUNITY_" id="154">
<allTabs>
<allTabs>
<tab name="Oveview"/>
<tab name="UDDI: Business Entity"/>
<tab name="Taxonomy"/>
<tab name="Architecture"/>
</allTabs>

7. 次に示すように、autoAccept属性を追加し、値をtrueに設定します。

<assetType name="Application" community="_CHANGE_COMMUNITY_" id="154"
autoAccept="true">
<allTabs>
<allTabs>
<tab name="Oveview"/>
<tab name="UDDI: Business Entity"/>
<tab name="Taxonomy"/>
<tab name="Architecture"/>
</allTabs>

これで、タイプが「Service」であるアセットを自動的に受け入れるようにOracle Business Process Managementプロセス・エンジンが構成されました。

8. Oracle Business Process Managementプロセス・エンジンが実行されている場合は、これを停止して再起動し、workflow.xmlの最新の変更をロードします。

9. ワークフロー構成のリフレッシュ・ツールを使用すると、Oracle Business Process Managementプロセス・エンジンを再起動せずにworkflow.xmlファイルをリフレッシュできます。workflow.xmlファイルのリフレッシュの詳細は、A.8.4.1項「ワークフロー構成ファイルのリフレッシュ」を参照してください。

A.11.4 アセット発行イベントのトリガー

Oracle Business Process Managementプロセス・エンジンを構成して実行したら、次の手順に従ってアセット発行イベントを処理します。

1. WebコンソールからOracle Enterprise Repositoryのアセット・エディタを起動します。
Oracle Enterprise Repositoryのアセット・エディタの使用の詳細は、『Oracle Fusion Middleware Oracle Enterprise Repositoryユーザーズ・ガイド』を参照してください。

2. 図A-31に示すように、「ファイル」→「新規」から新しいアセットを作成します。

注意:

アセット・タイプは「サービス」にする必要があります。

3. 「OK」をクリックし、アセットを発行します。

4. アセットが発行されたら、Oracle Business Process Managementログ・ビューアに切り替えて、イベントが処理されたことを確認します。ログ・ビューアを起動するには、<OBPM Enterprise Home>\binディレクトリ内のobpmlogviewer.exeファイルをダブルクリックします。

5. 図A-49に示すように、プロセス・アドミニストレータのプリファレンス設定を使用して、プロセス・エンジンの「ログ」ページで「デバッグ」レベルをオンにします。デフォルトでは、このレベルは「警告」に設定されています。

図A-49 Oracle Business Process Managementプロセス・アドミニストレータ - ロギング・プリファレンス

6. デバッグ・レベルをオンにすると、Oracle Enterprise Repository自動ワークフローに関する情報のみでなく、他のプロセス・エンジン情報も含む多くの情報が出力されることがわかります。Oracle Enterprise Repositoryのロギングをフィルタ処理するには、図A-50に示すように、次の手順に従います。

1. ログ・ビューアで、一番左側にあるリスト・ボックス内の「メッセージ」を選択します。

2. 横のリスト・ボックスで「次で始まる」を選択します。

3. テキスト・ボックスに「OER」と入力します。

4. 「フィルタの適用」ボタンをクリックします。

図A-50 Oracle Business Process Managementログ・ビューア

7. ログ・ビューアに「OER: アセットの受入れが完了しました」というメッセージが表示されたら、アセット・エディタに戻り、「表示」→「ツリーのリフレッシュ」コマンドを使用して「管理」タブをリフレッシュします。

8. 図A-51に示すように、「承認」セクションが最新のデータで更新されていることを確認します。

図A-51 Oracle Enterprise Repositoryのアセット・エディタ - 「管理」タブ

9. また、図A-52に示すように、「管理」タブの監査ログが更新されていることも確認します。

図A-52 Oracle Enterprise Repositoryのアセット・エディタ - 監査ログ

A.12 「コミュニティ・フロー」ユースケース

コミュニティ・フローは、自動割当てルールの構成を可能にすることによってアセットの受入れ、割当て、登録プロセスを自動化する方法を提供するとともに、様々な機関の間のフェデレーテッド・レジストラに関する概念を示します。すべてのコミュニティにわたって(システム・レジストラ通知を介して)多数のレジストラを送信するかわりに、システム・レジストラの数を1人または2、3人の個人に制限し、コミュニティの管理レジストラのかわりに自動受入れフローでアセットを受け入れるようにすることができます。コミュニティ・フロー機能により、コミュニティのためにアセット発行を承認する権限を持つ個人にアセット発行を分散できます。

たとえば、2つのコミュニティを追加し、各コミュニティについて2つの異なるレジストラを構成できます。次に、作成するプロジェクトまたはアセット・タイプに応じて、特定のアセットをコミュニティに関連付けることができます。コミュニティ・フローでは、レジストラによる手動受入れと同じ方法で、このようなアセットを自動的に受け入れます。

B その他の構成

この付録では、これまでに取り上げていないカスタマイズ・オプションおよび構成オプションについて説明します。

この付録の内容は以下のとおりです。

- B.1項「Oracle Enterprise Repositoryヘルプ・システムのカスタマイズ」

- B.2項「発行アップロード・ディレクトリの作成および構成」

- B.3項「アセット監査ログの作成」

- B.4項「プラグインおよびアダプタ」

- B.5項「Oracle Enterprise Repositoryデフォルト・アーティファクト・ストアの統合」

- B.6項「PDFへのエクスポート機能で使用されるXSLTテンプレートの管理」

- B.7項「UTF-8/Unicode文字のサポート」

- B.8項「アセット・タイプのインベントリ」

- B.9項「データ・ルール」

- B.10項「ハーベスタのプロパティ」

B.1 Oracle Enterprise Repositoryヘルプ・システムのカスタマイズ

Oracle Enterprise Repositoryの標準インストールでは、ヘルプ・リンクはOracleでホストされるヘルプ・ファイルを指します。ただし、状況によっては、ヘルプ・ファイルをローカルでホストするほうが適していることがあります。

この項には次のトピックが含まれます:

- B.1.1項「ヘルプ・ファイルのダウンロード」

- B.1.2項「カスタム・ヘルプURLプロパティの構成」

B.1.1 ヘルプ・ファイルのダウンロード

1. 圧縮されたOracle Enterprise Repositoryヘルプ・ファイルをダウンロードします。(ご使用のシステム用の正しいバージョンについては、Oracleサポートにお問い合せください。)

2. アプリケーション・サーバーまたはWebサーバー上のURLでのアクセスが可能な目的のディレクトリに、圧縮されたヘルプ・ファイルのコンテンツを展開します。

B.1.2 カスタム・ヘルプURLプロパティの構成

この手順は、Oracle Enterprise Repositoryの「管理」画面で実行します。

1. 左側のパネルで、「システム設定」を選択します。図B-1に示すように、「システム設定」セクションが表示されます。

図B-1 Oracle Enterprise Repositoryの「システム設定」セクション

2. 「システム設定」の「検索」テキスト・ボックスに、「cmee.tool.help.url」と入力します。図B-2に示すように、カスタム・ヘルプURLプロパティが表示されます。

図B-2 カスタム・ヘルプURLプロパティ

3. カスタム・ヘルプURLテキスト・ボックスに、ヘルプ・ファイルの適切なURLを入力します。このURLの適切なエンドポイントは、wwhelp.htmです。
最初のヘルプURLには、新たに作成されたファイルの場所が反映されている必要があります。次に例を示します。

http://host.domain.name:port/aler-web/help/wwhelp.htm

4. 「保存」をクリックします。

5. ブラウザをリフレッシュします。

6. Oracle Enterprise Repositoryのメニュー・バーで「ヘルプ」をクリックして、リンクが適切なURLを指していることを確認します。

B.2 発行アップロード・ディレクトリの作成および構成

発行アップロード・ディレクトリを作成および構成できます。

発行アップロード・ディレクトリの作成

アプリケーション・サーバーで、アセットの発行時にアップロードされるアセット・ファイルを含むディレクトリを作成します。

発行アップロード・ディレクトリ用の共有ディレクトリの設定

ご使用のオペレーティング・システムに適した方法を使用して、共有ディレクトリを作成します。

- Windowsの場合、これは通常UNC共有です。

- UNIX系の場合、アプリケーションによりディレクトリおよびファイルが使用可能になります(Samba、Apache、NFSなど)。

この項には次のトピックが含まれます:

- B.2.1項「アセット・アップロードのシステム設定」

- B.2.2項「アーティファクト・ストアの作成および構成」

- B.2.3項「新しいアーティファクト・ストアの選択」

B.2.1 アセット・アップロードのシステム設定

この手順は、Oracle Enterprise Repositoryの「管理」画面で実行します。

1. 左側のパネルで、「システム設定」を選択します。

2. 「サーバー設定」グループで、アップロード領域セクションを見つけます。

図B-3 アップロード領域セクション

3. 次の情報を参考にして、アップロード領域の設定を組織とその環境が反映されるように変更します。
発行アップロード・ディレクトリ

- cmee.server.paths.upload

- アセットの発行時にアップロードされるファイルを格納するために使用されるディレクトリを定義します。空白のままにすると、ファイルをアップロードできません。このディレクトリは、Oracle Enterprise Repository Webアプリケーション内に配置する必要があります。たとえば、<ORACLE_HOME>/user_projects/domains/<oerdomain>/autodeploy/<oer-app-name>/oer-app/custom/uploadとします。この場合、uploadはcustomディレクトリ内に作成されたディレクトリです。アップロード・ディレクトリがカスタム・ディレクトリの子である必要はありませんが、そうであることが推奨されます。このプロパティにより、次の機能が有効になります。

- 「アセットの発行」フォームの「添付ファイルの即時追加」オプションが有効になります。(発行プロセス中にアセットにファイルを添付する場合に必要です。)

- アセット・エディタのアップロードされた発行ファイル・オプションが有効になります。

レジストラ発行アップロード・パス

- cmee.server.paths.upload-registrar

- 発行アップロード・ディレクトリへの直接アクセスを可能にする、レジストラ参照用のディレクトリ・パス(通常はUNCパス)を定義します。アップロード・フォルダには、Windows共有が設定されている必要があります。たとえば、次のようになります。\\<machineName>\<sharename>\uploadアップロード・ディレクトリがUNCでない場合は、空白のままにします。

- アセット・エディタを使用したファイル参照が有効になります(オプション)。

- UNCでホストされる場合、パスにはWindows OS、SambaまたはSharityが必要です。

- アセット・エディタのアップロードされた発行ファイルにある「参照」ボタンの表示が有効になります。

発行アップロード用のアーティファクト・ストア

- cmee.server.paths.upload-repository

- 発行済ファイルへの直接パブリック・アクセスを可能にするために、構成済のアーティファクト・ストアを指定します。アセット・エディタでの発行済ファイルのワンステップ受入れに使用します。このプロパティを設定すると、次のようになります。

- 使用可能またはダウンロード可能なアセット・ファイルが表示されます。

- アセット・エディタのアップロードされた発行ファイル・セクションに、「Accept」ボタンが表示されます。

プロキシ・ダウンロード

Oracle Enterprise Repositoryには、Repositoryアプリケーション・サーバーをユーザーのリポジトリ・プロキシとして機能できるようにする追加のオプションがあります。この機能では、ファイルのダウンロード中にHTTP URLに指定されたユーザー名とパスワードのテキストが自動的に削除されます。この機能は、Oracle Enterprise Repositoryからアーティファクト・ストア内のリソースへのネットワーク接続が確立している場合にのみ、任意のアーティファクト・ストアに適用できます。詳細は、Oracle Enterprise Repositoryサポートにお問い合せください。

アーティファクト・ストア構成の例

次のいずれかのアーティファクト・ストアを構成する手順は、「アーティファクト・ストアの作成および構成」を参照してください。

- UNC

- ホスト名: unc.oer.com

- パス: upload/

- ユーザー名: user_oer

- パスワード: flash

- URL: file:////unc.oer.com/upload/

- HTTP

- ホスト名: http.oer.com

- パス: oer-web/upload

- ユーザー名: user_oer

- パスワード: flash

- URL: http://user_oer:flash@http.oer.com/oer-web/upload/

- FTP

- ホスト名: meta.oer.com

- パス: upload

- ユーザー名: user_oer

- パスワード: flash

- URL: ftp://user_oer:flash@meta.oer.com/upload/

- ClearCase

- ホスト名: clearcase.oer.com

- パス: ccaseweb/bin/ccweb

- ユーザー名: user_oer

- パスワード: flash

- URL: http://clearcase.oer.com/ccaseweb/bin/ccweb/?dir=/&elem=&cmd=view&user=user_oer&password=flash

- PVCS

- ホスト名: pvcs.oer.com

- パス: dav

- ユーザー名: user_oer

- パスワード: flash

- URL: http://user_oer:flash@pvcs.oer.com/dav/

- ローURI

- 名前: Example RAW URI

- ローURI: http://www.example.com/path1/path2?parameter1&parameter2

- URL: http://www.example.com/path1/path2?parameter1&parameter2

B.2.2 アーティファクト・ストアの作成および構成

アーティファクト・ストアは、Oracle Enterprise Repositoryのアセットに関連するファイルが格納される場所です。Oracle Enterprise Repositoryのホームページからアセット・エディタ・ウィンドウを起動します。

1. アセットの編集/管理をクリックします。図B-4に示すように、アセット・エディタが表示されます。

図B-4 アセット・エディタ

2. 「アクション」メニューで、アーティファクト・ストアの構成を選択します。図B-5に示すように、「アーティファクト・ストアの構成」ダイアログが表示されます。

図B-5 「アーティファクト・ストアの構成」ダイアログ

3. 「追加」をクリックします。図B-6に示すように、「新規アーティファクト・ストアの作成」ダイアログが表示されます。

図B-6 「新規アーティファクト・ストアの作成」ダイアログ

4. 「名前」テキスト・ボックスにアーティファクト・ストアの一意の名前を入力します。

5. 「タイプ」リストでアーティファクト・ストアのタイプを選択します(この例では、UNCを使用しています)。

6. 「ホスト名」ボックスにアプリケーション・サーバーのホスト名を入力します。

7. 「パス」テキスト・ボックスにパスの残りの部分を入力します。
ホスト名とパスが付いたファイル・リンクが「URL」テキスト・ボックスに表示されます。このリンクを切り取って、ファイル・エクスプローラまたはブラウザ・ウィンドウに貼り付け、ファイルを表示します。

8. 必要に応じて、「ユーザー名」ボックスと「パスワード」ボックスに適切な情報を入力します。

9. 「OK」をクリックします。

10. B.2.3項「新しいアーティファクト・ストアの選択」で説明されているように、発行アップロード用のアーティファクト・ストアのシステム設定を使用して、アーティファクト・ストアを有効にします。

B.2.3 新しいアーティファクト・ストアの選択

「アーティファクト・ストアの作成および構成」で説明されているようにアーティファクト・ストアを構成した後、Oracle Enterprise Repositoryの「管理」ページで発行アップロード用のアーティファクト・ストアのシステム設定を使用して、アーティファクト・ストアを選択します。

1. Oracle Enterprise Repositoryの「管理」ページを開きます。

2. 左側のパネルで、「システム設定」を選択します。

3. 図B-3に示すように、システム設定の「サーバー設定」グループでアップロード領域セクションを見つけます。

4. 送信アップロード用のアーティファクト・ストア・リストを使用して、新しく作成したアーティファクト・ストアを選択します。

5. 「保存」をクリックします。

B.3 アセット監査ログの作成

適切なシステム構成では、個別の保存済または変更済アセットのXMLメタデータをテキスト・ファイルにエクスポートして、監査証跡を作成できます。テキスト・ファイルはアプリケーション・サーバー上に作成され、アプリケーション内でレビューのために使用することはできません。この機能を有効化するために必要なプロパティについては、Oracleサポートにお問い合せください。

この手順は、Oracle Enterprise Repositoryの「管理」画面で実行します。

1. 左側のパネルで、「システム設定」を選択します。メイン・ペインに「システム設定」セクションが表示されます。

2. 「新しいシステム設定の有効化」テキスト・ボックスに、Oracle Enterprise Repositoryサポートにより指定されたプロパティを入力します。

3. 「有効化」ボタンをクリックします。メイン・ペインのプロパティのリストに、「アセットの保存/エクスポート・ファイル名」が表示されます。

4. 「アセットの保存/エクスポート・ファイル名」テキスト・ボックスに、アセット・ログを保存するファイルの名前を入力します。

5. 「保存」をクリックします。

B.4 プラグインおよびアダプタ

Oracle Enterprise Repositoryでは、次のプラグインおよびアダプタを使用できます。それぞれについて、インストレーション・ガイドと構成ガイドが用意されています。詳細は、Oracleサポートにお問い合せください。

- LDAPアダプタ

- SSOアダプタ

- Oracle Enterprise Platform for Eclipse (OEPE)を使用したRepositoryとEclipseの統合

- Visual Studio .NETプラグイン

- WSADアダプタ

- PVCS統合

- IBM Rational ClearQuest用コネクタ

- IBM Rational ClearCase用コネクタ

- Serena ChangeMan Dimensions用コネクタ

- プロジェクトの作成

- 進行中のアセット

- Apache Ant統合

- Harvest-HTTPリポジトリ統合

B.5 Oracle Enterprise Repositoryデフォルト・アーティファクト・ストアの統合

ご使用のシステムにいずれか1つのデフォルト・アーティファクト・ストアを統合すると、Oracle Enterprise Repositoryでアーティファクト・ストアを使用できます。通常、いずれか1つのデフォルト・タイプを使用してファイルにアクセスするために使用するURLは、次のようになります。

http://server.host.com:port/additionalPathStructure/fileName

アセットへのファイルの追加

この手順は、Oracle Enterprise Repositoryのアセット・エディタで実行します。

1. 「検索」またはその他の方法を使用して、ファイルを追加するアセットを見つけます。

2. 図B-7に示すように、「概要」タブの「ファイル情報」要素を見つけます。

図B-7 「ファイル情報」セクション

3. 「追加」ボタンをクリックします。図B-8に示すように、「編集」ダイアログが表示されます。

図B-8 「編集」ダイアログ

4. 「名前」および「説明」テキスト・ボックスに入力します。

5. 「編集」ボタン(「URL」フィールドの横)をクリックします。図B-9に示すように、「URLの編集」ダイアログが表示されます。

図B-9 「URLの編集」ダイアログ

6. オプションを使用して、追加するファイルのソースを選択します。
アーティファクト・ストア・ファイル

1. ホスト・リストから項目を選択します。(構成により、使用可能な選択項目が決定されます。)

2. 必要に応じて、次を行います。
「パス」テキスト・ボックスに適切なadditionalPathStructure/fileNameを入力、または

「参照」をクリックし、追加するファイルを指定します。

このオプションは、アーティファクト・ストア・タイプ、ClearQuest、ファイル・ストアおよびPVCSを使用している場合に使用できます。

外部ファイル

1. 「URL」テキスト・ボックスに、ファイルのURLを入力します。

2. 「テスト」をクリックして、URLが有効であることを確認します。

7. 必要に応じて、補足のテキスト・ファイルを作成してファイルに追加できます。

1. 「テキスト・ファイル」オプションを選択します。

2. 「タイプ」リストから、テキスト・ファイルのタイプを選択します。

3. 必要に応じて、「ファイル」テキスト・ボックスにテキストを入力します。

8. 終了したら、「OK」をクリックして、「URLの編集」ダイアログを閉じます。

9. 「OK」をクリックして、「編集」ダイアログを閉じます。追加したファイルが「ファイル情報」要素のリストに表示されます。

B.6 PDFへのエクスポート機能で使用されるXSLTテンプレートの管理

FOとは、ページで構成されるドキュメントを記述するXMLフォーマットです。Apache XML ProjectのFOPなどのFOプロセッサでは、FOを利用してPDF出力が生成されます。XMLドキュメントからのPDFドキュメントの作成は、2段階のプロセスです。

1. XSLT (XSL-FO)スタイルシートを使用して、XMLドキュメントがFOドキュメントに変換されます。

2. FOドキュメントが処理されて、PDF (または、処理するXSLTスタイルシートに定義されたその他の出力)が生成されます。

Oracle Enterprise RepositoryのXSLT出力機能はタイプ・レベルで適用されるため、対応するタイプのアセットの出力に必要なテンプレートは1つのみです。ただし、作成または特定のタイプに対して適用できるテンプレートの数または範囲に制限はありません。

注意:

アプリケーション・デプロイメントの適切なディレクトリの場所は、ご使用のアプリケーション・サーバーによって異なります。システム管理者に連絡して、適切なパス情報を入手してください。

B.6.1 Oracle Enterprise Repositoryで使用されるXSL:FOテンプレートの管理

この項では、Oracle Enterprise Repositoryとともに使用するためのXSL:FOテンプレートの管理方法について説明します。この節では、次のトピックについて説明します。

アセットXMLエクスポートからのXSLテンプレートの管理

前提条件:

- (前述の説明に従って) Oracle Enterprise RepositoryがXSLT出力用に構成されています。

- 後述のプロセスでは、Altova XML Spyを使用する必要があります。

1. 前述の説明に従って、XSLT出力機能を使用してOracle Enterprise Repositoryのインスタンスを構成します。

2. Oracle Enterprise Repositoryにログインします。

3. 「検索」またはその他の方法を使用して、XSLテンプレートを作成するタイプの登録済アセットを選択します。

注意:

適切にドキュメント化されたアセットを選択すると、XSL:FOテンプレートのプレビューが容易になります。

4. 次のサブディレクトリを含むローカル作業フォルダを作成します。

- xml

- schema

- xsl

- sps

5. XMLドキュメントを<oer_home>/reports/export directory <<HOW DID IT GET THERE?>>ディレクトリから新たに作成したxmlサブディレクトリに転送します。

6. Altova XML Spyを使用して、そのXMLドキュメントを開きます。

7. Altova XML Spyの「DTD/Schema」メニューから、「Generate DTD/Schema」を選択します。

8. 要求された場合は、生成するスキーマ・ファイルについて次のオプションを選択します。

- DTD/Schema file format: W3C Schema

- List of Values: Unlimited

- Attribute/Element type detection: Best possible

- Represent complex elements as: Complex types

- Elements that were used once: Make local definition

9. 「OK」をクリックして、スキーマを生成します。

10. 生成されたXSDファイルを、作業フォルダのschemaサブディレクトリに保存します。

11. 「Do you want to assign generated DTD/Schema to your XML document?」と表示された場合は、「No」を選択します。

12. Altova XML Spyを閉じます。前の手順で生成したXMLスキーマには、そのスキーマを処理する前に削除する必要のあるデータ要素値が含まれています。

13. テキスト・エディタの検索および置換機能を使用して、<xs:enumeration value=という式を含むすべての行を削除します。

14. スキーマ・ファイルへの変更を保存します。

15. テキスト・エディタを終了します。

16. Altova StyleVisionを使用して、変更したスキーマ・ファイルを開きます。

警告:

値フィールドに関連する要素を含むスキーマ・ファイルを開くと、StyleVisionのエラーが発生します。

17. StyleVisionを使用して、出力したドキュメントのレイアウトを変更します。
レイアウトの変更を表示するには、次の手順を実行します。

1. 「File」メニューの「Assign Working XML File...」を選択します。

2. エクスポートしたXMLドキュメントを選択します。
これにより、ライブ情報が移入されたXSL:FOテンプレートの出力のプレビューが生成されます。最も一般的なレイアウト方法は、Oracle Enterprise Repositoryのアセット詳細のレイアウトを厳密に模倣することです。

18. レイアウトが完了したら、StyleVisionで書式設定されたドキュメントをローカル作業フォルダのspsサブディレクトリに保存して、後から取得または変更できるようにします。

19. 「File」メニューを開きます。

20. 「Save Generated Files」を選択します。

21. 「Save Generated XSL:FO File...」を選択します。

22. XSLドキュメントをローカル作業フォルダのxslサブディレクトリに保存します。
XSLドキュメントが関連付けられているタイプに対して適切なファイル名を使用します。

23. 生成されたXSLファイルを、(前述のcmee.asset.xml.paths.xsl-sourceプロパティに指定されているように)<oer_home>/reports/xslフォルダにコピーします。

24. Oracle Enterprise Repositoryで、元のXMLスキーマを生成するためにエクスポートしたアセットを選択します。

25. アセット詳細で「印刷」ボタンをクリックして、そのアセットのXMLスキーマをエクスポートします。ダイアログが表示されます。

26. ダイアログのプロンプトに従って、PDFドキュメントを生成するために使用される、新たに作成したXSL:FOテンプレートを選択します。ジェネレータでPDFドキュメントが生成されます。

27. ドキュメントの表示ボタンをクリックして、PDFドキュメントを開きます。

28. PDFドキュメントと、StyleVisionで作成したテンプレートのデザインを比較します。

29. 必要に応じて変更を加えます。

B.7 UTF-8/Unicode文字のサポート

PDFへのエクスポート機能では、FOPエンジンでArialUnicode、またはUnicodeを表示できる類似したフォントを使用しないかぎり、UTF-8/Unicode文字を適切に処理できません。

Unicode文字をレンダリングするための構成

1. 適切なTrueTypeフォント(TTF)ファイルを見つけます。

2. 次のコマンドを実行して、そのファイルのXML定義を作成します。
java -cp fop.jar org.apache.fop.fonts.apps.TTFReader {TTF_FILE_LOCATION} {FONT_NAME}.xml

注意:

コマンドで、次を行います。

- TTF_FILE_LOCATIONをTTFファイルの場所に置き換えます。

- FONT_NAMEをフォント名に置き換えます。

3. userconfig.xmlという名前の構成ファイルを作成します。このファイルにより、選択したフォントを使用するようにFOPが構成されます。詳細は、http://www.sagehill.net/docbookxsl/AddFont.htmlを参照してください。

4. userconfig.xmlファイルをクラスパスに配置します。WEB-INFの下にあるclassesディレクトリをお薦めします。

5. 適切な場合に常に新しいフォントを使用するように、XSLTを構成します。
このためには、通常、フォント・ファミリ"{FONT_NAME}"=を適切なfo:block要素に追加する必要があります。

userconfig.xmlファイルがクラスパス上にない場合、PDFへのエクスポート・プロセスでは、Unicode文字がシャープ記号(#)に置換されます。

マルチバイト文字セットとシングル・バイト文字セットの両方で機能するサンプルXSLT

- Application.xsl

- Business Process.xsl

- Communication Adapter.xsl

- Component.xsl

- Environment.xsl

- Framework.xsl

- Pattern.xsl

- Process.xsl

- Project Profile.xsl

- Service.xsl

- XML Schema.xsl

シングル・バイト文字セットのみで機能するサンプルXSLT

- Artifact_ DTD.xsl

- Artifact_ MFL.xsl

- Artifact_ WS-Policy.xsl

- Artifact_ WSDL.xsl

- Artifact_ XQuery.xsl

- Artifact_ XSD.xsl

- Artifact_ XSLT.xsl

- Assembly Model.xsl

- Binding.xsl

- Binding_ File Source.xsl

- Binding_ JMS.xsl

- Binding_ Relational Database.xsl

- Binding_ SB-Custom.xsl

- Binding_ SB-DSP.xsl

- Binding_ SB-EJB.xsl

- Binding_ SB-Email.xsl

- Binding_ SB-File.xsl

- Binding_ SB-FTP.xsl

- Binding_ SB-HTTP.xsl

- Binding_ SB-JMS.xsl

- Binding_ SB-Local.xsl

- Binding_ SB-MQNative.xsl

- Binding_ SB-Oracle.xsl

- Binding_ SB-PeopleSoft.xsl

- Binding_ SB-SAP.xsl

- Binding_ SB-SB.xsl

- Binding_ SB-SFTP.xsl

- Binding_ SB-Siebel.xsl

- Binding_ SB-Tuxedo.xsl

- Binding_ SB-WLI.xsl

- Binding_ Web Service.xsl

- Component_ Data Service.xsl

- Component_ DSP Web Service Mapper.xsl

- Component_ Java.xsl

- Component_ SB Proxy Service.xsl

- Component_ SCA Composite.xsl

- EA - Sample Asset Type.xsl

- EA - Waiver.xsl

- Endpoint.xsl

- Interface.xsl

- Interface_ Data Service.xsl

- Interface_ Java.xsl

- Interface_ Messaging.xsl

- Interface_ Web Service.xsl

- Procedure.xsl

- SCA Composite.xsl

- SCA Reference.xsl

- SCA Service.xsl

- SOA - Business Entity.xsl

- Training.xsl

B.8 アセット・タイプのインベントリ

この項では、ベース・データ・パックとハーベスタ・ソリューション・パックのアセット・タイプのインベントリについて説明します。

B.8.1 ベース・データ・パック

ベース・データ・パックは、Oracle Enterprise Repositoryの新規インストール時に一緒にインストールされる、Oracle Enterprise Repositoryデータのセットです。このデータ・パックは、Oracle Enterprise Repositoryの新しいインスタンスごとに最初に必要になります。

名前

UUID

説明

アプリケーション

af788182-4c10-11dc-ac31-7de68f5ca4a1

アーティファクト: DTD

af693f35-4c10-11dc-ac31-7de68f5ca4a1

アーティファクト: WSDL

dcb567bc-2428-11dc-8a61-b94a9aa7eb2f

WSDLアーティファクトを含むエンティティを表します。

アーティファクト: WS-Policy

dccb87e1-2428-11dc-8a61-b94a9aa7eb2f

WS-Policyアーティファクトを含むエンティティを表します。

アーティファクト: XSD

dcca7670-2428-11dc-8a61-b94a9aa7eb2f

バインディング

af6ff5fb-4c10-11dc-ac31-7de68f5ca4a1

ビジネス・プロセス

af7218dd-4c10-11dc-ac31-7de68f5ca4a1

通信アダプタ

af6dd319-4c10-11dc-ac31-7de68f5ca4a1

コンポーネント

af7c5215-4c10-11dc-ac31-7de68f5ca4a1

エンドポイント

af7b40a4-4c10-11dc-ac31-7de68f5ca4a1

環境

af763790-4c10-11dc-ac31-7de68f5ca4a1

フレームワーク

af6806b4-4c10-11dc-ac31-7de68f5ca4a1

インタフェース

af74d7ff-4c10-11dc-ac31-7de68f5ca4a1

パターン

af774901-4c10-11dc-ac31-7de68f5ca4a1

プロシージャ

af71076c-4c10-11dc-ac31-7de68f5ca4a1

サービス

af6ee48a-4c10-11dc-ac31-7de68f5ca4a1

インタフェースの実装である具体的なサービスを表します。

SOA - ビジネス・エンティティ

af73c68e-4c10-11dc-ac31-7de68f5ca4a1

トレーニング

af7a0823-4c10-11dc-ac31-7de68f5ca4a1

B.8.2 ハーベスタ・ソリューション・パック

ハーベスタは、Oracle Enterprise Repository 11gインストールにバンドルされている11.1.1.x.x-OER-Harvester-Solution-Pack.zipに含まれています。

名前

UUID

説明

アダプタ

a22d8c30-d767-11dd-bee0-79d657a0a2b0

エンタープライズ・アプリケーションへのアクセスを提供する、具体的なアダプタを表します。

アダプタ構成

a30bde41-d767-11dd-bee0-79d657a0a2b0

サービスをアダプタに接続する構成情報を表します。

アーティファクト: XQuery

908940d3-23e1-11dc-a7fd-f9d708c0d3f4

XQueryアーティファクトを含むエンティティを表します。

アーティファクト: XSD

dcca7670-2428-11dc-8a61-b94a9aa7eb2f

XSDアーティファクトを含むエンティティを表します。

アーティファクト: XSLT

907347be-23e1-11dc-a7fd-f9d708c0d3f4

XSLTアーティファクトを含むエンティティを表します。

アーティファクト: Biz

ed1ed534-39b8-11de-bee0-79d657a0a2b0

Bizアーティファクトを含むエンティティを表します。

アーティファクト: BPEL

4000545f-73ae-11dd-833d-572100858305

BPELアーティファクトを含むエンティティを表します。

アーティファクト: ComponentType

b68aed1b-4705-11de-bee0-79d657a0a2b0

アーティファクト: Composite

01299694-3680-11de-bee0-79d657a0a2b0

コンポジットを定義するcomposite.xmlファイル

アーティファクト: Decs

1225bb95-3680-11de-bee0-79d657a0a2b0

アーティファクト: EDL

b20c5569-3680-11de-bee0-79d657a0a2b0

イベントを定義する.edlファイル

アーティファクト: FaultPolicies

c531c4c9-88fd-11de-bc41-3f5f390f1c4f

アーティファクト: Flow

6cb09bd6-39b9-11de-bee0-79d657a0a2b0

アーティファクト: Jar

87e299ac-9988-11de-bc41-3f5f390f1c4f

アーティファクト: Java

95e94c6d-9988-11de-bc41-3f5f390f1c4f

アーティファクト: JCA

d3a652ca-3680-11de-bee0-79d657a0a2b0

アーティファクト: MFL

90767c11-23e1-11dc-a7fd-f9d708c0d3f4

MFLアーティファクトを含むエンティティを表します。

アーティファクト: MPlan

955e06e3-367e-11de-bee0-79d657a0a2b0

メディエータを定義する.mplanファイル

アーティファクト: Proxy

132bbd15-39b9-11de-bee0-79d657a0a2b0

アーティファクト: Rules

4eda8116-3680-11de-bee0-79d657a0a2b0

ルール・ディクショナリを定義する.rulesファイル

アーティファクト: SpringBeans

b443f7a8-88fd-11de-bc41-3f5f390f1c4f

アーティファクト: Task

898dd147-3680-11de-bee0-79d657a0a2b0

ヒューマン・タスク(ワークフロー)を定義する.taskファイル

アーティファクト: Toplink

6c09ffcb-9988-11de-bc41-3f5f390f1c4f

アーティファクト: WSDL

dcb567bc-2428-11dc-8a61-b94a9aa7eb2f

WSDLアーティファクトを含むエンティティを表します。

アーティファクト: WS-Policy

dccb87e1-2428-11dc-8a61-b94a9aa7eb2f

WS-Policyアーティファクトを含むエンティティを表します。

ビジネス・プロセス: BPEL

d9f3ac95-73ab-11dd-833d-572100858305

上位レベルのビジネス・プロセスを表します。

ビジネス・ルール

80f3cb02-3683-11de-bee0-79d657a0a2b0

Oracle Rulesからのビジネス・ルール(デシジョン・サービス)定義

コンポジット

feb0203b-3681-11de-bee0-79d657a0a2b0

SCAコンポジット

コンポジット・デプロイメント

daad43be-3682-11de-bee0-79d657a0a2b0

デプロイされたSCAコンポジット

コンポジット・デプロイメント参照

ee9eb3ef-3682-11de-bee0-79d657a0a2b0

デプロイされたコンポジットで必要とされる参照

コンポジット・デプロイメント・サービス

14b97e80-3683-11de-bee0-79d657a0a2b0

デプロイされたコンポジットにより提供されるサービス

コンポジット参照

cad63dcd-3682-11de-bee0-79d657a0a2b0

コンポジットで必要とされる参照

コンポジット・サービス

bdb3d08c-3682-11de-bee0-79d657a0a2b0

コンポジットにより提供されるサービス

デプロイメント: BPEL

11683a9e-73ae-11dd-833d-572100858305

ビジネス・プロセスのデプロイされたインスタンスを表します。

エンドポイント

af7b40a4-4c10-11dc-ac31-7de68f5ca4a1

エンタープライズ・アプリケーション

a381aa82-d767-11dd-bee0-79d657a0a2b0

上位レベルのエンタープライズ・アプリケーションを表します。

エンタープライズ・アプリケーション・デプロイメント

a4007773-d767-11dd-bee0-79d657a0a2b0

エンタープライズ・アプリケーションのデプロイメントを表します。

フォルト・ポリシー

d240f82a-88fd-11de-bc41-3f5f390f1c4f

ヒューマン・タスク

5750eb21-3683-11de-bee0-79d657a0a2b0

Oracle Workflowからのヒューマン・タスク定義

インタフェース

af74d7ff-4c10-11dc-ac31-7de68f5ca4a1

サービス

af6ee48a-4c10-11dc-ac31-7de68f5ca4a1

インタフェースの実装である具体的なサービスを表します。

Springコンテキスト

a2698097-88fd-11de-bc41-3f5f390f1c4f

B.9 データ・ルール

この項には次のトピックが含まれます:

- B.9.1項「アセット・タイプ要素のフラグ」

- B.9.2項「過去に収集されたデータ」

- B.9.3項「要素の格納」

- B.9.4項「アセット・タイプに必須となる要素」

- B.9.5項「機能に関連付けられた要素」

B.9.1 アセット・タイプ要素のフラグ

アセット・タイプに追加できる要素の多くには、Oracle Enterprise Repositoryの機能を拡張するための1組のフラグがあります。これらのフラグは、要素の追加または編集時にタイプ・マネージャで切り替えられます。

必須フラグ - これらは、アセット・エディタでアセットを保存するために移入される要素です。このフラグは、オープンAPIを介した保存を制限しません。

索引付きフラグ - これらは、アセットの拡張検索で使用可能な要素です。これは、カスタム・データに格納されているアセットに最も有効です。

B.9.2 過去に収集されたデータ

Oracle Enterprise Repositoryには、リポジトリ内のタイプ、およびこれらのタイプのアセットに対する将来の操作には影響を与えるものの、すでにアセットに関連付けられているメタデータには影響を与えない操作がいくつかあります。

- アセット・タイプから削除された要素
アセット・タイプから要素が削除された場合、その要素に指定された値を持つアセットは、データベースにそれらの値を保持し、そのアセットのその後の保存でもそれらの値を保持し続けます。値は、UIには表示されなくなりますが、その要素をそのアセット・タイプに再び追加した場合には、API操作、カスタム・レポートおよびリストアで使用できます。

- 受入れ可能な値リストによって制限される要素のデータ値
受入れ可能な値リストは、1つのリストまたは複数選択リストを持つアセットに値が割り当てられるときに有効な値を指定します。Oracle Enterprise Repositoryでは、すでに要素に割り当てられている値も有効な値とみなされます。リストが変更された場合、そのリストの値を使用しているアセットは、それ以降は保存されません。

値リストの変更を、その値を使用しているアセットに伝播するために、OpenAPIプログラムを使用できます。このプログラムにより、削除された値を使用しているアセットを返す、要素と値のペアが検索されます。その後、これらの値が有効な値に変更され、アセットが保存されます。

たとえば、信号機の値リストに値「赤」、「黄」、「青」が含まれているとします。すべての新しいアセットは、信号機リストの移入時に値「赤」、「黄」、「青」を使用できます。

「左折」という値を持つ既存のアセットがあります。この値は過去のある時点では有効でしたが、現在は信号機値リストに含まれていません。この既存のアセットでは、信号機リストの有効な値は「赤」、「黄」、「青」、「左折」です。

B.9.3 要素の格納

Oracle Enterprise Repositoryのアセット・メタデータは、4つの異なるグループのいずれかに属する要素に格納されます。これらの各グループは、異なる方法で永続化され、機能します。4つのグループは、次のとおりです。

- 必須データ
これらは、アセット・タイプに含まれている必要のある要素です。

必須データ要素は、真にリレーショナルな方式でデータベースに永続化され、データを含む列があり、アセットID外部キーによってアクセスできます。すべての必須データ要素には、mandatory-data/で始まるXMLマッピングがあります。

- カスタム・データ
これらは、カスタマイズと削除に適した要素です。タイプ・マネージャで新たに作成された要素は、このセクションに表示されます。カスタム・データ要素は、データベースにCLOBとして格納される、XMLの単一ブロックに保持されます。すべてのカスタム・データ要素には、custom-data/で始まるXMLマッピングがあります。

- 管理データ
これらは、アセット・エディタの「管理」タブに表示される要素です。これらの要素は、カスタマイズできません。これらの要素は、登録ワークフローとステータスおよびカスタム・アクセス設定に使用されます。

管理データ要素は、真にリレーショナルな方式でデータベースに永続化され、データを含む列があり、アセットID外部キーによってアクセスできます。このデータは、たとえばAssetRegister()など、アセットでアクションを開始することによって変更されます。

- カスタム・メタデータ・フレームワーク(CMF)メタデータ
このフレームワークによって保持されるメタデータは、システム提供のものとみなされ、Oracle Enterprise Repository UIによって変更されないように保護されます。このフレームワークは主に統合で使用され、これらの統合は、メタデータの特定の構造を利用し、多くの場合、XMLスキーマに関連付けられています。CMFメタデータ要素はブロックにBLOBとして保持され、これはCMFエントリ・タイプに相当します。通常、これらのブロックはXMLです。

B.9.4 アセット・タイプに必須となる要素

いずれのアセット・タイプからも削除できない要素がいくつかあります。

- 名前
この要素は、アセットの名前です。名前とバージョンのペアは、Oracle Enterprise Repositoryで一意である必要があります。これは128文字に制限されます。接頭辞name:を使用すると、検索をこの要素のみに制限できます。アセット詳細では、名前はアセット・ヘッダーの一部です。

- バージョン
この要素は、アセットのバージョンです。名前とバージョンのペアは、Oracle Enterprise Repositoryで一意である必要があります。これは128文字に制限されます。アセット詳細では、バージョンはアセット・ヘッダーの一部です。

- 説明
この要素は、アセットの説明です。この要素にはHTMLが含まれている場合があり、アセットのロード時にブラウザでHTMLとして処理されます。これは4000文字に制限されます。接頭辞description:またはdesc:を使用すると、検索をこの要素のみに制限できます。

- 通知電子メール
この要素は、アセットが使用されたときに通知を受け取る電子メール・アドレスです。この電子メール・アドレスは、カンマまたはその他の区切り文字を含まない単一アドレスです。複数の受信者が通知を受け取る必要がある場合は、この電子メール・アドレスは、電子メール・システムおよびOracle Enterprise Repository外で設定されたグループである必要があります。

- キーワード
この要素には、アセットのキーワードが含まれています。これらは、入力された検索文字列を使用したすべての検索に含まれます。

- ファイル情報
この要素には、アセットのダウンロード済ファイルのURIが含まれています。この要素は、アセット詳細に表示されません。

- アップロードされた発行ファイル
この要素には、Oracle Enterprise Repositoryにアップロード済で、まだ「ファイル情報」に受け入れられていないファイルのリストが含まれています。この要素は、アセット詳細に表示されません。

B.9.5 機能に関連付けられた要素

- ポリシー: ポリシー機能では、2つの要素、1つのリレーションシップ・タイプ、および2つのシステム設定が必要です。タイプ・マネージャでは、「ポリシー」アーキタイプが使用されます。

- ポリシー(アーキタイプ「ポリシー・タイプ」のインスタンス)では、ポリシー・アサーションのリストをホストするためにプラグインが必要です。このプラグインは、ポリシー・アサーション(PolicyAssertionPlugin)です。

- アセット(アーキタイプ「アセット・タイプ」のインスタンス)では、ポリシーによる管理のために、双方向で決められた順序のリレーションシップが必要です。デフォルトのリレーションシップ・タイプは、適用先ポリシーです。

- 管理対象アセットにポリシーをリンクするリレーションシップ・タイプは、cmee.asset-policy.relationshipのシステム設定で指定されます。

- 管理対象アセットには、各ポリシー・アサーションでTrue/Falseのレスポンスを可能にするために、プラグインが必要です。このプラグインは、適用対象アセット・ポリシー(AppliedAssetPolicyPlugin)です。

- アセット・ポリシーの有効化のシステム設定(cmee.asset-policy.enable)により、「ポリシー・タイプ」アーキタイプ、ポリシー・アサーション、および適用対象アセット・ポリシーを使用できます。

- コンプライアンス・テンプレート: この機能では、3つのリレーションシップと1つのシステム設定が必要です。タイプ・マネージャでは、コンプライアンス・テンプレート・アーキタイプが使用されます。

- コンプライアンス・テンプレートでは、使用するアセットを規定するためのリレーションシップが必要です。必要なリレーションシップ名のリストは、次のとおりです。

- Assets-to-be-Used [アセットを規定するもの/規定のアセット]

- Required-Environments [環境を規定するもの/規定される環境]

- Processes-to-be-Followed [プロセスを規定するもの/規定されるプロセス]

- コンプライアンス・テンプレートの有効化のシステム設定(cmee.compliance-template.enable)により、コンプライアンス・テンプレート・アーキタイプを使用できるようになります。

- プロジェクトの作成: プロジェクトの作成機能では、1つの要素と1つのシステム設定が必要です。

- プロジェクトの作成機能には、プロジェクトの作成に関連するプロジェクトのリストにアセットをマップするためのプラグインが必要です。このプラグインは、プロジェクトの作成(ProducingProjectsPlugin)です。

- プロジェクトの作成(cmee.project.producing.enabled)のシステム設定により、プロジェクトの作成を使用できるようになります。

- 一意の要素: 一意の要素では、1つの要素と2つのシステム設定が必要です。

- 一意の要素には、一意の値を保持するためのプラグインが必要です。このプラグインは、一意の要素(UniqueElementPlugin)です。

- カスタム一意要素の有効化のシステム設定(cmee.unique-element.enable)により、一意の要素を使用できるようになります。

- タイプごとの一意の要素のシステム設定(cmee.unique-element.per-assettype)により、一意の要素がシステム全体に適用されるか、または個別のタイプ内に適用されるかが決定されます。

- 予測節約正味時間(PNHS): PNHSは、ほとんどのレポートの実行に影響します。これには1つの要素が必要です。

- PNHSでは、保存された時間数を保持するために数値テキスト・フィールドが必要です。これは正の数である必要があります。数値テキスト・フィールドには、custom-data/development-hoursのXMLマッピングが必要です。

- この要素をアセット・タイプに追加する必要がある場合、XMLマッピングを適切に作成するために、開発時間という名前の数値テキスト・フィールドを作成します。次に、その要素を編集して、適切なラベルを付けるために名前を予測節約正味時間に変更します。要素を追加または編集する際には、引用符は使用しないでください。

- 合計開発時間(TDH): この要素は、いくつかのレポートの実行に影響します。これには1つの要素が必要です。

- 合計開発時間(TDH)では、節約された時間数を保持するために数値テキスト・フィールドが必要です。これは正の数である必要があります。数値テキスト・フィールドには、custom-data/total-development-hours--tdh-のXMLマッピングが必要です。

- この要素をアセット・タイプに追加する必要がある場合、合計開発時間(TDH)という名前の数値テキスト・フィールドを作成します。要素を追加または編集する際には、引用符は使用しないでください。

- 収集: ハーベスタ・ツールは、多数の製品(Oracle SOA Suite、Oracle Service Bus、Oracle Enterprise Manager、Oracle BPEL PM, UDDI Registriesなど)との統合を可能にします。収集を可能にするには、ハーベスタ・ソリューション・パックをインポートして、ソリューション・パックに含まれているすべてのアセット・タイプが存在し、アクティブである必要があります。ハーベスタは、アセットのmandatory-data、custom-dataおよびCMF metadataセクションの組合せにメタデータを書き込みます。

- 収集で利用されるフィールドは、次のとおりです。

- 名前: アセット名は、収集された複数の属性を連結したものです。
抽象エンティティの場合、「名前」はinternalNameとなり、これはnamespace、shortName、discriminatorの組合せです。

アーティファクト・エンティティの場合、「名前」はnamespaceとpathの組合せになります。タイプ・エンティティの場合、「名前」はinternalNameとなり、これはエンティティのtypeとshortNameの組合せです。

- バージョン: アセットのバージョンで、ハーベスタによりデフォルトで(1.0)に設定されます。

- ファイル情報: アセットのファイル情報には、アセットの使用およびダウンロード操作で使用可能なファイルのリストが含まれています。アーティファクト・エンティティの場合、「ファイル情報」は、ファイルのURIまたはファイルのコンテンツが含まれるように構成されます。パラメータpathには、URIが含まれます。

- harvesterProperties: 収集操作によるメタデータでは、internal.introspector.storeという名前のCMFメタデータ・エントリにそのデータが配置されます。メタデータは、イントロスペクション標準属性ビューアという名前のビューア内で、アセット詳細に公開されます。internal.introspector.store内に含まれると予想されるプロパティは、収集ソースとOracle Enterprise Repositoryのアセット・タイプによって異なります。ハーベスタのプロパティの詳細は、B.10項「ハーベスタのプロパティ」を参照してください。

Oracle Enterprise Repositoryとの様々な統合で使用されるアセット・タイプのフィールドは、次のとおりです。

フィールド

コアOER

XU

OSBハーベスタ

SOA Suiteハーベスタ

ローWSDLハーベスタ

AIAハーベスタ

EMハーベスタ

Ovationハーベスタ

名前

はい

はい

はい

はい

はい

はい

はい

はい

バージョン

はい

はい

はい

はい

はい

はい

はい

はい

説明

はい

はい

はい

はい

はい

はい

はい

はい

ファイル情報

はい

harvesterProperties

はい

はい

はい

はい

はい

はい

はい

UDDIサービス・キー

はい

はい

UDDIレジストリ

はい

B.9.6 アセット・タイプ・カタログの説明

アセット・タイプ・カタログには、ベース・データ・パックとハーベスタ・ソリューション・パックに用意されているアセット・タイプがリストされます。これは、Asset Type Catalog.xlsという名前のExcelスプレッドシート内に含まれています。各アセット・タイプは、そのタイプにあるすべての要素のリストとともに含まれています。各要素について、次のような情報がリストされます。

- アセット・タイプ: 要素が存在するアセット・タイプ。

- ソース: 要素とアセット・タイプが含まれているソリューション・パックまたはデータ・パック。

- タブ: 要素を表示できる「エディタ」タブ。このタブ内では、要素は順序付けられていません。

- 要素: アセット・エディタに表示される、要素の名前。

- タイプ: タイプ・マネージャで新しい要素を追加するときにリストされるデータ型を使用した、要素のデータ型。

- XMLマッピング: assetRead()操作によって生成されたXMLに表示される、データのXPath。

- プロパティ: 文字列の最大長、数値のスケール、精度および範囲、リストに指定された値リストの名前など、要素のデータ型に関連するプロパティのリスト。

- 値リスト: 受入れ可能な値リストで指定された値のみに制限される要素の場合、許容範囲内の値が表示されます。Oracle Enterprise Repositoryでは、値に制約のある要素に対して過去に収集されたデータを保持できます。

- 必須: 要素の「必須」フラグの値。

- 索引付き: 要素の「索引付き」フラグの値。

- ノート: Oracle Enterprise Repositoryの顧客が要素の使用に関して独自のノートを追加できる列。

B.10 ハーベスタのプロパティ

プロパティ名

適用されるアセット・タイプ

説明

収集日付

すべて

アセットがOracle Enterprise Repositoryに収集された日付

収集者

すべて

収集を実行したOracle Enterprise Repositoryユーザー

ハーベスタの説明

すべて

ハーベスタの実行中に設定されたオプションの説明

ハーベスタ・バージョン

すべて

使用されたハーベスタのバージョン

ネームスペース

すべての非アーティファクト・タイプ

ハーベスタの実行中に設定された、プロジェクトのネームスペース

製品名

すべて

アーティファクトが収集された製品

製品バージョン

すべて

アーティファクトが収集された製品のバージョン

内部名

すべての非アーティファクト・タイプ

重複を検出するためにハーベスタで使用される、アセットの一意の内部名

(各種)

ビジネス・プロセス: BPEL、デプロイメント: BPEL、サービス(タイプ=メディエータ)、ヒューマン・タスク、ビジネス・ルール、Springコンテキスト

composite.xmlから読み込まれるSCAコンポーネントのプロパティ

(各種)

コンポジット、コンポジット・デプロイメント

composite.xmlから読み込まれるSCAコンポジットのプロパティ

(各種)

アダプタ構成

アダプタ構成を定義したWSDLまたは.JCAファイルから読み込まれる、アダプタ構成のJCAプロパティ

バインド・タイプ

エンドポイント、コンポジット・デプロイメント・サービス、コンポジット・デプロイメント参照

エンドポイントによって使用されるバインドのタイプ

デプロイメントURL

エンドポイント、デプロイメント: BPEL、コンポジット・デプロイメント、コンポジット・デプロイメント・サービス、コンポジット・デプロイメント参照

プロジェクトがリモートで収集されたサーバーのURL

EJBバージョン

エンドポイント、サービス

composite.xmlから読み込まれる、EJBエンドポイントのEJBバージョン・プロパティ。EJB 2.1または3.0サービスのいずれであるかを指定します。

エンドポイントURI

エンドポイント

エンドポイントを呼び出すことのできるURI。アダプタ構成の場合

公開イベント

ビジネス・プロセス: BPEL、デプロイメント: BPEL、サービス(タイプ=メディエータ)、ヒューマン・タスク、ビジネス・ルール、Springコンテキスト、コンポジット、コンポジット・デプロイメント

このコンポーネント、またはcomposite.xmlに定義されているこのコンポジット内のコンポーネントによってサブスクライブされたイベントのQName

サブスクライブ先イベント

ビジネス・プロセス: BPEL、デプロイメント: BPEL、サービス(タイプ=メディエータ)、ヒューマン・タスク、ビジネス・ルール、Springコンテキスト、コンポジット、コンポジット・デプロイメント

このコンポーネント、またはcomposite.xmlに定義されているこのコンポジット内のコンポーネントによってサブスクライブされたイベントのQName

インタフェース・タイプ

インタフェース、コンポジット・サービス、コンポジット参照

サービスによって提供されるインタフェースのタイプ

呼び出された操作

ビジネス・プロセス: BPEL

このビジネス・プロセスにより、編成されるサービス上で呼び出される操作。

レジストリ名

エンドポイント、サービス

composite.xmlから読み込まれる、ADF BCエンドポイントのレジストリ名プロパティ

リクエスト形式

エンドポイント

Oracle Service Busメッセージング・トランスポートで使用される、Oracle Service Busのリクエスト形式

レスポンス形式

エンドポイント

Oracle Service Busメッセージング・トランスポートで使用される、Oracle Service Busのレスポンス形式

SCA名

エンドポイント、コンポジット・デプロイメント・サービス、コンポジット・デプロイメント参照

composite.xmlに指定されているインタフェースまたはバインドの識別子。ワイヤおよびイベントのリレーションシップを決定するために、ハーベスタ内部で使用されます。

サービス・タイプ

サービス

サービスのタイプの説明

トランスポート・タイプ

エンドポイント

Oracle Service Busエンドポイントによって使用される、Oracle Service Busトランスポートのタイプ

ソース製品

ソース・バインド/バインド・タイプ/アドレス・タイプ

Oracle Enterprise Repositoryトランスポート・タイプ

Oracle Service Bus

混合

(OSBトランスポート・タイプによる、後述を参照)

Oracle Service Bus

XML

(OSBトランスポート・タイプによる、後述を参照)

Oracle Service Bus

抽象XML

(OSBトランスポート・タイプによる、後述を参照)

Oracle Service Bus

SOAP

(OSBトランスポート・タイプによる、後述を参照)

Oracle Service Bus

抽象SOAP

(OSBトランスポート・タイプによる、後述を参照)

Oracle Service Bus

.flow

(OSBトランスポート・タイプによる、後述を参照)

SOA Suite

binding.adf

adf bc

SOA Suite

binding.ejb

ejb

SOA Suite

binding.b2b

b2b

SOA Suite

binding.ws

(wsdlによる、後述を参照)

SOA Suite

binding.wsif

(wsdlによる、後述を参照)

SOA Suite

binding.jca

jca

ローWSDL

soap、soap12

soap

ローWSDL

http

http

ローWSDL

java

java

ローWSDL

ejb

ejb

ローWSDL

jca

jca

ローWSDL

jms

ims

ソース製品

ソース・トランスポート・タイプ

Oracle Enterprise Repositoryトランスポート・タイプ

Oracle Service Bus

http

http

Oracle Service Bus

jms

jms

Oracle Service Bus

ファイル

ファイル

Oracle Service Bus

ftp

ftp

Oracle Service Bus

ローカル

ローカル

Oracle Service Bus

その他

(OSBに表示)

ソース製品

ソース・インタフェース/コンポーネント/ファイル・タイプ

Oracle Enterprise Repositoryサービス・タイプ

Oracle Service Bus

.biz

ビジネス・サービス

Oracle Service Bus

.proxy

プロキシ・サービス

Oracle Service Bus

.flow

分割-結合サービス

SOA Suite

interface.wsdl

Webサービス

SOA Suite

interface.java

Javaサービス

SOA Suite

implementation.mediator

メディエータ・サービス

ローWSDL

(すべて)

Webサービス

ソース製品

ソース・インタフェース/バインド/ファイル・タイプ

Oracle Enterprise Repositoryインタフェース・タイプ

Oracle Service Bus

.flow

Webサービス

Oracle Service Bus

抽象SOAP

任意のWebサービス

Oracle Service Bus

抽象XML

任意のWebサービス

Oracle Service Bus

混合

メッセージング

Oracle Service Bus

XML

Webサービス

Oracle Service Bus

SOAP

Webサービス

SOA Suite

interface.wsdl

Webサービス

SOA Suite

interface.wsdl

Javaサービス

ローWSDL

(すべて)

Webサービス

索引
A  B  C  D  E  F  G  H  I  J  K  L  M  N  O  P  Q  R  S  T  U  V  W  X

A

受入れ, A.10

発行の受入れ, A.10.2

アクセス, 4.4

アクセス管理者, 4.7.1

アクセス制御, 17.5.1.8

アクセス定義, 1.6.4.2, 4.4

アクセスのオプション, 4.7.2

アクセス設定およびアセット・エディタ, 1.6.4.1

アクセス設定, 1.6, 4.3.2

アクセス設定およびアセット・エディタ, 4.2.1

システム設定へのアクセス, 17.1

Oracle Enterprise Repositoryの「診断」ページへのアクセス, 5.1

ポリシー管理機能のアクティブ化, 14.2

adapterAsset, 6.2.10

アダプタおよびアプリケーション, 6.2.10

リレーションシップのプロジェクトへの追加, 1.4.7

アセットへのSFIDの追加, 13.4

アセットへのファイルの追加, B.5

メトリックの追加, 7.1.2

タイプへの適用対象アセット・ポリシー要素の追加, 14.6

ポリシー・タイプへのポリシー・アサーション要素の追加, 14.4

タイプへのSFID要素の追加, 13.3

Oracle Business Process Management Webアプリケーションの管理, A.5.2

Oracle Business Process Managementプロセスの管理, A.5

「管理」タブ, A.10.3

拡張構成, 6.2.10

拡張オプション, 3.2.3

拡張登録フローのコンポーネント, A.11.1

拡張ロールベース・アクセス制御, 4.1

上級発行者, 4.7.1

アフィニティ設定, 17.5.1.13

applicationName, 6.2.10

Oracle BSE (WSDL/SOAP)を介したアプリケーション, 6.3.1.7

コンプライアンス・テンプレートのプロジェクトへの適用, 11.4

アセットへのポリシーの適用, 14.7

承認, A.10

アーキテクチャ・ブループリント, 11.1

アーティファクト/製品のバージョン・マトリクス, 6.1.3

アセット有効期限の警告の通知, A.6.8.1

アセット・タイプのインベントリ, B.8

ハーベスタによって作成されるアセット・タイプ, 6.3.1

アセット・アップロードのシステム設定, B.2.1

アセット, 4.4, A.1

進行中のアセット, 12.1, 17.5.1.5

「アセット」ペイン - 使用方法, 6.3.12.1

監査ログ、レビューおよびノート, A.10.5

自動ワークフローを使用した自動アセット登録, A.10.1

自動ワークフロー・コンポーネント, A.4.1

自動ワークフロー, A.2.2, A.11

自動ワークフロー・エンジン, A.5.3

自動アセット受入れのフローチャート, A.6.4.1

自動アセット登録フロー, A.6.4

B

ベース・データ・パック, 2.4, B.8.1

基本概念, 4.3

基本構成, 1

「部門」を参照

「概要」を参照

ベスト・プラクティス, 6.3.14 BI Publisher, 16.1 BPEL, 6.3.1.1 build.propertiesファイルのプロパティ値, A.3.4 ビジネス・エンティティ, 10.3.2.1.1

C

プログラムによるSFIDの計算, 13.7

カテゴリ分け, 10.3.2.1.4

Oracle Registry Repository Exchange Utilityのログ・ファイルの確認, 10.3.4

クラスパスのURL, 6.2.7.2

格納されたイベントのクリーンアップ, A.8.3

ユーザーのクローニング, 1.3.4

プロジェクトのクローズ, 1.4.6

ハーベスタのコマンド行オプション, 6.2.2.2

タブ承認プロセスの完了, A.10.4

コンプライアンス・テンプレート, 11.1

コンプライアンス・テンプレート, 1.4.1

Oracle Business Process Managementプロセス・エンジンの構成および実行手順, A.11.3

コンテナ管理認証を使用するOracle Enterprise Repositoryの構成, 3.3.2

シングル・サインオン認証で使用するOracle Enterprise Repositoryの構成, 3.2.2

カスタム・ヘルプURLプロパティの構成, B.1.2

Oracle Enterprise Repositoryイベント・マネージャの構成の手順, A.11.1

setenvファイルの構成, A.3.5

アセット・タイプ名を使用した構成, 10.2.1.2

WebSphere 6.1.0.5でのJMSプロバイダの構成, A.7.5

フェイルオーバー用のスタンドアロン・プロセス・エンジンの構成, A.5.4

既存のロールのアクセス設定の構成, 4.7

拡張ロールベース・アクセス制御の構成, 4

自動収集の構成と使用, 6

進行中のアセットの構成, 12

使用状況の自動検出の構成, 13

自動ワークフローの構成, A.6

BI Publisher Enterprise Serverの構成, 16

コミュニティ・フローの構成, A.6.4.1

外部JMSサーバー用の接続プロパティの構成, A.7.2

電子メール通知および配信リストの構成, 8

クラスタリング用の組込みJMSサーバーの構成, A.7.4.2

外部JMS Jarファイルの構成, A.7.2.4

クラスタリング用の外部JMSサーバーの構成, A.7.4.3

Webサービス・エンドポイント用のJMS永続サブスクライバの構成, A.7.3.1

JMSメッセージ・ヘッダーのプロパティの構成, A.7.2.2

JMSサーバーの構成, A.7

Oracle Enterprise Repositoryクラスタ内のJMSサーバーの構成, A.7.4

ハーベスタのロギングの構成, 6.2.8

イベント・マネージャ・イベントのロギングの構成, A.4.6

メタデータ変更フローの構成, A.6.6.2

メトリックの構成, 7

オプションのイベント・マネージャ設定の構成, A.4.4.2

UDDIマッピング・ファイル内のOracle Enterprise Repositoryカテゴリ分けの構成, 10.2.4

外部認証ツールを使用するためのOracle Enterprise Repositoryの構成, 3

Oracle Enterprise Repositoryワークフローの構成, 9, A

ポリシー管理の構成, 14, 15

プリスクリプティブな再利用の構成, 11

発行イベントを処理するための自動ワークフローの構成, A.11.3.2

BI Publisherサーバーの構成 - キャッシュ有効期限, 16.4

データベースを使用するための組込みActiveMQ JMSサーバーの構成, A.7.3

イベント・マネージャの構成, A.4.2

イベント・マネージャのシステム設定の構成, A.4.4

ハーベスタの構成, 6.2

コマンド行用のハーベスタの構成, 6.2.2

Oracle Enterprise Repositoryイベント・マネージャの構成, A.4

Oracle Enterprise Repository JDBCデータ・ソースの構成, 16.3

レポートを有効化するためのOracle Enterprise Repositoryシステム設定の構成, 16.5

Oracle Registry Repository Exchange Utilityの構成, 10.2

Oracle Registry Repository Exchange Utilityの構成ファイルの構成, 10.2.3

サブスクリプション・マネージャの構成, A.4.5

tModelKey UDDI設定の構成, 10.2.5

Webサービス・エンドポイントの構成, A.4.5.1

ワークフローの構成, A.8.4

使用されるアセット, 1.4.1

コンテナ管理の設定, 3.3

発行アップロード・ディレクトリの作成, B.2

新規ユーザーの作成と未承認ユーザーの許可, 3.2.3.2

アセットCASの作成, 4.6.1.2

ファイルCASの作成, 4.6.2.2

コンプライアンス・テンプレートの作成, 11.3

コンプライアンス・テンプレート・タイプの作成, 11.2

配信リストの作成, 8.3

新規部門の作成, 1.2.1

新規ロールの作成, 1.5.2

新規ユーザーの作成, 1.3.1

ポリシーの作成, 14.5

ポリシー・タイプの作成, 14.3, 15.3

プロジェクトの作成, 1.4.2

アセット監査ログの作成, B.3

アーティファクト・ストアの作成および構成, B.2.2

発行アップロード・ディレクトリの作成および構成, B.2

ワークフロー構成ファイルの作成およびカスタマイズ, A.6.2

新規ユーザーのデフォルト・ロールの作成と割当て, 3.2.3.1

カスタム・リンク, 17.5.1.11

Oracle Enterprise Repositoryヘルプ・システムのカスタマイズ, B.1

電子メール通知テンプレートのカスタマイズ, A.6.9

Oracle Enterprise Repositoryのカスタマイズ, 2

D

データ・ルール, B.9

データベース・ランタイム・プロパティ, A.5.3.2

dbqueries, 7.3.1

セキュリティ・モデルの定義, 16.2

Oracle Enterprise Repository接続およびレジストラの定義, A.6.2.1

有効期限後のアセットの削除, A.6.8.4

ロールの削除, 1.5.4

単一セッションの削除, 1.7.2

複数のセッションの削除, 1.7.3

部門, 1.2

Oracle Enterprise Repository事前構成BI Publisherコンテンツのデプロイ, 16.1

サンプル・ディレクトリ・クローラの説明, 13.5.1.3

アセット・タイプ・カタログの説明, B.9.6

重複アーティファクトの検出, 6.3.10

通知サービス・プラグインの開発, A.9.3.3

Webサービス・エンドポイントの開発, A.9.2

互換性のない契約を持つエンドポイントの開発, A.9.4

「診断」ページ, 5.1

進行中のアセットの無効化, 12.4

「ドキュメント」タブ, A.10.3

ヘルプ・ファイルのダウンロード, B.1.1

収集されたアーティファクトのダウンロード, 6.3.11

E

プロジェクトの編集, 1.4.3

ロールの編集, 1.5.3

部門情報の編集, 1.2.2

権限の編集, 1.6.2

ユーザー情報の編集, 1.3.5

要素の格納, B.9.3

アセット・タイプに必須となる要素, B.9.4

機能に関連付けられた要素, B.9.5

電子メール通知テンプレート, A.2.3.3

電子メール通知のユースケース, A.6.10

電子メール・テンプレート, 8.4

デバッグ・ロギングの有効化, 3.2.3.7

LDAP統合システム・プロパティの有効化, 3.1.2

シングル・サインオン統合システム・プロパティの有効化, 3.2.2.1

システム設定プロパティの有効化, 17.3

未承認/新規ユーザー・ログインの有効化, 3.2.3.3

外部JMSサーバーの有効化および構成, A.7.2.1

進行中のアセットの有効化, 12.3

カスタム・アクセス設定の有効化, 4.2.2

認識されないSFIDの収集の有効化, 13.5.1.1

JMSクラスタリング・モードの有効化, A.7.4.1

SFIDの有効化, 13.2

イベント・マネージャの有効化, A.4.4.1

SFIDマネージャの有効化, 13.6.1

IDEによる進行中のアセットの表示の有効化, 12.5

パスワード暗号化ツール, 5.3.2

Oracle Enterprise Repositoryのデプロイメントで使用される暗号化パスワード, 5.2.1

構成ファイルのパスワードの暗号化, A.2.3.7

レジストラ・ユーザーのパスワードの暗号化, A.6.2.2

パスワードの暗号化, A.8.5

エンドポイント, 10.3.2.1.3

エンタープライズ認証設定, 17.5.3

eTrust Single Sign-On, 3.2

イベント・ログ・メッセージ, A.5.5.1

イベント管理ツール, A.2.3

Event Monitor, A.2.1

イベント・モニタリング・コンソール, A.4.3

「コミュニティ・フロー」ユースケース例, A.12

ユースケース例, 10.1.2

交換ユーティリティ構成ファイル, 5.3.2

Exchange Utilityツール

「既知の問題」を参照

Webサービス・エンドポイントのイベント・マネージャの拡張, A.9 外部統合設定, 17.5.5

F

fileSet, 6.2.4.2

アセット・タイプ要素のフラグ, B.9.1

機能設定, 17.5.1

G

一般的なユーザー・インタフェース, 17.5.1.1

新規構成ファイルの生成, A.2.3.5

暗号化パスワードの生成, 5.2

ハーベスタを使用する前に, 6.1

「ベスト・プラクティス」を参照

「前提条件」を参照

「既知の問題」を参照

過去に収集されたデータ, B.9.2 特定のアセットに対するアクセス権の付与または拒否, 4.6.1 アセット内の特定のダウンロード可能ファイルに対するアクセス権の付与または拒否, 4.6.2 権限の付与および拒否, 4.6 ロールへの権限の付与, 1.6.1

H

ハーベスタ, 6

ハーベスタ構成ファイル, 5.3.1

ハーベスタの機能, 6.1.2

ハーベスタのプロパティのマトリックス, B.10

ハーベスタ・ソリューション・パック, 2.4, 2.4, B.8.2

Oracle SOA Suiteサーバーからの収集, 6.2.6.1

アーティファクトの収集, 6.3

Oracle Business Process Analysisプロジェクトの収集, 6.3.2

Oracle SOA Suiteの収集, 6.3.1.5

Oracle Service BusからのWebサービスの収集, 6.2.6.3

WebLogic ServerからのWebサービスの収集, 6.2.6.2

交換されるメタデータの同期方法, 10.3.2

I

有効期限後の非アクティブ化, A.6.8.3

OBPMのインストール, A.3.2

Oracle Enterprise Repositoryソリューション・パックのインストール, 2.4

Oracle Registry Repository Exchange Utilityのインストール, 10.2.1.1

Oracle Registry Repository Exchange Utilityのインストールおよび構成, 10.2.1

Oracle Enterprise RepositoryワークフローのOracle BPM 10.3へのインストール, A.3

Oracle Service Registryのインストール, 10.2.2

WLSTからのハーベスタの呼出し, 6.2.5

repository.submit Antタスクを使用したハーベスタの呼出し, 6.2.4

ワークフローを使用したOracle Registry Repository Exchange Utilityの起動, 10.3.1.1

J

JCAアダプタ, 6.3.1.6

jcaCSAAdapterName, 6.2.10

jcaSpecBinding, 6.2.10

JMSサーバー, A.2.1

K

既知の問題, 6.3.15, 10.3.5

L

LDAPプロパティの例, 3.1.5

LDAP/Active Directory, 3.1

「概要」を参照

「セキュリティに関する考慮事項」を参照

プロジェクトの検索, 1.4.5 ログ・ビューア, A.2.3.2 OERフィルタが適用されたログ・ビューア, A.5.5.1

M

PDFへのエクスポート機能で使用されるXSLTテンプレートの管理, B.6

電子メール配信リストの管理, 8.3

メモリーおよび実行スレッド・プロパティ, A.5.3.3

メタデータ変更フロー, A.6.6

メトリック要素

「概要」を参照

その他, 17.5.1.13 その他のJMSプロパティ, A.7.2.3 LDAP/Active Directoryプロパティの変更, 3.1.3 WebアプリケーションのWeb.xmlファイルの変更, 3.3.3 イベントのモニタリングおよび管理, A.8 イベントのモニタリング, A.8.2 データベースへの設定の移動, 17.4 複数層自動割当てフローチャート, A.6.5.1 複数層自動割当てフロー, A.6.5

N

namespace, 6.2.10

新規ユーザー通知, 3.2.3.4

部門の同期に関する注意事項, 3.2.3.5

通知, 17.5.1.7

通知サービス・プラグイン, A.9.3.3

O

オブジェクト・モデル, 13.5.1.2

ハーベスタの入手, 6.2.1

オープンAPI, 17.5.4.1

Oracle Business Process Management, A.2.1

Oracle Business Process Managementログ・ビューア, A.5.5, A.11.4

Oracle Enterprise Repository自動ワークフロー, A.2

Oracle Enterprise Repositoryデフォルト・アーティファクト・ストアの統合, B.5

Oracle Enterprise Repositoryイベント・マネージャ, A.2.1

Oracle Metadata ServiceのURL, 6.2.7.1

Oracle Registry Repository Exchange Utility, 10.1

Oracle Service Bus (OSB)プロジェクト, 6.3.1.9

その他の構成, B

その他のパスワード, 5.2.2

概要, 1.1, 3.1.1, 7.1.1

自動ワークフローの概要, A.6.1

イベント・マネージャ用のJMSの概要, A.7.1

「概要」タブ, A.10.3

P

parameter.properties, 6.2.1

repository.submit Antタスクのパラメータ, 6.2.4.1

パスワードの暗号化, 5

オプションのハーベスタ構成の実行, 6.2.7

プラグインおよびアダプタ, B.4

ポリシー, 4.4, 14.1

ポリシー管理, 17.5.1.6

前提条件, 6.1.1

プリスクリプティブな再利用, 11.1

PDFを介したアセット詳細の出力, 17.5.1.3

プロセスの概要, 4.5

タブを承認するプロセス, A.10.4

作成済アセット, 1.4.1

プロジェクト管理者, 4.7.1

プロジェクト・プロファイル, 11.1

プロジェクト, 1.4, 4.4

プロジェクトおよびナビゲータ, 17.5.1.4

プロキシ・サービスまたはビジネス・サービス, 6.3.1.8

Q

カテゴリ分けによる問合せ, 10.2.3.3.3

フィルタによる問合せ, 10.2.3.3.4

名前による問合せ, 10.2.3.3.1

登録ステータスによる問合せ, 10.2.3.3.2

R

ユーザー/使用方法の再割当て, 1.4.4

Oracle Enterprise Repositoryの外観の変更, 2.2

既存の構成ファイルのリフレッシュ, A.2.3.6

ワークフロー構成ファイルのリフレッシュ, A.8.4.1

アセットの登録, A.10.3

レジストラ, 4.7.1

レジストラ管理者, 4.7.1

登録およびアクティブ・ステータス, 10.3.2.1.5

拒否, A.10

リレーションシップ図, 1.1

「リレーションシップ」タブ, A.10.3

remoteProject, 6.2.4.2, 6.2.4.2

SFIDファイルの削除, 13.4.2

レポート, 4.4, 17.5.1.12

レビュー, A.10

ロールの同期, 3.2.3.6

ロールベース・アクセス制御のユースケース, 4.8

ロール/部門ベースのホームページ表示, 2.3

ロール, 1.5, 4.3.1

プロジェクト・コンプライアンス・レポートの実行, 11.6

データベースに対する問合せの実行, 7.3

Antからのハーベスタの実行, 6.2.4.3

Oracle Enterprise Repositoryポリシー・レポートの実行, 14.10

Oracle Registry Repository Exchange Utilityの実行, 10.3.1

ランタイム収集の詳細, 6.2.6

S

イベントのクリーンアップの例, A.8.3.3

WSDLファイルの例, A.9.2

検索, 17.5.1.2

システム設定の検索, 17.2

Oracle Service Registryの検索, 10.3.3

収集されたアセットの検索, 6.3.12

セキュリティに関する考慮事項, 1.6.4, 3.1.4, 4.2

セキュリティ暗号化パスワード・ツール, A.6.2.2

新しいアーティファクト・ストアの選択, B.2.3

Webサービスの操作の選択, A.9.3.2

コマンド行用の収集対象のアーティファクトの選択, 6.2.2.2

サーバー設定, 17.5.2

サービス・キー, 10.3.2.1.2

セッション, 1.7

「単一セッションの削除」を参照

「複数のセッションの削除」を参照

「セッションの表示」を参照

発行アップロード・ディレクトリ用の共有ディレクトリの設定, B.2 setenvファイルのプロパティ値, A.3.5 コマンド行用のリポジトリ接続情報の設定, 6.2.2.1 宛先レジストリの設定, 10.2.3.4 イベントをフィルタ処理するための式の設定, A.4.5.2 レジストリ接続情報の設定, 10.2.3.2 レジストリ問合せの設定, 10.2.3.5 リポジトリ接続情報の設定, 10.2.3.1 リポジトリ問合せの設定, 10.2.3.3 ソース・レジストリの設定, 10.2.3.6 複数層タブ承認のためのコミュニティの設定, A.6.5.3 複数層タブ承認のためのアセット・タイプの設定, A.6.5.4 SFIDの制限事項, 13.8 SFIDマネージャ, 13.6 SFIDツール・キット, 13.5 ソフトウェア・コンポーネント, A.2.1 Software File Identification (SFID), 13.1, 17.5.1.9 ネストした要素としてのパラメータの指定, 6.2.4.2 repository.submit Antタスクのパラメータの指定, 6.2.4.1 Oracle Business Process Management管理センターの起動, A.5.2.1 Oracle Business Process Managementプロセス・エンジンの起動, A.5.2.2 発行, A.10 サブスクリプション・マネージャ, A.2.1 UTF-8/Unicode文字のサポート, B.7 タイマー・ベースのワークフローを使用した同期, 10.3.1.1.2 イベントのトリガー時の同期, 10.3.1.1.3 部門の同期, 3.2.3.5 ロールの同期, 3.2.3.6 システム管理, 4.4 システム管理者, 4.7.1 Oracle Enterprise Repositoryのシステム設定, 17.5 システム設定の概要, 17

T

分類タブ, A.10.3

時間ベースのエスカレーション・フローチャート, A.6.7

時間ベースのエスカレーション・フロー, A.6.7

未受入れのアセットの追跡, A.6.7.2

未承認のアセットの追跡, A.6.7.3

未登録のアセットの追跡, A.6.7.4

未発行のアセットの追跡, A.6.7.1

ハーベスタでのトランザクション処理, 6.2.9

アセット・イベントのトリガー, A.4.3

アセット発行イベントのトリガー, A.11.4

U

Oracle Registry Repository Exchange Utilityのプロパティ・ファイルの理解, 10.2.6

登録プロセスの理解, A.10

有効期限後のアセットの登録の解除, A.6.8.2

SFIDファイルの更新, 13.4.1

配信リストの更新, 8.3.1

URI, 6.2.4.2, 6.2.4.2

使用 - ダウンロード, 17.5.1.10

ユーザー, 4.7.1

ユーザー・ロールの説明, 1.5.1

ユーザー・ロールおよびデフォルトの権限, 4.7.1

ユーザー検索, 1.3.3

ユーザー, 1.3, 1.4.1

タブ承認のためのaleridの使用, A.6.5.2

コンプライアンス・テンプレートに関連付けられているアセット(規定のアセット)の使用, 11.5

使用方法の使用, 6.3.12.1

電子メール通知および電子メール配信リストの使用, 8.1.1

統合開発環境でのハーベスタの使用, 6.2.3

メタデータの使用, 6.3.12.2

Oracle Enterprise Repository Exchange Utilityの使用, 10.3

SFIDマネージャの使用, 13.6.2

サード・パーティ・タスクの使用, 6.2.4.4

V

有効なメタデータ・エンティティ, 10.1.1.1

アセット・タイプの要素の有効化, 7.2

ポリシー・アサーションの検証, 14.9

有効期限の検証フローチャート, A.6.8

有効期限の検証フロー, A.6.8

ユーザー権限の検証, 1.6.3

進行中のアセットの表示, 12.2

ポリシー・ステータスの表示, 14.8

プロジェクト詳細の表示, 1.4.1

セッションの表示, 1.7.1

ユーザー情報の表示, 1.3.2

W

Webサービスの操作, A.9.3

Webベースのプロセス・アドミニストレータ, A.2.3.1

Oracle Enterprise Repositoryイベント・マネージャとは, A.4.1

Oracle Registry Repository Exchange Utilityとは, 10.1.1

リスト・メンバーに電子メールのコピーが送信される場合, 8.3.2

アセット・イベントのフローへのワイヤリング, A.6.3

ワークフロー構成ファイル, A.6.2.1

ワークフロー構成ツール, A.2.3.4

WSDL, 6.3.1.2

X

XSD, 6.3.1.3

XSL, 6.3.1.4

オラクル社の法律上の注意点について

コピーライトについて

Copyright © 1994-2015, Oracle and/or its affiliates.All rights reserved.

商標と登録商標について

OracleおよびJavaはOracle Corporationおよびその関連企業の登録商標です。その他の名称は、それぞれの所有者の商標または登録商標です。

Intel、Intel Xeonは、Intel Corporationの商標または登録商標です。すべてのSPARCの商標はライセンスをもとに使用し、SPARC International, Inc.の商標または登録商標です。AMD、Opteron、AMDロゴ、AMD Opteronロゴは、Advanced Micro Devices, Inc.の商標または登録商標です。UNIXは、The Open Groupの登録商標です。

ライセンス制約の保証と結果的に生じる損害の免責

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

保証免責

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます。誤りを見つけた場合は、オラクル社までご連絡ください。

制限付権利

このソフトウェアまたは関連ドキュメントを、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供する場合は、次の通知が適用されます。

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations.As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs.No other rights are granted to the U.S. Government.

危険な用途への使用について

このソフトウェアもしくはハードウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアもしくはハードウェアは、危険が伴うアプリケーション（人的傷害を発生させる可能性があるアプリケーションを含む）への用途を目的として開発されていません。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用する際、安全に使用するために、適切な安全装置、バックアップ、冗長性（redundancy）、その他の対策を講じることは使用者の責任となります。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、オラクル社およびその関連会社は一切の責任を負いかねます。

第三者のコンテンツ、製品、サービスに対する免責事項

このソフトウェアまたはハードウェア、そしてドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても一切の責任を負いかねます。

ドラフトのアルファ版およびベータ版ドキュメントについて

このドキュメントが試作版の場合:

このドキュメントは試作版であり、デモおよび暫定使用のみを目的としたものです。このソフトウェアを使用するハードウェアに限定するものではありません。オラクル社およびその関連会社は、このドキュメントに関して一切の責任を負わず、いかなる保証もいたしません。また、このドキュメントを使用したことによって損失、費用、あるいは損害が発生しても、一切の責任を負いかねます。