Oracle® Fusion Middleware

Oracle Enterprise Repository管理者ガイド

12c リリース1 (12.1.3)

E59479-02(原本部品番号:E55954-03)

2015年10月

Oracle Enterprise Repositoryの構成およびカスタマイズ・タスクについて説明する管理者向けのドキュメント。

Oracle Fusion Middleware Oracle Enterprise Repository管理者ガイド 12c リリース1 (12.1.3)

E59479-02

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

原本著者: Oracle Corporation

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

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

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

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)、その他の対策を講じることは使用者の責任となります。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、オラクル社およびその関連会社は一切の責任を負いかねます。

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の登録商標です。

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

目次

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

はじめに

- 対象読者

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

- 関連ドキュメント

- 表記規則

このガイドでの新しい情報

- 12c リリース1 (12.1.3)の新機能と変更された機能

- 12c リリース1 (12.1.3)向けドキュメントにおけるその他の重要な変更

第I部 インフラストラクチャの管理

1 基本構成

- 1.1 概要

- 1.2 部門

- 1.2.1 新しい部門の作成

- 1.2.2 部門情報の編集

- 1.2.3 部門の削除

- 1.3 ロール

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

- 1.3.2 新規ロールの作成

- 1.3.3 ロールの編集

- 1.3.4 ロールの削除

- 1.4 アクセス設定

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

- 1.4.2 権限の編集

- 1.4.3 ユーザー権限の検証

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

- 1.4.4.1 アクセス設定とアセット・エディタ

- 1.4.4.2 権限

- 1.5 ユーザー

- 1.5.1 新しいユーザーの作成

- 1.5.2 ユーザー情報の表示

- 1.5.3 ユーザー検索

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

- 1.5.5 ユーザー情報の編集

- 1.5.6 ユーザーの削除

- 1.6 プロジェクト

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

- 1.6.2 プロジェクトの作成

- 1.6.3 プロジェクトの編集

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

- 1.6.5 プロジェクトの検索

- 1.6.6 プロジェクトの終了

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

- 1.6.8 プロジェクトの削除

- 1.7 セッション

- 1.7.1 セッションの表示

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

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

- 1.8 タイプ

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

- 1.10 Java Web Startのインストール

- 1.10.1 Java Web Startのダウンロードとインストール

- 1.10.2 Java Web Startのトラブルシューティング

- 1.10.3 LinuxでのJava Web Startの構成

2 システム設定の概要

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

- 2.2 システム設定の検索

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

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

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

- 2.5.1 機能設定

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

- 2.5.1.2 検索

- 2.5.1.3 アセット詳細のPDF出力

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

- 2.5.1.5 進行中のアセット

- 2.5.1.6 ポリシー管理

- 2.5.1.7 通知

- 2.5.1.8 アクセス制御

- 2.5.1.9 Software File Identification (SFID)

- 2.5.1.10 使用 - ダウンロード

- 2.5.1.11 カスタム・リンク

- 2.5.1.12 レポート

- 2.5.1.13 その他

- 2.5.2 サーバー設定

- 2.5.2.1 一般

- 2.5.2.2 サーバー・リソース

- 2.5.2.3 電子メール

- 2.5.2.4 アップロード領域

- 2.5.2.5 監査

- 2.5.2.6 キャッシュ

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

- 2.5.3.1 一般

- 2.5.3.2 認証トークン

- 2.5.3.3 パスワード設定

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

- 2.5.3.5 LDAPおよびActive Directory設定

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

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

- 2.5.4 オープンAPI設定

- 2.5.4.1 オープンAPI

- 2.5.5 外部統合設定

- 2.5.5.1 UDDI

- 2.5.5.2 ファイル・ストア

- 2.5.5.3 Rational ClearCase

- 2.5.5.4 イベント

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

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

- 2.5.6.2 WSDLおよびXSD

- 2.6 既知の問題

3 Oracle Enterprise Repositoryのカスタマイズ

- 3.1 概要

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

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

- 3.2 Oracle Enterprise Repositoryの再ブランド設定

- 3.2.1 CSSからの開始

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

- 3.2.2.1 スキンの選択

- 3.2.2.2 スキンの作成

- 3.2.2.3 イメージ

- 3.2.2.4 カスタム・スキンのアクティブ化

- 3.2.2.5 Oracleが提供するカスタム・スキンのOracle Enterprise Repositoryへのインストール

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

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

- 3.3.1 インストール

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

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

- 4.1 概要

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

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

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

- 4.3.1 配信リストの作成

- 4.3.2 配信リストの更新

- 4.3.3 電子メールにリスト・メンバーがコピーされる状況

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

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

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

5 インポート・エクスポート・ツール

- 5.1 概要

- 5.2 インポート・エクスポート・ツールの使用

- 5.2.1 概要

- 5.2.2 parameter.propertiesファイル

- 5.2.2.1 parameter.propertiesファイルのサポート対象パラメータ

- 5.2.2.2 parameter.propertiesサンプル・ファイル

- 5.2.3 デフォルトのインポート動作

- 5.3 インポート・エクスポート・ツールの起動

- 5.3.1 Oracle Enterprise Repositoryからの起動

- 5.3.2 Oracle Enterprise Repositoryの外部からの起動

- 5.3.3 初期起動

- 5.4 Oracle Enterprise Repositoryからの項目のエクスポート

- 5.5 Oracle Enterprise Repositoryへの項目のインポート

6 BI Publisherでのレポートの構成

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

- 6.1.1 Oracle Enterprise RepositoryでのBI Publisherの構成

- 6.2 セキュリティ・モデルについて

- 6.2.1 管理者ユーザー

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

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

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

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

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

- 6.6 レポートの操作

- 6.6.1 レポート・タイプについて

- 6.6.2 カスタム・レポートの追加

- 6.6.2.1 概要

- 6.6.2.2 構成手順

- 6.6.3 レポートの実行

第II部 アセット・ライフサイクルの管理

7 タイプ・マネージャの使用

- 7.1 概要

- 7.2 タイプ・マネージャの起動

- 7.2.1 タイプ・マネージャのビュー

- 7.2.1.1 エディタ

- 7.2.1.2 ビューア

- 7.3 新しいタイプの作成

- 7.4 登録ワークフローに対応するタブの構成

- 7.4.1 タブの追加

- 7.4.2 タブの位置の変更

- 7.4.3 タブの編集

- 7.4.4 タブの削除

- 7.5 タブの要素

- 7.5.1 要素の操作

- 7.6 タイプ・マネージャ・アイコンのイメージの追加

- 7.6.1 アイコン・イメージの要件

- 7.6.2 使用可能なタイプ・アイコンの表示と選択

- 7.7 一意のID

- 7.7.1 タイプへの一意のID要素の追加

- 7.7.2 カスタム・レポート作成に必要な情報

- 7.8 共通のメタデータ・ビューア

- 7.8.1 XPath共通メタデータ・ビューア

- 7.8.2 XSLT共通メタデータ・ビューア

- 7.9 タイプXMLスキーマの表示と編集

- 7.9.1 XMLスキーマの構成

- 7.9.2 スキーマのエクスポート機能の使用

- 7.9.3 タイプXMLエディタの使用

8 自動収集の構成および使用

- 8.1 ハーベスタの使用の開始

- 8.1.1 前提条件

- 8.1.2 ハーベスタの機能

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

- 8.2 ハーベスタの構成

- 8.2.1 ハーベスタの入手

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

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

- 8.2.2.2 コマンド行で収集するアーティファクトの選択

- 8.2.3 Repository.Submit Antタスクを使用したハーベスタの起動

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

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

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

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

- 8.2.4 WLSTからのハーベスタの起動

- 8.2.5 実行時収集の詳細

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

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

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

- 8.2.5.4 デプロイ済サービスの収集

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

- 8.2.6.1 Oracle Metadata ServiceのURL

- 8.2.6.2 クラスパスURL

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

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

- 8.2.9 拡張構成

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

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

- 8.3.1.1 BPEL

- 8.3.1.2 WSDL

- 8.3.1.3 WADL

- 8.3.1.4 XSD

- 8.3.1.5 XSL

- 8.3.1.6 Oracle SOA Suiteの収集

- 8.3.1.7 JCAアダプタ

- 8.3.1.8 Oracle BSE (WSDL/SOAP)を使用するアプリケーション

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

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

- 8.3.1.11 BPMN

- 8.3.2 重複するアーティファクトの検出

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

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

- 8.3.4.1 使用方法の使用

- 8.3.4.2 メタデータの使用

- 8.3.5 ハーベスタでの作成対象アセットのプレビュー

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

- 8.3.6.1 収集に推奨される権限

- 8.3.6.2 ネームスペース・パラメータのオーバーライド回避

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

- 8.3.6.4 完了した作業の収集

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

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

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

- 8.3.6.8 リタイア済エンドポイントの収集

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

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

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

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

- 8.3.6.13 アセットのバージョニングについて

- 8.3.7 既知の問題

- 8.3.7.1 システムにアセット・タイプが存在する必要がある

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

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

- 8.3.7.4 サポートされているリモート・サーバー・タイプ

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

- 8.3.7.6 「リポジトリ内の表示」オプション

9 アセット・エディタの使用

- 9.1 概要

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

- 9.3 システム・オプションの構成

- 9.3.1 受入れ可能な値リストの構成

- 9.3.2 アーティファクト・ストアの構成

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

- 9.3.4 カテゴリ分けの構成

- 9.3.5 リレーションシップの構成

- 9.3.5.1 システム供給リレーションシップの構成

- 9.3.6 拒否理由の構成

- 9.3.7 ベンダーの構成

- 9.4 高度なアセット発行

- 9.5 アセット、コンプライアンス・テンプレート、ポリシーの移行

- 9.5.1 アセット、コンプライアンス・テンプレート、ポリシーの移行

- 9.6 アセット登録プロセスについて

- 9.6.1 発行済アセットの受入れ

- 9.6.2 アセットの登録

- 9.6.2.1 アセットのタブの承認

- 9.6.2.2 登録プロセスの完了

- 9.6.3 アセットへのノートの追加

- 9.7 アセット・ステータスについて

- 9.7.1 アセットのステータスの割当てまたは変更

- 9.8 アセットの削除

第III部 Oracle Enterprise Repositoryの保護

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

- 10.1 概要

- 10.1.1 LDAP/Active Directory

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

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

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

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

- 10.1.5 LDAPプロパティの例

- 10.2 シングル・サインオン

- 10.2.1 概要

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

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

- 10.2.2.2 基本認証とのOracle Enterprise Repository SSO統合の使用

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

- 10.2.3 拡張オプション

- 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.7 デバッグ・ロギングの有効化

- 10.3 コンテナ管理設定

- 10.3.1 概要

- 10.3.2 コンテナ管理の認証用のOracle Enterprise Repositoryの構成

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

11 高度なロールベース・アクセス制御の構成

- 11.1 概要

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

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

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

- 11.3 基本概念

- 11.3.1 ロール

- 11.3.2 アクセス設定

- 11.4 アクセス定義

- 11.5 プロセスの概要

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

- 11.6.1 特定のアセットへのアクセスの付与/拒否

- 11.6.1.1 前提条件

- 11.6.1.2 アセットCASの作成

- 11.6.2 アセット内の特定のダウンロード・ファイルへのアクセスの付与/拒否

- 11.6.2.1 前提条件

- 11.6.2.2 ファイルCASの作成

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

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

- 11.7.2 アクセス・オプション

- 11.7.2.1 オプションI: CASを使用した特定のアセットへのアクセスの付与または拒否

- 11.7.2.2 オプションII: CASを使用した特定のファイルおよびアセットへのアクセスの付与または拒否

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

- 11.8.1 ユースケース1: 顧客および取引パートナへのWebサービスの公開

- 11.8.1.1 利点

- 11.8.1.2 概要

- 11.8.1.3 ソリューション

- 11.8.2 ユースケース2: アウトソース先の環境における知的財産の管理

- 11.8.2.1 利点

- 11.8.2.2 概要

- 11.8.2.3 ソリューション

- 11.8.3 ユースケース3: フェデレーテッド・リポジトリの確立

- 11.8.3.1 利点

- 11.8.3.2 概要

- 11.8.3.3 ソリューション

- 11.8.4 ユースケース4: アセット・ライフサイクルの管理

- 11.8.4.1 利点

- 11.8.4.2 概要

- 11.8.4.3 ユースケースのソリューションの構成

- 11.8.4.4 アセット・ライフサイクル管理ソリューションの検証テスト

- 11.8.5 ユースケース5: ソース・コード・ファイルへのアクセスのアセット作成チームのみへの制限

- 11.8.5.1 利点

- 11.8.5.2 概要

- 11.8.5.3 ソリューション

- 11.8.6 ユースケース6: 特定のグループへのブラウザ限定リポジトリ・アクセスの付与

- 11.8.6.1 利点

- 11.8.6.2 概要

- 11.8.6.3 ソリューション

- 11.8.6.4 検証テスト

12 パスワードの暗号化

- 12.1 暗号化されたパスワードの生成

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

- 12.1.2 その他のパスワード

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

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

- 12.2.2 Exchange Utility構成ファイル

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

- 12.2.4 APIカタログへのエクスポート構成ファイル

第IV部 高度なライフサイクル管理

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

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

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

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

- 13.2.2 手順2: デプロイしたSCAにイベントを配信するためのOER Event Managerの構成

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

- 13.2.2.2 Event Managerの有効化

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

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

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

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

- 13.4.1.1 作成するプロジェクト

- 13.4.1.2 承認フロー

- 13.4.1.3 イベントとアクションのマッピング

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

- 14.1 概要

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

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

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

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

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

15 コード・コンプライアンス・インスペクタとの統合

- 15.1 概要

- 15.1.1 CCIレポートの生成およびOERへの公開の手順の概要

- 15.2 コンプライアンスのチェックおよびOERのレポート・データの同期

- 15.2.1 CCIレポート用のOERアーティファクト・ストアの構成

- 15.2.2 cci-oerSynch.propertiesファイルの構成

- 15.2.3 checkComplianceコマンドの実行

- 15.2.4 OERへのSOAまたはAIAプロジェクトの収集

- 15.2.5 CCIとOERの同期コマンドの実行

- 15.2.6 ファイルのコピー

- 15.3 OERの「レポート」メニューからのアクセスに関するレポートの構成

- 15.3.1 レポートの確認

16 ポリシー管理の構成

- 16.1 概要

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

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

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

- 16.5 ポリシーの作成

- 16.6 適用されたアセット・ポリシー要素のタイプへの追加

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

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

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

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

17 Enterprise Manager統合ユーティリティ

- 17.1 概要

- 17.1.1 前提条件

- 17.1.2 Enterprise Manager統合ユーティリティの取得

- 17.1.3 高レベルなユースケース

- 17.2 Enterprise Manager統合ユーティリティの使用

- 17.2.1 コマンド行からの実行

- 17.2.2 Enterprise Managerからのスケジュール

- 17.2.3 メトリックの発行

- 17.2.3.1 Oracle Service Bus

- 17.2.3.2 BPEL PM

- 17.2.3.3 WebLogic Webサービス

- 17.2.3.4 Oracle SOA Suite 11g

- 17.2.3.5 アーティファクトの作成

- 17.2.3.6 エンドポイントの作成

- 17.2.3.7 更新するメトリック

- 17.3 Enterprise Manager統合ユーティリティの構成

- 17.3.1 コマンド行ユーティリティのリポジトリおよびEnterprise Manager接続情報の設定

- 17.3.2 拡張構成

- 17.3.2.1 メトリックのマッピング

- 17.3.2.2 ターゲット・ファインダ

- 17.3.2.3 ロギング

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

- 17.5 既知の問題

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

18 メトリックの構成

- 18.1 概要

- 18.1.1 メトリック要素

- 18.1.2 再利用可能なメトリックのタブの追加

- 18.2 アセット・タイプの要素の検証

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

- 18.3.1 dbqueries

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

- 19.1 概要

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

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

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

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

- 19.5 Oracle JDeveloperによる進行中のアセットの表示の有効化

20 契約管理の構成

- 20.1 概要

- 20.1.1 前提条件

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

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

- 20.3.1 契約の作成

- 20.3.2 契約の編集

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

- 20.3.3.1 使用条件

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

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

- 21.1 Oracle Registry Repository Exchange Utilityの使用の開始

- 21.1.1 Oracle Registry Repository Exchange Utilityとは

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

- 21.1.1.2 前提条件

- 21.1.2 サンプル・ユースケース

- 21.2 Oracle Registry Repository Exchange Utilityの構成

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

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

- 21.2.1.2 アセット・タイプ名の使用の構成

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

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

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

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

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

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

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

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

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

- 21.2.5 tModelKey UDDI設定の構成

- 21.2.6 Oracle Registry Repository Exchange Utilityのプロパティ・ファイルについて

- 21.2.7 XUサポート

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

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

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

- 21.3 Oracle Enterprise Repository Exchange Utilityの使用

- 21.3.1 Oracle Registry Repository Exchange Utilityの実行

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

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

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

- 21.3.2.2 Oracle Service RegistryからOracle Enterprise Repositoryへのメタデータの同期

- 21.3.3 Oracle Service Registryとの間で交換されたメタデータのOracle Enterprise Repositoryでの検索

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

- 21.3.5 既知の問題

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

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

- 21.3.5.3 不正なバージョンのJavaの実行

第V部 付録

A その他の構成

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

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

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

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

- A.2 アセット監査ログの作成

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

- A.4 PDFへのエクスポート機能で使用するXSLTテンプレートの管理

- A.4.1 Oracle Enterprise Repositoryで使用するXSL:FOテンプレートの管理

- A.5 UTF-8/Unicode文字のサポート

- A.6 データ・ルール

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

- A.6.2 過去に収集されたデータ

- A.6.3 要素の格納

- A.6.4 アセット・タイプに存在する必要がある要素

- A.6.5 機能に関連付けられた要素

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

- A.7 ハーベスタ・プロパティ

索引

はじめに

『Oracle Fusion Middleware Oracle Enterprise Repository管理者ガイド』には、Oracle Enterprise Repositoryで4種類の管理タスク(インフラストラクチャ管理、アセット・ライフサイクル管理、セキュリティ管理、高度なアセット・ライフサイクル管理)を実行するために必要な情報がまとめられています。

対象読者

このドキュメントは、Oracle Enterprise Repositoryインストールの管理者またはアセット・ライフサイクル・プロセスの管理者を対象としています。

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

オラクル社のアクセシビリティへの取組みの詳細は、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 12cドキュメント・セット内の次のドキュメントを参照してください。

- Oracle Fusion Middleware Oracle Enterprise Repositoryコンセプト・ガイド

- Oracle Fusion Middleware Oracle Enterprise Repositoryインストレーション・ガイド

- Oracle Fusion Middleware Oracle Enterprise Repositoryアップグレード・ガイド

- Oracle Fusion Middleware Oracle Enterprise Repository開発者ガイド

表記規則

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

規則

意味

太字

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

イタリック体

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

固定幅フォント

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

このガイドでの新しい情報

ここでは、Oracle Enterprise Repositoryの新機能と変更された機能、およびこのガイドに記載されているその他の重要な変更について紹介し、詳細情報へのリンクを提供します。このドキュメントは、以前の『Oracle Fusion Middleware Oracle Enterprise Repository構成ガイド』の新しいエディションです。

既知の問題(リリース・ノート)のリストは、http://www.oracle.com/technetwork/middleware/soasuite/documentation/releasenotes121300-2124738.htmlで、「Known Issues for Oracle SOA Products and Oracle BPM Products for 12c Release 1 (12.1.3.0.0)」を参照してください。

12c リリース1 (12.1.3)の新機能と変更された機能

Oracle Enterprise Repository 12c リリース1 (12.1.3)で、このガイドは次の新機能と変更された機能が記載されるように更新されました。

- 第8章「自動収集の構成および使用」には、次の説明があります。

- OERハーベスタでRESTサービスの収集がサポートされるようになりました。

- OERに、Oracle Service Busで使用するハーベスタが含まれています。

- 8.3.1.3項「WADL」が追加され、ここではWADLアーティファクトの収集について説明します。

- 第13章「Oracle Enterprise Repositoryエクスプレス・ワークフローの構成」が追加され、ここではこのリリースでの新しい簡略化されたワークフローについて説明します。

この12c リリース1 (12.1.3)向けドキュメントにおけるその他の重要な変更

Oracle Enterprise Repository 12c リリース1 (12.1.3)で、このガイドは次のように更新されました。

- 第2章「システム設定の概要」では、追加のシステム設定について説明します。

- 以前のリリースの『Oracle Fusion Middleware Oracle Enterprise Repositoryユーザーズ・ガイド』および『Oracle Fusion Middleware Oracle Enterprise Repository統合ガイド』の管理タスクが、このガイドに移動されました。

第I部

インフラストラクチャの管理

この部では、Oracle Enterprise Repositoryのインフラストラクチャの基本的な管理タスクについて説明します。

この部は、次の章で構成されています。

- 第1章「基本構成」

- 第2章「システム設定の概要」

- 第3章「Oracle Enterprise Repositoryのカスタマイズ」

- 第4章「電子メール通知および配信リストの構成」

- 第5章「インポート・エクスポート・ツール」

- 第6章「BI Publisherでのレポートの構成」

1 基本構成

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

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

- 1.1項「概要」

- 1.2項「部門」

- 1.3項「ロール」

- 1.4項「アクセス設定」

- 1.5項「ユーザー」

- 1.6項「プロジェクト」

- 1.7項「セッション」

- 1.8項「タイプ」

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

- 1.10項「Java Web Startのインストール」

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.3項「部門の削除」

1.2.1 新しい部門の作成

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

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

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

3. 「名前」および「説明」フィールドに適切な情報を入力します。

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

1.2.2 部門情報の編集

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

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

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

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

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

5. 必要に応じて、「名前」および「説明」フィールドを更新します。

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

1.2.3 部門の削除

Oracle Enterprise Repositoryで部門を削除するには、Oracle Enterprise Repositoryの「管理」画面から次の手順を実行します。

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

2. 「すべてをリスト」をクリックするか、削除する部門を検索します。

3. 部門を削除します。

- 「検索結果」画面から部門を削除するには、削除する各部門の横にあるチェック・ボックスを選択し、「削除」をクリックします。この方法を使用すると、複数の部門を同時に削除できます。

- 詳細ページから部門を削除するには、削除する部門の詳細ページを開き、「削除」をクリックします。

1.3 ロール

Oracle Enterprise Repositoryの「管理」ページで「ロール」リンクをクリックすると、管理者は組織の様々な機能用のロールを設定できます。各ロールに対してOracle Enterprise Repositoryのアクセス設定が確立され、各ユーザーには組織内でのそれぞれの機能に基づいて特定のロールが割り当てられます。

管理ロールが割り当てられたユーザーは、すべてのOracle Enterprise Repository機能に制限なしにアクセスできます。デフォルトでは、新規インストールまたは以前のバージョンからの移行のいずれにおいても、管理者として識別されたユーザー・アカウントには、初期インストールおよび構成を容易にするために管理ロールが割り当てられます。管理権限の割当ては、元のOracle Enterprise Repository管理ユーザー・アカウントと追加アカウント1つのみに制限することをお薦めします。Oracle Enterprise Repositoryで設定されている様々なデフォルトのロールによって、あらゆるOracle Enterprise Repositoryユーザーの機能と責任を満たす様々な権限が提供されます。これらのロールは、組織の特定のニーズにあわせてカスタマイズできます。

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

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

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

- 1.3.4項「ロールの削除」

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

次に、Oracle Enterprise Repositoryに付属の様々なデフォルト・ロールについて説明します。「管理」タブにアクセスできるユーザーは、組織のニーズにあわせてロール名を変更できます。これらのロールに付与されている権限は、「アクセス設定」セクションで変更できます。

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

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

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

- プロジェクトの表示

- レポートの生成

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

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

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

- レポートの生成

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

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

- プロジェクトの表示

- レポートの生成

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

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

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

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

- プロジェクトの表示

- レポートの生成

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

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

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

- タブの承認

- アセットの登録

- アクセス設定の編集

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

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

- プロジェクトの表示

- レポートの生成

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

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

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

- タブの承認

- アセットの登録

- アクセス設定の編集

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

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

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

- レポートの生成

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

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

- レポートの生成

(システム管理者ロールを一般ユーザーに割り当てないでください。)

1.3.2 新規ロールの作成

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

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

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

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

図1-3 「新規ロールの作成」ダイアログ

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

4. 必要に応じて、新しいユーザーに自動的に割当てボックスを選択します。

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

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

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

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

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

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

1.3.3 ロールの編集

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

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

図1-5 ロールのリスト

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

3. ロールをクリックして、その情報を下部ペインに表示します。

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

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

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

1.3.4 ロールの削除

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

注意:
ロールの削除には、削除権限が必要です。権限およびアクセス設定の詳細は、1.4項「アクセス設定」を参照してください。

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

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

3. オプション1:

- 上のフレームのリストで、削除する各ロールの横にあるボックスにチェックを入れます。

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

4. オプション2:

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

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

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

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

1.4 アクセス設定

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

システム保護により、管理者は不注意から今後アクセス設定にアクセスできなくなるような権限変更を行うことはできません。

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

- カスタム・アクセス設定(CAS)
高度なロールベース・アクセス制御を設定して、Oracle Enterprise Repositoryの特定のアセットまたはアセット・グループへのアクセスを特定のユーザー・ロールに制限します。

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

- 1.4.2項「権限の編集」

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

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

1.4.1 ロールへの権限の付与

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

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

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

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

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

図1-8 権限の設定

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

図1-9 権限の設定

ロールが左側に表示され、権限が上部に表示されます。

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

図1-10 権限の設定

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

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

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

- 2回目のクリックで、Xが追加されます(拒否済)。

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

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

1.4.2 権限の編集

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

1.4.3 ユーザー権限の検証

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

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

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

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

図1-11 アセットの基本アクセス設定のアクセスの表示

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

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

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

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

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

図1-13 ユーザー・アクセス設定

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

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

1.4.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.4.4.1 アクセス設定とアセット・エディタ

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

1.4.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.5 ユーザー

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

- 第1.5.1項「新しいユーザーの作成」

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

- 1.5.3項「ユーザー検索」

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

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

- 1.5.6項「ユーザーの削除」

1.5.1 新しいユーザーの作成

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

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

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

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

注意:
アスタリスク(*)で示された各必須フィールドには必ず値を入力してください。

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

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

5. 「ロール」セクションで、矢印ボタンを使用して項目を「使用可能なロール」列から「選択したロール」列に移動して、新しいユーザーにロールを割り当てます。(ユーザー・ロールが、すべての新しいユーザーのデフォルトのロールです。)

6. 「部門」セクションで、矢印ボタンを使用して項目を使用可能な部門列から選択した部門列に移動して、新しいユーザーを部門に割り当てます。

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

1.5.2 ユーザー情報の表示

ユーザーの情報を表示するには、Oracle Enterprise Repositoryの「管理」画面で次の手順を実行します。

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

2. 「検索」またはすべてをリストを使用して、表示するユーザーを見つけます。
ユーザーのリストがメイン・ペインに表示されます。

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

4. 検索結果の非表示と表示ボタンをクリックして、ユーザーの詳細をメイン・ペイン全体に拡張します。

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

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

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

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

1.5.3 ユーザー検索

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

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

2. 「名前」フィールドに適切なテキストを入力します。

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

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

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

ユーザーのクローニングは、管理者がユーザー・アカウントを迅速に複製する簡単な方法です。

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

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

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

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

4. 「概要」セクションの各テキスト・フィールドに適切な情報を入力します。

5. 必要に応じて、矢印ボタンを使用して「使用可能」列と「選択済」列の間で項目を移動して、「ロール」および「部門」セクションの情報を編集します。

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

1.5.5 ユーザー情報の編集

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

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

2. 「検索」またはすべてをリストを使用して、編集するユーザーを見つけます。ユーザーのリストが、メイン・ペインの上のフレームに表示されます。

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

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

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

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

1.5.6 ユーザーの削除

Oracle Enterprise Repositoryでユーザーを削除するには、Oracle Enterprise Repositoryの「管理」画面から次の手順を実行します。

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

2. 「すべてをリスト」をクリックするか、削除するユーザーを検索します。

3. ユーザーを削除するには:

- 「検索結果」画面からユーザーを削除するには、削除する各ユーザーの横にあるチェック・ボックスを選択し、「削除」をクリックします。この方法を使用すると、複数のユーザーを同時に削除できます。

- 詳細ページからユーザーを削除するには、削除するユーザーの詳細ページを開き、「削除」をクリックします。

1.6 プロジェクト

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

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

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

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

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

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

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

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

- 1.6.6項「プロジェクトの終了」

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

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

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

概要

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

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

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

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

使用されるアセット

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

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

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

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

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

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

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

作成済アセット

プロジェクトによって作成されたアセットをリストします。

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

ユーザー

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

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

関連プロジェクト

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

1.6.2 プロジェクトの作成

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

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

図1-21 Create New Project

2. 「名前」、「説明」および予測開発時間フィールドに適切な情報を入力します。

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

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

5. 「ステータス」リストで適切なステータスを選択します。「オープン」ステータスは、プロジェクトが変更のためにまだ開かれていることを示します。「クローズ」ステータスは、プロジェクトは閉じられており、変更のために開かれていないことを意味します。

6. 必要に応じて、新しいユーザーに自動的に割当てを選択します。

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

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

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

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

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

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

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

図1-24 「概要」タブ

1.6.3 プロジェクトの編集

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

1. 「検索」またはその他の方法を使用して、編集するプロジェクトを見つけます。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

9. 矢印ボタンを使用して、ユーザーをプロジェクト・リーダーまたはプロジェクト・メンバー(あるいはその両方)として再割当てします。

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

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

1.6.5 プロジェクトの検索

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

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

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

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

1.6.6 プロジェクトの終了

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

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

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

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

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

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

図1-29 「ステータスの更新」

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

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

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

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

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

プロジェクト・リレーションシップ機能により、プロジェクト間のリレーションシップを親/子に基づいてマッピングできます。

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

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

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

図1-31に示すように、プロジェクトのリストがメイン・ペインの上のセクションに表示されます。

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

2. 編集するプロジェクトを選択します。図1-32に示すように、「プロジェクトの詳細」ペインがメイン・ペインの下のセクションに表示されます。

図1-32 「プロジェクトの詳細」ペイン

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

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

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

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

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

6. 必要に応じて、追加するプロジェクトを選択し、矢印ボタンを使用して親オブジェクトまたは子プロジェクト・カテゴリ・ウィンドウに移動します。選択したウィンドウにプロジェクトが表示されます。

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

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

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

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

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

1.6.8 プロジェクトの削除

Oracle Enterprise Repositoryでプロジェクトを削除するには、Oracle Enterprise Repositoryの「プロジェクト」ページから次の手順を実行します。

1. 「すべてをリスト」をクリックするか、削除するプロジェクトを検索します。

2. プロジェクトを削除するには:

- 「検索結果」画面からプロジェクトを削除するには、削除する各プロジェクトの横にあるチェック・ボックスを選択し、「削除」をクリックします。この方法を使用すると、複数のプロジェクトを同時に削除できます。

- 詳細ページからプロジェクトを削除するには、削除するプロジェクトの詳細ページを開き、「削除」をクリックします。

1.7 セッション

セッションによって、管理者はどのユーザーがOracle Enterprise Repositoryにログインしているかを確認でき、必要に応じてユーザー・セッションを停止できます。

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

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

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

1.7.1 セッションの表示

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

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

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

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

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

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

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

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

1. メイン・ペインのセッションのリストで、削除する各セッションを選択します。

ヒント:
リストされているすべてのセッションを選択するには、列の上部にあるチェック・ボックスにチェック・マークを入れます。

2. 表ヘッダーの「削除」ボタンをクリックします。確認ダイアログが表示されます。

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

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

1.8 タイプ

タイプによって、アセットの構成が定義されます。すべてのアセットには、その属性を定義するタイプが必要です。タイプのXMLを生成することもできます。これは特に、1つのタイプから別のタイプへのマッピング属性が必要となる移行プロセスで使用されます。詳細は、第8章「タイプ・マネージャの使用」を参照してください。

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

Oracle Enterprise Repositoryでは、「診断」ページはデフォルトで無効になっています。http://host_name:port/application_name/diag/index.jspに移動します(host_nameは適切な場所に置き換えます)。

「診断」ページをデフォルト・モードで開くと、次のメッセージが表示されます。

診断ページは現在無効です。Oracle Enterprise Repository管理者に問い合せてください。

「診断」ページを有効にするには、次の手順を実行します。

1. ORACLE_HOME/user_projects/domains/DOMAIN_NAME/bin/に移動します。

2. Oracle Enterprise Repositoryサーバーを起動する前に、setStartupEnv.shまたはsetStartupEnv.cmdを編集します。

3. -DdiagPagesEnabled=trueを、このファイルのEXTRA_JAVA_PROPERITES="${EXTRA_JAVA_PROPERTIES}行に追加します。

4. Oracle Enterprise Repositoryサーバーを再起動します。

必要な場合にのみ有効にし、システムが問題なく稼働するようになったら無効にすることをお薦めします。

1.10 Java Web Startのインストール

Java Web Startは、拡張子がJNLPのファイルを実行するブラウザ・プラグインです。Oracle Enterprise Repositoryのアセット・エディタ、タイプ・マネージャ、ナビゲータ・アプレット、ブラウズ・ツリー・アプレットおよびインポート/エクスポート・ユーティリティを使用するには、クライアントにJava Web Startが必要です。

- 1.10.1項「Java Web Startのダウンロードとインストール」

- 1.10.2項「Java Web Startのトラブルシューティング」

- 1.10.3項「LinuxでのJava Web Startの構成」

1.10.1 Java Web Startのダウンロードとインストール

Java Web Startは、最新バージョンのJDKに含まれています。

このドキュメントが公開された時点では、Oracle Fusion Middleware製品にはJDK 7.0 Update 55以降が必要です。ただし、記載されているように動作保証情報を確認して、必要なJDKのバージョンを常に確認してください。必要なJDKをダウンロードするには、ブラウザを使用して次のURLに移動し、Java SE JDKをダウンロードしてください。

http://www.oracle.com/technetwork/java/javase/downloads/index.html

1.10.2 Java Web Startのトラブルシューティング

ブラウザで不明な拡張子を持つファイルが見つかると、多くの場合、アプリケーションを開くときに開くか保存することを求められます。JNLPファイル・タイプのこのアクションを実行するには、「Open」オプションを選択し、$JAVA_HOME/jre/bin/javawsファイルを参照して、適切なオプションを選択します。新しいJREが必要な場合は、1.10.1項「Java Web Startのダウンロードとインストール」の手順に従って最新のJREをインストールします。

1.10.3 LinuxでのJava Web Startの構成

Linuxオペレーティング・システムでJava WebStartを使用する前に、Java WebStartを構成する必要があります。

Java WebStartを構成するには、次の手順を実行します。

注意:
Linuxの場合、ブラウザにはいくつかのオプションのみが用意されており、LinuxインストールのデフォルトのブラウザはMozilla Firefoxです。

1. Mozilla Firefoxを閉じます。

2. コンピュータ上でmozillaディレクトリ(例: /usr/lib/mozilla-1.4または/home/<user>/.mozilla)を探します。

3. コマンド・プロンプトを開き、次のようなコマンドを使用してコンピュータ上のmozillaディレクトリに移動します。

cd home/<user>/.mozilla

4. pluginsディレクトリが存在しない場合は、次のコマンドを使用して作成します。

mkdir plugins

5. 次のように、Mozillaインストール・ディレクトリの下のpluginsサブディレクトリに移動します。

cd plugins

6. 現在のディレクトリで、Java ns7/libjavaplugin_oji.soファイル・タイプへのシンボリック・リンクを作成します。
ln -s /oracle/soa/mwhome_gov/jdk7/jre/plugin/i386/ns7/libjavaplugin_oji.so

7. Mozilla Firefoxを開き、次のリンクをテストします。
http://www.java.com/en/download/help/testvm.xml

8. Mozilla Firefoxで、「Edit」メニューをクリックし、「Preferences」を選択します。「Preferences」ダイアログが表示されます。

9. 「Applications」をクリックします。「Application」ページが表示されます。

10. 「Search」フィールドに、「JNLP」と入力します。JNLPが表示されます。

11. 表示されたJNLPを選択します。「Action」リストがアクティブになります。

12. 「Action」リストをクリックして、インストールされている正しいjavaws (例: WLS JDKとともにインストールされたjavawsなど)をポイントするようにします。

注意:
ただし、64ビットのLinuxでは、WLSにはJRockitのみが付属しています。プラグインにアクセスするには、64ビットのJDKを手動でダウンロードする必要があります。

注意:
アプリケーションをローカルに保存し、<JAVA_HOME>/jre/binにあるjavaws実行可能ファイルを使用して、Java Web Startアプリケーションを実行することもできます。次に例を示します。

<JAVA_HOME>/jre/bin/javaws -verbose /path_to_file/impexp.jnlp

2 システム設定の概要

この章では、Oracle Enterprise Repositoryの管理者が基本操作や特定の機能を構成するために使用するシステム設定について説明します。

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

- 2.1項「システム設定へのアクセス」

- 2.2項「システム設定の検索」

- 2.3項「システム設定プロパティの有効化」

- 2.4項「データベースへの設定の移動」

- 2.5項「Oracle Enterprise Repositoryのシステム設定」

- 2.6項「既知の問題」

2.1 システム設定へのアクセス

システム設定にアクセスするには、次の手順を実行します。

1. Oracle Enterprise Repositoryの「管理」画面のサイドバーにある「システム設定」をクリックします。

図2-1 Oracle Enterprise Repositoryの「システム設定」ページ

メイン・ペインで「システム設定」セクションが開きます。

システム設定はカテゴリに分けられています。各カテゴリはさらに機能グループに分けられています。

図2-2 機能設定が閉じた状態

2. プラス・アイコンをクリックして任意のカテゴリまたは機能グループの表示を開きます。

3. マイナス・アイコンをクリックして表示を閉じます。

2.2 システム設定の検索

システム設定検索を使用して特定の機能のシステム設定を検索できます。

1. 「検索」フィールドに検索語を入力します。関連するカテゴリ・セクションが開き、関連するシステム設定が表示されます。

図2-3 機能設定が開いた状態

2. 「クリア」をクリックして検索結果をクリアします。

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

Oracle Enterprise Repositoryの一部のオプション機能をアクティブにするためには、特定のプロパティを有効にする必要がある場合があります。これらのプロパティはOracle Supportにより提供されています。

1. 必要なシステム設定プロパティを取得します。

2. 新しいシステム設定の有効化フィールドにそのシステム設定プロパティを入力します。

3. 「有効化」をクリックします。該当するシステム設定カテゴリが下部のペインに開きます。

4. 必要に応じて、システム設定プロパティを編集します。

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

2.4 データベースへの設定の移動

注意:
このオプションを使用すると、プロパティ・ファイルに格納されているすべてのシステム設定がデータベースに移動されます。このアクションを元に戻すことはできません。

「データベースへの設定の移動」をクリックします。すべてのシステム設定がデータベースに保存されます。これはクラスタ環境用です。クラスタ環境内のすべてのサーバーが1つのシステム設定ソースを持つことになります。

2.5 Oracle Enterprise Repositoryのシステム設定

この項では、Oracle Enterprise Repositoryに用意されているすべてのシステム設定について説明します。

この項には次のトピックが含まれます:

- 2.5.1項「機能設定」

- 2.5.2項「サーバー設定」

- 2.5.3項「エンタープライズ認証設定」

- 2.5.4項「オープンAPI設定」

- 2.5.5項「外部統合設定」

- 2.5.6項「インポート/エクスポートおよびイントロスペクション設定」

2.5.1 機能設定

この項には次のトピックが含まれます:

- 2.5.1.1項「一般的なユーザー・インタフェース」

- 2.5.1.2項「検索」

- 2.5.1.3項「アセット詳細のPDF出力」

- 2.5.1.4項「プロジェクトおよびナビゲータ」

- 2.5.1.5項「進行中のアセット」

- 2.5.1.6項「ポリシー管理」

- 2.5.1.7項「通知」

- 2.5.1.8項「アクセス制御」

- 2.5.1.9項「Software File Identification (SFID)」

- 2.5.1.10項「使用 - ダウンロード」

- 2.5.1.11項「カスタム・リンク」

- 2.5.1.12項「レポート」

- 2.5.1.13項「その他」

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

プロパティ

- フルネーム形式

- enterprise.defaults.fullname.format

- ユーザー名の表示形式を指定します。名前部分の文字列{prefix}、{first}、{middle}、{suffix}を句読点で句切って任意の順序で指定できます。余分なスペースは切り捨てられます。

注意:
この設定を変更した場合はサーバーの再起動が必要です。

- 表示名フィールド

- enterprise.defaults.displayname.field

- リストから選択した項目によって、ユーザーに表示される情報が決まります。選択可能なオプションにより、ユーザーの電子メール・アドレス(emailaddressオプション)、ユーザーのフルネーム(fullnameオプション)、ユーザーのユーザー名(usernameオプション)、ユーザーのフルネームとユーザー名(fullname (username)オプション)、またはユーザーのフルネームとユーザーID (fullname (userid)オプション)が表示されます。

注意:
この設定を変更した場合はサーバーの再起動が必要です。

- 表示名 - フルネームとイニシャル

- enterprise.defaults.fullname.middleasinitial

- ユーザーのミドル・ネームを扱う場合は、TrueおよびFalseオプションを使用して、ミドルネームをフルミドルネームで表示するか、イニシャルで表示するかを切り替えます。

図2-4に、Trueを指定した場合の形式を示します。

図2-4 フルネームとフルミドル・ネーム

図2-5に、Falseを指定した場合の形式を示します。

図2-5 フルネームとイニシャル

- デフォルトの参照カテゴリ分け

- cmee.assettab.default-categorization

- リストから選択した項目によって、「アセット」画面の参照ツリーに表示される初期アセット・カテゴリ分けが決まります。選択可能なカテゴリ分けは、アセット機能、アセット・ライフサイクル・ステージ、ビジネス目標、「分類」、「ドメイン」、エンタープライズ・アーキテクチャ・モデル、「ライン・オブ・ビジネス」、「ソース」、「テクノロジ」、およびツールです。
図2-6に、デフォルトの参照カテゴリ分けとしてアセット機能を選択した場合の結果を示します。

図2-6 参照ツリー - カテゴリ分けとしてアセット機能を選択した場合

- アセット参照ツリーの表示

- cmee.assettab.browse.visible

- Trueに切り替えると、アセット・カテゴリ分けでソート可能なアセット参照ツリーが表示されます。Falseに切り替えると、アセット参照ツリーが無効になります。

- デフォルトの参照タイプ

- cmee.assettab.default-categorization-show-assettype

- TrueおよびFalseオプションを使用して、「アセット」画面の参照ツリーにデフォルトでアセットをタイプ別に表示するかどうかを切り替えます(タイプはデフォルトの参照カテゴリ分けのシステム設定によって決まります)。
図2-7に、このプロパティをTrueに切り替えた場合の結果を示します。

図2-7 参照ツリー - アセットをタイプ別に表示した場合

- リスト・ペイン内のフィールドの最大サイズ

- cmee.asset.listpane.maxsize

- リスト・ペイン内のフィールドの最大サイズを指定します。このサイズを超えるフィールドは切り捨てられ、ユーザーがフィールド上にマウスを置いたときにツールチップとして完全なテキストが表示されます。

- スティッキーなレジストラ・キュー

- cmee.registrar.stickyqueues

- TrueおよびFalseオプションを使用して、選択したアセット・エディタのタブをアセットの参照時にデフォルトで表示するかどうかを切り替えます。

- True: 各アセットは、前に選択したアセットが表示されていたアセット・エディタのタブに表示されます。

- False: 各アセットは、デフォルトでアセット・エディタの「概要」タブに表示されます。

- 表のズーム

- cmee.assettab.multiplegroupelement.force-zoom

- TrueおよびFalseオプションを使用して、表要素をそれぞれ独自のウィンドウで開くかどうかを切り替えます。

- 表ヘッダーの繰返し

- cmee.assettab.multiplegroupelement.show-header-interval

- テキスト・ボックスに入力される数値により、大きな表で表ヘッダーを繰り返す間隔(行数)が決定されます。

- 図2-8に、このプロパティに値0を割り当てた場合の結果を示します。

図2-8 コスト・カテゴリ - ヘッダーを繰り返さない場合

- 図2-9に、このプロパティに値2を割り当てた場合の結果を示します。

図2-9 コスト・カテゴリ - 表ヘッダーを繰り返した場合

- リレーションシップを閉じる

- cmee.assettab.relationships.collapse

- Trueに切り替えると、アセット詳細ページの関連アセットのリストが閉じます。ユーザーがリストを開くには、リレーションシップ名の左側にある「ズーム」ボタンをクリックする必要があります。

- すべての詳細のタブ表示

- cmee.framework.show-as-tabs

- TrueおよびFalseオプションを使用して、アセット詳細をデフォルトで表示するかどうかを切り替えます。

- 図2-10に、このプロパティをTrueに設定した場合の結果を示します。

図2-10 アセット詳細ページ - すべての詳細のタブ表示をTrueに設定した場合

- 図2-11に、このプロパティをFalseに設定した場合の結果を示します。

図2-11 アセット詳細ページ - すべての詳細のタブ表示をFalseに設定した場合

- 長い日付書式の指定

- cmee.server.date.format.long.default

- 完全な日付情報を表示するための日付書式を指定します(yyyy-MM-dd HH:mm:ss z)。

- 短い日付書式の指定

- cmee.server.date.format.short.default

- 省略形の日付情報を表示するための日付書式を指定します(yyyy-MM-dd)。

- 長い日付書式の指定と似ています。

- システム供給リレーションシップの表示

- cmee.show-system-supplied-relationships

- TrueおよびFalseオプションを使用して、アセット・エディタのタブおよびアセット詳細にシステム供給リレーションシップを表示するかどうかを切り替えます。Falseに設定した場合、システム供給リレーションシップはアセット・エディタの「リレーションシップ」タブおよびアセット詳細には表示されなくなりますが、アセット・エディタのリレーションシップの構成ダイアログには引き続き表示されます。
システム供給リレーションシップは、アセットの更新時により複雑な照合を行うためなどに、Oracle Enterprise Repository内のシステム固有のリレーションシップに使用されます。したがって、システム供給リレーションシップは、ユーザーが作成または削除することも、方向を変更することもできず、常に読取り専用になります。

- Webツールにおける非アクティブ・アセット・タイプの非表示

- oracle.gui.assettype.hide.inactive

- Trueに切り替えると、検索結果で非アクティブ・アセット・タイプが非表示になります。

2.5.1.2 検索

プロパティ

- アセット検索の結果の最大数

- cmee.search.assets.maxresults

- テキスト・ボックスに入力される数値により、検索によって返されるアセットの最大数が決定されます。0を入力すると、無制限の数が返されます。

- 検索の保存

- cmee.asset.registry.saved.searches

- TrueおよびFalseオプションを使用して、検索の保存機能を切り替えます。この機能を使用すると、検索基準を保存して再利用できます。
Trueに設定した場合、次の図に示すように、「アセット」画面のサイドバーに「保存済の検索」セクションが表示されます。

図2-12 「保存済の検索」の有効化

- 索引付きフィールドの検索

- cmee.search.general.include.indexedfields

- TrueおよびFalseオプションを使用して、一般アセット検索で索引付きフィールドを対象とするかどうかを切り替えます。

- カテゴリ分けの検索

- cmee.search.general.include.categorizations

- TrueおよびFalseオプションを使用して、一般アセット検索でカテゴリ分けを対象とするかどうかを切り替えます。

- 詳細な検索オプションへのカテゴリ分けのデフォルト表示

- cmee.search.advanced.categorizations.visible

- TrueおよびFalseオプションを使用して、詳細な検索オプション・ダイアログにカテゴリ分けツリーをデフォルトで開いた状態で表示するかどうかを切り替えます。

図2-13に、このプロパティをFalseに設定した場合の結果を示します。

図2-13 詳細な検索オプション - カテゴリ分けツリーを閉じた場合

図2-14に、このプロパティをTrueに設定した場合の結果を示します。

図2-14 詳細な検索オプション - カテゴリ分けツリーを開いた場合

- 特定のフィールドの検索

- cmee.search.specific.field

- TrueおよびFalseオプションを使用して、キーワード・テキスト・ボックスに検索対象フィールドを指定することにより、標準検索で特定のフィールドを検索できるようにするかどうかを切り替えます。
次の図に示すように、文字列description:MyAssetを入力した場合、リポジトリ内のすべてのアセットの「説明」フィールドを対象としてキーワードMyAssetが検索されます。

図2-15 特定のフィールドの検索

- 空検索の確認

- cmee.empty.search.confirm

- TrueおよびFalseオプションを使用して、ユーザーが空白の文字列を検索する際に警告メッセージを表示するかどうかを切り替えます。
Trueに設定すると、警告メッセージが表示されます。

- 検索のロギング

- cmee.log.searches

- TrueおよびFalseオプションを使用して、検索をロギングするかどうかを切り替えます。キーワード検索の検索基準のみがロギング対象となります。

- すべての検索のロギング

- cmee.log.complete.searches

- TrueおよびFalseオプションを使用して、すべての検索基準をロギングするかどうかを切り替えます。すべての検索基準がロギング対象となります。

- ユーザー検索の最小文字数

- cmee.users.min.text.search

- テキスト・ボックスに入力される数値により、ユーザー情報を検索するために必要な最小文字数が決定されます。
最小数に満たない文字数でユーザー検索を実行しようとすると、警告メッセージが表示されます。

- アセンブリ・モデルの表示

- cmee.assembly.model.visibility

- このプロパティをTrueに切り替えると、アセンブリ・モデルをフィルタ処理できるようになります。

2.5.1.3 アセット詳細の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が指定されます。

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

プロパティ

- プロジェクトの有効化

- cmee.projects.enabled

- TrueおよびFalseオプションを使用して、複数プロジェクトをサポートするかどうかを切り替えます。

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

- cmee.projecttool.advanced

- TrueおよびFalseオプションを使用して、ナビゲータおよびプロジェクト階層を含む拡張プロジェクト・オプションを使用するかどうかを切り替えます。

- Microsoft JDKに対するナビゲータ・サポート

- cmee.navigator.force-msjdk-support

- TrueおよびFalseオプションを使用して、MicrosoftのInternet Explorer用アプレット・プラグインと互換性のある代替ナビゲータ・アプレットを使用するかどうかを切り替えます。

- ユーザー定義プロジェクト

- cmee.extraction.user-projects.enable

- TrueおよびFalseオプションを使用して、アセットの使用/ダウンロード・プロセスでユーザーが即座にプロジェクトを作成できるようにするかどうかを切り替えます。

図2-16に、このプロパティをTrueに設定した場合の結果を示します。

図2-16 ユーザー定義プロジェクトをTrueに設定した場合の使用/ダウンロード

図2-17に、このプロパティをFalseに設定した場合の結果を示します。

図2-17 ユーザー定義プロジェクトをFalseに設定した場合の使用/ダウンロード

- ユーザー定義プロジェクト - 接頭辞

- cmee.extraction.user-projects.prefix

- プロパティ・テキスト・ボックスに入力されるテキストが、ユーザー定義プロジェクトの接頭辞になります。これはレポート内での視覚的なグループ化に役立ちます。(ユーザー定義プロジェクトの有効化が必要です。)

- 作成するプロジェクト

- cmee.project.producing.enabled

- TrueおよびFalseオプションを使用して、アセットの発行ダイアログに作成するプロジェクト・セクションを表示するかどうかを切り替えます(Oracle Enterprise Repositoryの「アセット」画面でアセットの発行リンクをクリックして標準発行を実行する場合)。

図2-18に、このプロパティをTrueに設定した場合の結果を示します。

図2-18 アセットの発行 - 作成するプロジェクト・セクションを表示した場合

図2-19に、このプロパティをFalseに設定した場合の結果を示します。

図2-19 アセットの発行 - 作成するプロジェクト・セクションを非表示にした場合

- 拡張プロジェクト・オプション - カテゴリ分け

- cmee.projecttool.categorizations

- TrueおよびFalseオプションを使用して、プロジェクトにカテゴリ分けを割り当てるかどうかを切り替えます。

- プロジェクトのレポートされたアセット価値の有効化

- cmee.projecttool.assetvalue.enabled

- TrueおよびFalseオプションを使用して、プロジェクトのレポートされたアセット価値のメトリックを使用するかどうかを切り替えます。

2.5.1.5 進行中のアセット

プロパティ

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

- cmee.asset.in-progress.visible

- Trueを選択した場合、アセット・エディタ以外で進行中のアセットを参照できるようになります。

2.5.1.6 ポリシー管理

プロパティ

- コンプライアンス・テンプレートの有効化

- cmee.compliance-template.enable

- コンプライアンス・テンプレート・システムを有効にします。

- アセット・ポリシーの有効化

- cmee.asset-policy.enable

- ポリシー管理システムを有効にします。

- ポリシー・アサーションを閉じる

- cmee.asset-policy.collapse.assertions

- 適用されているポリシーをアセット詳細に表示するときにアサーションの表示をデフォルトで閉じます。

- アセット・ポリシー・リレーションシップ

- cmee.asset-policy.relationship

- ポリシーの割当てに使用するシステム内のリレーションシップ・タイプを定義します。双方向、並び順リレーションシップを使用する必要があります。

2.5.1.7 通知

プロパティ

- アセット使用通知

- cmee.extraction.notify-maintainer

- TrueおよびFalseオプションを使用して、アセットが使用された場合に、そのアセットに対してリストされている通知アドレスに電子メールが自動的に送信されるようにするかどうかを切り替えます。

- 電子メールの送信時には、次のアルゴリズムを使用して宛先アドレスが決定されます。

- アセットに通知アドレスがある場合はこれを電子メール宛先として使用します。

- これが該当しない場合、システム設定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

- ユーザーがアセットをダウンロードしてから、「ステータスの更新」フォームへの入力を求めるリマインダを送信するまでの日数を示す数値をテキスト・ボックスに入力します。図2-20を参照してください。

図2-20 ステータスの更新

- リマインダ遅延 - 後続

- cmee.extraction.subsequent.delay

- 初回の使用ステータス・リマインダ・メッセージを送信してから、後続のリマインダを送信するまでの日数を示す数値をテキスト・ボックスに入力します。

2.5.1.8 アクセス制御

プロパティ

- カスタム・アクセス設定

- cmee.customaccesssettings.enabled

- 拡張カスタム・アクセス設定を有効にします。

- アセットに対するカスタム・アクセス設定

- cmee.customaccesssettings.asset

- アセットに対する拡張カスタム・アクセス設定を有効にします。

- ファイルに対するカスタム・アクセス設定

- cmee.customaccesssettings.file

- ファイルに対するカスタム・アクセス設定を有効にします。

- すべての権限の切替え機能

- cmee.security.gui.toggleall

- GUIコントロールを有効にし、管理者が一度に1つのロールのすべての権限を切り替えられるようにします。

2.5.1.9 Software File Identification (SFID)

プロパティ

- 使用状況の自動検出の有効化

- cmee.usagedetection.enable

- SFIDを管理し、可能な使用状況を自動的に検出するための使用状況の自動検出プラグインを有効にします。

- 未認識SFIDの収集の有効化

- cmee.sfid.harvesting.enable

- 検出されたSFIDがシステムにまだ登録されていない場合にそのSFIDに関する情報が収集されるようにします。

2.5.1.10 使用 - ダウンロード

プロパティ

- アセット使用カスタム・ファイル

- cmee.extraction.export.filename

- アセット・ダウンロード・ペインでファイル名を入力してカスタム・アセット・メタデータ・フィールドを保存します。

- アセット使用カスタム・フィールド・リスト

- cmee.extraction.exported-custom-field.

- この固有設定を使用すると、カスタム・アセット使用フィールドを作成できます。

注意:
このプロパティは末尾にピリオドが付いています。「検索」フィールドにこのプロパティを入力する際には、プロパティとともにピリオドを入力してください。

カスタム使用フィールドの作成

1. 新しいシステム設定の有効化ボックスにプロパティ名を入力し、[Enter]を押します。

2. 必要に応じて、「追加」をクリックして追加のテキスト・ボックスを開きます。

図2-21 使用 - ダウンロード

3. 追加の各カスタム使用フィールドの名前をそれぞれ対応するテキスト・ボックスに入力します。

4. 完了後、「保存」をクリックします。新しいカスタム使用フィールドが使用 - ダウンロード・ダイアログに表示されます。

図2-22 カスタム・フィールドが追加された使用 - ダウンロード

2.5.1.11 カスタム・リンク

この設定グループを使用すると、Oracle Enterprise Repositoryのメニュー・バーの右側に表示されるカスタム・リンクの構成および表示を制御できます。

プロパティ

- カスタム・リンク1

- cmee.tool.show-marketplace

- TrueおよびFalseオプションを使用して、カスタム・リンク1を表示するかどうかを切り替えます。

図2-23 カスタム・リンク

図2-24 カスタム・リンク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のヘルプ・ファイルはデフォルトではリモートでホストされています。必要な場合は、ヘルプ・ファイルをローカル環境でホストできます。その場合、ヘルプ・ファイルの場所が反映されるようにこの設定を変更します。

2.5.1.12 レポート

プロパティ

- レポートの有効化

- oracle.reports.enabled

- レポート機能を有効にするかどうかを指定します。

- レポート・サーバーURL

- oracle.reports.server.url

- レポート・サーバー・リンクのカスタムURLを指定します。

- レポート・サーバー・エンドポイントURL

- oracle.reports.server.endpoint.url

- レポート・サーバーに対して認証するWebサービス・エンドポイントのカスタムURLを指定します。

- レポート・サーバー・ユーザー名

- oracle.reports.server.username

- レポート・サーバーに対するユーザー名資格証明を指定します。

- レポート・サーバー・パスワード

- oracle.reports.server.password

- レポート・サーバーに対するパスワード資格証明を指定します。

- レポートのExcel出力の有効化

- oracle.reports.excel.enable

- レポートのExcel出力を有効にします。

2.5.1.13 その他

プロパティ

- アセット発行のファイル要件

- cmee.submission.file.required.enable

- 有効にした場合、標準アセット発行を実行するユーザーは、ファイルの場所を示すURLを指定するか、ファイルをアップロードする必要があります。

- コンシューマ調査

- cmee.extraction.consumer-survey.enable

- TrueおよびFalseオプションを使用して、全アセット使用の調査の更新を表示するかどうかを切り替えます。この調査は、My Stuffページのアセット使用セクションに表示されるアセットを対象としています。
Trueに設定した場合、図2-25に示すように、完全な調査が表示されます。

図2-25 ステータスの更新 - コンシューマ調査プロパティをTrueに設定した場合

Falseに設定した場合、図2-26に示すように、「ステータス」リストのみが表示されます。

図2-26 ステータスの更新 - コンシューマ調査プロパティをFalseに設定した場合

- デフォルトの使用拒否理由

- cmee.default.usage.rejection.reason

- リストを使用して、デフォルトのアセット拒否理由を選択します。My Stuffセクションでのアセット使用ステータスの更新時にアセットが拒否されると、この理由が記録されます。選択可能なオプションは、要件に不適合、テクノロジが未成熟、非互換性、ドキュメントが不十分、法律/ライセンス、「パフォーマンス」、プロジェクトのタイミング、「信頼性」、調査のみ、「リスク」、「スケーラビリティ」、システム・リソース要件、およびユーザビリティです。

- タイプ・マネージャの有効化

- cmee.typemanager.enabled

- TrueおよびFalseオプションを使用して、タイプ・マネージャを表示するかどうかを切り替えます。
Trueに設定した場合、アセット・エディタでタイプの管理を選択したときにタイプ・マネージャが表示されます。Falseに設定した場合、タイプ・マネージャは表示されません。

- Microsoft Excelスプレッドシートへのアセットのエクスポート

- cmee.asset.registry.export.excel

- TrueおよびFalseオプションを使用して、アセット詳細情報を外部のMicrosoft Excelスプレッドシートにエクスポートできるようにするかどうかを切り替えます。

Trueに設定した場合、図2-27に示すようにアセット検索結果フレームに「Excelにエクスポート」メニュー選択項目が表示され、アセット詳細にExcelボタンが表示されます。

図2-27 検索結果内の「Excelにエクスポート」

このプロパティをFalseに設定した場合、メニュー選択項目およびボタンは表示されません。

アフィニティ設定

Oracle Enterprise Repositoryのコンテキスト内では、アフィニティは、2つ以上のアセットが同じプロジェクトにデプロイされる場合に生じる条件になります。アフィニティ要素は、この条件を満たす各アセットのアセット詳細に表示され、(デプロイされた)共通のプロジェクトが存在する他のアセットをリストします。

次のアフィニティ・システム設定を使用して、アフィニティ要素とそのコンテンツの特定の動作を決定します。

- アフィニティしきい値

- cmee.assettab.affinity.threshold

- アフィニティ一致件数がこの設定で入力した数値を超えた場合は、アセット詳細でそのアフィニティ要素にすべてのアフィニティ・アセットの表示リンクが表示されます。

- アフィニティ最小プロジェクト数

- cmee.assettab.affinity.minimum

- このフィールドに入力される数値により、アセットをアセット詳細ページの「アフィニティ」セクションに表示するために含める必要がある、プロジェクトの最小数が決定されます。

アセットを使用したプロジェクトの数が指定の数値に満たない場合、アフィニティ要素により、表示基準が満たされなかったことが示されます。

2.5.2 サーバー設定

この項には次のトピックが含まれます:

- 2.5.2.1項「一般」

- 2.5.2.2項「サーバー・リソース」

- 2.5.2.3項「電子メール」

- 2.5.2.4項「アップロード領域」

- 2.5.2.5項「監査」

- 2.5.2.6項「キャッシュ」

2.5.2.1 一般

- 管理ロール

- enterprise.security.roletype.admin

- このボックスに入力されるテキストは、Oracle Enterprise Repository内で無制限の管理者権限を持つロールに適用される名前を指定します。

- アセット・エディタでのアセット説明内の埋込みHTMLの有効化

- cmee.asseteditor.enable-embedded-html-asset-description

- Trueに設定した場合、埋込みHTMLをアセットの説明に入力できるようになります。

- 会社名

- cmee.enterprisetab.homepageselection.enabled

- TrueおよびFalseオプションを使用して、ユーザー・ロールまたは部門の割当てに基づいて特定のホームページを割り当てるかどうかを切り替えます。

Trueに設定した場合、ユーザー・ロールまたは部門に基づいて特定のホームページが割り当てられます。Falseに設定した場合、デフォルトのホームページが表示されます。

- ホームページ選択の有効化

- cmee.server.companyname

- 会社の名前をテキスト・ボックスに入力します。

- ホームページ

- cmee.enterprisetab.homepage

- デフォルトのURLはデフォルトのOracle Enterprise Repositoryのホームページを指し、メイン・フレーム(右側)に表示されます。

図2-28 デフォルトのOracle Enterprise Repositoryのホームページ

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オプションを使用して、ユーザーが「受入れ」、「発行」または「登録」をクリックしたときのツリーの自動リフレッシュを無効にするかどうかを切り替えます。

2.5.2.2 サーバー・リソース

プロパティ

- データベース接続名

- 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

- Webサーバー上のJNLPツールjarの格納場所を指すファイル・パスです。Java Web Startの互換性の問題により、このパスでSSL対応サービスを指すことはできません。

- WebApp JSPパス

- cmee.server.paths.jsp

- アプリケーション・サーバー上のJSPの格納場所を指すファイル・パスです。

- WebAppサーブレット・パス

- cmee.server.paths.servlet

- アプリケーション・サーバー上の製品サーブレットの格納場所を指すファイル・パスです。

- アセット詳細パス

- cmee.assettab.asset-detail-page

- 統合によるアセット詳細のロードに使用されるアプリケーション・サーバー・パスです。

2.5.2.3 電子メール

プロパティ

- 配信リストの電子メールの許可

- cmee.email.cc

- TrueおよびFalseオプションを使用して、電子メール配信リスト機能を使用できるようにするかどうかを切り替えます。これにより、ユーザーが配信リストを作成できるようになり、そのリスト内のメンバーは、アセット登録プロセスの一環として送信される特定の電子メール通知にCCとして自動的に追加されます。

- 配信リストでの外部電子メールの許可

- 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オプションを使用して、内部での情報提供のみを目的としてオラクルに月次の診断電子メールを自動的に送信するかどうかを切り替えます。

2.5.2.4 アップロード領域

プロパティ

- 発行アップロード・ディレクトリ

- cmee.server.paths.upload

- HTTPファイル・アップロード・プロセスから直接アプリケーション・サーバー上にファイルをアップロードするために、ローカルで参照されるオペレーティング・システム・パスを定義します。このプロパティにより、次の機能が有効になります。

- アセットの発行フォームの今すぐ添付ファイルを追加オプションが有効になります。(発行プロセスでアセットにファイルを添付する場合に必要です。)

- アセット・エディタのアップロードされた発行ファイル・オプションが有効になります。

- レジストラ発行アップロード・パス

- cmee.server.paths.upload-registrar

- アセット・エディタによるファイル参照が有効になります(オプション)。

- パス(UNCによってホストされる場合)には、Windows OSまたはSamba/Sharityが必要です。

- アセット・エディタのアップロードされた発行ファイルで「参照」ボタンの表示が有効になります。

- 発行アップロード用のアーティファクト・ストア

- cmee.server.paths.upload-repository

- 構成済アーティファクト・ストアを設定して、発行されたファイルへの直接的なパブリック・アクセスを許可します。このプロパティは、アセット・エディタでの発行済ファイルの1ステップ受入れに使用されます。このプロパティを設定すると、次のようになります。

- 使用およびダウンロード可能なアセット・ファイルが表示されます。

- アセット・エディタのアップロードされた発行ファイル・セクションに「受入れ」ボタンが表示されます。

2.5.2.5 監査

プロパティ

- アセット保存エクスポート・ファイル名

- cmee.asset.logging.filenamep

- テキスト・ボックスに入力されるテキストにより、アセット・データの保存時に常に使用するファイル名が指定されます(アーカイブおよび監査用)。

- アセット保存エクスポートのエラーによる失敗

- cmee.asset.logging.failonerror

- Trueオプションを選択した場合、なんらかの理由でアセット・エクスポート・ファイル名に書き込めない場合に監査の保存が中止されます。

2.5.2.6 キャッシュ

プロパティ

- 起動時のアセット・キャッシュの事前ロード

- cmee.assets.preload.at-startup

- Trueオプションを選択した場合、アプリケーション・サーバーの起動時にアセット・キャッシュが事前ロードされます。
Trueに設定した場合、アセット・キャッシュが事前ロードされます。

- 別スレッドとしてのアセット・キャッシュの事前ロード

- cmee.assets.preload.as-seperate-thread

- Trueオプションを選択した場合、アプリケーション・サーバーの起動時に事前ロードされたアセット・キャッシュが別スレッドとして扱われます。

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

この項には次のトピックが含まれます:

- 2.5.3.1項「一般」

- 2.5.3.2項「認証トークン」

- 2.5.3.3項「パスワード設定」

- 2.5.3.4項「プラグイン・ログイン設定」

- 2.5.3.5項「LDAPおよびActive Directory設定」

- 2.5.3.6項「シングル・サインオン(SSO)設定」

- 2.5.3.7項「コンテナ・ログイン設定」

2.5.3.1 一般

プロパティ

- 非承認ユーザーのログイン

- enterprise.security.unapproveduser.allowlogin

- TrueおよびFalseオプションを使用して、非承認ユーザーがシステムにログインできるようにするかどうかを切り替えます。これは、LDAPまたはコンテナ管理の認証を使用する場合に役立ちます。

- ログイン・ポップアップの表示

- enterprise.security.showloginpopup

- TrueおよびFalseオプションを使用して、Oracle Enterprise Repositoryのログイン・ダイアログをデフォルトで表示するかどうかを切り替えます。このダイアログによりユーザーを識別し、ログイン情報を表示します。

- 失敗したログイン試行の最大回数

- enterprise.security.loginattempt.max

- テキスト・ボックスに入力される数値エントリにより、ユーザーのロックアウト基準となる、失敗したログイン試行の最大回数が決定されます。0以下の値を入力した場合、ロックアウトは無効になります。図2-29に、ロックアウトされていることをユーザーに通知するメッセージを示します。

図2-29 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.container.synchroles.enabled

- Trueオプションを選択した場合、コンテナ・ロールの同期が有効になります。

- 拡張コンテナ・ログインの有効化

- enterprise.authentication.advancedcontainer.enabled

- Trueオプションを選択した場合、認証用に拡張コンテナ・ログイン・モジュールが有効になります。

- デフォルトの電子メール接尾辞

- enterprise.defaults.email.suffix

- デフォルトの電子メール・アドレスを決定するためにユーザー名に追加される接尾辞です。

- 新規非承認ユーザーに関する通知

- cmee.new.unapproved.users.notify

- TrueおよびFalseオプションを使用して、LDAP、Java EEコンテナなどの外部認証を介して新規ユーザーが作成された場合に、セキュリティ管理者に自動的に電子メールを送信するかどうかを切り替えます。

2.5.3.2 認証トークン

プロパティ

- 認証トークンの有効期限

- enterprise.defaults.authtokens.expiration.value

- テキスト・ボックスに入力される数値により、認証トークンを有効期限切れおよびパージ対象として扱うまでの期間が決定されます(単位は、認証トークンの有効期限の単位メニュー選択項目で決定されます)。

- 認証トークンの有効期限の単位

- enterprise.defaults.authtokens.expiration.period

- リストを使用して、認証トークンの有効期限設定と一緒に使用する時間単位を選択します。選択可能なオプションは、「分」、「時間」および「日」です。

- 有効期限切れ認証トークンのパージ頻度

- enterprise.defaults.authtokens.purgefrequency.value

- テキスト・ボックスに入力される数値により、有効期限切れ認証トークンのパージ間隔が決定されます(単位は、有効期限切れ認証トークンのパージ頻度の単位メニュー選択項目で決定されます)。

- 有効期限切れ認証トークンのパージ頻度の単位

- enterprise.defaults.authtokens.purgefrequency.period

- リストを使用して、有効期限切れ認証トークンのパージ頻度設定と一緒に使用する時間単位を選択します。

2.5.3.3 パスワード設定

プロパティ

- パスワード - 最小長

- 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

- テキスト・ボックスに入力される数値により、現行パスワードのパスワード履歴への追加が許可されるまでの最小時間数が決定されます。この機能は、パスワードを何度も変更してパスワード履歴を逃れようとする行為を防止するのに役立ちます。

2.5.3.4 プラグイン・ログイン設定

プロパティ

- プラグイン・ログイン・モジュール・クラス名

- enterprise.loginmodules.pluggableloginmodule.classname

- テキスト・ボックスに入力されるテキストにより、プラグイン・ログイン・モジュールのクラス名が指定されます。
必要に応じて、「+追加」をクリックして、別のプラグイン・ログイン・モジュールのクラス名を追加します。

- プラグイン・ログイン・モジュール表示名

- enterprise.loginmodules.pluggableloginmodule.displayname

- テキスト・ボックスに入力されるテキストは、プラグイン・ログイン・モジュールの表示名として表示されます。
必要に応じて、「+追加」をクリックして、別のプラグイン・モジュールの表示名を追加します。

- プラグイン・ログイン・モジュール

- enterprise.loginmodules.pluggableloginmodule.enabled

- プラグイン・ログイン・モジュールを有効にするには、テキスト・ボックスにtrueと入力します。
必要に応じて、「+追加」をクリックして、別のプラグイン・モジュールを追加して有効または無効にします。

- プラグイン・ログイン・モジュール - 内部チェック

- enterprise.loginmodules.pluggableloginmodule.internalchecking

- 構成済のプラグイン・ログイン・モジュールに対してパスワードの有効期限と猶予期間ログインの内部チェックを有効にするには、trueと入力します。
LDAPベース、SSOベース、コンテナ管理またはその他の外部ログイン・モジュールを使用して、これらのタイプのチェックを外部認証システムに委任するには、テキスト・ボックスにfalseと入力します。

必要に応じて、「+追加」をクリックして、別のプラグイン・モジュールを追加してその内部チェックを有効または無効にします。

2.5.3.5 LDAPおよびActive Directory設定

プロパティ

- 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の場合、バインドDNを設定する必要があります。デフォルトは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

- このフィールドは必須です。このプロパティのテキストは、使用するブリッジのクラス名を表します。

2.5.3.6 シングル・サインオン(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

- Trueオプションを選択した場合、ユーザーのブラウザに現在保存されているすべてのCookieがアセット・エディタ用のJava Web Startに渡されます。

- 認可ヘッダーの抑制 - JWS

- cmee.jws.suppress-authorization-header

- Trueオプションを選択した場合、JWSによって起動されたユーティリティによる認可ヘッダーの伝播が抑制されます。

2.5.3.7 コンテナ・ログイン設定

プロパティ

- フォールバック認証

- enterprise.loginmodules.fallbackauthentication

- フォールバック認証を有効にします。

- コンテナ・ログイン・モジュール・クラス名

- enterprise.loginmodules.containerloginmodule.classname

- テキスト・ボックスに入力されるテキストにより、コンテナ・ログイン・モジュールのクラス名が指定されます。

- コンテナ・ログイン・モジュール表示名

- enterprise.loginmodules.containerloginmodule.displayname

- テキスト・ボックスに入力されるテキストは、コンテナ・ログイン・モジュールの表示名として表示されます。

- コンテナ・ログイン・モジュール

- enterprise.loginmodules.containerloginmodule.enabled

- Trueオプションを選択した場合、コンテナ・ログイン・モジュールが有効になります。

- コンテナ・ログイン・モジュール - 内部チェック

- enterprise.loginmodules.containerloginmodule.internalchecking

- Trueオプションを選択した場合、コンテナ・ログイン・モジュールの内部チェックが有効になります。

2.5.4 オープンAPI設定

この項では、次のオープンAPI設定について説明します。

2.5.4.1 オープンAPI

プロパティ

- オープンAPI

- cmee.extframework.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

- 一時エクスポート・ファイルのパスです。

- REXAPI SSLトラストストア

- rexapi.ssl.trustStore

- REX APIでSSL接続を確立するために使用される信頼できるキーストアのパスです。

- REXAPI SSLトラストストア・パスワード

- rexapi.ssl.trustStorePassword

- REX APIでSSL接続を確立するために使用される信頼できるキーストアのパスワードです。

- REXAPI SSLキーストア

- rexapi.ssl.keyStore

- REX APIでSSL接続を確立するために使用されるキーストアのパスです。

- REXAPI SSLキーストア・パスワード

- rexapi.ssl.keyStorePassword

- REX APIでSSL接続を確立するために使用されるキーストアのパスワードです。

注意:
REXオープンAPIの詳細は、『Oracle Fusion Middleware Oracle Enterprise Repository開発者ガイド』のRepository Extensibility Framework に関する項を参照してください。

2.5.5 外部統合設定

この項には次のトピックが含まれます:

- 2.5.5.1項「UDDI」

- 2.5.5.2項「ファイル・ストア」

- 2.5.5.3項「Rational ClearCase」

- 2.5.5.4項「イベント」

2.5.5.1 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

- Trueオプションを選択した場合、Oracle Enterprise Repositoryが選択したアプリケーションのUDDIレジストリとして機能するようになります。

- インポート - デフォルトのUDDIサービス・タイプ

- cmee.import.uddi.service.assettype

- リストを使用して、インポートしたUDDIサービスに割り当てるデフォルトのアセット・タイプを指定します。

2.5.5.2 ファイル・ストア

プロパティ

- 拡張アクセス・ファイル・ストア

- registry.advanced.filestores.enabled

- Trueオプションを選択した場合、拡張ファイル・ストア・オプションが設定されます。

2.5.5.3 Rational ClearCase

プロパティ

- 構成の仕様

- cmee.config-spec.enabled

- Trueオプションを選択した場合、構成の仕様ファイルをアセットにアタッチできるようになります。

2.5.5.4 イベント

プロパティ

- Event Managerの有効化

- cmee.eventframework.enabled

- Trueオプションを選択した場合、拡張登録フロー・サブシステムが有効になります。

- イベント・マネージャの通知サービス・スレッド・スリープ(秒)

- cmee.eventframework.notifier.sleep

- 通知サービスが、エンドポイントが使用できない場合にどのくらいの時間(秒単位)待機した後にイベントの送信を試みるかを指定します。

- イベント・マネージャのストア・スレッド・スリープ(秒)

- cmee.eventframework.store.sleep

- イベント・マネージャのストア・マネージャ・スレッドがどのくらいの時間(秒単位)スリープした後に、メモリー内の次に使用可能なイベントをポーリングするかを指定します。

- イベント・マネージャの配信スレッド・スリープ(秒)

- cmee.eventframework.delivery.sleep

- イベント・マネージャの配信マネージャ・スレッドがどのくらいの時間(秒単位)スリープした後に、JMSサーバーに対して次に使用可能なイベントを選択するかを指定します。

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

この項には次のトピックが含まれます:

- 2.5.6.1項「インポート/エクスポート」

- 2.5.6.2項「WSDLおよびXSD」

2.5.6.1 インポート/エクスポート

プロパティ

- インポート/エクスポート・クライアント

- 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

- テキスト・フィールドに入力される値は、作成された一時ファイルの格納先ディレクトリを表します。これらのファイルは使用後にクリーンアップされます。

2.5.6.2 WSDLおよびXSD

プロパティ

- WSDLイントロスペクション要素の有効化

- cmee.wsdl-introspection.enabled

- Trueオプションを選択した場合、WSDLサマリー情報を示すアセット詳細プラグイン要素が有効になります。

2.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を参照する必要があります。

3 Oracle Enterprise Repositoryのカスタマイズ

この章では、組織のOracle Enterprise Repositoryのホームページおよびその他のインタフェースのカスタマイズについて説明します。

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

- 3.1項「概要」

- 3.2項「Oracle Enterprise Repositoryの再ブランド設定」

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

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

3.1 概要

組織は、Oracle Enterprise Repositoryのルック・アンド・フィールをカスタマイズできます。Oracle Enterprise Repositoryのカラー・パレットを変更できます。加えて、Oracle Enterprise Repositoryのホームページをロール別または部門別にカスタマイズできます。これにより、組織はガバナンスおよび特定のアセットをOracle Enterprise Repositoryユーザーのサブセットにプロモートできます。

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

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

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

3.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. ログイン画面で、「ユーザー名」ボックスと「パスワード」ボックスに適切な情報を入力します。

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

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

注意:
OERインストールがファイアウォールで保護されている場合、OERのホームページを表示するには、ブラウザでプロキシを設定する必要がある場合があります。

3.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がインストールされているアプリケーション・サーバーによって異なります。

3.2 Oracle Enterprise Repositoryの再ブランド設定

この項では、Oracle Enterprise Repositoryを再ブランド設定する方法およびOracle Enterprise Repositoryでスキンをカスタマイズする方法について説明します。内容は次のとおりです。

- 3.2.1項「CSSからの開始」

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

3.2.1 CSSからの開始

Oracle Enterprise Repositoryでは、アプリケーションの色およびその他の視覚的な側面を制御するために編集できるCSS (カスケード・スタイルシート)が使用されます。Oracle Enterprise Repositoryは、大部分がニュートラルのカラー・パレット上に構築されており、単一色を中心にブランド設定されます。図3-1に示すように、CSSから色や書体を編集できます。

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

Oracle Enterprise Repositoryには、次のスキンが用意されています。

- 青 -- #0066CC

- 緑 -- #669933

- ニュートラル -- #999999

Oracle Enterprise Repositoryには、デフォルトとしてOracleスキンが用意されています。

スキンには次の色も含まれています。

- 白 -- #FFFFFF

- 灰色 -- #EEEEEE

3.2.2 スキンのカスタマイズ

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

- 3.2.2.1項「スキンの選択」

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

- 3.2.2.3項「イメージ」

- 3.2.2.4項「カスタム・スキンのアクティブ化」

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

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

3.2.2.1 スキンの選択

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

3.2.2.2 スキンの作成

Oracle Enterprise Repository用に独自のカスタム・スキンを作成する場合は、そのスキン用の新しいフォルダを作成してskinsフォルダに追加する必要があります。既存のスキン・フォルダをコピーして名前を変更する方法をお薦めします。Oracleでは、Oracle Enterprise Repositoryのインタフェースを単一色を中心に設計しています。推奨されるベスト・プラクティスは、新しいスキンのカラー・パレットを、Oracle Enterprise Repositoryで用意されているデフォルトのパレットと同様の中間色調の範囲にすることです。

CSSを新しい色で更新するには、置換対象の色の16進数を検索し、置換します。たとえば、青のスキンをコピーした場合は、0066CCを新しい色に置き換えます。これをsettings.cssファイルとstyle.cssファイルに対して行います。次のCSSファイルが<OER_home>/applications/oer/oer-web/skins/blueディレクトリにあります。

- settings.css

- style.css

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

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

3.2.2.3 イメージ

デフォルトのイメージを更新することで、再ブランド設定を完了できます。イメージは2つの異なる場所に格納されますが、パスは同じに見えます。ベスト・プラクティスとして、新しいイメージは置換対象のイメージと同じサイズ(幅と高さ)にします。次のイメージが<OER_home>/applications/oer/oer/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および他のフォルダもあります。

3.2.2.4 カスタム・スキンのアクティブ化

ここまでの手順を完了すると、skinsフォルダのデフォルトのスキンのいずれかに非常によく似たカスタム・スキンが作成されます。最後の手順では、新しいスキンの新しいskin.propertiesファイルを作成します。これを行うには、既存のskin.propertiesファイルをコピーして編集します。このプロパティ・ファイルには、編集が必要な2つの項目(名前および色の値)があります。

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

- 16進の色の値を、新しいスキンのパレット内の色の値に置き換えます。

これらの変更を行った後、サーバーを再起動することで新しいスキンがアクティブになります。

3.2.2.5 Oracleが提供するカスタム・スキンのOracle Enterprise Repositoryへのインストール

Oracleが提供するカスタム・スキンをインストールするには、次の手順を実行します。

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

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

3. Oracle Enterprise Repositoryの既存の<FMW_home>/user_projects/domains/oer/config-oer/skin.propertiesファイルのバックアップ・コピーを作成します。

4. 新しいskin.propertiesファイルを、カスタム・スキンのZIPアーカイブから<FMW_home>/user_projects/domains/oer/config-oer/ディレクトリにコピーします。

5. イメージとCSSファイルを含む抽出カスタム・スキン・ディレクトリを、<OER_home>/applications/oer/oer/oer-web/skins/ディレクトリに移動します。skin.propertiesファイルは、スキンのリソースを検索するためにこのディレクトリを指します。

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

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

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

- 「スキンの新規作成」

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

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

- 「css」

- 「image」

スキンの新規作成

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

1. /skinsの下にyour_skins_folderを作成します。

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

3. エントリskins.org.nameがyour_skins_folderを反映するようにskins.propertiesファイルを編集します。

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

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

CSSおよびイメージの参照が適切な/skinsフォルダを指すように、skintagsカスタム・タグ・ライブラリが使用されます。現在は、cssおよびimageという2つのスキン・タグがあります。既存のJSPは更新されています。新しいJSPはskintagsライブラリを使用する必要があります。

skintagsライブラリのタグの使用

スキン・タグのいずれかを使用するには、JSPに次のものを追加する必要があります。

<%@ taglib uri="/skintags" prefix="skin" %>

(JSP内のみでの参照であるため、prefixは任意のものを使用できます)。

CSS

カスケード・スタイルシートのタグは、次の例のようになります。

<skin:css element='the_relative_path_to_the_style_sheet'/>

スタイルシートでの使用方法:

<LINK HREF="" REL="stylesheet" TYPE="text/css">

image

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ファイルで定義されているように、skinフォルダから始まります。)

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

この機能により、ユーザー・ロールまたは部門の割当てに基づいて特定のホームページが表示されます。この節では、次のトピックについて説明します。

- 3.3.1項「インストール」

3.3.1 インストール

Oracle Enterprise Repositoryのホームページをロール別または部門別にカスタマイズできます。次のステップを実行します:

1. homepages.xmlという名前のファイルを作成します。例3-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ファイルの内容によって定義されます。

例3-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ファイルもcustomディレクトリにあります。

- 順序が重要です。複数の部門で複数のロールまたはメンバーシップを持つユーザーは、最初に一致した選択に設定されます。

- 行7

- 選択基準のいずれにも該当しないユーザーのデフォルトのホームページを示します。

注意:
homepages.xmlの構成後、カスタムjspへのリダイレクトで「404 Not found」エラーが表示される場合は、<domain directory>/servers/<server name>/tmpフォルダ内にキャッシュされているデータをすべての削除し、再デプロイします。

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

この項では、ベース・データパックおよびHarvester Solution Packのインストール手順について説明します。

ベース・データパック

ベース・データパックは、Oracle Enterprise Repositoryデータベース・インストールの一部としてインストールされます。ベース・データは、他の方法では入手できません。Oracle Enterprise Repositoryの1つのバージョンから次のバージョンへのアップグレードでは提供されません。

ベース・データの一部として提供されるアセット・タイプは、主にテンプレートとみなされます。新しいアセット・タイプを作成するには、すでに存在するものをクローニングします。これらのアセット・タイプに2つのベスト・プラクティスを適用することをお薦めします。

1. ベース・データのアセット・タイプは、新しいOracle Enterprise Repositoryアプリケーションに固有のアセット・タイプを少なくとも1つ作成するまでは削除しないでください。

2. ベース・アセット・タイプを拡張する必要がある場合は、そのベース・アセット・タイプを変更することをお薦めします。Oracleが提供するタイプは様々なアセット・モデルで使用され、今後のOracleモデルへの確実な移行のために必要です。

3. ソリューション・パックで提供されるアセット・タイプを拡張する必要がある場合は、ソリューション・パックで提供される要素をタイプから削除しないことが重要です。推奨事項は次のとおりです。

- エディタの場合: Deprecationなどの名前の新しいタブを作成し、その新しいタブに要素を移動します。

- ビューアの場合: 要素は非表示要素という名前のセクションに移動されます。

Harvester Solution Pack

ハーベスタは12.1.3.0.0-OER-Harvester-Solution-Pack.zipに含まれていますが、これはOracle Enterprise Repositoryインストールとバンドルされています。

Harvester Solution Packをインストールするには、インポート/エクスポート・ツールを使用する必要があります。このツールは、Oracle Enterprise Repositoryの「管理」タブから、インポート・エクスポート・オプションで使用できます。Harvester Solution Packの一部として提供されるアセット・タイプは、ハーベスタ・ツールで必要です。インポート/エクスポート・ツールの詳細は、第5章「インポート・エクスポート・ツール」を参照してください。

契約管理ソリューション・パック

契約管理ソリューション・パックは、Oracle Enterprise Repositoryインストールとバンドルされています。

契約管理ソリューション・パックをインストールするには、インポート/エクスポート・ツールを使用する必要があります。このツールは、Oracle Enterprise Repositoryの「管理」タブから、インポート・エクスポート・オプションで使用できます。インポート/エクスポート・ツールの詳細は、第5章「インポート・エクスポート・ツール」を参照してください。

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

この章では、電子メール通知およびテンプレートを構成し、配信リストを管理する方法について説明します。

この章の内容は次のとおりです。

- 4.1項「概要」

- 4.2項「電子メール通知の設定」

- 4.3項「電子メール配信リストの管理」

- 4.4項「電子メール・テンプレートの使用」

4.1 概要

Oracle Enterprise Repositoryでは、アセット登録プロセスの様々な参加者への自動電子メールがサポートされています。電子メールはリポジトリ・イベントに基づいて送信されますが、イベントのトリガーがユーザー・インタフェースを介したOERとの相互作用によるか、OER自動ワークフローによるかには関係ありません。自動電子メールは有効または無効にすることができ、これらの電子メールのテンプレートを特定のOERインスタンスに対して構成できます。自動通知および任意のサブスクライバ電子メールの受信者は、OERから送信されてくる電子メールの電子メール配信リストを指定できます。

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

ユーザーは、電子メール配信リストを作成し、アセット登録プロセスの一環として生成される特定の電子メール通知にリスト・メンバーが自動的にコピーされるようにできます。配信リストのメンバーは、リスト所有者がアセットのレビューアまたは承認者として関係するアセット登録イベントについて通知されるため、配信リストはアセット登録ワークフローの自動化に役立ちます。たとえば、リスト所有者が欠席する予定の場合、他の認可ユーザーを電子メール配信リストに追加することによって、アセットのレビューおよび承認の責任を委任できます。

4.2 電子メール通知の設定

新しいバージョンのアセットが作成されたときに電子メール通知を受信するには、電子メール・アドレスを使用してcmee.registrar.emailシステム設定を入力する必要があります。電子メール・アドレスを使用してcmee.registrar.emailシステム設定を更新するには、「管理」ページ、「システム設定」の順に移動します。このシステム設定をまだ有効にしていない場合は、新しいシステム設定の有効化フィールドにcmee.registrar.emailと入力し、「有効化」をクリックして有効にします。設定がすでに存在する場合は、「検索」フィールドにcmee.registrar.emailと入力します。図4-1に示すように、「通知」セクションで、システム・レジストラ電子メール・フィールドに電子メール・アドレスを入力します。「保存」をクリックして設定を保存します。

図4-1 機能設定

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

配信リストは、ユーザーのMy Stuff→「構成オプション」→電子メール通知の管理ページで作成します。既存のOracle Enterprise Repositoryユーザーだけでなく外部電子メール・アドレスを配信リスト用に選択できますが、そのオプションがOracle Enterprise Repository管理者によって許可されている場合のみです。

これらの手順は、図4-2に示すように、My Stuffページの「電子メール通知」セクションで実行します。

図4-2 「電子メール通知」

4.3.1 配信リストの作成

電子メール配信リストを作成するには、次の手順を実行します。

1. 図4-3に示すように、「リストの作成」をクリックして配信リストの更新ダイアログを開きます。

図4-3 配信リストの更新

2. 「リストの作成」をクリックして配信リストの更新ダイアログを開きます。

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

2. 「部門」リストを使用して検索を絞り込みます。

3. 「検索」をクリックします。

検索結果が「検索結果」列のリストに表示されます。

3. 矢印ボタンを使用して「検索結果」列から「選択したユーザー」列にユーザーを移動することで、配信リストにユーザーを追加します。どちらかの列のすべてのユーザーを追加または削除するには、「すべて >>」および「すべて <<」ボタンを使用します。

注意:
配信リストに含めることができるメンバー数は最大で20です。

4. 外部のユーザーをリストに追加するには、カンマをデリミタとして使用して、追加電子メール・アドレス・ボックスに電子メール・アドレスを入力します。
例: jack@example.com,jill@example.com,jake@example.net

5. 「OK」をクリックして配信リストを保存します。

図4-4 電子メール通知

4.3.2 配信リストの更新

電子メール配信リストを更新するには、次の手順を実行します。

1. 「リストの更新」をクリックして配信リストの更新ダイアログを開きます。

2. 4.3.1項「配信リストの作成」の手順に従って、新しいメンバーを追加するかメンバーを削除します。

3. 「OK」をクリックして配信リストを保存します。

4.3.3 電子メールにリスト・メンバーがコピーされる状況

ユーザーの配信リストのメンバーは、次の通知電子メールで電子メールにコピーされます。

- アセット受入れ

- アセット割当て

- アセット登録

- アセット発行/拒否

- アセット受入れ不可

- アセット割当て解除

- アセット未登録

- アセット未発行

4.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です。

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

「管理」タブの電子メール・テンプレート・セクションで、電子メール通知を構成できます。各電子メール・テンプレートには有効な置換のリストがあり、これらはその特定のテンプレートで使用できます。置換の例として<%asset.name%>があり、これはテンプレートにアセットの名前を移入します。有効な置換のリストは、Oracle Enterprise Repositoryで使用できる30個のテンプレートそれぞれで異なっています。Oracle Enterprise Repositoryで電子メール通知を表示するには、次の手順を実行します。

1. ログイン資格証明を使用して、Oracle Enterprise Repositoryにログインします。Oracle Enterprise Repositoryのホームページが表示されます。

2. 「管理」をクリックします。「管理」ページが表示されます。

3. 「電子メール・テンプレート」をクリックします。図4-5に示すように、電子メール・テンプレートのリストとそのステータスおよび説明が表示されます。

図4-5 電子メール・テンプレートのリスト

4. 任意のテンプレートをクリックして、その電子メール・テンプレートの詳細を下のペインに表示します。たとえば、アセット使用をクリックします。図4-6はアセット使用電子メール・テンプレートを示しており、これはアセットが使用されていることをアセットの通知電子メール・フィールドで指定された連絡先に通知するために送信されます。

図4-6 電子メール・テンプレート - アセット使用

5. 「保存」をクリックします。

6. 同様に、他の電子メール・テンプレートの詳細を表示できます。

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

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

1. 「管理」サイドバーで「電子メール・テンプレート」をクリックします。電子メール・テンプレートのリストがメイン・ペインの上のフレームに表示されます。

図4-7 電子メール・テンプレートのリスト

2. 編集する電子メール・テンプレートをリストから選択します。電子メール・テンプレートの編集画面が下のフレームで開きます。

図4-8 電子メール・テンプレート: 全アセット・タブ承認

3. 「ステータス」リストを使用して、電子メール・メッセージをアクティブにするか、非アクティブにします。

4. 必要に応じて、テンプレート情報を編集します。

編集に関する注意

- 「ステータス」フィールドは「アクティブ」または「非アクティブ」に設定できます。「非アクティブ」の場合、指定したイベントについて電子メール通知は送信されません。「アクティブ」がデフォルトのステータスです。

- 置換は、件名、メッセージおよびメール送信者電子メール・アドレス内に配置できる動的変数です。通知が送信されるときに、これらの変数は適切な値に置き換えられます。次の例は、アセットの名前の置換を入力する構文を示しています。
<%asset.name%>というアセットを発行しました

電子メール・テンプレート画面には、各電子メール通知で使用できる置換のリストが表示されます。

5 インポート・エクスポート・ツール

この章では、インポート・エクスポート・ツールの機能と、このツールを使用してOracle Enterprise Repositoryに対する項目のインポートとエクスポートを行う方法について説明します。

この章の内容は次のとおりです。

- 概要

- インポート・エクスポート・ツールの使用

- インポート・エクスポート・ツールの起動

- Oracle Enterprise Repositoryからの項目のエクスポート

- Oracle Enterprise Repositoryへの項目のインポート

5.1 概要

Oracle Enterprise Repositoryのインポート・エクスポート・ツールは、Oracle Enterprise Repositoryのインスタンス間でアセットや関連するメタデータのやり取りをできるように設計されています。

注意:
インポート・エクスポート・ツールを使用するときは、次のベスト・プラクティスに従います。

- Oracle API CatalogからエクスポートしてOracle API Catalogにインポートすることがサポートされています。

- Oracle Enterprise RepositoryからエクスポートしてOracle Enterprise Repositoryにインポートすることがサポートされています。

- Oracle API CatalogからエクスポートしてOracle Enterprise Repositoryにインポートすることがサポートされています。

- Oracle Enterprise RepositoryからエクスポートしてOracle API Catalogにインポートすることは、API Catalogへのエクスポート・ユーティリティを使用する場合にのみ、サポートされています。インポート/エクスポート・ユーティリティを使用すると、このユーティリティで作成されたzipファイルをインポートできます。OERからOACへのアセットのインポート以外でインポート/エクスポート・ツールを使用することは、サポートされていません。また、お薦めしません。
ユーティリティのインストールの詳細は、『Oracle Fusion Middleware Oracle Enterprise Repositoryインストレーション・ガイド』のAPI Catalogへのエクスポート機能のパッチのインストールに関する項を、OERからOACにAPIアセットをエクスポートするユーティリティの使用の詳細は、『Oracle Fusion Middleware Oracle Enterprise Repository開発者ガイド』のAPI CatalogへのAPIアセットのエクスポートに関する項を参照してください。

アーカイブは完全に自己完結型であることが必要です。つまり、エクスポートされたすべての項目を完全に記述するために必要な依存データもすべてエクスポートされます。依存関係は次のとおりです。

- アセット、コンプライアンス・テンプレートおよびポリシーはタイプに依存します。

- アセット・タイプ、コンプライアンス・テンプレート・タイプおよびポリシー・タイプは、カテゴリ分けタイプとリレーションシップ・タイプに依存します。

たとえば、単一アセットをエクスポートする場合、結果として作成されるアーカイブには、該当のアセット、それに関連付けられているアセット・タイプ、およびそのアセット・タイプが依存するカテゴリ分けタイプとリレーションシップ・タイプが含まれます。インポートする場合、アーカイブに含まれるすべてのデータは、Oracle Enterprise Repositoryの宛先インスタンスにインポートされます。同じ名前の項目がある場合に生じる競合は、次の方法で解決されます。

- アセット、コンプライアンス・テンプレート、ポリシーおよびそのそれぞれのタイプには、システム内に一意の名前が必要です。インポートされる項目の名前が、宛先のOracle Enterprise Repositoryインスタンスにすでにある項目と同じ場合、「v2」が新しい(インポートされた)項目の名前に付加されます。このようなことが繰り返されるたびに、項目の新しいバージョン(「v3」、「v4」など)が作成されます。インポートされる項目の名前にすでに「Vn」指定が付いている場合、その名前にさらに「v2」が付加されます。

- カテゴリ分けタイプは、同じ名前の宛先カテゴリ分けタイプがある場合、データをマージします。宛先システムに存在しないソース・アーカイブのカテゴリ分けは、既存の(宛先)カテゴリ分けタイプに追加されます。

- 同じ名前とタイプを共有するソースおよび宛先リレーションシップ・タイプは無視されます。つまり、既存の記述テキストが宛先システムで保持されます。ソースと宛先リレーションシップ・タイプで同じ名前を共有するとしても、タイプが異なる場合は、前述のように、宛先システムへのインポート時に、ソース・リレーションシップ・タイプの名前に「v2」が付加されます。

注意:
Oracle Enterprise RepositoryのインスタンスがSiteminderで保護されるように構成される場合、インポート・エクスポート・ツールが適切に機能できるようにするには、次のURLを無視する(または保護しない)ようにポリシー・サーバーを構成する必要があります。
http://appserver.example.com/oer/services/

5.2 インポート・エクスポート・ツールの使用

この項では、インポート・エクスポート・ツールを使用して、Oracle Enterprise Repositoryに対するオブジェクトのインポートまたはエクスポートを行う方法について説明します。この項の内容は次のとおりです。

- 5.2.1項「概要」

- 第5.2.2項「parameter.propertiesファイル」

- 第5.2.3項「デフォルトのインポート動作」

注意:
インポート・エクスポート・ツールにはJava Web Startが必要です。Java Web Startのインストールおよび構成の詳細は、1.10項「Java Web Startのインストール」を参照してください。

5.2.1 概要

インポート・エクスポート・ツールは、Oracle Enterprise Repository内の「管理」タブの「インポートとエクスポート」ページで利用できます。Oracle Enterprise Repositoryユーザーには、システム設定で指定される管理ロール「Admin Role」(enterprise.security.roletype.admin)が必要です。

インポート・エクスポート・ツールは、起動時にダウンロードして起動するJava WebStartプログラムです。

エクスポート操作では、エクスポートするOracle Enterprise Repositoryのオブジェクトを検索できます。アセット・タイプ、アセット、カテゴリ分けタイプおよびリレーションシップ・タイプを検索できます。エクスポート操作の結果は、検索されたオブジェクトと、そのオブジェクトのすべての依存関係を含む.zipファイルになります。デフォルトでは、結果として作成される.zipファイル内にサンプル・ファイルparameter.propertiesが含まれます。

インポート操作は、インポート・エクスポート・ツールによってエクスポートされた.zipファイルを使用して、含まれる項目をOracle Enterprise Repositoryにロードします。インポートの動作は、META-INF/parameter.propertiesまたは一連のデフォルト・アクションで決まります。

注意:
『Oracle Fusion Middleware Oracle Enterprise Repository開発者ガイド』のアセット検索結果のZIPへのエクスポートに関する項で説明されているように、検索結果画面からエクスポートされたアセットをインポートすることもできます。

異なるOracle Enterprise Repositoryインスタンス間でデータを移動する必要があるOracle Enterprise Repository管理者は、インポート・エクスポート・ツールまたはOracle Enterprise Repository OpenAPIを使用する必要があります。インポート・エクスポート・ツールを使用する場合、インポート操作を実行する前に、parameter.propertiesファイルを.zipバンドルに含める必要があります。エクスポート操作により、/META-INFディレクトリにあるプレースホルダ・ファイルが作成されます。

5.2.2 parameter.propertiesファイル

各インポート・バンドルには/META-INFディレクトリが含まれます。このディレクトリには、バンドルのインポート時にインポート・エクスポート・ツールの動作を制御するファイルが含まれます。parameter.propertiesファイルが存在しない場合、インポート操作の前にこのファイルを作成する必要があります。

5.2.2.1 parameter.propertiesファイルのサポート対象パラメータ

プロパティ・ファイルのサポート対象パラメータは、パラメータの法定値とともにリストされます。

PreserveUUIDs

- 使用者: アセット

- 説明: このパラメータは、ランダムに生成する新しいUUIDではなくバンドルのアセットのUUIDを保持します。

- 値:

- True - 新規作成されたアセットのUUIDは、インポート・バンドルで指定されるUUIDです。

- False - 新規作成されたアセットのUUIDは、Oracle Enterprise Repositoryでランダムに生成されます。

Standard.saver.assettype.props.duplicate.matching

- 使用者: アセット・タイプ

- 説明: このパラメータは、インポート・ツールによって、バンドルのアセット・タイプがOracle Enterprise Repositoryにすでに存在するものの複製であるかどうかを特定する方法を指定します。

- 値:

- UUID - インポート・バンドルで指定されるアセット・タイプのUUIDが、Oracle Enterprise Repositoryのアセット・タイプのUUIDと一致する場合、複製が確定されます。

- 名前 - インポート・バンドルで指定されるアセット・タイプの名前が、Oracle Enterprise Repositoryのアセット・タイプの名前と一致する場合、複製が確定されます。

Standard.saver.assettype.props.duplicate.handling

- 使用者: アセット・タイプ

- 説明: このパラメータは、Oracle Enterprise Repositoryのアセット・タイプの複製であると特定されるバンドルのアセット・タイプがインポート・ツールによって処理される方法を指定します。

- 値:

- 新しいバージョンの作成 - インポート・バンドルのUUIDとアーキタイプで新しいアセット・タイプを作成しますが、名前の最後に接尾辞「V」と番号が付けられてバージョン指定されます(Service V2など)。アセット・タイプには新しいUUIDがあります。

- 無視 - バンドルの複製アセット・タイプを無視します。アセット・タイプをインポートせず、Oracle Enterprise Repositoryのアセット・タイプを変更しません。

- マージ - Oracle Enterprise Repositoryのアセット・タイプと、バンドルの複製アセット・タイプをマージします。マージ操作では、Oracle Enterprise Repositoryのアセット・タイプの要素が変更されるわけではありません。操作は追加的なものであり、バンドルのアセット・タイプの要素が、Oracle Enterprise Repositoryのアセット・タイプに付加されます。要素の一致は、要素のXMLマッピングによって行われます。ルールは次のとおりです。

- 要素のXMLマッピングが存在する場合、要素を無視します。

- 要素のXMLマッピングが存在しない場合、それを追加します。要素は、最初に要素のタブを見つけてから、タブが存在しない場合は作成することで追加されます。要素はタブの最後に追加されます。

- 上書き - Oracle Enterprise Repositoryのアセット・タイプを、バンドルの複製アセット・タイプに置き換えます。Oracle Enterprise Repositoryのアセット・タイプのアセットは変更されませんが、これらのアセットの表示は影響を受けます。

Standard.saver.relationshiptype.props.duplicate.handling

- 使用者: リレーションシップ・タイプ

- 説明: このパラメータは、Oracle Enterprise Repositoryのリレーションシップ・タイプの複製であると特定されるバンドルのリレーションシップ・タイプをインポート・ツールによって処理する方法を指定します。複製のリレーションシップ・タイプは、リレーションシップ・タイプの名前と方向の特性で常に一致します。

- 値:

- 無視 - バンドルの複製リレーションシップ・タイプを無視します。該当のリレーションシップ・タイプを使用し、すでにOracle Enterprise Repositoryには存在しないアセット・リレーションシップを作成します。

- 上書き - Oracle Enterprise Repositoryのリレーションシップ・タイプを、バンドルの複製リレーションシップ・タイプに置き換えます。これにより、リレーションシップ・タイプのすべての情報が上書きされます。該当のリレーションシップ・タイプを使用し、すでにOracle Enterprise Repositoryには存在しないアセット・リレーションシップも作成されます。

Standard.saver.metadata.props.duplicate.handling

- 使用者: CMFメタデータ

- 説明: このパラメータは、Oracle Enterprise RepositoryのCMFメタデータの複製であると特定されるバンドルのCMFメタデータのブロックをインポート・ツールによって処理する方法を指定します。複製CMFメタデータは、メタデータのUUIDで常に一致します。

- 値:

- 無視 - バンドルの複製CMFメタデータを無視します。

- 上書き - Oracle Enterprise RepositoryのCMFメタデータを、バンドルの複製CMFメタデータに置き換えます。これにより、CMFメタデータのすべての情報が上書きされます。

Standard.saver.metadata.props.duplicate.handling

- 使用者: CMFメタデータ・エントリ・タイプ

- 説明: このパラメータは、Oracle Enterprise RepositoryのCMFメタデータ・エントリ・タイプの複製であると特定されるバンドルのCMFメタデータ・エントリ・タイプをインポート・ツールによって処理する方法を指定します。複製CMFメタデータ・エントリ・タイプは、メタデータ・エントリ・タイプの名前で常に一致します。

- 値:

- 無視 - バンドルの複製CMFメタデータ・タイプを無視します。

- 上書き - Oracle Enterprise RepositoryのCMFメタデータ・エントリ・タイプを、バンドルの複製CMFメタデータ・エントリ・タイプに置き換えます。これにより、CMFメタデータ・エントリ・タイプのすべての情報が上書きされます。

5.2.2.2 parameter.propertiesサンプル・ファイル

すべてのオプションが含まれるサンプルのparameter.propertiesファイルは次のようになります。

##Name: parameters.properties
##Location: import_bundle.zip/META_INF/

##Legend:
## a double ## indicates a comment
## a single # indicates a command which can be used in an import bundle
## the text between []'s is the set of valid values for the parameter with comma
separating individual values

## for assets:
## This parameter will retain the UUIDs of assets in the bundle rather than randomly generating new UUIDs
#PreserveUUIDs=[true,false]
#Standard.saver.asset.props.duplicate.handling=[Create New Version, Ignore, Overwrite]
#Standard.saver.asset.props.duplicate.matching=[UUID, NameVersion]

## for assettypes:
#Standard.saver.assettype.props.duplicate.handling=[Create New Version, Ignore, Merge, Overwrite]
#Standard.saver.assettype.props.duplicate.matching=[UUID, Name]

## for relationship types:
#Standard.saver.relationshiptype.props.duplicate.handling=[Ignore, Overwrite]

## For CMF metadata
#Standard.saver.metadata.props.duplicate.handling=[Ignore, Overwrite]

## For CMF metadata entry types
#Standard.saver.metadataentrytype.props.duplicate.handling=[Ignore, Overwrite]

5.2.3 デフォルトのインポート動作

parameter.propertiesファイルが.zipバンドルに存在しない場合、インポートのデフォルト動作は次のようになります。

アセット・タイプ

- 同じ名前とバージョンのアセットがOracle Enterprise Repositoryにある場合、アセットはすでに存在します。

- すでに存在するアセットはUUIDで評価されます。

- 同じ名前、バージョンおよびUUIDのアセットは無視されます。

- 名前とバージョンが同じであってもUUIDが異なるアセットでは、新しいアセットが生成されます。このアセットのUUIDはランダムで、バージョンは同じです。ただし、名前の最後には接尾辞「V」と番号が付けられバージョン指定されます(Service Asset V2など)。

- すでに存在しないアセットは、インポート・バンドルに指定された名前とバージョンで作成されます。UUIDはランダムに生成されます。

- リレーションシップのどちらのアセットもインポート・バンドルに含まれる場合、リレーションシップが作成されます。

受入れ可能な値リスト

- 同じ名前の受入れ可能な値リストが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にある場合、リレーションシップ・タイプはすでに存在します。

- 同じ名前と方向のリレーションシップ・タイプは無視されます。

- 名前が同じで方向が異なるリレーションシップ・タイプでは、新しいリレーションシップ・タイプが生成されます。この場合、方向はバンドルに指定された方向で、名前は接尾辞「V」と番号でバージョン指定されます。

- すでに存在しないリレーションシップ・タイプは、インポート・バンドルに指定された名前と方向で作成されます。

メタデータ・エントリ

- 同じUUIDのメタデータ・エントリがOracle Enterprise Repositoryにある場合、メタデータ・エントリはすでに存在します。

- Oracle Enterprise Repositoryにすでに存在するメタデータ・エントリは、インポート・バンドルのメタデータ・エントリで上書きされます。

- すでに存在しないメタデータ・エントリは、インポート・バンドルに指定されたUUIDで作成されます。

メタデータ・エントリ・タイプ

- 同じUUIDのメタデータ・エントリ・タイプがOracle Enterprise Repositoryにある場合、メタデータ・エントリ・タイプはすでに存在します。

- Oracle Enterprise Repositoryにすでに存在するメタデータ・エントリ・タイプは、インポート・バンドルのメタデータ・エントリ・タイプで上書きされます。

- すでに存在しないメタデータ・エントリ・タイプは、インポート・バンドルに指定されたUUIDで作成されます。

5.3 インポート・エクスポート・ツールの起動

インポート・エクスポート・ツールは、Oracle Enterprise Repositoryの「管理」画面内から起動できます。インポート・エクスポート・ツールにはJDK 1.4.2以上が必要です。

5.3.1 Oracle Enterprise Repositoryからの起動

インポート・エクスポート・ツールは、「管理」タブから起動します。インポート・エクスポート・ツールの特性と、包括的なバックアップに必要なデータ量により、ツールは、管理ロールが割り当てられているユーザー(組込みの管理ユーザーなど)に制限されます。インポート・エクスポート・ツールを起動するためのリンクは、管理ロールを持つユーザーのみに表示されます。

「管理」タブの「インポート/エクスポート」セクションは、システム設定のプロパティによって有効になり構成されます。このセクションが管理ロールを持つユーザーに表示されない場合、次のシステム設定が有効でTrueに設定されていることを確認します。

cmee.importexport.enabled

注意:
インポート・エクスポートはREXを利用する自己完結型ツールであるため、Oracle Enterprise Repositoryからツールを起動した後、再度ログインする必要があります。

5.3.2 Oracle Enterprise Repositoryの外部からの起動

Oracle Enterprise Repositoryにローカルでログインしていない場合に、インポート・エクスポート・ツールの使用が必要になることがあります。インポート・エクスポート・ツールを保存して、ローカル・マシンから実行できます。

ローカル・マシンからインポート・エクスポート・ユーティリティを実行するには、次の手順を実行します。

1. 1.10項「Java Web Startのインストール」の手順に従って、システムで実行されるようにJava Web Startを構成します。

2. 「管理」サイドバーでインポートとエクスポートをクリックします。

3. 「インポート・エクスポート・クライアント」を右クリックし、「ファイルの保存」またはブラウザの同等の機能を選択して、impexp.jnplファイルを保存します。

4. impexp.jnlpファイルを実行の起点にする場所に移動します。

5. impexp.jnlpファイルを実行します。

注意:
インポート・エクスポート・ツールは、ローカルで保存し、<JAVA_HOME>/jre/binにあるjavaws実行可能ファイルを使用して実行することもできます。次に例を示します。

<JAVA_HOME>/jre/bin/javaws -verbose /path_to_file/impexp.jnlp

5.3.3 初期起動

図5-1に示すように、インポート・エクスポート・ツールの起動時に、Oracle Enterprise Repositoryの接続情報の入力を求められる場合があります。

注意:
SSO環境以外では、資格証明が求められることはありません。

図5-1 Oracle Enterprise Repositoryインポート・エクスポート・ユーティリティ

- OER URL
Oracle Enterprise Repositoryインストールのパスは、システム設定で定義されているとおり、通常はServletパスと同じになります。例: http://example.com/oer/

- ユーザー名
Oracle Enterprise Repository内で管理ロールが付与されているユーザーの名前。

- パスワード
上のボックスで指定したユーザーのパスワード。

インポート・エクスポート・ツールがジョブ・モニターによって自動的に中断されるまでに実行可能な最大時間をミリ秒単位で設定するには、新しいシステム設定を次のように構成する必要があります。

cmee.extframework.impexp.monitor.maxruntime

5.4 Oracle Enterprise Repositoryからの項目のエクスポート

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

1. 「管理」サイドバーでインポートとエクスポートをクリックします。

2. インポート・エクスポート・クライアントをクリックします。インポート・エクスポート・クライアントが表示されます。

3. 図5-2に示すように、「エクスポート」タブをクリックします。

図5-2 「エクスポート」タブ

4. ターゲット・ファイルの選択フィールドに適切なファイル名を入力するか、「参照」をクリックしてターゲット・ファイルのエクスポート先のディレクトリを選択します。「次」をクリックします。

5. エクスポートするエンティティの選択を使用して、エクスポートするエンティティを特定します。この選択により、以降の手順でのエクスポート・クライアントの具体的な動作が決まります。

6. 図5-3に示すように、エクスポートするアセットの選択ダイアログが表示されます。

図5-3 エクスポートするアセットの選択ダイアログ

7. 「検索」を使用するか、「すべてをリスト」をクリックすると、「使用可能」列に項目のリストが表示されます。

8. 矢印ボタンを使用して、選択した項目を「使用可能」列と「選択済」列の間で移動します。

9. 「次」をクリックします。手順5(エクスポートするエンティティの選択)で複数の選択が行われた場合、次の「選択」ダイアログで手順7と8を繰り返して、エクスポートする次の項目グループを選択します。

10. 「次」をクリックします。図5-4に示すように、エクスポート実行の準備ダイアログには、エクスポートするファイルのリストが表示されます。

図5-4 エクスポート実行の準備ダイアログ

11. 「次」をクリックします。エクスポート・プロセスのステータスが、進行状況バーに示されます。

注意:
エクスポートされた項目のサイズや複雑性に違いがある場合、このプロセスの速度や進行状況バーの動作に影響があります。

図5-5に示すように、完了するとエクスポートの概要が表示されます。

図5-5 エクスポート操作の実行ダイアログ

Microsoft Windowsプラットフォームでは、Windows Explorerが開き、アーカイブが保存されたフォルダが表示されます(システム権限によりアプリケーションからのシェルの実行が許可されると仮定)。

5.5 Oracle Enterprise Repositoryへの項目のインポート

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

注意:
この手順は、Oracle Enterprise Repositoryへのソリューション・パックのインポートにも適用されます。

1. 「管理」サイドバーでインポートとエクスポートをクリックします。

2. インポート・エクスポート・クライアントをクリックします。インポート・エクスポート・クライアントが表示されます。

3. 「インポート」タブをクリックします。

4. インポートするファイルの選択フィールドに適切なファイル名を入力するか、図5-6のように「参照」をクリックして、インポートするソース・ファイルを選択します。

図5-6 インポート元ソース・ファイルの選択ダイアログ

5. 「次」をクリックします。図5-7に示すように、インポート実行の準備ダイアログには、選択したソース・ファイルが表示されます。

図5-7 インポート実行の準備ダイアログ

6. 「次」をクリックします。インポート・プロセスのステータスが、進行状況バーに示されます。インポートされた項目のサイズや複雑性に違いがある場合、このプロセスの速度や進行状況バーの動作に影響があります。
図5-8に示すように、完了するとインポートの概要が表示されます。

図5-8 インポート操作の実行ダイアログ

注意:
インポート・エクスポート・ツールを実行する場合、比較的大きなデータ・セットをインポートすると、メモリーの問題が生じる可能性があります。これを回避するには、インポート・エクスポート・クライアント・リンクを右クリックして、リンクに名前を付けて保存...オプションをコンテキスト・メニューから選択することで、impexp.jnlpファイルをローカルに保存します。インポートするデータ・セットのサイズにさらに合うように、impexp.jnlpファイルを編集してmax-heap-sizeのデフォルトの量を増やします。データ・セットをインポートするマシンに十分なメモリーがある場合、次の例に示すように、max-heap-sizeパラメータの値をさらに高く変更します(<j2se version="1.6" max-heap-size="1024m"/>)。

6 BI Publisherでのレポートの構成

この章では、Oracle Enterprise Repositoryでのレポート用にBusiness Intelligence (BI) Publisherを構成する方法について説明します。

注意:
Oracle BI Publisherの使用制限付きライセンスがOERに含まれています。このライセンスにより、OERに含まれるレポートを使用できます。独自のカスタム・レポートを作成する場合は、Oracle Business Intelligence Enterprise Editionの完全なライセンスを取得してください。

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

- 6.1項「Oracle Enterprise Repository事前構成済BI Publisherコンテンツのデプロイ」

- 第6.2項「セキュリティ・モデルについて」

- 6.3項「Oracle Enterprise RepositoryのJDBCデータソースの構成」

- 6.4項「BI Publisherサーバーの構成 - キャッシュ有効期限」

- 6.5項「レポートを有効にするためのOracle Enterprise Repositoryシステム設定の構成」

- 6.6項「レポートの操作」

6.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コンテンツに置き換えられます。

6.1.1 Oracle Enterprise RepositoryでのBI Publisherの構成

注意:
10gレポートを11gに移行しようとしないでください。

Oracle Enterprise Repository-BI Publisherコンテンツをデプロイするには、次の手順を実行します。

1. データベースのパッケージ化されたコンテンツ・アーカイブを見つけます。レポートは、Oracle Enterprise Repositoryデプロイメントの<ORACLE_HOME>/oer/modules/tools/solutions/reportsディレクトリにあります。
このディレクトリに、12.1.3.0.0-OER-BIP11gReports.zipがあります。これには、各データベースに対応する3つのフォルダが含まれています。各フォルダには、OERのレポートのみが含まれています。

2. BI Publisherアプリケーション・サーバーを停止します。

3. 適切なデータベース・フォルダからOERフォルダをBI PublisherのReportsディレクトリにコピーします。
domain/config/bipublisher/repository/Reports

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

5. Webコンソールhttp://hostname:port/xmlpserverを開いて、BI Publisher構成を確認します。OERフォルダがShared Foldersディレクトリに表示されることを確認します。

6.2 セキュリティ・モデルについて

BI Publisherは、固有のセキュリティ・モデルではなくEnterprise Managerを使用してユーザーおよびロールを管理します。セキュリティ・モデルの詳細は、『Oracle Fusion Middleware Oracle Business Intelligence Publisher管理者ガイド』を参照してください。

6.2.1 管理者ユーザー

管理者ユーザーおよびパスワードは、インストール時に決定されます。このユーザーおよびパスワードは、OERへのデータベース接続の設定、OERユーザーおよびロールの構成、およびBI Publisherでのデータソースの設定に必要です。

注意:
BI Publisherでは、パスワードの大文字と小文字は区別されます。

6.2.2 OERユーザーおよびOER_REPORTSロール

BI Publisher WLSコンソールを使用してOERユーザーを作成します。このユーザーにBIグループを適用します。OERユーザー資格証明を使用してBI Publisherコンソールにログインすることで、ユーザー・アカウントを確認します。Shared Folders->OERフォルダのレポートを表示します。

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

レポート・フッターに正しいタイムゾーンを表示するには、OERユーザー・アカウントに対してBI Publisherでタイムゾーンを設定します。

- OERユーザーとしてサインインし、BI Publisherコンソールの右上のセクションの「次としてサインイン<username>」リンクにある「アカウント」リンクを選択してタイムゾーン設定を変更します。

6.3 Oracle Enterprise RepositoryのJDBCデータソースの構成

JDBC情報を更新するには、次の手順を実行します。

1. BI Publisherに管理者としてログインします。

2. 「管理」タブをクリックします。

3. 「データソース」セクションで、OER - 「JDBC接続」リンクを選択します。

注意:
これは、大文字と小文字が区別されます。

4. データソースの更新画面で、Oracle Enterprise Repositoryのデータベースをポイントするように接続文字列を変更します。
Oracle Databaseのバージョンに応じて、Oracle Databaseに対して次のいずれかのドライバ・タイプを選択できます。JDBCライブラリ・ファイル(JAR)はBI Publisherサーバー・インストールの一部としてインストールされるため、その他のJarファイルは必要ありません。

- Oracle 11g

- Oracle 12c

Oracle JDBC接続の例:

データベース・ドライバ・クラス

oracle.jdbc.OracleDriver

接続文字列

jdbc:oracle:thin:@[HOST]:[PORT]:[DB_NAME]

例

jdbc.oracle.thin:@machine.example.com:1521:oer

5. 「接続のテスト」ボタンをクリックして、BI Publisherがデータベースにアクセスできることを確認します。

6. 「適用」をクリックして変更を保存します。

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

デフォルトでは、Oracle Enterprise Repositoryのすべてのレポートで、レポート・データ生成時のデータベース・ラウンドトリップを削減するためにドキュメント・キャッシュが使用されます。データがキャッシュされる一方で、レンダリングされたレポートに常にOracle Enterprise Repositoryでの最新のアクティビティが表示されるとはかぎりません。キャッシュ有効期限の設定は、レポートの2回目以降の表示用にBI Publisherでデータをリフレッシュする必要がある頻度によって変わります。キャッシュ有効期限のBI Publisherでのデフォルト値は30です。この値を変更するには、次の手順を実行します。

1. BI Publisherに管理者としてログインします。

2. 「管理」タブをクリックします。

3. 「システム・メンテナンス」セクションで、「サーバー構成」リンクを選択します。

4. 「キャッシュ」セクションで、「キャッシュ有効期限」(分単位)を指定し、「適用」をクリックして変更を適用します。

注意:
レポートがBI Publisherによってレンダリングされる場合、結果はレポート用に検出されたデータによって異なります。データが存在するようになるまで、BI Publisherによって返されるレポートは一貫性がない場合があります。

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

Oracle Enterprise Repositoryには、各種レポートへの一連のリンクが含まれたレポート・ページがあります。これらのレポートはBI Publisherインスタンスによってホストされるため、レポートをホストするためにBI Publisherインスタンスをインストールおよび構成する必要があります。Oracle Enterprise Repositoryの「レポート」ページのすべてのリンクは、Oracle Enterprise Repositoryのインストール直後は不完全です。すべてのレポート・リンクに、プロトコル、ホスト名、ポート、Webアプリケーション名および親ディレクトリを指定するシステム設定があります。レポートを実行する前に、このシステム設定を構成する必要があります。

システム設定の構成

1. システム管理者または管理ロールを持つユーザーとしてOracle Enterprise Repositoryにログインします。

2. Oracle Enterprise Repositoryの「管理」ページで、「システム設定」をクリックします。

3. 「検索」テキスト・ボックスで、システム設定のリストをフィルタ処理するためにレポートと入力します。

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.4項「アクセス設定」で説明されているように、基本アクセス設定によって設定されます。

7. システム設定「レポート・サーバー・ユーザー名」および「レポート・サーバー・パスワード」を、6.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から返された場合は、表示するたびに変更を確認するように「インターネット一時ファイル」を変更します。

6.6 レポートの操作

この項では、図6-1に示すように、「レポート」ページで利用可能なOracle Enterprise Repositoryのレポートについて説明します。

図6-1 Oracle Enterprise Repositoryの「レポート」ページ

6.6.1 レポート・タイプについて

この項では、Oracle Enterprise Repositoryのレポート・タイプについて説明します。

プロジェクト・ポートフォリオ生産性レポート

プロジェクト・ポートフォリオ生産性レポートには、プロジェクト・チームの生産性全体(規定されるアセット使用要件に関するコンプライアンスのレベル、既存のアセット・ポートフォリオを活用することで実現した価値など)が示されます。レポートは、アセット・ポートフォリオに対する各プロジェクト・チームの貢献度にも着目します。プロジェクト・ポートフォリオ生産性レポートには、次の項目があります。

- アセット生産性の詳細(プロジェクト別) (アセット生産性の追跡機能を有効にする必要があります)。
プロジェクトで使用される個々のアセットと、アセットの使用による節約時間を示します。マネージャは、このレポートを使用して、アセットの再利用に関してグループまたは個人に報酬を与えることができます。設計者やレジストラは、レポートを使用して、ポートフォリオでの新たな基準を見極めることができます。また、マネージャは、このレポートを使用して、クライアントに対して生み出される価値を数値化することもできます。

- アセット使用(プロジェクト別)
プロジェクトで使用される個々のアセットと、アセットの使用による節約時間を示します。マネージャは、このレポートを使用して、アセットの再利用に関してグループまたは個人に報酬を与えることができます。設計者やレジストラは、レポートを使用して、ポートフォリオでの新たな基準を見極めることができます。また、マネージャは、プロジェクト・リーダーとともにこのレポートを使用して、クライアントに対して生み出される価値を数値化することもできます。

- プロジェクト・コンプライアンス(コンプライアンス・テンプレートを使用すると仮定)
プロジェクトに適用されるコンプライアンス・テンプレートと、プロジェクトがテンプレートに従っているかどうかを示します。

アセット・ポートフォリオ管理レポート

主に設計者とレジストラによって使用されます。これらのレポートは、アセット・ポートフォリオの品質、ステータスおよび価値を示します。また、これらのレポートは、アセットの需要と供給を監視し、アセット・ポートフォリオの分類の絞込みに役立ちます。このグループ内に含まれるレポートは次のとおりです。

- アセット・ポートフォリオ・ポリシー・ステータス
組織のアセット・ポートフォリオ全体に関して、ポリシー・ステータス(可、不可、不明)の概要を示します。このレポートを使用すると、ユーザーは、各ステータスのアセットのリスト(たとえば、不可となるすべてのアセット)を表示できます。詳細なレポートには、各アセットに適用されるすべてのポリシーと、すべてのポリシー・アサーションのステータスがリストされます。

- アセット・ポートフォリオの評価
使用されるアセットの数、各アセットの使用頻度、および再利用による節約時間の合計を示します。設計者とレジストラは、このレポートを使用して、最も重要で価値のあるアセットを検索できます。

- アセット評価
コンシューマによるアセットの評価を示します。設計者とレジストラは、レポートを使用して、アセットについて判断された価値を図で示すことができ、プロデューサとメインテイナは、レポートをフィードバック・メカニズムとして使用できます。

- アセットの拒否
プロジェクトでの使用に関してアセットが拒否された理由を示します。設計者とレジストラは、このレポートを使用して、特定のアセットの需要レベルを測定でき、プロデューサとメインテイナは、レポートをフィードバック・メカニズムとして使用できます。

- アセット・ステータス
アセットの名前、タイプおよびステータス(アクティブ、非アクティブなど)を示します。レジストラは、このレポートを使用して、アセット・ポートフォリオに必要なアセット・ライフサイクル・メンテナンスのレベルを決定できます。

- アセット使用(プロジェクト別)
プロジェクトで使用される個々のアセットと、アセットの使用による節約時間を示します。マネージャは、このレポートを使用して、アセットの再利用に関してグループまたは個人に報酬を与えることができます。設計者やレジストラは、レポートを使用して、ポートフォリオでの新たな基準を見極めることができます。また、マネージャは、プロジェクト・リーダーとともにこのレポートを使用して、クライアントに対して生み出される価値を数値化することもできます。

- コンシューマによってレポートされたアセット価値(アセット別)
アセット関連の、コンシューマによってレポートされた節約と、アセットの予測値を示します。マネージャは、このレポートを使用して、実質予測時間の計算に使用される数値を絞り込むことができます。設計者とレジストラは、このレポートを使用して、レジストリで最も使用され価値のあるアセットを特定できます。プロデューサとメインテイナは、このレポートを使用して、コンシューマが実感した実際のアセット価値を決定し、レジストリのアセットに対する進行中の変更や強化を特定できます。

- ポリシー・ステータス・レポート
組織のポリシー・ポートフォリオのすべてのポリシーの概要と、ステータスが可、不可、または不明のアセットの数を示します。このレポートは、各ポリシーで管理されるアセットの詳細リストと、ステータスが可、不可または不明のアサーションの数も示します。

- 検索条件
各検索パラメータの結果の数を示します。設計者とレジストラは、このレポートを使用して分類を定義できます。

- 結果が作成されない検索
結果が作成されなかった検索の検索パラメータを示します。最終的には、レジストリ内の需要が満たされなかった領域が示されます。レジストラと設計者は、このレポートを使用して分類を絞り込むことができます。

- 最新の結果を作成する検索
最新の結果を戻した検索の検索パラメータを示します。このレポートは、設計者やレジストラによって使用され、ユーザーがレジストリ内の必要な情報を検索するかどうかを判断できます。レポートは、分類の絞込みにも使用できます。

- 発行済アセットのステータス
承認サイクルのアセットのステータスを示します。レジストラは、このレポートを使用して、作業が必要なアセットのスケジュールを決定できます。

- アセットを通知するサブスクライバ
アセット情報に対する特定のサブスクライバを示します。このレポートは、設計者やレジストラによって使用され、ポートフォリオのアセットに関する需要レベルを決定できます。

アセット・リリース管理レポート

アセットのプロデューサやメインテイナによって主に使用されます。これらのレポートは、アセットの絞込みや強化についてこれらのユーザーに通知し、コンシューマ・コミュニティやプロジェクトの使用に対するアセット変更の影響を決定します。また、これらのレポートによって、変更が通知される必要がある利害関係者が特定されます。アセット・リリース管理レポートには次のオプションがあります。

- アセットのデプロイ
デプロイされるアセットの名前と、そのアセットが関連付けられるプロジェクトの名前を示します。プロデューサ、メインテイナおよびプロジェクト・リーダーによって使用され、アセットに対する変更の影響を評価します。

- アセットの使用
特定のプロジェクトで使用するために選択されたアセットをリストします。プロデューサ、メインテイナおよびプロジェクト・リーダーによって使用され、アセットに対する変更の影響の可能性を評価します。

- アセット評価
コンシューマによるアセットの評価を示します。設計者とレジストラは、レポートを使用して、アセットについて判断された価値を図で示すことができ、プロデューサとメインテイナは、レポートをフィードバック・メカニズムとして使用できます。

- アセットの拒否
プロジェクトでの使用に関してアセットが拒否された理由をリストします。設計者とレジストラは、このレポートを使用して、特定のアセットの需要レベルを測定でき、プロデューサとメインテイナは、レポートをフィードバック・メカニズムとして使用できます。

- コンシューマによってレポートされたアセット価値(アセット別)
アセット関連の、コンシューマによってレポートされた節約と、アセットの予測値を示します。マネージャは、このレポートを使用して、実質予測時間の計算に使用される数値を絞り込むことができます。設計者とレジストラは、このレポートを使用して、レジストリで最も使用され価値のあるアセットを特定できます。プロデューサとメインテイナは、このレポートを使用して、コンシューマが実感した実際のアセット価値を決定し、レジストリのアセットに対する進行中の変更や強化を特定できます。

- アセットを通知するサブスクライバ
アセット情報に対する特定のサブスクライバを示します。このレポートは、設計者やレジストラによって使用され、ポートフォリオのアセットに関する需要レベルを決定できます。

パフォーマンス・レポート

これらのレポートでは、個々のユーザーが、組織への貢献度の値を数値化できます。また、組織でのプロデューサ、コンシューマおよびプロジェクト・リーダーのパフォーマンスに関して、部門長に通知します。Oracle Enterprise Repositoryに現在含まれているパフォーマンス・レポートは次のとおりです。

- アセットの使用(プロジェクト別)
プロジェクトで使用されるアセットと、アセットの使用による節約時間を示します。マネージャは、このレポートを使用して、アセットの再利用に関してグループまたは個人に報酬を与えることができます。設計者やレジストラは、レポートを使用して、ポートフォリオでの新たな基準を見極めることができます。また、マネージャは、プロジェクト・リーダーとともにこのレポートを使用して、クライアントに対して生み出される価値を数値化することもできます。

プログラム管理レポート

各種マネージャによって主に使用されます。これらのレポートは、プログラムが組織にもたらす価値(ROI)を公開し、プログラムが正常に目標を達成するかどうか、およびプログラムの成長と進捗を示し、インセンティブやガバナンスの基盤としての役割を果たします。プログラム管理レポートには次のオプションがあります。

- アクティブおよび非承認ユーザーのログイン
アクティブおよび非承認ユーザーの名前と、そのユーザーがログインした時間を示します。システム管理者またはセキュリティ管理者は、このレポートを使用して、レジストリ・ライセンスを再度割り当てることができます。

- ログインしたことがないアクティブおよび非承認ユーザー
一度もログインしたことがない、アクティブおよび非承認ユーザーの名前を示します。システム管理者またはセキュリティ管理者は、このレポートを使用して、レジストリ・ライセンスを再度割り当てることができます。

- アセット・ポートフォリオの評価
使用されるアセットの数、各アセットの使用頻度、および再利用による節約時間の合計を示します。設計者とレジストラは、このレポートを使用して、最も重要で価値のあるアセットを検索できます。

- コンシューマによってレポートされたアセット価値(アセット別)
アセット関連の、コンシューマによってレポートされた節約と、アセットの予測値を示します。マネージャは、このレポートを使用して、実質予測時間の計算に使用される数値を絞り込むことができます。設計者とレジストラは、このレポートを使用して、レジストリで最も使用され価値のあるアセットを特定できます。プロデューサとメインテイナは、このレポートを使用して、コンシューマが実感した実際のアセット価値を決定し、レジストリのアセットに対する進行中の変更や強化を特定できます。

- パスワード・イベント・ログ
ユーザーに対して行われたパスワードの変更を示します。このレポートは、セキュリティ管理者やシステム管理者によって使用され、セキュリティ違反を特定できます。

- 発行ステータス(プロデューサ別)
プロデューサの名前、発行および登録されたアセットの数、使用インスタンスの数、アセット・コンシューマによる予測節約時間を示します。

- アセットを通知するサブスクライバ
アセット情報に対する特定のサブスクライバを示します。このレポートは、設計者やレジストラによって使用され、ポートフォリオのアセットに関する需要レベルを決定できます。

6.6.2 カスタム・レポートの追加

Oracle Enterprise Repositoryでは、「レポート」ページにカスタム・レポートを追加できます。すべてのカスタム・レポートは、Oracle Enterprise Repositoryに対して外部のレポート・エンジンによって生成され、URLで公開される必要があります。「レポート」ページでは、カスタム・レポートに名前と説明を加えて、そのレポートへのリンクを作成できます。

注意:
Oracle BI Publisherの使用制限付きライセンスがOERに含まれています。このライセンスにより、OERに含まれるレポートを使用できます。独自のカスタム・レポートを作成する場合は、Oracle Business Intelligence Enterprise Editionの完全なライセンスを取得してください。

注意:
カスタム・レポートがこの方式で追加される場合、Oracle Enterprise Repositoryの今後のアップグレード時に、レポートを含むディレクトリをバックアップして保護する必要があります。

6.6.2.1 概要

Oracle Enterprise Repositoryレポート・サブシステムは、.toc (目次)、.jod (内部レポートGUIのXML表現)、.xml (Oracle Enterprise Repositoryレポート定義)の各ファイルの集合で構築されます。これらのファイルは、Oracle Enterprise Repository WebアプリケーションのWEBINF/config/reportsディレクトリ内にあります。カスタム・レポートを構築するには、.tocファイルを変更し、.xmlファイルを作成する必要があります。.jodファイルは、このカスタマイズとは関係ないため、変更する必要はありません。

Oracleでは、「レポート」ページの「カスタム」セクションの下に、目次用のcustom.tocファイルを備えています。customreports.xmlファイルも含まれており、このファイルをコピーして、レポートに関連する名前を付ける必要があります。

6.6.2.2 構成手順

Oracle Enterprise Repositoryでカスタム・レポートを構成する手順は次のとおりです。

1. Oracle Enterprise RepositoryのデプロイされたインスタンスのWEB-INF/config/reportsディレクトリを参照します。

2. customreports.xmlを、レポートを表す新しい名前にコピーします。拡張子は.xmlにしてください(CustomerReportA.xmlなど)。

3. customreports.xmlに名前を付けて説明し、そのレポートへのリンクを追加するため、次のように編集します。

- <report>要素には、レポートに一意の短い名前を示す必要があるパラメータ名があります。ファイル名をお薦めします(<report name='CustomerReportA'>など)。

- <displayName>要素の値は、「レポート」ページの「カスタム」セクション内に表示されるラベルです(<displayName>Report A</ displayName>など)。

- <description>要素の値は、「レポート」ページに表示される説明です(<description>This describes Report A.</description>など)。

- <externalLink>要素の値は、レポートのURLになります。このURLがレポートを実行します。(<externalLink>http://www.example.com/reports/CustomerReportA?cmd=execute</externalLink>など)。

4. コピーして変更したcustomreports.xmlファイルをWEB-INF/config/reportsディレクトリに保存します。これは、Oracle Enterprise Repositoryがすべてのレポート・ファイルを検索する場所です。これでレポートが作成されました。

5. custom.tocファイルを編集して、新規作成されたレポートを、Oracle Enterprise Repositoryの「レポート」領域に追加します。

- <report>要素は、レポートの名前を指定します。レポートの.xmlファイルに表示される内容に同じテキストを使用します。ファイル名をお薦めします。(<report name='CustomerReportA'>など)

6. レポートのcustom.tocファイルと.xmlファイルをバックアップします。これらのコピーは、アップグレードによるファイルのリセット以降に行われるアップグレードの後に必要です。

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

6.6.3 レポートの実行

この手順は、「レポート」ページで実行されます。レポートを実行するには、Oracle Business Intelligence Publisher (BI Publisher)をインストールして構成する必要があります。

1. サイドバーのリストからレポートを選択します。レポート・フォームによって、新しいブラウザ・ウィンドウにBI Publisherが開きます。

2. BI Publisherのユーザー名を使用してBI Publisherにログインします。このユーザー名は、Oracle Enterprise Repositoryのユーザー名とは異なります。

3. レポート上部にあるパラメータ値を選択します。

4. カレンダ・アイコンをクリックしてカレンダを起動し、「開始」と「終了」の日付を選択します。各レポートの日付は、デフォルトで年度の開始日から現在までの範囲に設定されています。

5. レポートにその他のパラメータを適宜選択します。

6. 「ソート順序」を選択します。

7. 「テンプレート」リストをクリックして、レポートの出力形式を選択します。デフォルトでは、HTMLテンプレートが表示されます。

8. 「表示」をクリックします。レポートが生成されます。

第II部

アセット・ライフサイクルの管理

この部では、Oracle Enterprise Repositoryのライフサイクルの高度な管理タスクについて説明します。

この部は、次の章で構成されています。

- 第7章「タイプ・マネージャの使用」

- 第8章「自動収集の構成および使用」

- 第9章「アセット・エディタの使用」

7 タイプ・マネージャの使用

この章では、タイプ・マネージャを使用して、Oracle Enterprise Repositoryのアセット・エディタやアセット詳細に表示されるように、アーティファクトごとの情報の編成と表示を制御する方法について説明します。

この章では、次の項目について説明します。

- 概要

- タイプ・マネージャの起動

- 新しいタイプの作成

- 登録ワークフローに対応するタブの構成

- タブの要素

- タイプ・マネージャ・アイコンのイメージの追加

- 一意のID

- 共通のメタデータ・ビューア

- タイプXMLスキーマの表示と編集

7.1 概要

Oracle Enterprise Repositoryの各アーティファクトは、次の3つのいずれかの見出しに分類されます。

- アセット

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

- ポリシー

各見出しは様々なタイプで表されます。

- アセット・タイプ

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

- ポリシー・タイプ

これらのタイプはパターンであり、その各種インスタンスは、Oracle Enterprise Repository内で管理できる多様なアーティファクトに対応するように作成されます。次に例を示します。

- アプリケーションは、アセット・タイプのインスタンスです。

- プロジェクト・プロファイルは、コンプライアンス・テンプレート・タイプのインスタンスです。

- 規制コンプライアンス・ポリシーは、ポリシー・タイプのインスタンスです。

タイプによって、Oracle Enterprise Repositoryのすべてのアーティファクト(アセット、コンプライアンス・テンプレート、ポリシー)に関する情報の表示とそのアーティファクトの分類の両方が決まります。Oracle Enterprise Repositoryには複数のタイプが付属しています。タイプ・マネージャを使用して、これらのタイプを変更したり、新しいタイプを作成できます。

タイプ・マネージャは、アセット・エディタやアセット詳細に表示されるように、アーティファクトごとの情報の編成と表示を制御します。

7.2 タイプ・マネージャの起動

この手順は、アセット・エディタで実行されます。

注意:
アセット・エディタにはJava Web Startが必要です。Java Web Startのインストールおよび構成の詳細は、1.10項「Java Web Startのインストール」を参照してください。

1. 「アクション」メニューで、タイプの管理を選択します。図7-1に示すように、タイプ・マネージャ・ページが表示されます。

図7-1 タイプ・マネージャ・ページ

2. ツリーでアセット・タイプ、コンプライアンス・テンプレートまたはポリシーを選択して、その構成を表示または編集します。

7.2.1 タイプ・マネージャのビュー

各タイプにはエディタとビューアがあります。

各タイプのエディタとビューアのビューの構成に関連する情報は、データベースのXMLファイルに保存されます。タイプ・マネージャは、GUIにXMLファイルをロードします。これにより、タイプの作成、変更および削除が可能になります。タイプが保存されると、データはXMLでアセンブルされ、データベースにロードされます。

- 7.2.1.1項「エディタ」

- 7.2.1.2項「ビューア」

7.2.1.1 エディタ

エディタは、アセット・エディタに表示されるように、特定タイプのアセットおよびコンプライアンス・テンプレートの情報の編成と表示を制御します。

図7-2 エディタ・タブ

エディタの表示は次の3つのセクションに分類されます。

- 一般
タイプ名、使用ステータス・セレクタ、タイプ・アイコン・セレクタ、「プレビュー」ボタン(アセット・エディタで表示される場合と同様に、アセット、コンプライアンス・テンプレートまたはポリシー・タイプを表示)が含まれます。

- タブ
タイプに使用可能なタブのリストが表示されます。これらのタブは、アセットおよびコンプライアンス・テンプレートのアセット・エディタ・ビューに表示されるタブに相当します。リストされているタブをクリックすると、タブ・セクションの真下にある「要素」セクションにその要素が表示されます。

- 要素
項目をクリックすると、タブ・セクションにリストされているタブの要素がここに表示されます。

タブ・セクションと「要素」セクションの右側に次の複数のボタンが表示されます。

- 追加

- 編集

- 削除

- 上へ移動

- 下へ移動

これらのアクションは、タブ・セクションまたは「要素」セクションにリストされるどの項目にも適用できます。単純に項目を選択してから、適切なボタンをクリックします。

次に示される要素は、有効なタイプに必要です。これらの名前を変更できますが、タイプから削除することはできません。

- 名前

- バージョン

- 説明

- ファイル情報

- 電子メールで通知

- キーワード

7.2.1.2 ビューア

ビューアは、Oracle Enterprise Repositoryの「アセット」セクションに表示されるように(アセットとコンプライアンス・テンプレート情報の一般ユーザー・ビュー)、特定タイプのアセット、コンプライアンス・テンプレートまたはポリシーの情報の編成および表示を制御します。

図7-3 「ビューア」タブ

「ビューア」の表示は、主に次の3つのセクションに分類されます。

- 非表示要素
表示可能なすべての要素をリストします。

- (右側にある)「編集」ボタンを使用して、リストされている要素の構成を変更します。

- グループでの表示ボタンを使用して、Oracle Enterprise Repositoryの主なアセット表示にある2つの列のいずれかに要素を割り当てます。

- グループ
列1と列2があります。これらは、Oracle Enterprise Repositoryの主なアセット表示にある主要な2つの列に相当します。右側のボタンを使用して、それぞれの列の要素を構成します。

- 要素
「グループ」、列1またはグループ、列2で項目をクリックし、「要素」セクションでそれぞれの項目の要素を表示します。右側のボタンを使用して、これらの要素を構成します。

注意:
タイプに加えられる変更は、そのタイプに割り当てられるすべてのアセットの表示に影響します。

7.3 新しいタイプの作成

データベースの整合性を維持するには、アセットが現在関連付けられていないタイプのみを削除できます。

注意:
このアクションにより、再利用の測定が変更されます。

1. 図7-4に示すように、「ファイル」メニューで「新規」を選択すると、新しいタイプの作成ダイアログが開きます。

図7-4 新しいタイプの作成ダイアログ

2. 「タイプ名」テキスト・ボックスに適切な情報を入力します。

3. 「デフォルトのタイプ」リストで、新しいタイプの基本テンプレートとして既存のタイプのいずれかを選択します。

4. 「OK」をクリックします。図7-5に示すように、新しいタイプがツリーに表示されます。

図7-5 「アセット・タイプ」リスト

7.4 登録ワークフローに対応するタブの構成

タブは、登録ワークフローに対応する論理シーケンスでタイプに配置される必要があります。たとえば、「フレームワーク」アセット・タイプ(Oracle Enterprise Repositoryに付属)では、最初に「一般」情報の入力は直感で行われます。「ドキュメント」タブと「テスト」タブは非常に似ており、互いに近くにあります。ワークフロー・プロセスの最後である実際の登録手順は、「管理」タブで実行されます。そのため、「管理」タブはシステムで生成され、意図的にその位置で固定されます。

タブが承認されると、必ずTabApprovedEventイベントがトリガーされます。このイベントと、タブ名およびその他特定のメタデータが、ワークフローに送られ処理されます。

7.4.1 タブの追加

タブは、タイプ・マネージャで追加できます。次の手順を実行します。

1. 図7-6に示すように、変更するタイプを選択します。

図7-6 「アセット・タイプ」リスト

2. エディタ・タブのタブ・セクションで、「追加」をクリックします。図7-7に示すように、タブ・ダイアログが表示されます。

図7-7 タブ情報ダイアログ

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

4. 「OK」をクリックします。図7-8に示すように、新しいタブの名前がタブ・セクションのリストに表示されます。

図7-8 タブ・リスト

5. 「一般」セクションで「プレビュー」をクリックします。「プレビュー」ページが表示されます。図7-9に示すように、新しいタブが表示されます。

図7-9 コンポーネント・エディタのプレビュー

6. 「プレビュー」ページを閉じます。

7. 「保存」をクリックして変更を保存します。

7.4.2 タブの位置の変更

タブの位置を変更するには、次の手順を実行します。

1. 変更するタイプを選択します。

2. エディタ・タブで、移動するタブを選択します。

図7-10 タブ・リスト

3. 「上へ移動」または「下へ移動」を適宜クリックします。クリックするたびにタブのレベルが1つ移動します。図7-11に、選択したタブがリストの下から上に移動する状況を示します。

図7-11 タブ・リスト - 最上部にある選択済タブ

4. 「一般」セクションで「プレビュー」をクリックします。「プレビュー」ダイアログが表示されます。図7-12のタブの新しい位置に注意してください。

図7-12 コンポーネント・エディタのプレビュー

5. 「保存」をクリックして変更を保存します。

6. 「プレビュー」ウィンドウを閉じます。

7. 「保存」をクリックして変更を保存します。

7.4.3 タブの編集

選択したタブを編集するには、次の手順を実行します。

1. 図7-13に示すように、変更するタイプを選択します。

図7-13 「アセット・タイプ」リスト - タブが選択された状態

2. 図7-14に示すように、エディタ・タブで、編集するタブを選択します。

図7-14 タブ・リスト

3. 「編集」をクリックして、タブの名前を変更します。図7-15に示すように、タブ情報ダイアログが表示されます。

図7-15 タブ情報ダイアログ

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

5. 「保存」をクリックして変更を保存します。

7.4.4 タブの削除

注意:
タブを削除すると、そのタブに関連付けられているすべてのデータが削除されます。

タブを削除するには、次の手順を実行します。

1. 変更するタイプを選択します。

2. 図7-16に示すように、エディタ・タブで、削除するタブを選択します。

図7-16 タブ・リスト

3. 「削除」をクリックします。図7-17に示すように、確認のダイアログが表示されます。

図7-17 確認のダイアログ

4. 「はい」をクリックします。タブが削除され、タブのリストやプレビューに表示されなくなります。

5. 「保存」をクリックして、変更内容を保存します。

次の必須要素のいずれかを含むタブを除き、すべてのタブをタイプから削除できます。

- 名前

- バージョン

- 説明

- ファイル情報

- 電子メールで通知

- キーワード

システムにより、これらの要素を含むタブは削除されません。これらの要素を含むタブを削除するには、最初に要素を別のタブに移動する必要があります。

7.5 タブの要素

各種要素は、アセット・メタデータの管理やプレゼンテーションに対応するようにタブに追加できます。これらの要素の一部は使い捨てになります。つまり、タイプで一度しか使用されません。要素が割り当てられると、使い捨ての要素は、使用可能な要素のリストに表示されなくなります。各要素タイプのプロパティを次に示します。

- テキスト・フィールド -- データ文字列を含む

- 表示名
アセット・エディタに表示される要素ラベル。

- 必須
選択した場合、アセットを保存する前に、フィールドにデータを移入する必要があります。

- 索引付き
選択した場合、そのタイプの詳細な検索オプションにフィールドが表示されます。

- 最大長
フィールドの最大データ長の検証ルール。数字のエントリを受け入れます。

- 数値テキスト・フィールド -- 単一の数値を含む

- 表示名
アセット・エディタに表示される要素ラベル。

- 必須
選択した場合、アセットを保存する前に、フィールドにデータを移入する必要があります。

- 索引付き
選択した場合、そのタイプの詳細な検索オプションにフィールドが表示されます。

- 最小値
フィールドの最小データ値の検証ルール。数字のエントリを受け入れます。

- 最大値
フィールドの最大データ値の検証ルール。数字のエントリを受け入れます。

- 小数点以下の桁数
フィールドのデータの小数点以下の桁数を指定するための検証ルール。数字のエントリを受け入れます。

- 日付フィールド -- 単一の日付値を含む

- 表示名
アセット・エディタに表示される要素ラベル。

- 必須
選択した場合、アセットを保存する前に、フィールドにデータを移入する必要があります。

- 索引付き
選択した場合、そのタイプの詳細な検索オプションにフィールドが表示されます。

- URL -- URLにリンクする文字列を含む

- 表示名
アセット・エディタに表示される要素ラベル。

- 必須
選択した場合、アセットを保存する前に、フィールドにデータを移入する必要があります。

- 索引付き
選択した場合、そのタイプの詳細な検索オプションにフィールドが表示されます。

- チェック・ボックス -- 2つの値(有効または無効)によるチェック・ボックスを含む

- 表示名
アセット・エディタに表示される要素ラベル。

- 必須
選択した場合、アセットを保存する前に、フィールドにデータを移入する必要があります。

- デフォルトで選択
「はい」を選択した場合、チェック・ボックスは、同じタイプの新しいアセットに関して自動的に選択されます。

- リスト -- 限定された項目のリストを含む

- 表示名
アセット・エディタに表示される要素ラベル。

- 必須
選択した場合、アセットを保存する前に、フィールドにデータを移入する必要があります。

- 索引付き
選択した場合、そのタイプの詳細な検索オプションにフィールドが表示されます。

- 許容可能な値
リストを移入する使用可能なデータのリスト。「構成」ボタンを使用すると、値を構成できます。

- 編集可能なリスト -- データまたは数値のいずれかの項目を含む

- 表示名
アセット・エディタに表示される要素ラベル。

- 必須
選択した場合、アセットを保存する前に、フィールドにデータを移入する必要があります。

- 索引付き
選択した場合、そのタイプの詳細な検索オプションにフィールドが表示されます。

- エントリ・フィールド
英数字の値のリスト。「構成」を使用すると、英数字または数値のいずれかの値を構成できます。

- 複数選択リスト -- 一度のみ選択可能な項目で構成されたリストのデータを含む

- 表示名
アセット・エディタに表示される要素ラベル。

- 必須
選択した場合、アセットを保存する前に、フィールドにデータを移入する必要があります。

- 索引付き
選択した場合、そのタイプの詳細な検索オプションにフィールドが表示されます。

- 許容可能な値
リストを移入する使用可能なデータのリスト。「構成」ボタンを使用すると、新しい値や既存の値を構成できます。

- 表 -- 列と行の情報(列は要素に対応し、行は要素に関するデータに対応する)を含む。使用可能なタイプは次のとおりです。

- テキスト・フィールド

- 数値テキスト・フィールド

- URL

- チェック・ボックス

- ドロップ・ダウン・ボックス

- 表

- グループ表示名
アセット・エディタに表示される要素ラベル。

- 項目表示名
データ・エントリ領域

- 必須
選択した場合、アセットを保存する前に、フィールドにデータを移入する必要があります。

- 要素
各要素は、表の列になり、要素タイプと同じルールに従います。

- カテゴリ分け -- アセット・エディタのビューの動作に関連するデータを含む。タイプにつき1回のみ使用できます。

- 表示名
アセット・エディタに表示される要素ラベル。

- カテゴリ分けタイプ
Oracle Enterprise Repositoryで使用可能な各種カテゴリ分けのリスト。

- アセット・リレーションシップ -- リレーションシップの動作に固有のデータを含む。アセット間のリレーションシップを検索して設定するには、この要素タイプをタイプにつき1回のみ使用できます。

- 表示名
アセット・エディタに表示される要素ラベル。

- 関連付けられたファイル -- ファイルの動作に固有のデータを含む。関連付けられているファイルを追加すると、そのファイルへのリンクが作成されます。

- 表示名
アセット・エディタに表示される要素ラベル。

- 連絡先の選択 -- 連絡先の動作に固有のデータを含む。連絡先の作成や既存の連絡先の使用を有効にするには、この要素をタイプにつき1回のみ使用できます。

- 表示名
アセット・エディタに表示される要素ラベル。

- プロジェクトの作成 -- アセットを作成して使用するプロジェクトの動作に固有のデータを含む。プロジェクトの作成を有効にするには、この要素をタイプにつき1回のみ使用できます。

- 表示名
アセット・エディタに表示される要素ラベル。

- JARイントロスペクション -- JARファイルの動作に固有のデータを含む。完全修飾クラス名を要素の内容に追加するには、この要素をタイプにつき1回のみ使用できます。

- 表示名
アセット・エディタに表示される要素ラベル。

- 要件リストとカップリング -- 要件の動作に固有のデータを含む。この要素では、要素に入力したデータ(英数字)に基づきカップリングが有効になります。

- 表示名
アセット・エディタに表示される要素ラベル。

- ベンダー選択 -- ベンダーの動作に固有のデータを含む。この要素は、タイプにつき1回のみ使用できます。名前は、アセット・エディタのベンダーの構成オプションで構成されるベンダーの名前に相当します。

- 表示名
アセット・エディタに表示される要素ラベル。

- アップロードされた発行ファイル -- アップロードされたファイルの動作に固有のデータを含む。この要素は、タイプにつき1回のみ使用でき、アップロード・パスのアセットIDと同じ指定ディレクトリの内容に基づいてデータを生成します。

- 表示名
アセット・エディタに表示される要素ラベル。

- SFID -- 使用追跡の自動化の動作に関連するデータを含む。タイプにつき1回のみ使用できます。

- 表示名
アセット・エディタに表示される要素ラベル。

- 一意の要素 -- 一意のIDの動作に関連するデータを含む。タイプにつき1回のみ使用できます。

- 表示名
アセット・エディタに表示される要素ラベル。

- テンプレートの適用先プロジェクト -- コンプライアンス・テンプレートの動作に関連するデータを含む。タイプにつき1回のみ使用できます。

- 表示名
アセット・エディタに表示される要素ラベル。

- UDDIサービス・キー -- Harvester Solution Packで使用され、UDDIレジストリに公開されるサービスを一意に特定します。

- 表示名
アセット・エディタに表示される要素ラベル。

- UDDIレジストリ -- Harvester Solution Packで使用され、アセットが公開されたUDDIレジストリのリストを表示します。

- 表示名
アセット・エディタに表示される要素ラベル。

- XPathメタデータ・ビューア -- XPath共通メタデータ・ビューアです。詳細は、第7.8.1項「XPath共通メタデータ・ビューア」を参照してください。

- 表示名
アセット・エディタに表示される要素ラベル。

- メタデータ・タイプ
XML形式のエントリ・タイプを含むエントリ・タイプ。

- XPath
指定のメタデータ・タイプ内でのメタデータの検索に使用されるXPath。

- イントロスペクション標準属性ビューア -- Harvester Solution Packで使用され、ハーベスタ操作に関連するメタデータを表示します。通常は、ハーベスタ・プロパティと呼ばれる要素としてHarvester Solution Packのアセット・タイプに追加されます。このビューアは、XSLT共通メタデータ・ビューアの例でもあります。詳細は、第7.8.2項「XSLT共通メタデータ・ビューア」を参照してください。

- 表示名
アセット・エディタに表示される要素ラベル。

- メタデータ・ファイル -- この要素はアセット・ファイルと同様に実行されます。この要素はXML形式のメタデータを公開します。ハーベスタまたはユーティリティ交換操作によってアセットに付加されます。メタデータは、アセットに関する使用およびダウンロード操作に公開されます。この要素は、タイプのビューア部分では使用できず、「アセット詳細」には表示されません。

- 表示名
アセット・エディタに表示される要素ラベル。

- アセット・ファイル -- この要素では、アセットの使用およびダウンロード操作用にファイルを公開できます。アセットに名前とURLのぺアを指定することで各ファイルを追加できます。この要素は、タイプのビューア部分では使用できず、「アセット詳細」には表示されません。デフォルトでは、ファイル情報と呼ばれる要素としてすべてのアセット・タイプに追加されます。

- 表示名
アセット・エディタに表示される要素ラベル。

- WSDLサマリー -- Harvester Solution Packで使用され、WSDL(本来はサービスを定義)へのリンクを提供します。

- 表示名
アセット・エディタに表示される要素ラベル。

7.5.1 要素の操作

数値テキスト要素には数値情報が含まれ、多くの場合、レポートで使用されます。次の例では、タイプの「概要」タブに数値テキスト要素を追加してレポート作成フィールドを作成します。

1. 変更するタイプを選択します。

2. 図7-18に示すように、エディタ・タブの「要素」セクションで、「追加」をクリックします。

図7-18 「要素」セクション

図7-19に示すように、追加する要素タイプの選択ダイアログが表示されます。

図7-19 追加する要素タイプの選択ダイアログ

3. リストから数値テキスト・フィールドを選択します。

4. 「OK」をクリックします。数値テキスト・フィールドの編集ダイアログが表示されます。

図7-20 数値テキスト・フィールドの編集ダイアログ

5. 「表示名」テキスト・ボックスに適切な情報を入力します。

6. 「必須」を選択する場合、必要なデータがこの要素のすべてのフィールドに入力されるまで、このタイプのアセットを(アセット・エディタで)保存できません。

7. Oracle Enterprise Repositoryの検索に要素フィールドを含めるには、「索引付き」を選択します。

8. 「最小値」フィールドと「最大値」フィールドに適切な情報を入力します。

9. 入力後、「OK」をクリックします。

7.6 タイプ・マネージャ・アイコンのイメージの追加

タイプ・マネージャ・アイコンにイメージを追加できます。この項の内容は次のとおりです。

- 第7.6.1項「アイコン・イメージの要件」

- 第7.6.2項「使用可能なタイプ・アイコンの表示と選択」

7.6.1 アイコン・イメージの要件

- サイズ: 16x16ピクセル

- 形式: GIF形式

- 保存先: Oracle Enterprise Repositoryインストール・ファイルのホスト・ディレクトリのサブディレクトリimages/tree/enterprise/asset。

アイコン要素を追加するには、次のようにします。

1. images/tree/enterprise/assetサブディレクトリでicons.xmlファイルを見つけます。

2. icons.xmlを必要に応じて編集し、新しいGIFイメージのアイコン要素を追加します。

3. これが開いている場合、アセット・エディタを閉じて再度開きます。

7.6.2 使用可能なタイプ・アイコンの表示と選択

この手順は、タイプ・マネージャで実行されます。

1. タイプを選択します。

2. 図7-21に示すように、エディタ・タブの「一般」セクションで、「割当て」をクリックします。

図7-21 「一般」セクション

図7-22に示すように、アイコンの選択ダイアログが表示されます。

図7-22 「アイコンを選択」ダイアログ

3. リストからアイコンを選択します。

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

5. 「保存」をクリックし、変更を保存します。図7-23に示すように、サイドバーのリストのタイプの横に新しいアイコンが表示されます。

図7-23 「アセット・タイプ」リスト - 新しいタイプ

7.7 一意のID

Oracle Enterprise Repositoryに発行されるすべてのアセットには、Oracle Enterprise Repositoryに固有のID番号が自動的にタグ付けされます。これは、アセットの編成と管理に使用されます。ただし、特定の環境や状況では、組織が特定のアセットに追加のカスタム特定キーを割り当てる場合に効果があります。たとえば、Oracle Enterprise Repositoryに対して外部のシステムのリソースまたはアセットにアセットを関連付ける場合、一意のIDキーを使用して一意性を実行できます。

Oracle Enterprise Repositoryの一意のID機能を使用すると、タイプ・マネージャへのアクセス権を持つユーザーは、選択したアセット・タイプまたはコンプライアンス・テンプレート・タイプ(あるいはその両方)に一意のID要素を追加できます。タイプごとに追加できる一意のID要素は1つのみです。この一意のID要素は、選択したタイプのアセットのアセット・エディタ表示に表示されます。

アクセス・エディタへのアクセス権を持つユーザーは、「一意のID」テキスト・ボックスに適切な情報を追加することで、これらのアセットおよびコンプライアンス・テンプレートに一意のIDキーを割り当てることができます。

各IDキーの一意性は、システム全体で実行したり、特定のタイプ内での実行に制限したりすることができます。たとえば、システム全体で実行される場合、タイプに関係なく2つのアセットに同じ一意のIDキーを割り当てることはできません。タイプ内で実行される場合、同じタイプの2つのアセットに同じキーを割り当てることはできません。ただし、同じ一意のIDを異なるタイプの複数のアセットに割り当てることができます。アセット・エディタ内では、すでに別のアセットに割り当てられた一意のIDキーを含むアセットを保存しようとすると、エラー・メッセージが生じます。

一意のID要素の具体的なタイプ・マネージャ構成によって、その中に含まれる要素や情報が、Oracle Enterprise Repositoryの各アセットのアセット詳細表示に表示されるかどうかが決まります。

7.7.1 タイプへの一意のID要素の追加

この手順は、タイプ・マネージャで実行されます。

注意:
一意のID要素に関連付けられているプロパティを、「管理」画面のシステム設定セクションで有効にする必要があります。

1. 変更するタイプを選択します。

2. 一意のID要素が追加されるタブを選択します。

図7-24 「要素」セクション

図7-24に示すように、そのタブに割り当てられている要素が「要素」セクションに表示されます。

3. 「要素」セクションで、「追加」をクリックします。図7-25に示すように、追加する要素タイプの選択ダイアログが表示されます。

図7-25 追加する要素タイプの選択ダイアログ

4. リストから一意の要素を選択します。

5. 「OK」をクリックします。図7-26に示すように、一意の要素の編集ダイアログが表示されます。

図7-26 一意の要素の編集ダイアログ

6. 一意の要素の編集ダイアログの「表示名」テキスト・ボックスに適切な情報を入力します。

7. 「OK」をクリックします。図7-27に示すように、「一意のID」要素が「要素」リストに表示されます。

図7-27 「要素」リスト - 一意のID

8. 「保存」をクリックします。

7.7.2 カスタム・レポート作成に必要な情報

カスタム・レポートに一意のID要素を含めるには、この要素のスキーマ情報が必要です。このメタデータは、「アセット」表と結合できる表に格納され、特定のシステム設定の値に基づいて移入されます。メタデータと、そのデータを制御するルールの場所は、このセクションで指定されます。

- 表名:
UniqueElementValues

- フィールド:

- assetid: アセットのID(assets.idの外部キー)

- assettypeid: アセット・タイプのID(assettypes.idの外部キー)

- value: 一意の値(varchar 4000)

注意:
アセットの一意のID要素(アセット・エディタに表示される場合と同じ)に値が含まれる場合のみ、レコードがuniqueelementvalues表に表示されます。

プロパティ

次の2つのプロパティが一意の要素に関連付けられます。

- cmee.unique-element.enable

- 一意性についてフィールドの有効と無効を切り替えます。

- cmee.unique-element.per-assettype

- True = アセット・タイプ内で実行される一意性

- False = システム全体で実行される一意性

注意:
このプロパティのtrueとfalseを繰り返し切り替えると、予想外のシステム動作が生じることがあります。

サンプル・シナリオ

- cmee.unique-element.per-assettypeはtrueに設定されます。

- 一意性はアセット・タイプ内で実行されます。

- 異なるアセット・タイプの複数のアセットで同じ一意のIDを共有できます。

- 同じアセット・タイプのアセットで同じ一意のIDは共有できません。

- cmee.unique-element.per-assettypeはfalseに設定されます。

- 一意性はシステム全体で実行されます。

- アセット・タイプに関係なく、2つのアセットで同じ一意のIDは共有できません。

- このプロパティの変更によって、一意のIDの以前の割当てが影響を受けることはありません。ただし、アセットが一意のIDを共有する場合、アセットの変更保存が拒否されることがあります。

7.8 共通のメタデータ・ビューア

アセット・タイプ、コンプライアンス・テンプレートおよびポリシーには2つの要素があり、これらを使用すると、ユーザーは、アセットに添付するXML形式のメタデータを表示できます。1つはXPath表現に基づき、もう1つはXSLT変換に基づきます。要素がアセット・タイプに追加されると、アセット・エディタ・ビューとアセット詳細ビューでメタデータを表示できます。メタデータはアセット・エディタに表示されますが、これは参照目的のみです。これらのビューアでメタデータの編集は行えません。

この項の内容は次のとおりです。

- 第7.8.1項「XPath共通メタデータ・ビューア」

- 第7.8.2項「XSLT共通メタデータ・ビューア」

7.8.1 XPath共通メタデータ・ビューア

アセット・タイプに追加する場合、共通メタデータ・タイプとXPathを指定する必要があります。アセットを表示する場合、アセットにそのタイプの共通メタデータがある場合、XPathが共通メタデータに対して評価され、結果として作成される項目が簡単なリストとしてアセットに表示されます。

7.8.2 XSLT共通メタデータ・ビューア

これらのビューアは、Oracle Enterprise Repositoryにインポートされます。ビューアがインポートされると、アセット・タイプに追加可能な要素として表示されます。ビューアに名前を付ける以外の構成はありません。ビューアがアセット・タイプに追加されると、ビューアと互換性のある共通メタデータを含む該当タイプのアセットでは、ビューアのXSLTで定義されるメタデータが表示されます。

7.9 タイプXMLスキーマの表示と編集

タイプ・マネージャには、ユーザーがアセット・タイプ、コンプライアンス・テンプレート・タイプおよびポリシー・タイプのXMLスキーマを表示および編集できる機能があります。

- スキーマのエクスポート

- 選択したタイプのXMLスキーマを表示します。

- 管理ロールが割り当てられるユーザーのみが使用できます。

- タイプ・マネージャの「ファイル」メニューからアクセスします。

- XMLエディタ

- タイプ・マネージャを通じて、すべてのタイプのエディタ表示とビューア表示のXMLソースを編集できます。

- 管理ロールのユーザー、および特定のシステム設定に基づきその他のユーザーが利用できます。

- タイプ・マネージャの「サポート」メニューからアクセスします。

7.9.1 XMLスキーマの構成

この項では、使用可能な構成オプションについて説明します。

- 「スキーマのエクスポート」ビューアは、管理ロールに割り当てられるユーザーのみが使用できます。

- 表示される「サポート」メニューは、次の条件によって決まります。

- ユーザーに管理権限がある場合。

- XMLエディタ・オプションは「サポート」メニューで使用できます。

- プロパティcmee.asseteditor.allow.manual.proxyが有効な場合。

- 手動によるプロキシ構成オプションは、「サポート」メニューで使用できます。

7.9.2 スキーマのエクスポート機能の使用

この手順は、タイプ・マネージャで実行されます。

1. 「ファイル」メニューで「スキーマのエクスポート」を選択します。図7-28に示すように、「ロード」ダイアログが表示されます。

2. 「タイプ」リストからXMLスキーマ・タイプを選択します。

図7-28 「ロード」ダイアログ

3. 「OK」をクリックします。図7-29に示すように、XMLスキーマ表示が表示されます。

図7-29 XMLスキーマ表示

表示ウィンドウでは、スキーマの編集は行えません。ただし、後で使用するためにスキーマをローカル・ファイル・システムに保存できます。(ウィンドウの「ファイル」メニューで「保存」をクリックします。)

注意:
タイプXMLドキュメントの検証に使用する目的で、スキーマをローカル・ドキュメントにコピーして貼り付けることもできます。

7.9.3 タイプXMLエディタの使用

XMLエディタでは、アセット・タイプ、コンプライアンス・テンプレートおよびポリシー・タイプのXMLソースの未検証の変更が有効になります。

注意:
XMLソースの変更が適切に行われないと、すべてのタイプが使用不可の状態になる場合があります。

1. タイプ・マネージャで、「サポート」メニューからXMLエディタを選択します。次の警告メッセージが表示されます。
XMLエディタで行われた変更が検証されないため、タイプは使用不可と見なされます!

2. 「OK」をクリックします。空白のダイアログが表示されます。

3. 「OK」をクリックします。XMLスキーマ表示が開きます。

4. 空のウィンドウの「ファイル」メニューで、「ロード」を選択します。

5. 図7-30に示すように、「ロード」ダイアログで、編集するXMLスキーマのタイプを「タイプ」リストから選択します。

図7-30 「ロード」ダイアログ

6. 「XML型」リストから、エディタまたは「ビューア」を選択します。これらの選択が、タイプ・マネージャでのエディタ・タブと「ビューア」タブになります。

7. 「OK」をクリックします。図7-31に示すように、選択したスキーマが表示されます。

図7-31 XMLスキーマ表示

8. 必要に応じてスキーマを編集します。

9. 「ファイル」メニューから「保存」を選択して変更を保存します。

8 自動収集の構成および使用

この章では、ハーベスタの使用を開始する方法について説明します。Oracle Enterprise Repositoryへのデータの移入に使用するツールはハーベスタと呼ばれています。ハーベスタを使用して、Oracle製品および標準ベースのファイルからメタデータを読み取ります。これには、Oracle SOA Suite、Oracle Service Bus、Oracle BPAによって生成されたコンポジット、標準BPEL、WSDL、XSD、XSLT、BPMN 2.0およびWS-Policyファイルが含まれます。

ハーベスタによって、アセットの作成、アセット・メタデータの移入、およびアーティファクト・ファイルの情報に基づいたリレーション・リンクの生成が自動的に実行されます。

ファイルは、実行時環境にデプロイされたときに収集されます。ハーベスタは、コマンド行から使用することも、AntやWeblogic Scripting Tool (WLST)内で使用することもできます。

この章は次の項で構成されています。

- ハーベスタの使用の開始

- ハーベスタの構成

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

8.1 ハーベスタの使用の開始

この項では、ハーベスタの使用を開始する方法および高レベルな各種ユースケースでのハーベスタの使用について説明します。

この項には次のトピックが含まれます:

- 8.1.1項「前提条件」

- 8.1.2項「ハーベスタの機能」

- 8.1.3項「アーティファクト/製品のバージョン・マトリックス」

8.1.1 前提条件

ハーベスタを使用する前に、次の前提条件を実行する必要があります。

- 必要なアセット・タイプおよびリレーションシップを含むHarvester Solution PackをOracle Enterprise Repositoryにインポートします。<OER_Home>/modules/tools/solutions/12.1.3.0.0-OER-Harvester-Solution-Pack.zipファイルをインポートします。
Oracle Enterprise Repositoryソリューション・パックのインポートの詳細は、『Oracle Fusion Middleware Oracle Enterprise Repositoryインストレーション・ガイド』を参照してください。

- Oracle Service Busから収集する場合、Oracle Service Busのインストール場所と同じFMW_HOMEまたはOracle Service Busインストールにアクセス可能な共有ファイル・システムに、ハーベスタをインストールします。詳細は、8.2.2.2項「コマンド行で収集するアーティファクトの選択」を参照してください。

注意:
Oracle Service Busからプロジェクトを収集する場合は、通常のハーベスタ・ユーティリティharvest.batまたはharvest.shのかわりに、osb-harvest.batまたはosb-harvest.shユーティリティを使用する必要があります。これには、Oracle Service Bus 12cがインストールされている必要があります。OSBハーベスタの詳細は、第8章「Oracle Service BusからのWebサービスの収集」を参照してください。

- デプロイしたアプリケーション(Oracle SOA Suite、Oracle Service Busなど)またはWebサービスからアセットを収集する場合は、アプリケーションをWebLogic 11g以上にデプロイする必要があります。

- Oracle Application Integration Architectureからの収集の詳細は、Oracle Fusion Middleware Oracle Application Integration Architecture Foundation Pack開発者ガイドのOracle AIAのコンテンツ収集に関する項を参照してください。

- ハーベスタを使用するには、Java SDKバージョン6以上が必要です。

8.1.2 ハーベスタの機能

ハーベスタを使用すると、次の処理を行うことができます。

- SCAコンポジット、BPEL、WSDL、WADL、XSD、XSLT、BPMN 2.0、WS-Policy (オラクル社およびその他のベンダーからのもの)などの標準SOAアーティファクトをOracle Enterprise Repositoryに公開します。

- WSDLおよびWADLサービスを完全なSCAモデルではなく単一のAPIアセットとして公開し、制御が必要なアセットの数を大幅に削減します。WSDLまたはWADLを収集するときに、-simple_modelハーベスタ・オプション(表8-4の説明を参照)を使用して単一のAPIアセットを作成します。

- 影響分析用にアーティファクト間の依存関係を取得します。

- ネストされたWSDLおよびXSDファイルを処理します。

- 抽象インタフェース・アセットと具象デプロイメント/エンドポイントを作成します。

- BPELパートナ・リンクの依存関係を取得し、インタフェースに関連付けます。

- 変換に対するBPEL PMの依存関係を取得します。

- 再利用のためにアーティファクト・コンテンツをOracle Enterprise Repositoryに格納し、参照します。

- アーティファクトのSoftware File 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

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

表8-1に、ハーベスタでサポートされているアーティファクト/製品のバージョン・マトリックスを示します。

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

アーティファクト/製品

バージョン

BPEL

1.1および2.0

WSDL

1.1

WADL

1.1.5

SCA

0.95

JCAアダプタ

1.5

XSD

1.0

XSLT

1.0

Oracle BPEL PM

10.1.3.4

Oracle SOA Suite

11gおよび12c (12.1.3および12.2.1)

WS-Policy

1.2

Oracle Service Bus

11gおよび12c (12.1.3および12.2.1)

WebLogic Webサービス

11gおよび12c (12.1.3および12.2.1)

BPMN

2.0

注意:
Oracle SOA SuiteおよびService Busでは、12.2.1で導入されたエンドツーエンドJSONまたはネイティブのRESTサービスの収集をハーベスタがサポートしません。これらの製品の12.2.1リリース以降のその他のアーティファクトに関しては、収集をサポートしています。

8.2 ハーベスタの構成

この項では、ハーベスタを構成し、統合開発環境内で使用する方法について説明します。

この項には次のトピックが含まれます:

- 8.2.1項「ハーベスタの入手」

- 8.2.2項「コマンド行用のハーベスタの構成」

- 8.2.3項「Repository.Submit Antタスクを使用したハーベスタの起動」

- 8.2.4項「WLSTからのハーベスタの起動」

- 8.2.5項「実行時収集の詳細」

- 8.2.6項「オプションのハーベスタ構成の実行」

- 8.2.7項「ハーベスタのロギングの構成」

- 8.2.8項「ハーベスタでのトランザクション処理」

- 8.2.9項「拡張構成」

8.2.1 ハーベスタの入手

ハーベスタは、Oracle Enterprise Repositoryをインストールするときに次のディレクトリに自動的に解凍されます。

- <FMW_HOME>/oer/tools/harvester

- <FMW_HOME>/oer/tools/osbharvester

ハーベスタは、Oracle Enterprise Repository 12cインストールにバンドルされた12.1.3.0.0-OER-Harvester.zipにも含まれています。このファイルの場所は次のとおりです。

<FMW_HOME>/oer/modules/tools/solutions/12.1.3.0.0-OER-Harvester.zip

OSBハーベスタは、Oracle Enterprise Repository 12cインストールにバンドルされた12.1.3.0.0-OSB12c-Harvester.zipにも含まれています。このファイルの場所は次のとおりです。

<FMW_HOME>/oer/modules/tools/solutions/12.1.3.0.0-OSB12c-Harvester.zip

このマニュアルでは、<FMW_HOME>/oer/tools/harvesterまたは<FMW_HOME>/oer/tools/osbharvesterを<Harvester Home>ディレクトリとして表しています。どちらのディレクトリが該当するかは、実行しているハーベスタによって決まります。

表8-2に、製品および対応するバージョンの関係マトリックスを示します。

表8-2 ハーベスタの製品およびバージョンのマトリックス

製品およびバージョン

収集

IDE検索、参照および使用

Service Bus 11gおよび12c (12.1.3および12.2.1)

OER 12c

はい

SOA Suite 11gおよび12c (12.1.3および12.2.1)

OER 12c

はい

AIA Foundation Pack 11g

AIA

いいえ

標準ベースのアーティファクト(WSDL 1.1、XSD、BPEL、XSLT、BPMN 2.0)

OER 12c

状況により異なる

注意:
Oracle SOA SuiteおよびService Busでは、12.2.1で導入されたエンドツーエンドJSONまたはネイティブのRESTサービスの収集をハーベスタがサポートしません。これらの製品の12.2.1リリース以降のその他のアーティファクトに関しては、収集をサポートしています。

Harvester Solution Packで使用されるparameter.properties

Oracle Enterprise Repositoryへのインポート操作時のHarvester Solution Packの動作は、parameter.propertiesファイルによって決まります。このファイルは変更または修正できません。ソリューション・パック内のオブジェクトは、次のリストに示されている動作に従ってインポートされます。

- Harvester Solution Packの/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

- Harvester Solution Packの動作の概要

- アセット
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)
同名のAVLがOracle Enterprise Repository内に存在する場合、新しい値は、インポート・バンドル内の情報を使用してそのAVLに追加されます。

新しいAVLはOracle Enterprise Repositoryに追加されます。

- CMFメタデータ・エントリ・タイプ
重複するメタデータ・エントリ・タイプ(UUIDが同じもの)は無視されます。(ソリューション・パック内のエンティティは無視されます。)

新しいメタデータ・エントリ・タイプはOracle Enterprise Repositoryに追加されます。

- CMFメタデータ・エントリ
重複するメタデータ・エントリ(UUIDが同じもの)は無視されます。(ソリューション・パック内のエンティティは無視されます。)

新しいメタデータ・エントリはOracle Enterprise Repositoryに追加されます。

parameter.propertiesの詳細は、5.2.2項「parameter.propertiesファイル」を参照してください。

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

ハーベスタは、コマンド行から実行するように構成できます。組織は、そのエンタープライズ・リポジトリを、コマンド行からハーベスタを使用して簡単にブートストラップできます。コマンド行収集では次のものを収集できます。

- 個々のファイル

- ファイルのディレクトリ

- リモート・ファイル

- アーティファクト・ストアに存在するファイル

- Oracle MetaData Store (MDS)に存在するファイル

この項では、コマンド行用にハーベスタを構成するために実行が必要なタスクについて説明します。

- 8.2.2.1項「コマンド行用のリポジトリ接続情報の設定」

- 8.2.2.2項「コマンド行で収集するアーティファクトの選択」

8.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) allows you to encrypt
// the passwords that are stored in the Harvester configuration
// (HarvesterSettings.xml) file.
</credentials>
<timeout>30000</timeout>
</repository>

注意:
アセットに対する基本アクセス(表示、編集、受入れ、登録)が設定されたユーザーとしてハーベスタを実行することをお薦めします。

8.2.2.2 コマンド行で収集するアーティファクトの選択

ハーベスタは、コマンド行からharvest.batまたはharvest.shユーティリティを使用して実行できます。

注意:
Oracle Service Busからプロジェクトを収集する場合は、OSBハーベスタを使用する必要があります。OSBハーベスタは、<FMW_HOME>/oer/tools/osbharvesterディレクトリにインストールされており、osb-harvest.batまたはosb-harvest.shユーティリティを使用して実行できます。OSBハーベスタは、OSB 12cのインストール先と同じFMW_HOMEにインストールされている必要があります。
OSBハーベスタの使用方法の詳細は、8.2.5.3項「Oracle Service BusからのWebサービスの収集」を参照してください。

harvest.batおよびharvest.shユーティリティは、Oracle Enterprise Repositoryがインストールされているサーバーから実行できます。別のクライアントからハーベスタを実行する場合は、<FMW_HOME>/oer/modules/tools/solutionsディレクトリから12.1.3.0.0-OER-Harvester.zipファイルを取得し、有効なJAVA_HOME環境変数(表8-3を参照)が設定された任意のクライアントにそのzipファイルを解凍します。

osb-harvest.batおよびosb-harvest.shユーティリティは、Oracle Enterprise Repositoryがインストールされているサーバーから実行できます。別のクライアントからハーベスタを実行する場合は、次の操作を行います。

- Oracle Service Busをクライアント・マシン上の<FMW_HOME>ディレクトリにインストールします。

- クライアント・マシンでJAVA_HOME環境変数が表8-3に示すように設定されていることを確認します。

- Oracle Enterprise Repositoryがインストールされているマシン上の<FMW_HOME>/oer/modules/tools/solutionsディレクトリから12.1.3.0.0-OSB12c-Harvester.zipファイルを取得します。そのファイルをターゲット・マシン上の<FMW_HOME>/oer/toolsディレクトリに解凍します。ファイル解凍後のハーベスタのフルパスは、<FMW_HOME>/oer/tools/osbharvesterになっている必要があります。OSBハーベスタは、OSB 12cのインストール先と同じFMW_HOMEにインストールされている必要があります。

harvest.bat、harvest.sh、osb-harvest.batまたはosb-harvest.shを実行する前に、表8-3に示す環境変数が設定されていることを確認してください。Windowsでは、コマンド・ウィンドウで「set X」と入力すると変数Xの値が表示され、「set X=abc」と入力するとXの値が「abc」に設定されます。

表8-3コマンド行スクリプト

環境変数

説明

JAVA_HOME

JAVA_HOME環境変数がインストール済のJavaランタイム(JRE)またはSDKを指していることを確認します。Oracle Service Busイントロスペクションの場合は、Javaバージョン6以上である必要があります。

BEA_HOME

Oracle Service Busからプロジェクトを収集する場合にのみ、BEA_HOME環境変数がOracle Service Busサーバーを含むインストール・ディレクトリを指していることを確認します。たとえば、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

表8-4に、ハーベスタのコマンド行ユーティリティで指定できるオプションを示します。

表8-4 ハーベスタのコマンド行オプション

ハーベスタのオプション

説明

-settings<file>

構成設定XMLファイルを指定します。

-url <URL>

Oracle Enterprise RepositoryのURLを指定します。

-user <OER/OAC User Name>

Oracle Enterprise Repositoryユーザーのユーザー名を指定します。

-asset_version

モデルに作成されたすべてのアセットに適用するバージョンを指定します。

-artifact_store

検索対象のOracle Enterprise Repositoryアーティファクト・ストアの名前を指定します。アーティファクト・ストアは、Oracle Enterprise Repositoryのアセット・エディタで事前に作成しておく必要があります。指定した場合、-file引数はアーティファクト・ストアのURLに対する相対パスとして解決されます。

アーティファクト・ストアに対する相対URIを指定する場合、そのURIは.wsdl、.zipなどのファイルに解決される必要があります。directoriesを指すURIはサポートされていません。

アーティファクト・ストアの詳細は、8.2.3.2項「ネストされた要素としてのパラメータの指定」を参照してください。

-file <filename or URL>

収集するファイルまたはディレクトリを指定します。ファイル名またはファイルのURLを指定できます。

-file_type <type>

収集するファイルのファイル・タイプを指定します。指定しなかった場合は、ファイル拡張子からタイプが導出されます。config/pluginsフォルダ内のファイル・タイプのいずれかに対応している必要があります。デフォルトでは、.bpel、.mfl、.policy、.wsdl、.xsd、.xquery、.xsltがサポートされています。

-remote_url <URL>

ファイルではなく、リモート・プロジェクトの収集元となる実行中のサーバーを指定します。

-remote_username <username>

リモート・サーバーへの接続に使用するユーザー名を指定します。

-remote_server_type <type>

リモート・サーバーのタイプを指定します。リモート・サーバーとして、SOASuite、SOASuite11g、OSB、WLSのいずれかを指定できます。

注意: SOA Suite 11gサーバーに対して実行する場合は、SOASuite11gを使用してください。SOA Suite 12cサーバーに対して実行する場合は、SOASuiteを使用してください。

-remote_project <type>

収集対象として、ファイルではなく、リモート・プロジェクトの名前を指定します。省略した場合は、サーバー上のすべてのプロジェクトが収集されます。Oracle SOA Suiteの場合は、コンポジットの名前にリビジョンを付加したもの(MyComposite_rev1など)を指定する必要があります。WLSの場合は、WebLogic管理コンソールおよびEnterprise Managerに表示されるアプリケーション名を指定する必要があります。

-soa_partition <type>

Oracle SOA Suite用のパーティションの名前を指定します。デフォルトでは、soaのdefaultパーティションが使用されます。

-mds_settings <file>

MDSを初期化するためのadf-config.xmlファイルの場所を指定します。省略した場合は、ハーベスタに付属のadf-config.xmlファイルがデフォルトで使用されます。

-deployment_status <status>

作成されたアセットに設定されるデプロイメント・ステータスを指定します。設計時の値または実行時の値のいずれかを指定します。

-version

出力バージョン情報を指定します。

-preview

ハーベスタをプレビュー・モードで実行できるようにするかどうかを指定します。trueに設定した場合、ハーベスタはプレビュー・モードで実行されます。成否に関する詳細情報がロギングされ、変更がOracle Enterprise Repositoryにコミットされることはありません。

falseに設定するか、値を指定しなかった場合、ハーベスタは本番モードで実行されます。成否に関する詳細情報がロギングされ、変更がOracle Enterprise Repositoryにコミットされます。

-producing_project <project>

ハーベスタから作成されたすべてのアセットをこの作成するプロジェクトに適用します。

プロジェクトはOERにすでに存在している必要があります。

-registration_status

OERに作成されたアセットに設定される登録ステータスを指定します。受入れ可能な値は、Unsubmitted、PendingReview、UnderReviewおよびRegisteredです。

-simple_model

trueに設定した場合、単一アセット・モデルが作成されます。この場合、APIアセット・タイプが必要になります。

-apply_registrtion_status_to_existing_assets

trueに設定した場合、登録ステータスがイントロスペクト済モデル内の既存のアセットに適用されます。

-categorization_type

イントロスペクションから作成されたアセットに適用するカテゴリ分けタイプを指定します。カテゴリ分けを指定する必要もあります。

-categorization

イントロスペクションから作成されたアセットに適用するカテゴリ分けを指定します。カテゴリ分けタイプを指定する必要もあります。

-apply_categorization_to_existing_assets

trueに設定した場合、指定したカテゴリ分けがイントロスペクト済モデル内の既存のアセットに適用されます。

-help

ハーベスタのコマンド行ユーティリティのオンライン・ヘルプを表示します。

次に、リモート収集の例を示します。

harvest.bat -remote_url mysoasuiteserver:8001 -remote_username weblogic -remote_server_type SOASuite -remote_project MyComposite_rev1.0 -soa_partition department1

セキュリティを確実にするために、パスワードはコマンド行では渡さず、暗号化する必要があります。Oracle Enterprise Repositoryおよびリモート・サーバーのパスワードを設定する唯一の方法は、ハーベスタ構成(HarvesterSettings.xml)ファイルにパスワードを格納することです。パスワード暗号化ツール(encrypt.bat/encrypt.sh)を使用すると、ファイルに格納されているパスワードを暗号化できます。パスワードの暗号化の詳細は、第12章「パスワードの暗号化」を参照してください。

図8-1に、harvest.bat -helpコマンドによって表示されるコマンド行ユーティリティ・オプションおよびオンライン・ヘルプを示します。

図8-1 ハーベスタのコマンド行ユーティリティ・オプション

コマンド行オプションは、Oracle SOA Suite 11gサーバーから収集する場合にのみ必要です。その場合、-remote_server_type SOASuite11gオプションの指定が必要になります。詳細は、8.2.5.1項「Oracle SOA Suiteサーバーからの収集」を参照してください。

オプションを省略した場合は、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>

8.2.3 Repository.Submit Antタスクを使用したハーベスタの起動

ハーベスタをAntタスクとして起動すると、デプロイメント時にすべてのデプロイメント情報がOracle Enterprise Repositoryに格納されます。ハーベスタに付属のrepository.submit Antタスクを使用すると、メタデータを収集してOracle Enterprise Repositoryにインポートできます。このタスクは、<Harvester Home>ディレクトリ(12.1.3.0.0-OER-Harvester.zipを解凍したディレクトリ)にあるharvest-tasks.xmlファイルで定義できます。

この項には次のトピックが含まれます:

- 8.2.3.1項「repository.submit Antタスクのパラメータの指定」

- 8.2.3.2項「ネストされた要素としてのパラメータの指定」

- 8.2.3.3項「Antからのハーベスタの実行」

- 8.2.3.4項「サード・パーティ・タスクの使用」

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

表8-5に、harvest-tasks.xmlファイルでrepository.submit Antタスク用に指定できるパラメータを示します。

表8-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に作成された各アセットに関連付けるハーベスタの説明です。これはハーベスタ・プロパティに表示されます。ハーベスタ・プロパティの詳細は、A.7項「ハーベスタ・プロパティ」を参照してください。

いいえ。

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です。

8.2.3.2 ネストされた要素としてパラメータの指定

FileSet

FileSetは、収集するファイルのセットを選択するために使用します。1つ以上のfileSetを指定する必要があります。ハーベスタでは、.zip形式のファイル(.zip、.jar、.earファイルなど)を含め、fileSetで選択したすべてのファイルが確認されます。例8-1に示すAnt repository.submitタスクでは、fileSetディレクトリ(/tmp/componentsディレクトリ)の下位にあるすべてのファイルおよびディレクトリが確認され、これらがOracle Enterprise Repositoryにインポートされます。

URI

URIは、イントロスペクト対象のファイルを識別するために使用します。1つ以上のURIを指定できます。リモート・ファイルを指すhttp: URL、ローカル・ファイルを指すfile: URL、またはjavaでサポートされているその他のURLを指定できます。単一のファイルを指定することも、zip形式(zip、jar、earを含む)のファイルを指定することもできます。エクスポートされたOracle Service Busプロジェクトjarも含めることができます。Oracle Service Busプロジェクトは、Oracle Service Bus WorkshopからExport|Oracle Service Bus|Configuration Jarコマンドを使用してエクスポートできます。artifactStore属性は、検索対象のOracle Enterprise Repositoryアーティファクト・ストアの名前です。アーティファクト・ストアは、Oracle Enterprise Repositoryのアセット・エディタで事前に作成しておく必要があります。指定した場合、URIはアーティファクト・ストアのURLに対する相対パスとして解決されます。アーティファクト・ストアに対する相対URIを指定する場合、そのURIは.wsdl、.zipなどのファイルに解決される必要があります。ディレクトリを指すURIはサポートされていません。fileType属性では、収集するファイルのファイル・タイプを指定します。指定しなかった場合は、ファイル拡張子からタイプが導出されます。config/pluginsフォルダ内のファイル・タイプのいずれかに対応する値を指定する必要があります。デフォルトでは、.bpel、.mfl、.policy、.wsdl、.xsd、.xquery、.xsltがサポートされています。

例8-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>

登録ステータスおよびカテゴリ分け

HarvesterSettings.xmlファイルでは、ハーベスタから作成されたアセットの登録ステータスを指定できます。受入れ可能な値は次のとおりです。

- 未発行

- 発行済 - レビュー保留

- 発行済 - レビュー中

- 登録済

注意:
収集されたアセットのregistrationStatusをHarvesterSettings.xmlファイルで設定する際に受入れ可能な値は、コマンド行から収集する場合に使用される受入れ可能な値とは異なります。表8-4の-registration_statusエントリを参照してください。

デフォルトでは、登録ステータスは新規に作成されたアセットに適用されます。同じアーティファクトの前回の収集から作成されたアセットの登録ステータスを指定することもできます。有効にするには、例8-1に示すように、applyRegistrationStatusToExistingAssetsをtrueに設定します。

ハーベスタから作成されたアセットにカテゴリ分けを適用できます。そのためには、アセット・エディタのカテゴリ分けの構成タブに表示されるカテゴリ分けタイプの内部名を把握しておく必要があります。必須の値は要素名です。

1. アセット・エディタを開きます。

2. 「アクション」→カテゴリ分けの構成を選択します。

3. カテゴリ分けタイプを選択し、「編集」を選択します。要素名フィールドに値が表示されます(例8-2を参照)。

図8-2 カテゴリ分けの編集

要素名は、アセット・エディタのカテゴリ分けの構成ウィンドウにあるフィールドを指しています。このフィールドの値をHarvesterSettings.xmlで使用します。

登録ステータスとカテゴリ分けはコマンド行でも適用できます。コマンド行パラメータは、-registration_status、-apply_registration_status_to_existing_assets、-categorization_typeおよび-categorizationです。

RemoteProject

RemoteProjectでは、ハーベスタがファイルではなくリモート・サーバーのプロジェクトを読み取るように指定します。uri属性では、リモート・プロジェクトの収集元となる実行中のサーバーを指定します。usernameおよびpassword属性では、リモート・サーバーに対するログイン情報を指定します。

serverType属性では、リモート・サーバーのタイプとして、SOASuite、Oracle Service Bus、WebLogic Serverのいずれかを指定します。projectName要素では、収集対象として、ファイルではなく、リモート・プロジェクトの名前を指定します。省略した場合は、サーバー上のすべてのプロジェクトが収集されます。Oracle SOA Suiteの場合は、コンポジットの名前にリビジョンを付加したもの(MyComposite_rev1など)を指定する必要があります。WLSの場合は、WebLogic管理コンソールおよびEnterprise Managerに表示されるアプリケーション名を指定する必要があります。

例8-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ファイル内でも同様に設定できます。

8.2.3.3 Antからのハーベスタの実行

ハーベスタのAntタスクをインポートするには、Ant XMLに次の行を追加します。

<taskdef file=${harvester.dir}/harvest-tasks.xml/>

harvester.dirは、12.1.3.0.0-OER-Harvester.zipを解凍した<harvester home>ディレクトリです。

コマンド行から実行する場合は、Antのクラスパスに対してハーベスタのライブラリが利用可能になっていることを確認します。ハーベスタには、antのクラスパスを正しく設定できるrunantというスクリプトが用意されています。ハーベスタのantタスクを使用する場合は、このスクリプトを使用してantを起動する必要があります。次に例を示します。

runant -f mybuild.xml

ここで、mybuild.xmlはantのビルドXMLです。

runantに渡した引数はすべてantにも渡されます。harvest.batまたはharvest.shを実行する前に、必要な環境変数が設定されていることを確認します。設定が必要な環境変数のリストは、表8-6を参照してください。

表8-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からプロジェクトを収集する場合は、BEA_HOME環境変数がOracle Service Busサーバーを含むインストール・ディレクトリを指していることを確認します。たとえば、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

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

runantスクリプトでは、antの旧ランチャ(org.apache.tools.ant.Main)が使用されます。新ランチャではURIClassLoaderインタフェースが使用され、これによりOracle Service BusのカスタムURIStreamHandlersの使用が妨げられます。

旧antランチャでは、ant/libディレクトリ内のカスタムantタスクの自動検出はサポートされていません。<taskdef>を使用してカスタム・タスクを定義する場合は、classpath属性を指定する必要があります。

たとえば、次の例は<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"/>

8.2.4 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\common\wlst\libディレクトリにコピーします。

2. コマンド・ウィンドウで、次のコマンドを入力します。

- WLSTクラスパスを初期化します。<BEA_HOME>\wlserver\server\bin\setWLSEnv.cmdを実行します。

- ハーベスタ・クラスパスを初期化します。<harvester>フォルダに移動し、<harvester>\setenv.batを実行します。

- WLSTを起動します。java weblogic.WLST<scriptname>を実行します。

3. WLSTをantから起動するには、次の手順を実行します。

- コマンド・プロンプトで、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つの引数としてコマンド行パラメータのディクショナリを受け取ります。これらのパラメータはハーベスタのコマンド行から使用できるものと同じです。

ハーベスタをコマンド行から使用する方法の詳細は、8.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から収集する場合に必要になります。

8.2.5 実行時収集の詳細

アセットが開発環境からテスト環境、ステージング環境および本番環境へと移るときに、これらのアセットをOracle Enterprise Repositoryに収集し、Oracle Enterprise Repositoryに最新のエンドポイントが含まれるようにすることができます。Oracle Enterprise Repositoryでは、新しいエンドポイントが既存のアセットに関連付けられます。アセットがそのライフサイクル内を移動する際にWSDLが変更された場合は、更新版のWSDLもOracle Enterprise Repository内の既存のアセットに関連付けられます。

この項では、様々なサーバーの実行時収集について詳しく説明します。この項には次のトピックが含まれます:

- 8.2.5.1項「Oracle SOA Suiteサーバーからの収集」

- 8.2.5.2項「WebLogic ServerからのWebサービスの収集」

- 8.2.5.3項「Oracle Service BusからのWebサービスの収集」

- 8.2.5.4項「デプロイ済サービスの収集」

8.2.5.1 Oracle SOA Suiteサーバーからの収集

Oracle SOA Suiteサーバーから収集する場合は、次のWLSセキュリティ・ロールが必要です。

- 管理

- オペレータ

- モニター

-remote_urlパラメータでは、soa-infra管理対象サーバーのポートを指定する必要があります。Oracle SOA Suiteでのデフォルト値は8001です。

soa-infra管理対象サーバーが稼働中である必要があります。収集はリモート収集の一環としてMDSデータベースに接続します。MDSデータベースが稼働しており、収集を実行しているマシンからアクセス可能である必要があります。

SSL/HTTPプロトコルがサポートされています。ハーベスタはt3プロトコルを介してサーバーMBeansに接続します。

ハーベスタにより、実行時サーバーから収集されたアセットのDeployment URIプロパティに、-remote_urlの値が自動的に保存されます。

次に、Oracle SOA Suite 12cサーバーから収集する場合の例を示します。

harvest.bat -remote_url mysoasuiteserver:8001 -remote_username weblogic -remote_server_type SOASuite -remote_project MyComposite_rev1.0 -soa_partition default

次に、Oracle SOA Suite 11gサーバーから収集する場合の例を示します。

harvest.bat -remote_url mysoasuiteserver:8001 -remote_username weblogic -remote_server_type SOASuite11g -remote_project MyComposite_rev1.0 -soa_partition default

セキュリティを確実にするために、パスワードはコマンド行では渡さず、暗号化する必要があります。Oracle Enterprise Repositoryおよびリモート・サーバーのパスワードを設定する唯一の方法は、ハーベスタ構成(HarvesterSettings.xml)ファイルにパスワードを格納することです。パスワード暗号化ツール(encrypt.bat/encrypt.sh)を使用すると、ファイルに格納されているパスワードを暗号化できます。パスワードの暗号化の詳細は、第12章「パスワードの暗号化」を参照してください。

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>

注意:
Oracle SOA Suite 11gの場合は、<servertype>要素をSOASuite11gに設定する必要があります。さらに、Oracle SOA Suite 11gサーバーから収集する場合は、-remote_server_type SOASuite11gコマンド行引数の指定も必要です。

注意:
パーティションは、バージョン11g R1 PS2以上のSOAサーバーでのみ使用してください。PS2より前のバージョンを使用している場合は、soaPartition要素をコメント化してください。
デフォルトでは、ハーベスタは、defaultに設定されたpartition_nameオプションを使用して収集します。指定されていない場合、SOAデプロイメントにより、パーティションdefaultがすぐに使用できます。

クラスタ内のSOA Suiteコンポジットの収集

OHSサーバーは、Web層ラベルの一部としてミドルウェア・ホームにデプロイされ、このミドルウェア・ホーム内に構成されているドメインにも関連付けられます。

一般に多くのURIがOHSサーバーのmod_wl_2x.so HTTPサーバー・モジュールに割り当てられます。次に、その一部を示します(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クラスタ・インストールに適用されている唯一のカスタマイズです。

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

WebLogic Serverから収集する場合は、WebLogic Serverセキュリティ・ロールは不要です。

-remote_urlパラメータは、WLS管理サーバーのポートを指している必要があります。Weblogicでのデフォルト値は7001です。WLS管理サーバーが稼働中である必要があります。SSL/HTTPプロトコルがサポートされています。ハーベスタはt3プロトコルを介してサーバーMBeansに接続します。

ハーベスタにより、実行時サーバーから収集されたアセットのDeployment URIプロパティに、-remote_urlの値が自動的に保存されます。

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

Oracle Service BusからWebサービスを収集する場合は、WLSセキュリティ・ロール「管理」が必要です。

Oracle Service Bus 12cサーバーからWebサービスを収集する場合は、OSBハーベスタを使用する必要があります。OSBハーベスタは<FMW_HOME>/oer/tools/osbharvesterディレクトリにインストールされています。

OSBハーベスタは、コマンド行からosb-harvest.batまたはosb-harvest.shユーティリティを使用して実行できます。OSBハーベスタの構成の詳細は、8.2.2項「コマンド行用のハーベスタの構成」を参照してください。

Service Bus 11gサーバーから単純でないアセットを収集する場合は、Service Bus 11gに付属のハーベスタを使用できます。次のノートでは、Service Bus 11gサーバーから単純なモデルAPIアセット(表8-4で示すように、simple_modelプロパティを設定することから生じる)を収集するプロセスを説明します。

注意:
osb-harvest.bat/.shユーティリティを使用してService Bus 11gサーバーから単純モデル・アセットを収集する場合、Service Bus 12cがインストールされている同じミドルウェア・ホームからService Busハーベスタを実行する必要があります。Service Busサーバーが11gであっても、ハーベスタにはService Bus 12cライブラリが必要です。これを実行するには様々な方法がありますが、最も簡単な方法は、Service Busハーベスタを既存のService Bus 12cサーバーにコピーすることです。
Service Bus 12cが別のクライアントまたは別のミドルウェア・ホームにインストールされている場合、この場所を記述するsetenv.shまたはsetenv.batスクリプトを更新できます。

-remote_urlパラメータは、Oracle Service Busドメイン用のWLS管理サーバーのポートを指している必要があります。Weblogicでのデフォルト値は7001です。WLS管理サーバーが稼働中である必要があります。SSL/HTTPプロトコルがサポートされています。ハーベスタはt3プロトコルを介してサーバーMBeansに接続します。

ハーベスタにより、実行時サーバーから収集されたアセットのDeployment URIプロパティに、-remote_urlの値が自動的に保存されます。

次に、Oracle Service BusからWebサービスを収集する場合の例を示します。

osb-harvest.bat -remote_url myosbserver:7001 -remote_username weblogic -remote_server_type OSB -remote_project MyOSBProject

セキュリティを確実にするために、パスワードはコマンド行では渡さず、暗号化する必要があります。Oracle Enterprise Repositoryおよびリモート・サーバーのパスワードを設定する唯一の方法は、ハーベスタ構成(HarvesterSettings.xml)ファイルにパスワードを格納することです。パスワード暗号化ツール(encrypt.bat/encrypt.sh)を使用すると、ファイルに格納されているパスワードを暗号化できます。パスワードの暗号化の詳細は、第12章「パスワードの暗号化」を参照してください。

8.2.5.4 デプロイ済サービスの収集

SOA SuiteおよびService BusからのAPIの収集に加えて、デプロイ済WSDLファイルへのURLを使用してデプロイ済サービスを収集することもできます。次の例では、インターネットから気象サービスを収集しています。

./harvest.sh -file "http://example.com/WeatherWebService/Weather.asmx?WSDL"

このメソッドを使用すると、Oracle API Gateway (OAG)からセキュアなエンドポイントを収集できます。OAGからWSDL URLを取得するには、Webサービスのサービス・ハンドラで、WSDLのタブにあるゲートウェイからクライアントへのWSDLの公開を許可するチェック・ボックスを選択し、OAG Policy Studioからクライアントに対してWSDLが公開されるようにします。

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

<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イベントがトリガーされます。

ハーベスタ・プロパティの詳細は、A.7項「ハーベスタ・プロパティ」を参照してください。

8.2.6.1 Oracle Metadata ServiceのURL

ハーベスタでは、OracleのMDS (Metadata Service)からのファイルの読取りがサポートされています。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)というセクションを非コメント化します。また、Oracle SOA SuiteサーバーのMDSデータベースを指すようにjdbc-url、jdbc-useridおよびjdbc-passwordプロパティを変更します。

次の例に示すように、コマンド行から収集することもできます。

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ファイルに関する項を参照してください。

8.2.6.2 クラスパスURL

ハーベスタでは、javaクラスパスからのファイルの読取りがサポートされています。これらのファイルはclasspath: URLプロトコルを介して参照されます。これらのファイルは、ハーベスタのクラスパスにあるjarファイルまたはディレクトリ内にあります。たとえば、classpath:/META-INF/wsdl/ServiceException.wsdlです。

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

ハーベスタでは、log4jを使用してタスク実行が詳細にロギングされ、ログ・ファイルが<Harvester Home>ディレクトリに格納されます。ロギング・オプションを変更するには、<Harvester Home>ディレクトリにあるlog4fl.propertiesファイルを更新します。

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

デフォルトでは、ハーベスタによるOracle Enterprise Repositoryに対するすべての変更が単一のトランザクションで行われます。ハーベスタ機能でのトランザクション操作は次のルールに従います。

- Oracle Enterprise Repository 12cサーバーでは、一度に1つのトランザクションのみがサポートされます。トランザクションを開始できない場合は、ハーベスタから通知されます。

- トランザクションには一連のタイムアウトが関連付けられます。タイムアウトを超えると、ハーベスタ操作が停止されます。

- 設定cmee.extframework.impexp.monitor.rex.maxidleでは、クライアントとの接続が失われた場合にトランザクションが維持される最長時間を指定します。これにより、クライアント側のハーベスタ・プロセスが中断された場合にトランザクションを取り消すことができます。

- 設定cmee.extframework.impexp.monitor.maxruntimeでは、トランザクション全体に許容される最長時間を指定します。

単一の操作がcmee.extframework.impexp.monitor.rex.maxidle (maxidle)の設定を超え、後続の操作がすべて失敗する可能性があります。その場合、ログ内の最後のエラーとして「トランザクションが開始されていないため、ロールバックしようとしたときにエラーが発生しました」が記録されます。これは、文がmaxidleを超えたときにトランザクションが自動的にロールバックしましたが、クライアント・アプリケーションが強制ロールバックを試行したときにはトランザクションがもう存在しておらず、エラーを検出したことが原因です。結果として、ハーベスタ操作によるデータは、Oracle Enterprise Repositoryに追加されません。

8.2.9 拡張構成

この項では、ハーベスタの拡張構成オプションについて説明します。

アダプタおよびアプリケーション

ハーベスタには、サポート対象とするアダプタ・アセットおよびアプリケーション・アセットを制御するための構成ファイル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で手動で作成する必要があります。12.1.3.0.0-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に対応しています。namespaceが存在する場合は、アダプタ構成アセットは作成されず、アダプタ・デプロイメントのみが作成されます。

アダプタまたはアプリケーションに可能性のあるJCAクラスまたはXMLネームスペースが複数存在する場合は、複数のadapter要素が1つのadapterAssetに対応していることがあります。各adapterAsset要素は、作成されるアダプタ・アセットまたはアプリケーション・アセット(あるいはその両方)を示しています。name属性は、対応するadapter要素の名前と一致している必要があります。Oracle Enterprise Repositoryには、adapterAsset要素ごとに1つのアダプタ・アセットまたはアプリケーション・アセット(あるいはその両方)が作成されます。

- applicationName
applicationName属性が存在する場合は、アプリケーション・アセットの作成も必要であることを示しています。各プロパティ要素によって、指定されたデータが、作成されるアダプタ・アセットのハーベスタ・プロパティ・セクションに設定されます。

ハーベスタ・プロパティの詳細は、A.7項「ハーベスタ・プロパティ」を参照してください。

8.3 アーティファクトの収集

この項では、ハーベスタを構成し、統合開発環境内で使用する方法について説明します。

この項には次のトピックが含まれます:

- 8.3.1項「アーティファクトの収集」

- 8.3.2項「重複するアーティファクトの検出」

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

- 8.3.4項「収集されたアセットの検索」

- 8.3.5項「ハーベスタでの作成対象アセットのプレビュー」

- 8.3.6項「ベスト・プラクティス」

- 8.3.7項「既知の問題」

8.3.1 アーティファクトの収集

メタデータは、コマンド行またはAntタスクを使用してOracle Enterprise Repositoryに発行できます。

ハーベスタによりアーティファクトがスキャンおよび収集され、それらのアーティファクト間の依存関係が検出されます。次の項では、アーティファクトについて説明します。

- 8.3.1.1項「BPEL」

- 8.3.1.2項「WSDL」

- 8.3.1.3項「WADL」

- 8.3.1.4項「XSD」

- 8.3.1.5項「XSL」

- 8.3.1.6項「Oracle SOA Suiteの収集」

- 8.3.1.7項「JCAアダプタ」

- 8.3.1.8項「Oracle BSE (WSDL/SOAP)を使用するアプリケーション」

- 8.3.1.9項「プロキシ・サービスまたはビジネス・サービス」

- 8.3.1.10項「Oracle Service Bus (OSB)プロジェクト」

- 8.3.1.11項「BPMN」

ハーベスタによりこれらのアーティファクトのエンティティがOracle Enterprise Repositoryに作成され、それらの間のリレーションシップが確立されます。

Oracle Enterprise Repositoryに作成されたアーティファクトは、作成されたアセットのファイル情報に格納されます。収集されたアーティファクトがローカルに格納される場合は、Oracle Enterprise Repositoryに物理ファイルが格納されます。それに対し、収集されたファイルがリモートに格納される場合(http://)、Oracle Enterprise Repositoryは、そのアーティファクトのURLの場所を指します。収集されたアーティファクトのうちローカルに格納されたものは、デフォルトではExchange UtilityによりOSRに公開されません。リモートに格納されたアーティファクトのみが公開されます。

図8-3に、ハーベスタにより作成されるアセット・タイプとそれらのアセット間のリレーションシップを示します。また、図8-4に、アセット・モデル図の例を示します。

注意:
リレーションシップ・ロール名は、プライマリ・ロール、セカンダリ・ロールの順に示されています。
それに続く図では、プライマリ・ロールが各矢印の始点に、セカンダリ・ロールが各矢印の終点に配置されています。

図8-3 ハーベスタにより作成されるアセット・タイプ

8.3.1.1 BPEL

BPELアーティファクトがOracle Enterprise Repositoryに発行されると、Oracle Enterprise Repositoryで次の処理が行われます。

- ビジネス・プロセス・アセット(タイプBusiness Process:BPEL)がタイプArtifact:BPELのアーティファクト・アセットに直接関連付けられます。

- BPELアーティファクト・コンテンツを含むBPELアーティファクト・アセット(タイプArtifact:BPEL)が作成されます。

- Defined byリレーションシップを使用して、ビジネス・プロセスがBPELアーティファクト・アセットに関連付けられます。

- BPELフロー内の各パートナ・リンクについて、ビジネス・プロセスがインタフェース・アセット(タイプInterface)にも関連付けられます。

- BPELアーティファクト・アセットがWSDLアーティファクト・アセットおよびXSLTアーティファクト・アセット(フロー内で変換が行われた場合)に関連付けられます。これらのWSDLには、ビジネス・プロセスのパートナ・リンクおよびエントリ・ポイントの定義が含まれています。

図8-4 アセット・モデル

8.3.1.2 WSDL

WSDLアーティファクトがOracle Enterprise Repositoryに発行されると、Oracle Enterprise Repositoryで次の処理が行われます。

- WSDLにサービスが含まれている場合は、サービス・アセット(タイプService)が作成されます。

- ポート・タイプに対してインタフェース・アセット(タイプInterfaces)が作成されます。

- Contains interfaceリレーションシップを使用して、サービスがインタフェース・アセットに関連付けられます。

- ポートに対してエンドポイント・アセットが作成されます。

- Deployed toリレーションシップを使用して、サービス・アセットがエンドポイント・アセットに関連付けられます。

- WSDLアーティファクト・コンテンツを含むWSDLアーティファクト・アセット(タイプArtifact:WSDL)が作成されます。

- WSDLアーティファクトによりWSDLがインポートされ、XSDがインポートされるか含まれている場合は、Referencesリレーションシップを使用してそれらのWSDLおよびXSDアーティファクト・アセットに関連付けられます。

8.3.1.3 WADL

WADLアーティファクトがOracle Enterprise Repositoryに発行されると、Oracle Enterprise Repositoryで次の処理が行われます。

- WADLにサービスが含まれている場合は、サービス・アセット(タイプService)が作成されます。

- ポート・タイプに対してインタフェース・アセット(タイプInterfaces)が作成されます。

- Contains interfaceリレーションシップを使用して、サービスがインタフェース・アセットに関連付けられます。

- ポートに対してエンドポイント・アセットが作成されます。

- Deployed toリレーションシップを使用して、サービス・アセットがエンドポイント・アセットに関連付けられます。

- WADLアーティファクト・コンテンツを含むWADLアーティファクト・アセット(タイプArtifact:WADL)が作成されます。

- WADLアーティファクトによりWSDLがインポートされ、XSDがインポートされるか含まれている場合は、Referencesリレーションシップを使用してそれらのWSDLおよびXSDアーティファクト・アセットに関連付けられます。

8.3.1.4 XSD

XSDアーティファクトがOracle Enterprise Repositoryに発行されると、Oracle Enterprise Repositoryで次の処理が行われます。

- XSDアーティファクト・コンテンツを含むXSDアーティファクト・アセット(タイプArtifact:XSD)が作成されます。

- XSDアーティファクトによりXSDがインポートされるか含まれている場合は、Referencesリレーションシップを使用してそれらのXSDアーティファクト・アセットに関連付けられます。

8.3.1.5 XSL

XSLアーティファクトがOracle Enterprise Repositoryに発行されると、Oracle Enterprise Repositoryで次の処理が行われます。

- XSLアーティファクト・コンテンツを含むXSLアーティファクト・アセット(タイプArtifact:XSL)が作成されます。

- XSLアーティファクトにより変換のソースおよびターゲットとしてXSDおよびWSDLが参照されている場合は、Referencesリレーションシップを使用してそれらのXSDおよびWSDLアーティファクト・アセットに関連付けられます。

8.3.1.6 Oracle SOA Suiteの収集

この項では、Oracle SOA Suiteプロジェクトの収集について説明します。

- コンポジット: Oracle SOA Suiteプロジェクト・フォルダまたはcomposite.xmlファイルがイントロスペクトされると、Oracle Enterprise Repositoryで次の処理が行われます。

- コンポジット・アセットが作成されます。

- コンポジットによってサービスが公開されている場合は、Oracle Enterprise Repositoryにコンポジット・サービス・アセットが作成されます。これらは、Sync-ExposesServiceリレーションシップを使用してコンポジットに関連付けられます。

- コンポジットによって参照が公開されている場合は、Oracle Enterprise Repositoryにコンポジット参照アセットが作成されます。これらは、Sync-ExposesReferenceリレーションシップを使用してコンポジットに関連付けられます。

- composite.xmlファイルは、Artifact: Compositeタイプのアセットになり、Sync-Definesリレーションシップを使用してコンポジットに関連付けられます。

- コンポジット・デプロイメント: Oracle SOA Suiteプロジェクト・フォルダまたはcomposite.xmlファイルがイントロスペクトされると、Oracle Enterprise Repositoryで次の処理が行われます。

- コンポジット・デプロイメント・アセットが作成されます。

- コンポジット・デプロイメントによってサービスが公開されている場合は、Oracle Enterprise Repositoryにコンポジット・デプロイメント・サービス・アセットが作成されます。これらは、Sync-ExposesServiceリレーションシップを使用してコンポジット・デプロイメントに関連付けられます。

- コンポジットによって参照が公開されている場合は、Oracle Enterprise Repositoryにコンポジット・デプロイメント参照アセットが作成されます。これらは、Sync-ExposesReferenceリレーションシップを使用してコンポジット・デプロイメントに関連付けられます。

- コンポジット・デプロイメントは、Deployment-Deploysリレーションシップを使用してコンポジットに関連付けられます。

- コンポーネント・レベルのアーティファクト: 次のコンポジット・コンポーネントが作成され、Sync-Containsリレーションシップを使用してコンポジットに関連付けられます。

- BPELプロセスが存在する場合は、Business Process:BPELアーティファクトが作成されます。

- これはSync-Definesリレーションシップを使用してArtifact:BPELアーティファクトに関連付けられます。これは依存アーティファクトに関連付けられます(8.3.1.1項「BPEL」を参照)。

- メディエータが存在する場合は、サービス・タイプ属性がMEDIATORに設定されたサービス・アセットが作成されます。

- これはSync-Definesリレーションシップを使用してArtifact:MPlanアーティファクトに関連付けられます。これはArtifact-Referencesリレーションシップを使用して依存Artifact:XSLTアーティファクトに関連付けられます。

- ヒューマン・タスクが存在する場合は、ヒューマン・タスク・アセットが作成されます。

- これはSync-Definesリレーションシップを使用してArtifact:Taskアーティファクトに関連付けられます。これはArtifact-Referencesリレーションシップを使用して依存Artifact:XSDアーティファクトに関連付けられます。

- ビジネス・ルールが存在する場合は、ビジネス・ルール・アセットが作成されます。

- これはSync-Definesリレーションシップを使用してArtifact:Decsアーティファクトに関連付けられます。これはArtifact-Referencesリレーションシップを使用して依存Artifact:Rulesアーティファクトに関連付けられます。Artifact:Rulesアーティファクトは、Artifact-Referencesリレーションシップを使用して依存Artifact:XSDアーティファクトに関連付けられます。

- Springコンテキスト・コンポーネントが存在する場合は、Springコンテキスト・アセットが作成されます。

- これはSync-Definesリレーションシップを使用してArtifact:SpringBeansアーティファクトに関連付けられます。これは"Artifact-References"リレーションシップを使用して他のArtifact:SpringBeansアーティファクトに関連付けられます。

- コンポーネント・レベルのリレーションシップ:

- コンポーネントによってコンポーネント・サービスが提供されている場合は、インタフェース・アセットが作成されます。これはBPEL-Entry pointリレーションシップを使用してコンポーネント・レベルのアセットに関連付けられます(メディエータについては例外で、Service-Interfaceリレーションシップを使用して関連付けらます)。

- composite.xmlに<interface.ws>と定義されている場合は、サービスはインタフェース・アセットに関連付けられます。composite.xmlに<interface.java>と定義されている場合は、サービスはインタフェース・タイプ属性がJavaに設定されたインタフェースに関連付けられます。

- コンポーネント・サービスがコンポジット・レベルにプロモートされると、サービス・アセットはComposite-Promotesリレーションシップを使用して対応するコンポジット・サービス・アセットに関連付けられます。

- コンポーネント・サービスでWebサービスまたはWSIFバインディングが使用されるようにcomposite.xmlに定義されている場合は、エンドポイントWebサービス・アセットが作成されます。この場合、バインディング・タイプ属性がWeb ServiceまたはWSIFに設定されます。サービスがプロモートされると、これはComposite-Promotesリレーションシップを使用してコンポジット・デプロイメント・サービス・アセットに関連付けられます。

- コンポーネント・サービスでEJBまたはADFバインディングが使用されるようにcomposite.xmlに定義されている場合は、エンドポイント・アセットが作成されます。この場合、バインディング・タイプ属性がADF ServiceまたはEJB Serviceに設定されます。サービスがプロモートされると、これはComposite-Promotesリレーションシップを使用してコンポジット・デプロイメント・サービス・アセットに関連付けられます。

- コンポーネント・サービスでJCAまたはB2Bアダプタが使用される場合は、アダプタ構成アセットが作成されます。JCAアダプタの場合、これは対応するArtifact: JCAアセットに関連付けられます。これは対応するアダプタ・アセットに関連付けられます。サービスがプロモートされると、アダプタ構成はComposite-Promotesリレーションシップを使用してコンポジット・デプロイメント・サービス・アセットに関連付けられます。

- コンポーネントでプロモートされないコンポーネント参照が使用されている場合は、インタフェース・アセットが作成されます。コンポーネント参照に対しては新しいサービスは作成されません。ただし、対応するサービス・アセットがOracle Enterprise Repositoryまたは現在のイントロスペクションにすでに存在する場合は、コンポーネント参照に関連付けられます。このルールにより、参照プロジェクトとそれを公開するプロジェクトの両方のネームスペースにサービス・アセットが重複して作成されることがなくなります。これはPartner-Link pointリレーションシップを使用してコンポーネント・レベルのアセットに関連付けられます(メディエータについては例外で、Service-Frontsリレーションシップを使用して関連付けらます)。

- プロモートされるコンポーネント参照については、対応するサービス・アセットがOERに存在する場合は、そのサービス・アセットがComposite-Promotesリレーションシップを使用して対応するコンポジット参照アセットに関連付けられます。

- デプロイ済のプロモートされるコンポーネント参照でWebサービスまたはWSIFバインディングが使用されており、対応するエンドポイントWebサービスがOERに存在する場合は、それがComposite-Promotesリレーションシップを使用してコンポジット・デプロイメント参照アセットに関連付けられます。

- デプロイ済のプロモートされるコンポーネント参照でADFまたはEJBバインディングが使用されており、対応するエンドポイントがOERに存在する場合は、それがComposite-Promotesリレーションシップを使用してコンポジット・デプロイメント参照アセットに関連付けられます。

- デプロイ済のプロモートされるコンポーネント参照でJCAまたはB2Bアダプタが使用されており、対応するアダプタ構成アセットがOERに存在する場合は、それがComposite-Promotesリレーションシップを使用してコンポジット・デプロイメント・サービス・アセットに関連付けられます。

8.3.1.7 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

- サービスにエンドポイントが存在する場合は、アプリケーション・デプロイメント・アセットが作成されます。

- アプリケーション・アセットに関連付けられます。

- エンドポイント・アセットに関連付けられます。

8.3.1.8 Oracle BSE (WSDL/SOAP)を使用するアプリケーション

BSE (Business Service Engine)を使用して外部アプリケーションに接続するBPELプロセスまたはアプリケーションが収集されると、Oracle Enterprise Repositoryで次の処理が行われます。

- ハーベスタのadapters.xmlファイルに構成されているアプリケーション・アセットがOracle Enterprise Repository内で検索されます。

- サービスにエンドポイントが存在する場合は、アプリケーション・デプロイメント・アセットが作成されます。

- アプリケーション・アセットに関連付けられます。

- エンドポイント・アセットに関連付けられます。

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

プロキシ・サービスまたはビジネス・サービスがOracle Enterprise Repositoryに発行されると、Oracle Enterprise Repositoryで次の処理が行われます。

- サービス・タイプがProxy ServiceまたはBusiness Serviceのサービス・アセットが作成されます。

- リレーションシップContains interfaceを使用して、サービスがインタフェース・アセットに関連付けられます。

- プロキシ・サービスまたはビジネス・サービスがOracle Service BusのWeb Serviceタイプである場合、次のようになります。

- ポート・タイプに対してInterfaceアセットが作成されます。

- ポートに対してEndpointアセットが作成されます。

- これにより、Oracle Enterprise Repository Web UIの「概要」セクションにEndpointURIプロパティが表示されるようになります。

- リレーションシップDeployed toを使用して、サービス・アセットがEndpointアセットに関連付けられます。

- WSDLアーティファクト・コンテンツを含むWSDLアーティファクト・アセット(タイプArtifact:WSDL)が作成されます。

- プロキシ・サービスまたはビジネス・サービスがOracle Service BusのWeb Serviceタイプではない場合、次のようになります。

- ポート・タイプに対してインタフェース・アセットが作成されます。

- ポートに対してエンドポイント・アセットが作成されます。

- これにより、Oracle Enterprise Repository Web UIのハーベスタ・プロパティ・セクションにEndpointURIプロパティが表示されるようになります。ハーベスタ・プロパティの詳細は、A.7項「ハーベスタ・プロパティ」を参照してください。

- リレーションシップDeployed toを使用して、サービス・アセットがエンドポイント・アセットに関連付けられます。

- このサービスに関連付けられているWSDLはありません。したがって、RR-XUユーティリティを使用してUDDIと統合できません。また、Oracle Enterprise Repository Web UIのUse|Download機能やOracle Eclipse Workshopのサービス使用フレームワーク機能でWSDLを利用できません。

- WSDLアーティファクトによりWSDLがインポートされ、XSDがインポートされるか含まれている場合は、リレーションシップReferencesを使用してそれらのWSDLおよびXSDアーティファクト・アセットに関連付けられます。

- Frontsリレーションシップを使用して、プロキシ・サービスがその後ろにあるビジネス・サービスまたはプロキシ・サービスに関連付けられます。

- Invokesリレーションシップを使用して、ビジネス・サービスがそれによって起動される外部サービスおよびフローに関連付けられます。

- Defined byリレーションシップを使用して、Oracle Service Busのインタフェースを定義するアーティファクト(Artifact:WSDL、Artifact:XSDまたはArtifact:MFL)がインタフェース・アセットに関連付けられます。

- "Artifact-References"リレーションシップを使用して、Oracle Service Busにサービスを実装するために使用されるアーティファクト(Artifact:XQuery、Artifact:XSLT、Artifact:MFLまたはArtifact:WS-Policy)がArtifact:ProxyアセットまたはArtifact:Bizアセットに関連付けられます。

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

Oracle Service Busプロジェクトは、コマンド行からOracle Enterprise Repositoryに発行できます。OSBからの収集の詳細は、8.2.5.3項「Oracle Service BusからのWebサービスの収集」を参照してください。

ハーベスタによって、プロキシ・サービス、ビジネス・サービスおよびフローが処理されます。また、BPEL、WSDL、XSD、XSLT、XQuery、WS-Policy、MFLなどのアーティファクトも処理され、これらのアーティファクトが収集されてこれらの間にある依存関係が検出されます。ハーベスタによりエンティティがOracle Enterprise Repositoryに作成され、それらの間のリレーションシップが確立されます。

注意:
収集時には、収集対象となるコンテンツにより適したハーベスタを使用してください。たとえば、Oracle Service Busプロジェクトを収集する場合は、Oracle Service Busハーベスタを使用してください。

8.3.1.11 BPMN

BPMNアーティファクトがOracle Enterprise Repositoryに発行されると、Oracle Enterprise Repositoryで次の処理が行われます。

- ビジネス・プロセス・アセット(タイプBusiness Process:BPMN)がタイプArtifact:BPMNのアーティファクト・アセットに直接関連付けられます。

- BPMNアーティファクト・コンテンツを含むBPMNアーティファクト・アセット(タイプArtifact:BPMN)が作成されます。

- "Defined by"リレーションシップを使用して、ビジネス・プロセスがBPMNアーティファクト・アセットに関連付けられます。

8.3.2 重複するアーティファクトの検出

ハーベスタにより、WSDL、BPEL、BPMN、XSDなどのファイルに関する情報が、アーティファクトとしてOracle Enterprise Repositoryに格納されます。同じアーティファクト・ファイルが2回格納されることがないように、アーティファクトの格納時に、各アーティファクトについてSoftware File ID (SFID)が計算されます。新しいアーティファクトが発行される前に、そのSFIDがリポジトリ内の既存のSFIDと比較され、重複していないかチェックされます。

SFIDはMD5ハッシュとして計算されます。SFIDを計算する前にある程度の正規化が行われます。特に、アーティファクト・ファイルがXMLである場合は、Apache XML SecurityライブラリのCanonicalizerクラスを使用して正規化されます。この正規化は、W3C Canonical XML標準(www.w3.org/TR/xml-c14nを参照)に従って行われ、テキスト・エンコーディング、改行、空白、コメントおよび属性順序の正規化が含まれます。W3C標準に規定されていないいくつかの追加の正規化も行われます。たとえば、ネームスペース接頭辞の正規化、WSDLの要素の順序の正規化、ドキュメント要素の削除、包含/インポートされたファイルのインライン化などです。

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

ハーベスタでは、収集されたアセットからダウンロードできるアーティファクト・バンドルが作成されます。これらのアセットのアーティファクト・バンドルはzipファイルに格納されます。たとえば、エンドポイントの場合、WSDLファイルとそれに関連付けられているXSDファイルがzipペイロード内の相対位置に格納されます。

アーティファクトが別のアーティファクトをインポートする場合(WSDLによるXSDのインポートなど)、アーティファクトは常に親アーティファクトに対して相対的な子アーティファクトを参照します。たとえば、MyWSDL.wsdlがc:\tempにあり、インポート対象の子XSDがc:\temp\schemas\MyXSD.xsdにある場合、親のMyWSDL.wsdlでは、相対パス./schemas/MyXSD.xsdを使用して子がインポートされます。バンドルのダウンロード時には、親が子を解決できるように、親に対して相対的なschemasというフォルダに子アーティファクトが作成される必要があります。

アセットの使用/ダウンロードの詳細は、『Oracle Fusion Middleware Oracle Enterprise Repository開発者ガイド』のアセットの使用/ダウンロードに関する項を参照してください。

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

次の2つの方法のいずれかを使用して、収集されたアセットを検索できます。

- 8.3.4.1項「使用方法の使用」

- 8.3.4.2項「メタデータの使用」

8.3.4.1 使用方法の使用

収集されたサービスを使用方法に基づいて検索できます。図8-5に示すように、基本検索セクションの使用方法リストからWSDLポートを選択すると、WSDLサマリーおよびWSDLに定義されたエンドポイントを持ち、スコープがglobalに設定されているサービスが返されます。このリストは、詳細な検索オプションでも使用できます。

図8-5 「アセット」ペイン - 使用方法

8.3.4.2 メタデータの使用

ハーベスタでは、問合せに使用できるプロパティが各アセットにタグ付けされます。

図8-6に、書込み操作を起動するビジネス・プロセスを問い合せる方法を示します。検索画面を表示するには、Oracle Enterprise Repository Webコンソールのメイン・ページで「詳細な検索オプション」をクリックします。詳細な検索オプション・ダイアログで、次の手順を実行します。

- 追加基準によるフィルタ: オプションを選択します。

- フィールドの選択: リストからinternal.introspector.storeを選択します。

- XPathの入力: テキスト・フィールドに「/」を入力します。使用可能なフィールドのリストが表示されます。

図8-6 Oracle Enterprise Repositoryの詳細な検索オプション・ダイアログの表示

次の検索基準を指定できます。

- ハーベスタ説明

- ハーベスタ・バージョン

- ハーベスタ・ネームスペース

- 収集者

- ビジネス・プロセスにより起動された操作

8.3.5 ハーベスタでの作成対象アセットのプレビュー

ハーベスタでは、プレビュー機能を使用して作成対象アセットを確認できます。プレビュー機能は次のいずれかの方法で使用できます。

コマンド行の使用

コマンド行またはantタスクで-preview trueを追加すると、ハーベスタが実行され、作成対象のすべてのアセットのリストが表示されます。この段階では、変更は実際にはコミットされません。

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>

8.3.6 ベスト・プラクティス

この項では、ハーベスタを使用する際のベスト・プラクティスについて説明します。内容は次のとおりです。

- 8.3.6.1項「収集に推奨される権限」

- 8.3.6.2項「ネームスペース・パラメータのオーバーライド回避」

- 8.3.6.3項「WSDLファイル内のネームスペース」

- 8.3.6.4項「完了した作業の収集」

- 8.3.6.5項「XSDの収集およびメンテナンス・リリース」

- 8.3.6.6項「アセット・ライフサイクル全体でのメタデータの収集」

- 8.3.6.7項「WSDLアーティファクトのダウンロード」

- 8.3.6.8項「リタイア済エンドポイントの収集」

- 8.3.6.9項「SOAプロジェクトの収集」

- 8.3.6.10項「ハーベスタ・フォルダ内のファイルの収集」

- 8.3.6.11項「同一コンピュータでのハーベスタおよびExchange Utilityの実行」

- 8.3.6.12項「コンポジット・サービスWSDLの収集」

- 8.3.6.13項「アセットのバージョニングについて」

8.3.6.1 収集に推奨される権限

Oracle Enterprise Repository内のすべてのアセットの表示権限を持つレジストラまたは個人のみがアセットを収集する必要があります。リポジトリ内のすべてのアセットの表示権限を持っていない場合、すでに存在するアセットを収集することにより意図せずにアセットを重複させてしまう可能性があります。

8.3.6.2 ネームスペース・パラメータのオーバーライド回避

ハーベスタには、収集対象のアセットに対してプロジェクト・ネームスペースを設定するための機能が用意されています。ネームスペースが異なればアセットも異なるため、プロジェクト・ネームスペースを使用して重複するアセットを検出できます。ほとんどの場合、このパラメータをオーバーライドすることはお薦めしません。

ただし、Oracle SOA SuiteまたはOracle Service Bus製品から収集する場合は、そのプロジェクト名に基づいてプロジェクト・ネームスペースが自動的に設定されます(推奨される動作)。

複数のソースから同じプロジェクトおよびリビジョンを収集する場合は特にこのことに従うことが重要です。ネームスペースを変更したり、オーバーライドすると、OER内のアセットが重複してしまいます。

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

収集するWSDLファイルでは、一意のインタフェース、サービスおよびエンドポイントごとに一意のネームスペースを使用することをお薦めします。

Oracle Enterprise Repository内の既存のアセットとの相関はQNameを介して行われるため、インタフェース、サービスまたはエンドポイントの各アセットに重要な変更を加え、QNameを変更しない場合は、既存のアセットを変更後のアセットで上書きすることになります。

表8-7に、Oracle Enterprise RepositoryのアセットとWSDL構造の相関を示します。

表8-7 Oracle Enterprise RepositoryのアセットとWSDL構造の相関

リポジトリ・アセット

WSDL構造

サービス

/definition/service/@name

エンドポイント

/definition/service/port/@name

インタフェース

/definition/portType/@name

8.3.6.4 完了した作業の収集

完了した作業または完了間近の作業のみを収集することをお薦めします。開発環境から定期的に収集する場合は、Oracle Enterprise Repositoryに古いバージョンのアセットが散乱する可能性があります。

Oracle Enterprise Repositoryでは、エンドポイントおよびホストされたWSDLを持つサービスのみがOracle Service Registryにプロモートされます。加えて、具象WSDLを持つサービスのみが、JDeveloperを介して使用可能です。実行時環境から収集して、エンドポイントとWSDLの場所を取得することをお薦めします。

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

一部のスキーマ開発パターンには、不具合の修正や重要度の低い構造の追加を行うものの、スキーマのネームスペースの変更は行わないスキーマのメンテナンス・リリースが含まれます。わずかに変更されたスキーマ・アーティファクトをその後収集すると、リポジトリ内に膨大な数の新規アーティファクト・アセットが作成される可能性があることを認識しておく必要があります。Oracle Enterprise Repositoryでは、各アーティファクト・アセットはアーティファクト・コンテンツのハッシュまたはSoftware File ID (SFID)に基づいて相互に関連付けられます。SFIDは、すべてのインポートおよび包含のインライン化が終了した後で、各アーティファクト・コンテンツに対して計算されます。そのため、WSDLによってインポートされるXSDを変更した場合、新規XSDアーティファクトと新規WSDLアーティファクトの両方が作成されます。

企業全体で広範に使用されているスキーマを検討している場合は特にこの点に留意することが重要です。たとえば、他のスキーマ、WSDL、XSLT、BPELによって幅広くインポートされる下位レベル・スキーマ(customer.xsdなど)を検討します。customer.xsdに重要な変更を加え、後で企業の全アーティファクトを再収集した場合(一種の定期バッチ収集など)、customer.xsdを直接的または間接的に参照する多数の類似アーティファクト・アセットがリポジトリに作成されます。

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

ハーベスタはアセット・ライフサイクル中のいくつかの時点で起動でき、起動するたびに異なるソースからアーティファクトおよびメタデータが収集されます。次のリストに、アセット・ライフサイクル中にハーベスタを使用してOracle Enterprise Repositoryを最新の状態に保つ方法に関する推奨事項を示します。

1. デプロイメント時
デプロイメント直後に、アセットをOracle Enterprise Repositoryに公開する必要があります。デプロイメント時には、本番エンドポイントが収集され、アセットのメタデータがそのエンドポイント情報で更新されます。組織には、開発、テスト、ステージングおよび本番環境をサポートしている複数のエンドポイントがある場合があります。エンドポイントは、Oracle Enterprise Repositoryに収集される際にガバナンス・プロセスを経ることもあります。たとえば、開発エンドポイントとテスト・エンドポイントはコンシューマ・コミュニティ全体に提供できますが、本番エンドポイントについては、サービス・プロバイダおよびサービス・コンシューマがサービス契約を結ぶまで提供できません。

推奨アプローチ: デプロイメント・スクリプト(WLST、antまたはコマンド行)からハーベスタを起動します。

デプロイメントの終了時にハーベスタを起動します。-remote_server引数を使用して、デプロイされたアーティファクトを実行中のサーバーから収集します。

2. 実行時
プロジェクトがデプロイされて実行されると、ランタイム・メトリックが収集されてOracle Enterprise Repositoryのアセットに関連付けられます。ランタイム・メトリックを収集するためのオプションはいくつかあります。1つ目のオプションは、EM-Integrationを使用してEnterprise Managerからランタイム・メトリックを収集し、Oracle Enterprise Repositoryを更新することです。詳細は、『Oracle Enterprise Manager Connectors統合ガイド』を参照してください。

もう1つのオプションは、サード・パーティのランタイム監視ツールを使用してランタイム・メトリックをUDDIレジストリに公開することです。UDDIレジストリに公開されたメトリックは、Oracle Registry Repository Exchange Utilityを使用してOracle Enterprise Repositoryに伝播できます。

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

Oracle Enterprise Repository内のWSDLアーティファクトを使用する場合、WSDLファイルをダウンロードできます。多くの場合、このファイルはリモートの場所にあります。また、このファイルのURLの末尾に?wsdlが付いている場合があります。このような場合、WSDLを保存すると、ブラウザによりファイル拡張子としてデフォルトで.xmlが付加されます。後で.xmlを.wsdlに置き換える必要があります。WSDLファイルはHTTP/HTTPSまたはFTPサーバーでホストできます。

8.3.6.8 リタイア済エンドポイントの収集

エンドポイントを変更した場合(リタイアさせるか、別の場所に移動した場合)、Oracle Enterprise Repositoryからエンドポイントをリタイアさせ、Oracle Service Registryからエンドポイントを削除することをお薦めします。その後、新しいエンドポイントを持つ同一のWSDLサービスを再収集してください。

注意:
Exchange Utilityパブリッシャを再実行しても、リタイア済のエンドポイントがOracle Service Registryから削除されることはありません。

8.3.6.9 SOAプロジェクトの収集

SOAライフサイクルのベスト・プラクティスとして、SOAプロジェクトをOracle Enterprise Repositoryに収集し、SOAサーバーにデプロイし、Exchange Utilityを実行してOracle Service Registryに公開し、公開されたアセットをOracle Enterprise RepositoryまたはOracle Service Registryから使用することをお薦めします。

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

未解凍のハーベスタ・フォルダ(12.1.3.0.0-OER-Harvester.zip)内にあるファイルは収集しないことをお薦めします。これは現在サポートされていません。

8.3.6.11 同一コンピュータでのハーベスタおよびExchange Utilityの実行

サービスをOracle Service Registryに公開する際には、Exchange Utilityとハーベスタを同一コンピュータで実行して、それらが同じURLに解決されるようにすることをお薦めします。WSDL内のアクセス・ポイントの整形が不完全な別々のコンピュータでこれらを実行することもできますが、両方のコンピュータ上の同じURLに解決されるようにする必要があります。アクセス・ポイントがハーベスタとExchange Utilityで異なるURLに解決される場合は、サービスの公開がエラーにより失敗します。

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

公開されたコンポジット・サービスのWSDLはそれ単体では収集しないことをお薦めします。必ずコンポジット・プロジェクト全体を収集し、完全かつ正確なSOAアセット・モデルがOracle Enterprise Repositoryに格納されるようにすることをお薦めします。

8.3.6.13 アセットのバージョニングについて

収集方針を定義する際には、異なるハーベスタを使用すると異なる結果が得られることを理解することが重要です。次に例を示します。

- 実行中のSOAインフラまたはSOAコンポジット(MDS)でOERハーベスタを使用すると、完全なコンポジットとリレーションシップが得られます。

- OSBでOSBハーベスタを使用すると、プロキシ・サービスとバックエンド・ビジネス・サービスのリレーションシップが得られます。

サービスを複数回収集する場合は、OERにより、そのサービスが前回収集されたものと同一かどうかの確認が試みられます。Oracle Enterprise Repository 12cでは、2つのエンティティは次の場合に同一とみなされます。

- 名前とバージョンのペアが同じコンポジットは同一とみなされます(同一コンポジットに対して新しいリレーションシップやデプロイメントなどが追加される場合があります)。

- イントロスペクトされるWSDLに指定されている同じQNameを共有するサービスは同一とみなされます(WSDLに指定されているバージョン番号による影響はありません)。

- WSDL、XSD、composite.xmlファイルおよびその他のファイル・タイプが同じSFIDフィンガープリントを持つ場合、それらは同一アーティファクトとみなされます(SFIDは正規化されたアーティファクトに対して計算されます)。

収集時にOERで一致が検出された場合は、エンティティがすでに存在するものとみなされます(最新状態に保つために、説明が上書きされ、他のエンティティにリレーションシップが追加される場合もあります)。OERで一致が検出されなかった場合は、エンティティは固有の新規エンティティとみなされます(アーティファクトの名前が同じでコンテンツが異なる場合は、新しいアセット名が一意になるように-1が付加されることがあります)。

重要度の低いバグ修正や強化などのために同じアセットをリフレッシュすることが目的の場合の推奨事項は次のとおりです。

- エンドポイント・アドレスを同じに保つか、同じサービスに新しいインタフェース用のポート・タイプを追加します。

- WSDLでサービスのQNameを同じに保ちます。

- コンポジットの名前とバージョンのペアを同じに保ちます(また、SOA Suiteで新しいコンポジット・リビジョンを発行しません)。

注意:
変更されたアーティファクトは、関連するエンドポイントに単に増分的に追加されていき、最新のアーティファクトがエンドポイントのコンシューマに提供されます。名前が同じアーティファクトが他に存在する場合は、OERによって新しいアーティファクト名に-1が付加されます。ユーザーが特定のサービス・エンドポイントのWSDLを使用する場合は、該当するエンドポイント用に最後に発行されたアーティファクトが取得されます。

新しいアセットを新しいバージョン番号で発行してアセットのバージョニングを行うことが目的の場合は、次のことをお薦めします。

- オプションで、同じサービスに新しいインタフェース用のPortTypeを追加します。

- オプションで、前/次のリレーションシップを作成します。

- オプションで、前/次のリレーションシップに対して通知を有効化します。

- コンシューマが移行するまでサイドバイサイドで実行します。古いアセットを非アクティブにしてリタイアさせます。

推奨されるベスト・プラクティスは、アセット・コンシューマに設定した想定内容に応じて、リフレッシュおよびバージョニングの両方を組み合せて使用することです。

8.3.7 既知の問題

この項では、ハーベスタに関する既知の問題について説明します。

- 8.3.7.1項「システムにアセット・タイプが存在する必要がある」

- 8.3.7.2項「2つのバージョンのアセット・タイプ」

- 8.3.7.3項「収集されたアセット内のハーベスタ固有のメタデータ・エントリを削除しない」

- 8.3.7.4項「サポートされているリモート・サーバー・タイプ」

- 8.3.7.5項「不正な暗号化パスワードの使用」

- 8.3.7.6項「「リポジトリ内の表示」オプション」

8.3.7.1 システムにアセット・タイプが存在する必要がある

ハーベスタの機能を使用するための前提条件として、システムにアセット・タイプが存在している必要があります。必要なアセット・タイプは12.1.3.0.0-OER-Harvester-Solution-Pack.zipとともにインストールされます。

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

Oracle Enterprise Repository内の既存のアセット・タイプの中に、12.1.3.0.0-OER-Harvester-Solution-Pack.zipとともにインストールされるアセット・タイプと名前が同じものが存在する場合は、ハーベスタによりそれらのアセット・タイプにバージョン番号が付加されます。これはハーベスタのアセット・タイプの機能には影響せず、ハーベスタではこれらのアセット・タイプはUUIDに基づいて参照されます。

8.3.7.3 収集されたアセット内のハーベスタ固有のメタデータ・エントリを削除しない

ハーベスタによる収集プロセスでアセットが作成されると、メタデータ・エントリ・タイプがinternal.inspector.storeおよびinternal.harvester.manifest.storeのアセットにメタデータ・エントリがアタッチされます。これらのメタデータ・エントリは変更も削除もしないでください。このような操作を行うと、想定外のシステム動作が生じる可能性があります。

Oracle Enterprise Repositoryユーザー・インタフェースではこれらのメタデータ・エントリを削除できません。

8.3.7.4 サポートされているリモート・サーバー・タイプ

現在、ハーベスタでは、Oracle SOA Suiteプロジェクト、Oracle Service Busプロジェクト、およびWebLogic 11gまたは12cで実行されているWebLogic Serverプロジェクトへのリモート接続のみがサポートされています。

8.3.7.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

8.3.7.6 「リポジトリ内の表示」オプション

Oracle JDeveloperで「リポジトリ内の表示」オプションをクリックすると、JDeveloperでアセットの詳細が開きますが、この詳細は読取り専用になっており、このページ内のリンクは動作しない場合があります。

回避方法として、Oracle Enterprise Repositoryコンソールにログインし、リンクをクリックして詳細情報を表示する必要があります。

9 アセット・エディタの使用

この章では、Oracle Enterprise Repositoryのアセット・エディタを使用して、カテゴリ、リレーションシップ、拒否理由、リポジトリおよびベンダーを構成する方法について説明します。

この章では、次の項目について説明します。

- 概要

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

- システム・オプションの構成

- 高度なアセット発行

- アセット、コンプライアンス・テンプレート、ポリシーの移行

- アセット登録プロセスについて

- アセット・ステータスについて

- アセットの削除

9.1 概要

アセット・エディタは、アセットの管理と、アセットおよびタイプの構成に使用されます。カテゴリ、リレーションシップ、拒否理由、リポジトリおよびベンダーも、アセット・エディタ内で構成されます。

構成の詳細は、組織のガイドラインによって決まるため、ここで説明するオプションとはわずかに異なる場合があります。

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

この手順は、Oracle Enterprise Repositoryの「アセット」画面で実行されます。

注意:
アセット・エディタにはJava Web Startが必要です。Java Web Startのインストールおよび構成の詳細は、1.10項「Java Web Startのインストール」を参照してください。

1. アセットの編集/管理をクリックします。図9-1に示すように、アセット・エディタが表示されます。

図9-1 アセット・エディタ

9.3 システム・オプションの構成

アセット・エディタの「アクション」メニューでは、様々なシステム・オプションを構成できます。

- 第9.3.1項「受入れ可能な値リストの構成」

- 第9.3.2項「アーティファクト・ストアの構成」

- 9.3.4項「カテゴリ分けの構成」

- 9.3.5項「リレーションシップの構成」

- 第9.3.6項「拒否理由の構成」

- 9.3.7項「ベンダーの構成」

9.3.1 受入れ可能な値リストの構成

アセット表示のメタデータ要素として使用される単一および複数選択リストを定義および特定します。

1. 「アクション」メニューで、受入れ可能な値リストの構成を選択します。図9-2に示すように、受入れ可能な値リストの構成ダイアログが表示されます。

図9-2 受入れ可能な値リストの構成

2. 「追加」をクリックします。図9-3に示すように、受入れ可能な値リストの追加ダイアログが表示されます。

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

図9-3 受入れ可能な値リストの追加ダイアログ

4. 「追加」ボタンの横にあるテキスト・ボックスに適切なリスト項目名を入力します。

5. 「追加」をクリックします。

6. 必要に応じて、手順4と5を繰り返し、他のリスト項目を追加します。

7. 入力後、「OK」をクリックします。受入れ可能な値リストの構成ウィンドウに新しいリストが表示されます。

8. 受入れ可能な値リストを編集するには、受入れ可能な値リストの構成ウィンドウでリストを選択します。

9. 「編集」をクリックします。受入れ可能な値リストの編集ダイアログが表示されます。(受入れ可能な値リストの追加ウィンドウと同じフォーム。)

10. 必要に応じて変更を加えます。

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

9.3.2 アーティファクト・ストアの構成

Oracle Enterprise Repositoryのアセットに関連するファイルが保存される場所を決定します。

1. 「アクション」メニューから、アーティファクト・ストアの構成を選択します。図9-4に示すように、アーティファクト・ストアの構成ダイアログが表示されます。

図9-4 アーティファクト・ストアの構成ダイアログ

2. 「追加」をクリックします。図9-5に示すように、新規アーティファクト・ストアの作成ダイアログが表示されます。

図9-5 新規アーティファクト・ストアの作成ダイアログ

3. アーティファクト・ストアの名前を入力します。

4. 「タイプ」リストで、アーティファクト・ストアのタイプを選択します。

- デフォルト・タイプ:

- FTP
FTPサーバーのファイルにアクセスします。

- HTTP
Webサーバーのファイルにアクセスします。

- HTTPS
セキュアWebサーバーのファイルにアクセスします。

- UNC
WindowsまたはSambaの共有を使用するファイルにアクセスします。

- ローURI
ローURIを使用してファイルにアクセスします。

- ローSCM
ローSCMを使用してファイルにアクセスします。CVS、PerforceなどのSCMタイプの選択を有効にします。選択したSCMタイプは、パスURI接尾辞をダウンロード・フィールドを自動的に移入しますが、フィールドは必要に応じて変更できます。

5. サーバーのホスト名とパスを入力します。

6. (オプション)ユーザー名とパスワードを入力します。このオプションを実行すると、自動ログインが有効になります。

7. 入力後、「OK」をクリックします。

8. アーティファクト・ストアを編集するには、アーティファクト・ストアの構成ウィンドウのリストで、編集するストアを見つけます。

9. 「編集」をクリックします。アーティファクト・ストアの編集ダイアログが表示されます。(アーティファクト・ストアの新規作成ウィンドウと同じフォーム。)

10. 必要に応じて変更を加えます。

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

9.3.3 新しいアーティファクト・ストアの選択

アーティファクト・ストアを構成した後、Oracle Enterprise Repositoryの「管理」ページで発行アップロード用のアーティファクト・ストアのシステム設定を使用して、アーティファクト・ストアを選択する必要があります。

1. Oracle Enterprise Repositoryの「管理」ページを開きます。

2. 左側のパネルで、「システム設定」を選択します。

3. システム設定の「サーバー設定」グループでアップロード領域セクションを見つけます。詳細は、2.5.2項「サーバー設定」を参照してください。

4. 送信アップロード用のアーティファクト・ストア・リストを使用して、新しく作成したアーティファクト・ストアを選択します。

5. 「保存」をクリックします。

9.3.4 カテゴリ分けの構成

カテゴリ分けによって、アセットの編成方法と表示方法が決まります。これらも、同様の方法でプロジェクトに適用できます。

1. 「アクション」メニューで、カテゴリ分けの構成を選択します。図9-6に示すように、カテゴリ分けの構成ダイアログが表示されます。

図9-6 カテゴリ分けの構成ダイアログ

2. 「追加」をクリックします。図9-7に示すように、カテゴリ分けの追加ダイアログが表示されます。

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

図9-7 カテゴリ分けの追加ダイアログ

4. このカテゴリ分けタイプのいずれかのカテゴリ分けにのみアセットを割り当てることができる場合は、相互排他の割当てですか?オプションを選択します。

5. カテゴリ分けがアセットではなくプロジェクトに割り当てられるようにするには、プロジェクトに割当て可能ですか?オプションを選択します(このオプションがOracle Enterprise Repository管理者によって有効になっている場合)。

6. 使用環境でUDDIが有効な場合、Oracle Enterprise Repositoryは、カテゴリ分けのtModelKeyを自動で作成します。必要に応じて、管理者は、特定のUDDIバージョン2またはバージョン3のtModelKeyを任意のカテゴリ分けに割り当てることができます。

7. 「追加」をクリックして、サブカテゴリ分けを追加します。図9-8に示すように、カテゴリ分けの追加ダイアログが表示されます。

図9-8 カテゴリ分けの追加ダイアログ

8. 入力後、「OK」をクリックします。カテゴリ分けの構成ウィンドウに新しいカテゴリ分けが表示されます。

9. カテゴリ分けを編集するには、カテゴリ分けの構成ウィンドウのリストで、編集するカテゴリ分けを見つけます。

10. 「編集」をクリックします。カテゴリ分けの編集ダイアログが表示されます。(カテゴリ分けの追加ウィンドウと同じフォーム。)

11. 必要に応じて変更を加えます。

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

9.3.5 リレーションシップの構成

リレーションシップは、アセット間の関係、相互作用または相互依存を定義します。構成される場合、使用するために選択されたアセットに対する特定のリレーションシップの影響を受けるアセット(つまり、使用 - ダウンロード・ボタンがクリックされている)もダウンロードできます。

1. 「アクション」メニューで、リレーションシップの構成を選択します。図9-9に示すように、リレーションシップの構成ダイアログが表示されます。

図9-9 リレーションシップの構成ダイアログ

2. 「追加」をクリックします。図9-10に示すように、リレーションシップの追加ダイアログが表示されます。

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

図9-10 リレーションシップの追加ダイアログ

4. 「方向」リストで適切な選択を行います。
選択した方向は、ソース・アセット・テキスト・ボックスとターゲット・アセット・テキスト・ボックスに表示される情報に影響を与えます。たとえば、双方向リレーションシップでは、ターゲットとソースが内部依存していますが、双方向、並び順を使用すると、連続するバージョンのアセット間のリレーションシップ(Asset v0.90とAsset v1.0間のリレーションシップなど)を記述できます。

5. ダウンロード可能なターゲット・アセットをソース・アセットで作成するチェック・ボックスで、適切な選択を行います。

6. 入力後、「OK」をクリックします。

7. リレーションシップを編集するには、リレーションシップの構成ウィンドウのリストで、編集するリレーションシップを見つけます。

8. 「編集」をクリックします。リレーションシップの編集ダイアログが表示されます。(リレーションシップの追加ウィンドウと同じフォーム。)

9. 必要に応じて変更を加えます。

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

9.3.5.1 システム供給リレーションシップの構成

Oracle Enterprise Repositoryにはシステム供給リレーションシップもあります。これは、エンド・ユーザーに対して読取り専用機能が制限されています。標準のアセット・リレーションシップとは異なり、システム供給リレーションシップは、不変の名前と方向が必要なコンテキストで使用されます。そのため、特に指定のないかぎり、ユーザーがこれらのリレーションシップを追加、削除または変更することはできません。

9.3.6 拒否理由の構成

以前に使用またはダウンロードされたアセットを拒否するユーザーが利用可能な拒否理由の選択を決定します。拒否理由によって、アセットに関するローカル・コミュニティの重要なフィードバックが提供されます。

1. 「アクション」メニューで、拒否理由の構成を選択します。図9-11に示すように、拒否理由の構成ダイアログが表示されます。

図9-11 拒否理由の構成ダイアログ

2. 「追加」をクリックします。図9-12に示すように、拒否理由の編集ダイアログが表示されます。

図9-12 拒否理由の編集ダイアログ

3. 拒否理由テキスト・ボックスに適切なテキストを入力します。

4. 入力後、「OK」をクリックします。

5. 拒否理由を編集するには、拒否理由の構成ウィンドウのリストで、編集する拒否理由を見つけます。

6. 「編集」をクリックします。拒否理由の編集ダイアログが表示されます。

7. 必要に応じて変更を加えます。

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

9.3.7 ベンダーの構成

アセットを提供するベンダーをリポジトリに定義および特定します。

1. 「アクション」メニューで、ベンダーの構成を選択します。図9-13に示すように、ベンダーの構成ダイアログが表示されます。

図9-13 ベンダーの構成ダイアログ

2. 「追加」をクリックします。図9-14に示すように、ベンダー名の追加ダイアログが表示されます。

図9-14 ベンダー名の追加ダイアログ

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

4. 入力後、「OK」をクリックします。

5. ベンダーを編集するには、ベンダーの構成ウィンドウのリストで、編集するベンダーを見つけます。

6. 「編集」をクリックします。ベンダー名の編集ウィンドウが開きます。(ベンダー名の追加ウィンドウと同じフォーム。)

7. 必要に応じて変更を加えます。

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

9.4 高度なアセット発行

この機能により、(適切な権限を持つ)ユーザーは、Webコンソールからではなくアセット・エディタからアセットを発行できます。このため、ユーザーは、発行時にアセットの詳細をさらに入力できます。この手順は、アセット・エディタで実行されます。(アセット・エディタへのアクセスは、ユーザーが割り当てられるロールによって決まります。)

1. アセット・エディタで「ファイル」メニューを開き、「新規」を選択します。図9-15に示すように、アセットの新規作成ダイアログが表示されます。

図9-15 アセットの新規作成ダイアログ

2. 「名前」テキスト・ボックスと「バージョン」テキスト・ボックスに適切な情報を入力します。

3. 図9-16に示すように、「タイプ」リストで適切なタイプのテンプレートを選択します。

図9-16 アセットの新規作成ダイアログ - 「タイプ」リスト

4. 「OK」をクリックします。図9-17に示すように、アセット・エディタに新しいアセットが表示されます。

図9-17 アセット・エディタ - 新しいアセット

レビューと登録を行うアセットが発行されます。

9.5 アセット、コンプライアンス・テンプレート、ポリシーの移行

移行とは、あるアセット、コンプライアンス・テンプレートまたはポリシーのメタデータやファイルを、別のアセット、コンプライアンス・テンプレートまたはポリシー(通常は同じタイプ)に転送することです。メタデータの編集はその再作成よりも簡単であるため、この機能を使用すると、ユーザーは、異なるバージョンのアセット、コンプライアンス・テンプレートまたはポリシーをすばやく作成できます。たとえば、JavaComponent v1.0を作成するには、JavaComponent v0.90のメタデータとファイルを移行してから、v1.0アセットのメタデータに必要な変更を加えます。アセットを移行する場合、新しいアセットの名前またはバージョン番号(あるいはその両方)は異なる必要があります。移行では、Oracle Enterprise Repositoryの元のアセットが削除されるわけではありません。

アセット、コンプライアンス・テンプレートまたはポリシーを別のタイプに移行することもできます。ただし、異なるメタデータ要素は転送されません。たとえば、元のアセット・タイプがそのタブのいずれかで表を使用し、同じ表要素を持たないアセット・タイプに移行される場合、表とそのメタデータは移行されません。表のメタデータ要素は、新しいアセット・タイプで作成される必要があります。

9.5.1 アセット、コンプライアンス・テンプレート、ポリシーの移行

この手順は、アセット・エディタで実行されます。

1. 図9-18に示すように、「検索」を使用するか、アセット・エディタのファイル・ツリーを参照して、移行するソース・アセットまたはコンプライアンス・テンプレートを見つけます。

図9-18 アセット・エディタ - 「検索」ボタン

2. 「ファイル」メニューでコピーと移行を選択します。
図9-19に示すように、コピーと移行ダイアログが表示されます。

図9-19 コピーと移行ダイアログ

3. 「名前」テキスト・ボックスと「バージョン」テキスト・ボックスに適切な情報を入力します。

4. 「タイプ」リストで宛先のタイプ(ソース・アーティファクトが移行されるタイプ)を選択します。
類似しないタイプ間でアセットを移行すると、アセット詳細やアセット・エディタでのアセット情報の表示に影響があります。

5. 入力後、「OK」をクリックします。
図9-20に示すように、移行したアセットがアセット・エディタに表示されます。

図9-20 アセット・エディタ - 「概要」タブ

6. 図9-21に示すように、新しいアセットの「管理」タブをクリックします。

図9-21 「管理」タブ

7. 新しいアセットを登録するか、登録するためにそのアセットを別のユーザーに割り当てます。

9.6 アセット登録プロセスについて

登録プロセス内を移動するアセットは、アセット・エディタのファイル・ツリーに表示されているように、複数のフォルダで編成および管理されます。

アセットの登録プロセスは、「発行済」フォルダで開始されます。アセットは、『Oracle Fusion Middleware Oracle Enterprise Repository開発者ガイド』の標準アセット発行の実行に関する項で説明されているようにOracle Enterprise Repository Webインタフェースによって、または9.4項「高度なアセット発行」で説明されているようにアセット・エディタによって発行できます。レジストラによって受け入れられるか拒否されると、アセットは「発行済」の下の「レビュー中」フォルダに移動します。

アセット・エディタのタブでデータのレジストラ・レビューおよび承認を保留にすると、アセットは「レビュー中」から「登録済」フォルダに移動します。ユーザーは、発行済、未発行および登録済アセットにアクセスする検索機能を使用して、またはMy Stuffを使用して、アセットの進行状況を追跡できます。

登録プロセスには、次のアクションがあります。

- 発行: アセットがユーザーによって発行され、「発行済」の下の「レビュー保留」フォルダに表示されます。自動電子メール・メッセージによって、新しいアセットが発行キューに入ったことがレジストラに通知されます。

- レビュー: レジストラは、アセットとその関連情報を確認し、ワーク・キューに入れるか拒否するかを決定します。

- 拒否: アセットを拒否する場合、レジストラは拒否理由を入力します。
アセットは、「発行」フォルダから拒否されると、削除され、My Stuffの発行者の「発行(個人)」フォルダで拒否済としてマークされます。

- 受入れ: 登録が受け入れられたアセットは「レビュー中」フォルダに移動し、レジストラまたは上級発行者は登録プロセスを開始します。必要な情報が収集され、アセット・エディタの適切なタブに入力されます。レジストラは、各タブを確認し、ワークフローを監視します。ワークフローの特定のステージの情報が受入れ可能な場合、レジストラは該当するタブでデータを承認します。承認プロセスには規定の順序はなく、レジストラは任意のステージを任意の順序で承認できます。また、レジストラには、プロセスの任意のステージの情報を編集するオプションもあります。

- 承認: レジストラは、様々なタブで提供された情報に関する組織の基準に従って、「管理」タブで最終承認を付与します。アセットに対するアセット・エディタのタブの具体的な構成は、発行時にアセットが割り当てられたタイプ・テンプレートによって決まります。各タブには、アセットを説明してその使用を容易にするために使用されるメタデータの様々な要素があります。

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

- 9.6.1項「発行済アセットの受入れ」

- 9.6.2項「アセットの登録」

- 9.6.3項「アセットへのノートの追加」

9.6.1 発行済アセットの受入れ

アセットがOracle Enterprise Repositoryで処理されて登録されるには、発行が受け入れられ、1人以上のレジストラに割り当てられる必要があります。

この手順は、アセット・エディタで実行されます。(適切な権限が必要です。)

発行済アセットを受け入れるには、次の手順を実行します。

1. 「発行済」フォルダを開きます。

2. 「レビュー保留」フォルダを開きます。

3. 登録するアセットを選択します。

4. 登録プロセスを完了する手順は、次のとおりです。

- ユーザーにアセットを割り当てずに受け入れるには、「受入れ」をクリックします。アセットがツリー内の「レビュー中」フォルダに移動し、アセットの下にある各ワークフロー・フォルダにも表示されます。ワークフロー・フォルダは、アセット・エディタのタブに対応しています。

- 受け入れて特定のユーザーに割り当てるには、「受入れおよび割当」をクリックします。ユーザーの割当ダイアログが表示されます。矢印ボタンを使用して、「使用可能なユーザー」列と「選択したユーザー」列の間でユーザーを移動し、「OK」をクリックします。アセットがツリー内の「レビュー中」フォルダに移動し、選択したユーザーに割り当てられ、このユーザーがアセット・エディタの各タブに必要な情報を入力します。

9.6.2 アセットの登録

アセットが受け入れられた後、レジストラはアセットをレビューして、Oracle Enterprise Repositoryでの使用のために登録する必要があります。

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

- 9.6.2.1項「アセットのタブの承認」

- 9.6.2.2項「登録プロセスの完了」

9.6.2.1 アセットのタブの承認

アセットを登録する前に、アセットのタブで情報をレビューする必要があります。

すべてのアセット・タイプに共通のタブもありますが、アセットに対する具体的なアセット・エディタのタブは、発行時にアセットが割り当てられたタイプ・テンプレートの構成によって決まります。同様に、タブに表示されるメタデータ要素もタイプの構成によって決まります。具体的なタブおよび要素はタイプによって異なる場合がありますが、各タブの承認プロセスには、各要素での情報の入力またはレビュー(あるいはその両方)が含まれます。

アセットのタブを承認するには、次の手順を実行します。

タスク1   「概要」タブの承認

「概要」タブを承認するには、次の手順を実行します。

1. 選択したアセットの「概要」タブをクリックします。

2. 各フィールドに適切な情報を入力します。

3. 「承認」をクリックします。「概要」タブ・ラベルのテキストの色が変更され、「承認」ボタンは非承認に変わります。

注意:
アセット・エディタの承認のボタンは、適切な権限を持つユーザーにのみ表示されます。

タスク2   分類タブの承認

分類タブを承認するには、次の手順を実行します。

1. 選択したアセットの分類タブをクリックします。複数のカテゴリ分けが表示されます。

2. 「分類」セクションで「割当て」ボタンをクリックします。分類の割当てダイアログが表示されます。

3. ラジオ・ボタンを使用して、適切な分類を選択します。使用可能なオプションは次のとおりです。
Raw: 品質と完全性は保証されません。

教育: 教育/情報目的専用です。プロジェクトでの使用は承認されていません。

承認済: プロジェクトでの使用がレジストラによって承認されています。

推奨: 承認され、少なくとも1つのプロジェクトで正常にデプロイされています。

必須: アセットによって提供される機能がプロジェクトで必要な場合に必ず使用します。これは、顧客データへのアクセスや支払処理などを行うWebサービスに特に関係があります。

4. 「OK」をクリックします。選択内容が「分類」セクションに表示されます。

注意:
環境を反映するようにデフォルトのカテゴリをカスタマイズできます。

5. 分類タブのセクションごとにプロセスを繰り返します。

6. 「キーワード」セクションのテキスト・ボックスに適切なキーワードを入力し、「追加」をクリックします。新しいキーワードが「キーワード」リストに表示されます。必要に応じて、他のキーワードを追加します。

7. 分類タブが完了したら、「承認」をクリックします。「概要」タブ・ラベルのテキストの色が変更され、「承認」ボタンは非承認に変わります。

タスク3   「ドキュメント」タブの承認

「ドキュメント」タブを承認するには、次の手順を実行します。

1. 選択したアセットの「ドキュメント」タブをクリックします。多数の推奨ドキュメント・タイトルが「ドキュメント」ウィンドウに表示されます。適切なドキュメントをこれらの各タイトルに関連付けることができ、新しいドキュメントをリストに追加できます。

2. 「追加」をクリックします。「編集」ダイアログが表示されます。

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

4. 「URL」テキスト・ボックスの横にある「編集」ボタンをクリックします。URLの編集ダイアログが表示されます。

5. 必要に応じて、「リポジトリ・ファイル」または「外部ファイル」を選択します。

6. 使用可能なテキスト・ボックスに、必要な情報をすべて入力します。

7. 「OK」をクリックします。新しいドキュメントがリストに表示されます。

8. 既存のドキュメントのファイル情報を編集するには、ドキュメントを選択し、「編集」をクリックして、手順3-7を繰り返します。

9. 終了したら、「承認」をクリックします。「ドキュメント」タブ・ラベルのテキストの色が変更され、「承認」ボタンは非承認に変わります。

タスク4   「リレーションシップ」タブの承認

「リレーションシップ」タブを承認するには、次の手順を実行します。

1. 選択したアセットの「リレーションシップ」タブをクリックします。

2. 「追加」ボタンをクリックします。リレーションシップの追加ダイアログが表示されます。

3. 「検索」またはすべてのアクティブのリスト・ボタンを使用して、ダイアログの「アセット」セクションにアセットを表示します。

4. リストからアセットを選択します。

5. 「リレーションシップ・タイプ」リストを使用して、2つのアセット間の適切なリレーションシップを選択します。

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

7. 必要に応じて、他のアセット・リレーションシップを追加します。

8. 終了したら、「承認」をクリックします。「リレーションシップ」タブ・ラベルのテキストの色が変更され、「承認」ボタンは非承認に変わります。

タスク5   「管理」タブの承認

Oracle Enterprise Repositoryのすべてのアセットに「管理」タブがあります。「管理」タブを使用して、次のことを実行します。

- アセットの作成済、発行済、受入れ済ワークフローを追跡します。

- 他のタブの情報をレビューおよび承認するためにユーザーを割り当てます。

- アセットのステータスを変更します。詳細は、9.7項「アセット・ステータスについて」を参照してください。

- アセットのノートおよびレビューを表示します。

「管理」タブを承認するには、「登録」ボタンをクリックします。9.6.2.2項「登録プロセスの完了」で説明されているように、このアセットは登録プロセスの完了後に登録されます。

注意:
登録されたアセットに、承認されていないタブがある場合があります。

9.6.2.2 登録プロセスの完了

タブが承認された後(タスク5「「管理」タブの承認」で説明されているように、特に「管理」タブ)、アセット・エディタの「ファイル」メニューから「保存」をクリックして登録プロセスを完了します。これでアセットが登録されます。適切な権限を持つユーザーは、それをOracle Enterprise Repositoryで検出できるようになります。

9.6.3 アセットへのノートの追加

アセット・エディタからアセットにノートを追加できます。

アセットにノートを追加するには、次の手順を実行します。

1. アセット・エディタの「ファイル」メニューから、「ノートの追加」をクリックします。ノートの追加ダイアログが表示されます。

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

3. 「OK」をクリックします。アセットの「管理」タブの「ログ」セクションにあるリストにノートが追加されます。(「ログ」セクションで「リフレッシュ」ボタンをクリックする必要がある場合があります。)

9.7 アセット・ステータスについて

レジストラは、アセット・エディタの「管理」タブを使用して、アセットにステータスを割り当てることができます。

- アクティブ
使用可能なアセットに割り当てられるステータス。

- 非アクティブ
リポジトリ内にあるが、一般用途で使用できないアセットに割り当てられるステータス。非アクティブ・アセットは、再度アクティブにしたり、リタイヤしたりすることができます。非アクティブ・アセットは検索に表示されますが、使用するために選択することはできません(使用 - ダウンロード・ボタンは表示されません)。

- リタイア
一般用途からリタイヤされる、リポジトリ内のアセットに割り当てられるステータス。リタイア済のアセットは、再度アクティブにしたり、非アクティブにしたりすることができます。リタイヤ済のアセットは、使用するために選択することはできません(使用 - ダウンロード・ボタンは表示されません)。このアセットは検索にも表示されませんが、リポジトリのアクティブ・アセットまたは非アクティブ・アセットに対する関連アセットとして使用できます。

- 削除済
リポジトリから削除されるアセットに割り当てられるステータス。削除済アセットは、復元したり再度ステータスを割り当てることはできません。

9.7.1 アセットのステータスの割当てまたは変更

この手順は、アセット・エディタで実行されます。アセットのステータスに対する変更は、アセット・エディタで自動的に保存されます。

1. 「検索」を使用するか、アセット・エディタのファイル・ツリーを参照して、変更するソース・アセットまたはコンプライアンス・テンプレートを見つけます。

2. 「管理」タブをクリックします。

3. 図9-22に示すように、「ステータス」リストで、アセットに割り当てられるステータスを選択します。

図9-22 「ステータス」リスト

注意:
割り当てられたステータスに応じて、アセットはツリーで表示されなくなるか(「削除済」)、ユーザー検索に使用できなくなります(「リタイア」)。

9.8 アセットの削除

Oracle Enterprise Repositoryでアセットを削除するには、次の手順を実行します。

注意:
アセット・エディタの起動がロールで許可されているユーザー(アセット・エディタの起動権限を付与されているユーザーのみが、表示できるアセットを削除できます。ユーザー・ロールとそれらに関連付けられている権限の詳細は、『Oracle Fusion Middleware Oracle Enterprise Repository開発者ガイド』のユーザー・ロールの説明に関する項を参照してください。

注意:
これは、OER 12cの新機能です。以前のバージョンのOERからアップグレードする場合、以前のバージョンでアセット・エディタの起動権限が付与されていたユーザーはアセットを削除できるようになることを理解しておく必要があります。

1. 左側のパネルで、「アセット」をクリックします。

2. 「すべてをリスト」をクリックするか、削除するアセットを検索します。

3. 「検索結果」画面からアセットを削除するには、削除する各アセットの横にあるチェック・ボックスを選択し、「削除」をクリックします。この方法を使用して複数のアセットを同時に削除できます。

第III部

Oracle Enterprise Repositoryの保護

この部では、Oracle Enterprise Repositoryのセキュリティ・タスクについて説明します。

この部には次の章が含まれます:

- 第10章「外部認証ツールを使用するためのOracle Enterprise Repositoryの構成」

- 第11章「高度なロールベース・アクセス制御の構成」

- 第12章「パスワードの暗号化」

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

この章では、LDAP/Active Directoryなどの外部認証ツールを使用してOracle Enterprise Repositoryを認証する方法について説明します。

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

- 10.1項「概要」

- 10.2項「シングル・サインオン」

- 10.3項「コンテナ管理設定」

10.1 概要

この項では、LDAP/Active Directoryを使用してOracle Enterprise Repositoryでユーザーを認証する方法について説明します。

この項には次のトピックが含まれます:

- 10.1.1項「LDAP/Active Directory」

- 10.1.2項「LDAP統合のシステム・プロパティの有効化」

- 10.1.3項「LDAP/Active Directoryのプロパティの変更」

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

- 10.1.5項「LDAPプロパティの例」

10.1.1 LDAP/Active Directory

LDAP/Active Directory (AD)を使用してユーザーを認証する場合、LDAP/Active Directoryサーバーを使用する前に、ユーザーの部門およびロールの構成を検討する必要があります。統合を有効にすると、すべてのユーザーはLDAP/ADによって認証されます。したがって、LDAP/ADのユーザー名と一致する管理レベルのユーザー・アカウントを少なくとも1つ、Oracle Enterprise Repositoryデータベース内に作成することが重要です。このユーザー・アカウントにはLDAP/ADを有効にした場合でもOracle Enterprise Repositoryの管理機能を実行できるように、管理ロールを割り当てる必要があります。

LDAP/ADからロール同期を有効にする場合、少なくとも1つのユーザー・アカウントに管理レベルのが割り当てられている必要があります。ロール同期オプションを使用する前に、Oracle Enterprise RepositoryでLDAPロールが作成され、適切なOracle Enterprise Repository権限が割り当てられている必要があります。ロール名は名前のみで同期されます。管理レベルのユーザーがLDAP/ADを使用してOracle Enterprise Repositoryにログインすると、そのユーザーはアプリケーション・プロパティを適切に構成および管理できます。このユーザー・アカウントを日常のアクティビティに使用しないでください。

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

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

1. 左ペインの「システム設定」をクリックします。メイン・ペインで「システム設定」セクションが開きます。

2. 次の各設定を簡単に見つけるには、「システム設定」の「検索」ボックスを使用します。

3. 「検索」ボックスにenterprise.authentication.ldap.enabledと入力します。値をTrueに設定して、「保存」をクリックします。
次に示すように設定を変更します。

- 非承認ユーザーのログイン

- Trueに設定します。

- プラグイン・ログイン・モジュール・クラス名

- テキスト・ボックスにcom.flashline.enterprise.authentication.server.loginmodule.LDAPLoginと入力します。

注意:
このプロパティによって、LDAPはオン/オフになります。有効にすると、アプリケーションでユーザー認証にLDAPサーバーが使用されます。

- プラグイン・ログイン・モジュール表示名

- テキスト・ボックスにエンタープライズLDAPログインと入力します。

- プラグイン・ログイン・モジュール

- Trueに設定します。

- プラグイン・ログイン・モジュール - 内部チェック

- Falseに設定します。

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

10.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

- 検索範囲

- リスト内のサブツリーを選択します。

注意:
このプロパティによって、ユーザー・レコード検索の(ベースDNの下の)深さが定義されます。

- 検索されたエントリを識別する属性名

注意:
このプロパティによって、ツリー検索の範囲内でユーザー・アカウントを一意に識別する属性名が指定されます。

- 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アプリケーションを再起動します。

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

Oracle Enterprise RepositoryのLDAP/Active Directoryコネクタを使用すると、LDAPは、Oracle Enterprise Repositoryのユーザー認証およびロール割当てのためのユーザー識別の単一ソースとして機能できます。ただし、これにより、Oracle Enterprise Repositoryを介したファイルへのアクセスのユーザー認証を各ホスト・リポジトリが管理することは妨げられません。

Oracle Enterprise RepositoryのLDAP/Active Directoryコネクタを使用する場合、Oracle Enterprise Repositoryは、LDAPまたはActive Directoryを使用してユーザーを認証します。ユーザー名/パスワードの組合せが、バインド・リクエストとしてLDAPシステムに委任されます。ユーザーは、バインド・リクエストが成功した場合にのみ認証されます。

オプションとして、Oracle Enterprise Repositoryのユーザー・ロール割当てを格納および取得するようにLDAPを構成できます。この構成では、ユーザー・ログインのたびに、Oracle Enterprise RepositoryはLDAPに格納されたユーザーのロールと同期します。ロールはLDAPから直接追加され、Oracle Enterprise Repositoryによって管理されず、LDAP内のグループ・マッピングはOERによって使用されません。このオプションを使用するには、ldap.enable-synch-rolesシステム設定をTrueに設定する必要があります。ldap.rbac.roleAttribシステム設定は、ユーザーがOracle Enterprise Repository内で保持するロール名を含む複数値LDAP属性の名前に設定する必要があります。ldap.enable-synch-rolesシステム設定が有効でない場合、またはldap.rbac.roleAttribオプションによって参照されるLDAP属性が構成されていない場合、管理者はOracle Enterprise Repositoryで手動でユーザー・ロールを割り当てる必要があります。

10.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では、デフォルト・ユーザーはuserです。

- 理由

- 新しいユーザー・アカウントが作成されたことがセキュリティ管理者に通知されるまで、新規ユーザーに対して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認証が新規ユーザー作成に対する唯一の制限であるエンタープライズ・ライセンス契約。通常、LDAPアカウントによってロールが事前定義されない新規ユーザーのアクセスを制限するために、デフォルトのOracle Enterprise RepositoryロールはUserに設定されます。

- プロパティ設定

- ldap.allow-user-creation

- Trueに設定します。

- ldap.assign-default-roles

- Trueに設定します。

- enterprise.security.unapproveduser.allowlogin

- Trueに設定します。

10.1.5 LDAPプロパティの例

Active Directoryの制限により、ディレクトリ・サーバーに匿名でバインドされている(認証されていない)場合はディレクトリの最上位より下の検索ができないため、Oracle Enterprise Repositoryユーザー情報参照では「バインドDN」、「バインド・パスワード」および管理者としてデータを取得のプロパティが適切な値で設定されている必要があります。表10-1に、LDAP/Active Directoryのプロパティおよびその例を示します。

表10-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

password

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

表10-2に、カスタムおよび共通のLDAPプロパティを示します。

表10-2 カスタムおよび共通のLDAPプロパティ

実装に関係しないカスタムおよび共通のプロパティ

ldap.deptAttrib

department

ldap.rbac.roleAttrib

roles

ldap.allow-user-creation

true

ldap.enable-synch-roles

true

ldap.enable-synch-depts

true

10.2 シングル・サインオン

この項では、シングル・サインオンを使用してOracle Enterprise Repositoryでユーザーを認証する方法について説明します。

この項には次のトピックが含まれます:

- 10.2.1項「概要」

- 10.2.2項「シングル・サインオン認証で使用するためのOracle Enterprise Repositoryの構成」

- 10.2.3項「拡張オプション」

10.2.1 概要

Oracle Enterprise Repositoryの拡張コンテナ認証LoginModuleが、(SSOシステムによって移入される場合がある) HTTPリクエスト・ヘッダーによって渡されるユーザー資格証明を受け入れるために使用されます。この機能により、シングル・サインオン・システムと統合できます。

10.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)にすることができます。これらは、「システム設定」タブで構成できます。

この項には次のトピックが含まれます:

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

- 10.2.2.2項「基本認証とのOracle Enterprise Repository SSO統合の使用」

- 10.2.2.3項「アプリケーション・プロパティ・ファイルの手動変更」

注意:
フォールバック認証はREX APIでのみ機能します。

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

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

1. 左ペインの「システム設定」をクリックします。図10-1に示すように、Oracle Enterprise Repositoryの「システム設定」画面が表示されます。

図10-1 Oracle Enterprise Repositoryの「システム設定」画面

2. 「検索」ボックスにenterprise.authentication.advancedcontainer.enabledと入力します。値をTrueに設定して、「保存」をクリックします。

3. 図10-2に示すように、新しいシステム設定の有効化テキスト・ボックスにcmee.jws.pass-all-cookiesと入力します。

図10-2 新しいシステム設定の有効化ダイアログ

4. 「有効化」をクリックします。図10-3に示すように、システム設定の「サーバー設定」グループのJava Web Start (JWS)セクションに「JWSですべてのCookieを渡す」が表示されます。

図10-3 JWSですべてのCookieを渡す

5. プロパティがTrueに設定されていることを確認します。

6. 「保存」をクリックします。

7. 「システム設定」の「検索」テキスト・ボックスにコンテナ・ログイン・モジュールと入力します。図10-4に示すように、システム設定のエンタープライズ認証グループにコンテナ・ログイン・モジュール・セクションが表示されます。

図10-4 コンテナ・ログイン設定セクション

8. 次に示すように、プロパティを変更します。

- コンテナ・ログイン・モジュール・クラス名

- テキスト・ボックスにcom.oer.enterprise.authentication.server.loginmodule.AdvancedContainerLoginと入力します。

- コンテナ・ログイン・モジュール表示名

- テキスト・ボックスに「拡張コンテナ・ログイン・モジュール」と入力します。

- コンテナ・ログイン・モジュール

- プロパティを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に設定します。この機能により、ロールが作成されてユーザーはそのロールに割り当てられますが、作成されるロールに権限は割り当てられません。

- 欠落した部門の自動作成

- 現在は存在しない、ユーザーの部門ヘッダーに含まれる部門をOracle Enterprise Repositoryで作成できるようにするには、この値をTrueに設定します。この機能により、部門が作成されてユーザーはその部門に割り当てられますが、新しく作成される部門はプロジェクトに割り当てられません。

11. 「システム設定」の「検索」テキスト・ボックスにcookieログイン・モジュールと入力します。システム設定のエンタープライズ認証グループでCookieログイン設定セクションが開きます。

12. Cookieログイン・モジュール・プロパティをFalseに設定します。

13. 「システム設定」の「検索」テキスト・ボックスにプラグイン・ログインと入力します。システム設定のエンタープライズ認証グループでプラグイン・ログイン設定セクションが開きます。

14. プラグイン・ログイン・モジュール・テキスト・ボックスにfalseと入力します。

15. 「保存」をクリックします。

10.2.2.2 基本認証とのOracle Enterprise Repository SSO統合の使用

シングル・サインオンのインストールで基本認証を使用する場合、Oracle Enterprise Repositoryのアセット・エディタが正しく機能するためには、追加プロパティの設定が必要です。

1. 前述のプロセスを使用して、次のプロパティを有効にします。

- cmee.jws.suppress-authorization-header

2. プロパティをTrueに設定します。

3. 「保存」をクリックします。

10.2.2.3 アプリケーション・プロパティ・ファイルの手動変更

前提条件: アプリケーション・サーバーを停止します。プロパティ・ファイルを変更すると、アプリケーション・サーバーで実行されているアプリケーションに影響する可能性があります。

1. WEB-INF/classes内のcontainerauth.propertiesファイルを編集します。
このファイルには、シングル・サインオン・サーバーに固有のヘッダー名のリストが格納されています。この情報は、シングル・サインオンで返信に使用されるレスポンス・ヘッダーを表し、組織のシングル・サインオン管理者または設計者から入手する必要があります。

シングル・サインオンのレスポンスによって電子メールのヘッダーに適切な値が提供されない場合、実際のヘッダー値のかわりに空白""を使用できます。シングル・サインオンによって指定または移入されないその他のフィールドは、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個のプロパティは、ロールまたは部門(あるいはその両方)の同期が有効であり、複数のロールまたは部門が単一ヘッダー内にある場合に使用されます。これらの追加プロパティは、ブール・パラメータenable-synch-rolesおよびenable-synch-deptsで指定される値に応じて無効にするか無視できます。この例のdelimiterフィールドではunicodeの空白文字が使用されていますが、他のデリミタ文字にはunicodeは必要ありません。

2. Oracle Enterprise Repositoryアプリケーションを再起動します。

10.2.3 拡張オプション

次のオプションによって、デフォルト・ロールの割当て、新しいユーザーの作成と通知、部門の同期およびロールの同期の機能が追加されます。

- 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.7項「デバッグ・ロギングの有効化」

10.2.3.1 新しいユーザーのデフォルト・ロールの作成/割当て

拡張RBACの場合:

1. Oracle Enterprise Repositoryのメニュー・バーの「管理」をクリックします。Oracle Enterprise Repositoryの「管理」画面が表示されます。

2. 「ロール」をクリックします。

3. 「新規作成」をクリックします。

4. 名前フィールドにBrowse_Onlyと入力します。

- 「新しいユーザーに自動的に割当て」を選択します。

- このプロファイルに一致する既存のユーザーを追加します。

5. 「保存」をクリックします。

6. 「role 1: Create/Submit」をクリックします。

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. 「保存」をクリックします。

10.2.3.2 新しいユーザーの作成/非承認ユーザーの許可

Oracle Enterprise Repositoryのシングル・サインオン認証統合では、新しいユーザーは正常に認証されるとOracle Enterprise Repositoryデータベース内に自動的に作成されます。新しいユーザーに付与される具体的なアクセス権および権限は、前の項で説明したように、デフォルトの新規ユーザー・ロールの構成によって決まります。アクセス管理者による承認時に、新しいユーザーは異なるアクセス設定を持つ他のロールに割り当てられる場合があります。ただし、ロール同期を有効にしてシングル・サインオン統合が構成された場合、ユーザーはシングル・サインオン・レスポンスのヘッダーによって提供されるロールに割り当てられます。

10.2.3.3 非承認ユーザー/新しいユーザーのログインの有効化

このオプションを有効にすると、Oracle Enterprise Repositoryの非承認ユーザーまたは新しいユーザーは、シングル・サインオン認証後にアプリケーションにアクセスできます。無効にした場合、新しいユーザーまたは非承認ユーザーはOracle Enterprise Repositoryにアクセスできません。この機能は、アプリケーションへのアクセスの前に手動承認プロセスが必要な場合に特に役立ちます。

- 非承認ユーザーのログインの有効化 = true (ファイル: enterprise.properties)

- enterprise.security.unapproveduser.allowlogin=true

10.2.3.4 新しいユーザーの通知

このプロパティを有効にすると、シングル・サインオン経由でOracle Enterprise Repositoryに新しいユーザー・アカウントが追加されたときに、アクセス管理者に電子メールで通知されます。

- 新しいユーザーの通知の有効化 = true (ファイル: cmee.properties)

- cmee.new.unapproved.users.notify=true

10.2.3.5 部門の同期

このプロパティを有効にすると、シングル・サインオンのレスポンス・ヘッダー値から部門名が同期されます。

- 部門の同期の有効化 = true (ファイル: containerauth.properties)

- enterprise.container.auth.enable-synch-depts - 既知の部門がユーザーと同期される場合はtrueに設定し、それ以外の場合はfalseに設定します。

- 部門の作成の有効化 = true (ファイル: 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

10.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

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

log4fl.propertiesファイルに次の行を追加することによって、デバッグ・ロギングを有効にします。

log4j.category.com.oer.enterprise.authentication.client.LoginContext=debug, cmeeLog

10.3 コンテナ管理設定

この項では、コンテナ管理設定を使用してOracle Enterprise Repositoryでユーザーを認証する方法について説明します。

この項には次のトピックが含まれます:

- 10.3.1項「概要」

- 10.3.2項「コンテナ管理の認証用のOracle Enterprise Repositoryの構成」

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

10.3.1 概要

コンテナは、Oracle Enterprise Repositoryアプリケーションで値を有効にする前に、レルムまたはオーセンティケータ・バックエンドを使用して適切に構成されます。

10.3.2 コンテナ管理の認証用のOracle Enterprise Repositoryの構成

アクセス管理者の権限を使用して、コンテナ管理の認証用にOracle Enterprise Repositoryを構成できます。この手順は、Oracle Enterprise Repositoryの「管理」画面で実行します。

1. 「システム設定」の「検索」テキスト・ボックスにコンテナ・ログイン・モジュールと入力します。図10-4に示すように、システム設定のエンタープライズ認証グループにコンテナ・ログイン・モジュール・セクションが表示されます。

2. 次に示すように、プロパティを変更します。

- コンテナ・ログイン・モジュール・クラス名

- テキスト・ボックスにcom.oer.enterprise.authentication.server.loginmodule.ContainerLoginと入力します。

- コンテナ・ログイン・モジュール表示名

- テキスト・ボックスにコンテナ・ログイン・モジュールと入力します。

- コンテナ・ログイン・モジュール

- プロパティをTrueに設定します。

- コンテナ管理の認証機能を有効にします。

- enterprise.authentication.container.enabledをTrueに設定します。

- ユーザーのセキュリティ原則からロール同期を有効にします。

- enterprise.authentication.container.synchroles.enabledをTrueに設定します。

注意:
BPMハーベスタ、Exchange Utilityまたはその他のREX操作でコンテナ管理の認証を使用する場合は、このプロパティをfalseに設定する必要があります。このプロパティをfalseに設定すると、ユーザー・アカウントは手動で作成され、少なくとも管理者レベル権限を持つユーザーによってロールが割り当てられる必要があります。

3. 「保存」をクリックします。

4. 「システム設定」の「検索」テキスト・ボックスにcookieログイン・モジュールと入力します。システム設定のエンタープライズ認証グループでCookieログイン設定セクションが開きます。

5. Cookieログイン・モジュール・プロパティをFalseに設定します。

6. 「保存」をクリックします。

7. 「システム設定」の「検索」テキスト・ボックスにプラグイン・ログインと入力します。システム設定のエンタープライズ認証グループでプラグイン・ログイン設定セクションが開きます。

8. プラグイン・ログイン・モジュール・テキスト・ボックスにfalseと入力します。

9. 「保存」をクリックします。

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

1. Oracle Enterprise Repositoryアプリケーションまたはこのアプリケーションが実行されているアプリケーション・サーバーを停止します。

2. Oracle Enterprise Repositoryのweb.xmlファイルを変更します。

- 次のセキュリティ制約の内容をファイルの最後に追加します。

注意:
この構成は、認証要件にあわせて変更する必要があります。この例では基本認証を使用していますが、ご使用の環境には適していない場合があります。

<!-- 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アプリケーションを起動/再起動します。

11 高度なロールベース・アクセス制御の構成

この章では、高度なロールベース・アクセス制御の概要を示し、ロールベース・アクセス制御の各種概念について説明します。

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

- 11.1項「概要」

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

- 11.3項「基本概念」

- 11.4項「アクセス定義」

- 11.5項「プロセスの概要」

- 11.6項「権限の付与および拒否」

- 11.7項「既存のロールのアクセス設定の構成」

- 11.8項「ロールベース・アクセス制御のユースケース」

11.1 概要

高度なロールベース・アクセス制御を有効にした場合、Oracle Enterprise Repositoryコンテンツへのアクセスと可視性をアセット・レベルおよびファイル・レベルでロール別に制限できます。そのためには、アセットまたはファイル(あるいはその両方)にカスタム・アクセス設定を適用し、対象となる特定のコミュニティにアクセスを制限します。

この基本機能は、組織の次のような幅広いイニシアチブに適用できます。

- 顧客および取引パートナにWebサービスを公開します。

- アウトソース先の開発チームが利用できる知的財産の量を制限し、輸出管理に対処します。

- 企業アセットへのアクセスと表示を全員に許可し、ドメイン固有の情報を関連ドメイン内のユーザーに制限するフェデレーテッド・リポジトリを確立します。

- アセットの発行、受入れ、登録など、ユーザーが実行できるアクションを管理します。

- 開発中のアセットおよびリタイア済のアセットの可視性を制限します。

- ソース・コード・ファイルへのアクセスをアセット作成チームに制限します。

- 選択したグループにブラウザ限定Oracle Enterprise Repositoryアクセスを付与します。

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

ロールベース・アクセス制御(RBAC)を使用すると、Oracle Enterprise Repositoryでアセット使用やアセット作成をユーザー別に追跡したり、アセットの表示をパーソナライズして、Oracle Enterprise Repository内の特定コンテンツの可視性を制限できます。ただし、ロールベース・アクセス制御の目的は、アセット・メタデータにセキュリティを提供することや、基礎となるアセット・リポジトリのセキュリティを補強することではありません。

Oracle Enterprise Repositoryのアクセス設定では、保護されていないアセットやデータに対する追加のセキュリティは提供されません。セキュリティを最大限に高めるために、アセットのメタデータを管理して、保護されていないデータベース内のメタデータへの直接アクセスを禁止する必要があります。機密情報は、アセットのダウンロード可能ペイロードに埋め込んだり、ドキュメント・ファイルとしてアタッチし、セキュアなリポジトリでホストする必要があります。

注意:
基礎となるアセット・リポジトリからの認証および権限のチャレンジを回避するよう選択する場合は、自己責任で行います。

以下のアクションもセキュリティに影響します。

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

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

これらのアクションのいずれかにより、Oracle Enterprise Repositoryへのネットワーク・アクセスを持つすべてのユーザーにリポジトリ・コンテンツが公開される可能性があります。

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

特定のアクセス設定が使用されている場合、アセット・エディタにアクセスできるユーザーに対して、Oracle Enterprise Repositoryで本来非表示になるアセットとの間のリレーションシップが表示されます。この場合、非表示のアセットの名前が表示され、そのアセットとユーザーがアクセスできるアセットとの間のリレーションシップの詳細も表示されます。非表示のアセットのその他の情報はアセット・エディタに表示されません。この場合、表示可能なアセットと非表示のアセット間のリレーションシップを削除できます。ただし、該当するユーザーが非表示アセットにアクセスできない場合は、リレーションシップを復元できません。

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

Oracle Enterprise Repositoryユーザーの場合は、通常、インストール時にカスタム・アクセス設定がすでに有効になっており、正しく構成されています。該当しない場合は、3つのプロパティを構成してカスタム・アクセス設定を有効にする必要があります。

1. Oracle Enterprise Repositoryの「管理」ページにあるサイドバーで「システム設定」をクリックします。メイン・ペインで「システム設定」セクションが開きます。

2. 新しいシステム設定の有効化テキスト・ボックスにcmee.customaccesssettings.enabledと入力します。

3. 「有効化」ボタンをクリックします。図11-1に示すように、機能設定セクションの高度なロールベース・アクセス制御グループにカスタム・アクセス設定が表示されます。

図11-1 機能設定

4. プロセスを繰り返して次の各プロパティを有効にします。

- cmee.customaccesssettings.file

- cmee.customaccesssettings.asset

有効にした3つすべてのCASシステム設定が、機能設定セクションの高度なロールベース・アクセス制御グループに表示されます。(これらのプロパティのいずれかを無効にすると、機能がオフになります。)

注意:
これらのアクセス設定が「システム設定」のアクセス・リストに表示されない場合は、システム管理者またはOracle Enterprise Repositoryカスタマ・サポートに問い合せてください。

5. 各設定がTrueになっていることを確認します。

6. 終了したら、「保存」をクリックします。図11-2に示すように、カスタム・アクセス設定が「管理」画面のサイドバーに表示されるようになります。

図11-2 カスタム・アクセス設定

11.3 基本概念

この項では、ロールベース・アクセス制御の基本概念について説明します。この節では、以下のトピックについて説明します。

- 11.3.1項「ロール」

- 11.3.2項「アクセス設定」

11.3.1 ロール

Oracle Enterprise Repositoryのコンテキスト内では、ロールは機能と職責の特定の組合せによって定義されます。どの個人にも複数のロールを割り当てることができます。特定のアセットまたはアセット・コレクションへのアクセスおよびOracle Enterprise Repositoryの各種機能へのアクセスは、各ロールのアクセス設定に基づいて決定されます。

11.3.2 アクセス設定

ロールが実行可能な機能と職責は、アクセス設定で指定します。Oracle Enterprise Repositoryのアクセス設定は次の2つのカテゴリに分類されます。

- 基本アクセス設定(BAS)では、Oracle Enterprise Repository内のすべてのアセットへのアクセスおよびアセット・エディタなどの特定のツールへのアクセスが決定されます。基本アクセス設定により、システム全体の一般的な機能に対する各ユーザーの権限が決定されます。たとえば、「表示」権限を持つユーザーは、Oracle Enterprise Repository内のすべてのアセットを表示できます。「使用」および「ダウンロード」権限を持つユーザーは、Oracle Enterprise Repository内のすべてのアセットのすべてのファイルをダウンロードできます。

- カスタム・アクセス設定(CAS) (有効になっている場合)では、Oracle Enterprise Repository内の特定のアセットおよびファイルへのアクセス権限がユーザーに付与されます。たとえば、カスタム・アクセス設定では、特定のアセット・グループの表示、特定のアセットの編集、特定のアセット・セット内の特定のファイルの表示などの権限をユーザーに付与できます。

基本アクセス設定はすべてのサイトで有効になっています。カスタム・アクセス設定はリポジトリの構成に応じて有効にできます。

11.4 アクセス定義

この項では、Oracle Enterprise Repositoryで使用される様々な定義について説明します。この項には次のトピックが含まれます:

- 「アセット」

- 「アクセス」

- 「ポリシー」

- 「プロジェクト」

- 「レポート」

- 「システム管理」

アセット

制御されるツール: 「アセット」タブ、アセット・エディタ、タイプ・マネージャ(リポジトリの構成で有効有効にされている場合)。

注意:
アセット・エディタの起動権限を付与されたユーザーはアセットを削除できます。これは、OER 12cの新機能です。前のバージョンのOERからアップグレードする場合は、前のバージョンでこの権限を付与されたユーザーはアセットを削除できるようになる点を理解しておくことが重要です。

権限

説明

BAS

CAS

表示

アセット詳細にアクセスできます。

X

X

使用

アセット詳細に使用/ダウンロード・ボタンが表示されます。

X

X

ダウンロード

アセットの使用/ダウンロード・ボタンをクリックした後でファイル・リンクにアクセスできます。

X

X

確認

アセット詳細でレビュー機能にアクセスできます。

X

X

通知

アセットに関する情報が非定型電子メールでサブスクライバに通知されます。

X

X

編集

アセット・エディタにアクセスできます。

X

X

受入れ

アセット・エディタに「受入れ」ボタンが表示されます。

X

X

タブの承認

アセット・エディタの各タブの下部に「承認」ボタンが表示されます。

X

X

登録

アセット・エディタでアセットを登録できます。

X

X

アクセス設定の編集

(CASのみ)すべてのアセットに対するCAS権限を変更できます。

X

X

作成/発行

Oracle Enterprise Repositoryの「アセット」画面でアセットを発行したり、アセット・エディタで新規アセットを作成できます。

X

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

アセット・エディタにアクセスできます。

X

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

アセット・エディタでアーティファクト・ストアを作成および編集できます。

X

アセット・タイプの編集

タイプ・マネージャを使用してタイプ・メタデータを構成できます。アセット・エディタの権限が必要です。

X

アクセス

制御される機能: 「管理」画面: ユーザー、セッション、ロール、部門、ファイル・ストア、基本アクセス設定、カスタム・アクセス設定(リポジトリの構成で有効にされている場合)。

権限

説明

BAS

CAS

表示

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

X

編集

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

X

作成

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

X

削除

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

X

ポリシー

制御されるツール: 「ポリシー」画面(リポジトリの構成で有効にされている場合)。

権限

説明

BAS

CAS

ポリシーの適用

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

X

プロジェクト

制御される機能: 「プロジェクト」画面(リポジトリの構成で有効にされている場合)。

権限

説明

BAS

CAS

表示

「プロジェクト」画面でプロジェクトを表示できます。

X

編集

「プロジェクト」画面でプロジェクトを編集できます。

X

作成

「プロジェクト」画面でプロジェクトを作成できます。

X

テンプレートの適用

アセット詳細またはアセット・エディタでプロジェクトにコンプライアンス・テンプレートを適用できます。

X

レポート

制御される機能: 「レポート」画面(リポジトリの構成で有効にされている場合)。

権限

説明

BAS

CAS

表示

レポートの表示。

X

システム管理

制御される機能: 「管理」画面: システム設定、電子メール・テンプレート。

権限

説明

BAS

CAS

編集

全般、セキュリティ、認証およびファイル・ストアの設定を編集する機能。

X

有効化

全般、セキュリティ、認証およびファイル・ストアの新しい設定を有効化する機能。

X

注意:
BASまたはCASを使用する場合は、BASで次のグローバル権限を管理して、グローバルな機能権限および機能を付与する必要があります。

- 作成/発行

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

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

- タイプの編集

11.5 プロセスの概要

組織は、いくつかの単純な手順により様々なセキュリティ・モデルを確立できます。

- ロールの設定

- ロールへのユーザーの割当て

- BASおよびCASを使用したロールへの権限の付与

- アセットまたはファイルへのCASの割当て

図11-3に、プロセスの概要を示します。

図11-3 プロセスの概要

11.6 権限の付与および拒否

個々のユーザーは一般に複数のOracle Enterprise Repositoryロールを保持しています。たとえば、1人がユーザー・ロールとレジストラ・ロールの両方を持つ場合があります。この場合、レジストラは、ユーザーには付与されていない権限を持っています。同様に、アウトソース先の開発ユーザーがユーザー・ロールとアウトソース開発ロールの両方を持つ場合があります。ユーザー・ロールではリポジトリ内のすべてのアセットへのアクセスが許可されますが、アウトソース開発ロールでは機密情報を含むアセットへのアクセスは拒否されます。

特定のOracle Enterprise Repositoryユーザーに特定の権限を割り当てる方法を決定する際には、権限ステータスが次の3つのレベルに分類されることに留意してください。

- 付与済
権限は明示的に付与されています。

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

- 拒否済
権限は明示的に拒否されています。

複数ロールの状況では、Oracle Enterprise Repositoryで最も制限的なアクセスが認識されます。つまり、権限ステータス設定での「拒否済」は「付与済」よりも優先されます。ユーザーが割り当てられているロールに対して明確に拒否された権限は、そのユーザーが割り当てられている他のロールに対しても拒否されます。

この項には次のトピックが含まれます:

- 11.6.1項「特定のアセットへのアクセスの付与/拒否」

- 11.6.2項「アセット内の特定のダウンロード・ファイルへのアクセスの付与/拒否」

11.6.1 特定のアセットへのアクセスの付与/拒否

高度なロールベース・アクセス制御を構成で有効にした場合は、カスタム・アクセス設定を使用して、個々のアセットおよびファイルへのアクセス権限を付与または拒否できます。アセットCASを作成するには、アクセス管理者ロールと次の(BAS)権限の両方が割り当てられている必要があります。

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

- アクセス設定の編集

既存のアクセス設定を変更するには、アセット・エディタへのアクセスとアセットの編集権限が必要です。Oracle Enterprise Repositoryの予防措置により、アセットのアクセス設定の編集後に編集者がそのアセットに対してロックアウトされる(この変更をアセットに保存することができなくなります)可能性が排除されています。ただし、ロール設定を変更すると、特定のアセットへのアクセスが制限される可能性があります。ロール設定を編集する際は注意してください。

11.6.1.1 前提条件

- 対象となるすべてのユーザーがOracle Enterprise Repositoryに存在することを確認してください。

- 各ユーザーにグローバルBAS権限(つまり、アセットの作成/発行、アセット・エディタの起動)を割り当ててください。

該当のユーザーを含むロールがまだ存在していない場合は、ロールを作成してください。この手順は、Oracle Enterprise Repositoryの「管理」ページで実行します。

1. 左側のサイドバーで「ロール」をクリックします。図11-4に示すように、「ロール」セクションが表示されます。

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

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

図11-5 「新規ロールの作成」ダイアログ

3. 「名前」フィールドおよび「説明」フィールドに適切な情報を入力します。

4. 「保存」をクリックします。

11.6.1.2 アセットCASの作成

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

1. 左側のサイドバーで「ロール」をクリックします。図11-6に示すように、メイン・ペインに使用可能なロールのリストが表示されます。

図11-6 ロールのリスト

2. リストから編集対象のロールを選択します。メイン・ペインの下のフレームにロールの詳細が表示されます。

3. ロールの詳細で「編集」ボタンをクリックします。図11-7に示すように、「ロールの編集」ダイアログが表示されます。

図11-7 「ロールの編集」ダイアログ

4. 「ロールの編集」ダイアログの「ユーザー」セクションで「ユーザーの編集」ボタンをクリックします。図11-8に示すように、ユーザーの追加ダイアログが表示されます。

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

5. 「検索」を使用するか、すべてをリストをクリックして「使用可能なユーザー」列にデータを移入します。

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

7. 終了したら、「OK」をクリックします。「ユーザーの追加」ダイアログが閉じ、選択したユーザーが「ロールの編集」ダイアログの「ユーザー」セクションに表示されます。

8. 「OK」をクリックします。「ロールの編集」ダイアログが閉じます。

9. 「管理」画面のサイドバーでカスタム・アクセス設定をクリックします。図11-9に示すように、カスタム・アクセス設定セクションが表示されます。

図11-9 カスタム・アクセス設定セクション

10. 「新規作成」をクリックします。図11-10に示すように、新規カスタム・アクセス設定の作成ダイアログが表示されます。

図11-10 新規カスタム・アクセス設定の作成ダイアログ

11. 「名前」テキスト・ボックスおよび「説明」テキスト・ボックスに適切なテキストを入力します。

12. 「タイプ」リストから「アセット」を選択します。

13. 権限の設定セクションのオプションを使用して、関連する権限を該当するロールに割り当てます。

- 図11-11に示すように、1回クリックすると、権限が付与されます。

図11-11 チェック・マーク

- 図11-12に示すように、2回目のクリックで権限が拒否されます。

図11-12 クロス・マーク

- 3回目のクリックで、オプションがクリアされます(権限の付与なし)。

図11-13 空白

14. 終了したら、「保存」をクリックします。新規カスタム・アクセス設定の作成ダイアログが表示されます。

15. Oracle Enterprise Repositoryのメニュー・バーで「アセット」をクリックします。

16. 「アセットの編集/管理」をクリックします。図11-14に示すように、アセット・エディタが表示されます。

図11-14 アセット・エディタ・ウィンドウ

17. 新規カスタム・アクセス設定を適用するアセットを探して開きます(または、必要に応じて作成します)。

18. 図11-15に示すように、アセットの「管理」タブをクリックします。

図11-15 「管理」タブ

19. 必要に応じて矢印ボタンを使用して、新規CASを「使用可能」列から「選択済」列に移動します。

20. ユースケース内外でユーザー権限をチェックして、CASをテストします。「アクセスの表示」ボタンをクリックして、ユーザー・アクセスを確認します。

11.6.2 アセット内の特定のダウンロード・ファイルへのアクセスの付与/拒否

このようなファイルCASを作成するには、アクセス管理者ロールと次の(BAS)権限が割り当てられている必要があります。

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

- アクセス設定の編集

11.6.2.1 前提条件

- 対象となるすべてのユーザーがOracle Enterprise Repositoryに存在することを確認してください。

- 各ユーザーにグローバルBAS権限(つまり、アセットの作成/発行、アセット・エディタの起動)を割り当てて、アセットの発行および編集を許可してください。

該当のユーザーを含むロールがまだ存在していない場合は、ロールを作成してください。この手順は、Oracle Enterprise Repositoryの「管理」画面で実行します。

1. 「ロール」をクリックします。

2. 「新規作成」をクリックします。

3. 「新規ユーザーの作成」ウィンドウの「名前」フィールドおよび「説明」フィールドに適切な情報を入力します。

4. 「保存」をクリックします。

11.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をテストします。アセットで「アクセスの表示」ボタンをクリックして、ユーザー・アクセスを確認します。

最も一般的ないくつかのセキュリティ・ユースケース・シナリオについて、後述の項で簡単に紹介します。ただし、新規セキュリティ・モデルのいずれかを実装する前に、カスタム・アクセス設定をサポートするようにシステム内の既存のロールを構成する必要があります。

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

Oracle Enterprise Repositoryには、後述するいくつかのデフォルト・ロールが用意されています。カスタム・アクセス設定にあわせてOracle Enterprise Repositoryを構成する場合は、基本アクセス設定とカスタム・アクセス設定を組み合せてこれらのロールを再確立し、カスタム・アクセス設定により既存のユーザー・アクセス権限が妨げられないようにする必要があります。

11.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を使用するための構成を行います。システム管理者は、通常、次の操作を行うことができます。

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

- レポートの生成(有効な場合)

11.7.2 アクセス・オプション

既存のロールのアクセス設定を構成する際には次の2つのオプションを使用できます。高度なロールベース・アクセス制御を有効にした場合は、カスタム・アクセス設定を使用して個々のアセットおよびファイルへのアクセスを制御できます。

- オプション1: アセットへのアクセス
アセットへのアクセスを付与または拒否します。このオプションは、カスタム・アクセス設定を使用してアセットのサブセットを特定のドメイン内の開発者、顧客、取引パートナ、アウトソース先の開発者などに公開することを希望する組織にとって有効です。

オプション1の用途は次のとおりです。

- 顧客および取引パートナにWebサービスを公開します。

- アウトソース先の開発チームに公開する知的財産を制限します。また、輸出管理の対象となるアセットを管理します。

- 企業アセットへのアクセスと表示を全員に許可しますが、ドメイン固有の情報を関連ドメイン内のユーザーに制限するフェデレーテッド・リポジトリを確立します。

- 開発中のアセットへのアクセスを制限して、アセット・ライフサイクルを管理します。

- 特定のグループを、リポジトリへのブラウザ限定アクセスに制限します。

- オプション2: ファイルへのアクセス
アセット内のダウンロード・ファイル/ペイロードへのアクセスを付与または拒否します。このオプションは、カスタム・アクセス設定を使用してブラック・ボックス再利用をサポートする組織にとって有効です。たとえば、開発者にはコンパイル済コードへのアクセスを許可し、アセットのプロデューサおよびメインテイナにはソース・コードとコンパイル済コードの両方へのアクセスを許可できます。

オプション2の用途は次のとおりです。

- ソース・コード・ファイルへのアクセスをアセット作成チームとアセット・メンテナンス・チームに制限します。

設定プロセスはオプションごとに異なります。最も簡単な方法は、最初にアセットへのアクセスを付与または拒否し(オプション1)、後で必要に応じてファイルへのアクセス権限を追加することです。

注意:
特定のアセット設定では、ダウンロード・プロセス中には特定のユーザーに表示されないアセット・ファイルでも、同じユーザーがアセット・エディタを使用する場合は表示およびアクセス可能になります。そのユーザーによるファイルの表示を完全に制限するには、アセット・エディタでのアセットの表示権限をブロックする必要もあります。

11.7.2.1 オプションI: CASを使用した特定のアセットへのアクセスの付与または拒否

手順1: カスタム・アクセス設定を使用してデフォルト・ロールを再確立する

1. Basic_Default_AssetsというアセットCASを作成します。

2. 次のロールおよび関連する権限をCASに追加します。

- ロール: ユーザー

- 権限: 「表示」、「使用」、「ダウンロード」、「確認」

- ロール: 上級発行者

- 権限: 「表示」、「使用」、「ダウンロード」、「確認」、「編集」

- ロール: レジストラ

- 権限: 「表示」、「使用」、「ダウンロード」、「確認」、「編集」、「受入れ」、タブの承認、「登録」、アクセス設定の編集

注意:
この構成では、レジストラはすべてのアセットのアクセス設定を表示および変更できます。この権限を制限するには、レジストラ・ロールの「アクセス設定の編集」オプションを空白のままにしてください。

- ロール: レジストラ管理者

- 権限: 「表示」、「使用」、「ダウンロード」、「確認」、「編集」、「受入れ」、タブの承認、「登録」、アクセス設定の編集

3. 画面上部にあるすべての新規アセットへの自動適用を選択します。

4. 「保存」をクリックします。

5. この新規設定を既存のすべてのアセットに適用するかどうかを確認するダイアログが表示されたら、「はい」をクリックします。図11-16に、結果のカスタム・アクセス設定を示します。

図11-16 カスタム・アクセス設定画面

手順2: Oracle Enterprise Repositoryツールへのアクセスを有効にする

1. 次の新規ロールを作成します(ロールの前に数値を付加し、それらもロール・リストに一緒に表示されるようにしてください)。

- 1: Create/Submit

- 2: Launch Asset Editor

- 3: Edit Artifact Stores

- 4: Edit Types

2. 現在のBAS設定を編集して次の内容を反映します。

- ロール: 1: Create/Submit

- 権限: 作成/発行

- ロール: 2: Launch Asset Editor

- 権限: アセット・エディタの起動

- ロール: 3: Edit Artifact Stores

- 権限: アーティファクト・ストアの編集

- ロール: 4: Edit Types

- 権限: タイプの編集

アセットに対する既存のBAS権限を削除して、CASがOracle Enterprise Repository内のすべてのアセットに対するデフォルト権限セットになるようにします。

注意:
BASでグローバル・ツール権限を維持するためには、次に説明するように、あらかじめ指定された4つの機能権限またはツール権限のそれぞれに対応する新規機能ロールのいずれかに各ユーザーを割り当てる必要があります。

手順3: 既存のロールを基準として既存のユーザーに新規ロールを関連付ける

1. 各ロールを編集し、アセットの作成/発行、アセット・エディタの起動、アーティファクト・ストアの編集、タイプの編集の1つ以上の権限を必要とするすべてのユーザーをそれぞれ4つの各ロールに配置します。

- 補足メモ: 次の表に、Oracle Enterprise Repositoryのデフォルト・ロールのデフォルト権限を示します。

ロール

権限

ユーザー

作成/発行

上級発行者

作成/発行、アセット・エディタの起動

レジストラ

作成/発行、アセット・エディタの起動

レジストラ管理者

作成/発行、アセット・エディタの起動、アーティファクト・ストアの編集、タイプの編集

例11-1 実例紹介

Larryには、今までデフォルト権限を持つデフォルトのユーザー・ロールが割り当てられていました。新規設定で既存の権限が維持されるようにするには、ユーザー・ロールに再び割り当て、さらに新規ロールの「1: Create/Submit」にも割り当てる必要があります。

Darylについても同様で、今まで割り当てられていたレジストラ・ロールのデフォルト権限が維持されるようにするには、レジストラに再び割り当て、さらに「1: Create/Submit」と「2: Launch Asset Editor」にも割り当てる必要があります。ユーザーにロールを追加するのではなく、ロールにユーザーを追加することもできます。Oracle Enterprise Repositoryのロールのデフォルト権限が変更されていない場合は、各ロールを編集して該当するユーザーをすべて同時に追加できます。

手順4: 変更を検証する

1. 5人のユーザーを作成し、それぞれ次のロールの組合せのいずれかに割り当てます。

- ユーザー、1: Create/Submit

- 上級発行者、1: Create/Submit、2: Launch Asset Editor

- レジストラ、1: Create/Submit、2: Launch Asset Editor

- レジストラ管理者、1: Create/Submit、2: Launch Asset Editor、3: Edit Artifact Stores、4: Edit Types

- プロジェクト管理者

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および「レポート」リンクが表示されます。

次の点を検証してください。

- 「アセット」画面には、アセットの発行リンクもアセットの編集/管理リンクも表示されません。

- 「検索」ボタンをクリックしても、検索結果は表示されません。

11.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でグローバル・ツール権限を維持するためには、図11-17に示すように、あらかじめ指定された4つの機能権限またはツール権限のそれぞれに対応する新規機能ロールのいずれかに各ユーザーを割り当てる必要があります。

図11-17 カスタム・アクセス設定

1. 4つの新規ロールを作成し、次の名前を付けます(ロールの前に数値を付加し、それらもロール・リストに一緒に表示されるようにしてください)。

- 1: Create/Submit

- 2: Launch Asset Editor

- 3: Edit Artifact Stores

- 4: Edit Types

2. 現在のBAS設定を編集して次の内容を反映します。

- ロール: 1: Create/Submit

- 権限: 作成/発行

- ロール: 2: Launch Asset Editor

- 権限: アセット・エディタの起動

- ロール: 3: Edit Artifact Stores

- 権限: アーティファクト・ストアの編集

- ロール: 4: Edit Types

- 権限: タイプの編集

手順5: 既存のロールに基づいて既存のユーザーに新規ロールを関連付ける

1. 各ロールを編集し、アセットの作成/発行、アセット・エディタの起動、アーティファクト・ストアの編集、タイプの編集の1つ以上の権限を必要とするすべてのユーザーをそれぞれ4つの各ロールに配置します。
次の表に、Oracle Enterprise Repositoryのデフォルト・ロールのデフォルト権限を示します。

ロール

権限

ユーザー

作成/発行

上級発行者

作成/発行、アセット・エディタの起動

レジストラ

作成/発行、アセット・エディタの起動

レジストラ管理者

作成/発行、アセット・エディタの起動、アーティファクト・ストアの編集、タイプの編集

例11-2 実例紹介

Darylには、今までデフォルト権限を持つデフォルトのユーザー・ロールが割り当てられていました。新規設定で既存の権限が維持されるようにするには、ユーザー・ロールに再び割り当て、さらに新規ロールの「1: Create/Submit」にも割り当てる必要があります。

Larryについても同様で、今まで割り当てられていたレジストラ・ロールのデフォルト権限が維持されるようにするには、レジストラに再び割り当て、さらに「1: Create/Submit」と「2: Launch Asset Editor」にも割り当てる必要があります。

ユーザーにロールを追加するのではなく、ロールにユーザーを追加することもできます。Oracle Enterprise Repositoryのロールのデフォルト権限が変更されていない場合は、各ロールを編集して該当するユーザーをすべて同時に追加できます。

手順6: 変更を検証する

1. 5人のユーザーを作成し、それぞれ次のロールの組合せのいずれかに割り当てます。

- ユーザー、1: Create/Submit

- 上級発行者、1: Create/Submit、2: Launch Asset Editor

- レジストラ、1: Create/Submit、2: Launch Asset Editor

- レジストラ管理者、1: Create/Submit、2: Launch Asset Editor、3: Edit Artifact Stores、4: Edit Types

- プロジェクト管理者

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および「レポート」リンクが表示されます。

次の点を検証してください。

- 「アセット」画面には、アセットの発行リンクもアセットの編集/管理リンクも表示されません。

- 「検索」ボタンをクリックしても、検索結果は表示されません。

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

この項では、ロールベース・アクセス制御のユースケースについて説明します。

この項には次のトピックが含まれます:

- 11.8.1項「ユースケース1: 顧客および取引パートナへのWebサービスの公開」

- 11.8.2項「ユースケース2: アウトソース先の環境における知的財産の管理」

- 11.8.3項「ユースケース3: フェデレーテッド・リポジトリの確立」

- 11.8.4項「ユースケース4: アセット・ライフサイクルの管理」

- 11.8.5項「ユースケース5: ソース・コード・ファイルへのアクセスのアセット作成チームのみへの制限」

- 11.8.6項「ユースケース6: 特定のグループへのブラウザ限定リポジトリ・アクセスの付与」

11.8.1 ユースケース1: 顧客および取引パートナへのWebサービスの公開

この項では、顧客および取引パートナにWebサービスを公開する方法を例示するユースケースについて説明します。この項には次のトピックが含まれます:

- 11.8.1.1項「利点」

- 11.8.1.2項「概要」

- 11.8.1.3項「ソリューション」

11.8.1.1 利点

このシナリオでは、組織はWebサービスを利用して取引パートナ間の業務処理を改善し、顧客がシステムに接続して情報を収集できるようにすることができます。その一方で、バックエンド・システムの機密ナレッジが公開されないように、情報へのアクセスを制限します。

11.8.1.2 概要

このシナリオでは、組織の取引パートナと顧客はOracle Enterprise Repository内の該当するWebサービスにのみアクセスできます。その他のアセットへのアクセスは拒否されます。これらの措置を促進するために、Webサービス・アセットのメタデータは次の2つの一般グループに編成されます。

- 制限なし
組織がすべての社内関係者および外部関係者に公開するメタデータ、関連ファイルおよびダウンロード可能ファイルです。

- 制限付き
組織のバックエンド・システムの内部の仕組みを示すメタデータ、設計ドキュメントまたはファイルです。この情報にアクセスできるのは社内開発者のみです。

このシナリオで説明するカスタム・アクセス設定(CAS)を使用すると、Webサービス・アセットの制限付き部分および制限なし部分の両方へのアクセスに加え、リポジトリ内のその他のアセットへのアクセスがすべての社内開発者に付与されます。組織の取引パートナと顧客は、制限なしWebサービス・アセットにのみアクセスできます。このシナリオでは、2つの異なるWebサービス・アセット・タイプを作成する必要があります。1つは制限なしデータ用、もう1つは制限付きデータ用です。

注意:
このシナリオでは、顧客と取引パートナにWebサービスを公開する簡単な方法について説明します。ただし、このユースケースで対応していないその他の考慮事項がある場合は、追加基準や代替基準が必要になることがあります。たとえば、外部専用として個別のOracle Enterprise Repositoryインスタンスを確立することが適している場合があります。外部インスタンスは内部インスタンスとは別のものとしてブランド設定し、外部関係者に公開する情報として適したメタデータ、関連ファイルおよびダウンロード可能ファイルのみを扱うようにします。この場合、使用履歴とレビューには外部ユーザーの経験のみが反映されます。より複雑なソリューションが必要な状況では、Oracle Enterprise Repository実装マネージャまたはソリューション・コンサルタントに問い合せて支援や指示を受けてください。

11.8.1.3 ソリューション

この項では、このユースケースのソリューションについて説明します。

11.8.1.3.1 前提条件

顧客および取引パートナのユーザーがOracle Enterprise Repositoryに存在することを確認してください。

11.8.1.3.2 ロールの作成および割当て

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

1. 「ロール」をクリックします。図11-18に示すように、「ロール」セクションが表示されます。

図11-18 「ロール」セクション

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

図11-19 「新規ロールの作成」ダイアログ

3. 「名前」テキスト・ボックスに「User - Customer」と入力します。

4. 「説明」テキスト・ボックスに「Represents Web Services customers」またはその他の説明テキストを入力します。

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

6. 同じプロセスを繰り返して、「User - Trading Partner」ロールを作成します。

7. 新規ロールを該当するユーザー(つまり、該当する顧客および取引パートナを表すユーザー・アカウント)に割り当てます。

- 「管理」画面で次のいずれかの操作を行います。

- 「ロール」をクリックして、ロールにユーザーを割り当てます。

- 「ユーザー」をクリックして、ユーザーにロールを割り当てます。

11.8.1.3.3 メタデータの編成

Webサービス・アセットのメタデータは、Oracle Enterprise Repositoryで情報へのアクセスを許可するロール別に2つの一般グループに編成する必要があります。1つ目のグループは、すべてのユーザー(顧客、取引パートナおよび社内開発者)に表示するメタデータで構成します。2つ目のグループは、社内開発者のみに表示するメタデータで構成します。

1. アセット・エディタを起動します。

2. 「アクション」メニューで「タイプの管理」をクリックします。タイプ・マネージャが表示されます。

3. 「サービス」アセット・タイプをテンプレートとして使用して、「Service - Internal Only」という新規アセット・タイプを作成します。

4. 終了したら、タイプ・マネージャの「ファイル」メニューで「保存」をクリックします。

5. アセット・エディタの「ファイル」メニューでコピーと移行をクリックします。

6. 新規アセット・タイプService - Internal Onlyに既存のWebサービス・アセットをすべてコピー/移行します。

7. 「サービス」アセット・タイプの元のアセットをすべて編集し、公開表示から除外する情報またはメタデータを表すすべてのメタデータ・フィールドを削除します。

8. 新規アセット・タイプService - Internal Onlyからすべての制限なしフィールド(前述の1つ目のメタデータ・グループ)を削除します。

11.8.1.3.4 リレーションシップの作成

この手順は、アセット・エディタで実行されます。

1. 「アクション」メニューで「リレーションシップの構成」をクリックします。リレーションシップの構成ダイアログが表示されます。

2. 「追加」をクリックします。

3. 図11-20に示すように、External-Use-Internal-Onlyという双方向リレーションシップを構成します。

図11-20 リレーションシップの追加ダイアログ

11.8.1.3.5 リレーションシップの適用

サービス・アセットにExternal-Use-Internal-Onlyリレーションシップを追加します。

この手順は、アセット・エディタで実行します。

1. サービス・アセットのいずれかを開きます。

2. 「リレーションシップ」タブをクリックします。

3. 各サービス・アセットにExternal-Use-Internal-Onlyリレーションシップを適用します。これにより、社内ユーザーが制限付きフィールドにアクセスできるようになります。

4. CASを作成します。

- 「管理」画面のサイドバーでカスタム・アクセス設定をクリックします。

- 「新規作成」をクリックします。

- 図11-21に示すように、新規CASにAccess_Web_Service_Information_for_External_Useという名前を付けます。

図11-21 カスタム・アクセス設定: CAS Access_Web_Service_Information_for_External_Use

- 次の権限を設定します。

- ロール: User - Customer

- 権限: 「表示」、「使用」、「ダウンロード」、「確認」

- ロール: User - Trading User

- 権限: 「表示」、「使用」、「ダウンロード」、「確認」

5. アセット・エディタを起動します。

6. Webサービス・アセットのいずれかを開きます。

7. 「管理」タブを選択します。

8. Webサービスに新規CAS Access_Web_Service_Information_for_External_Useを適用します。このCASは、図11-22に示すように、各アセットにすでに割り当てられているBasic_Default_AssetsというCASと連動して機能します。

図11-22 アセット・エディタ画面

9. 各Webサービス・アセットに対してプロセスを繰り返します。

11.8.1.3.6 結果

- 「サービス」アセット・タイプ

図11-23 「サービス」アセット・タイプ

- Service - Internal Onlyアセット・タイプ

図11-24 Service - Internal Onlyアセット・タイプ

注意:
このビューの情報量はかなり少ないことに注意してください。

11.8.1.3.7 検証テスト

指定された3つの各ロール内のユーザーを選択し、次の説明に従ってアクセスを検証してください。

- ロール

- User - Customer

- User - Trading Partner

- アクセス

- Oracle Enterprise Repositoryのメニュー・バーには、「アセット」リンクとMy Stuffリンクのみが表示されます。

- 外部表示を目的としたWebサービス・アセット・メタデータのみを参照できます(「サービス」アセット・タイプ)。

- これらのアセットのリレーションシップは表示されません。

- Webサービス・アセットを使用する場合は、主要なダウンロード可能ファイルのみをダウンロードできます。関連アセットは使用できません。

- Oracle Enterprise Repositoryの「アセット」画面には、アセットの発行ボタンおよびアセットの編集/管理ボタンは表示されません。

- Webサービス・アセットのアセット詳細画面を表示したときに「編集」ボタンは表示されません。

- ロール

- ユーザー(社内従業員):

- アクセス

- 社内表示および外部表示を目的としたWebサービス・メタデータを参照できます(「サービス」および「Service - Internal Only」アセット・タイプ)。

- サービス・アセットのすべてのリレーションシップを参照できます。

- 社内限定サービス・アセットを表示したときに使用/ダウンロード・ボタンをクリックすると、外部表示を目的としたファイルが関連アセットとしてダウンロード・ウィンドウに表示されます。社内用ファイルと外部用ファイルの両方を同時にダウンロードできます。

11.8.2 ユースケース2: アウトソース先の環境における知的財産の管理

この項では、アウトソース先の環境で知的財産を管理する方法を例示するユースケースについて説明します。この項には次のトピックが含まれます:

- 11.8.2.1項「利点」

- 11.8.2.2項「概要」

- 11.8.2.3項「ソリューション」

11.8.2.1 利点

このシナリオで説明する設定を使用すると、高度に分散されたアウトソース先の環境を作業基盤としている組織は、知的財産を管理および保護する目的でそれらの公開をアウトソース先の開発チームに制限できます。また、これらの設定によって、アセットが輸出管理法規で指定されている制限事項に準拠するようにすることもできます。

11.8.2.2 概要

アウトソース先の開発チーム

このシナリオでは、外部サービス・プロバイダ(ESP)は、プロジェクト・プロファイルで指定されているアセットにかぎり、表示、使用およびレビューできます。プロジェクトの進行中に、ESPは、プロジェクト内で作成されたアセットを技術責任者またはプロジェクト設計者に発行して、レビュー、承認およびアセット登録を求めることもできます。たとえば、プロジェクトの設計フェーズが終了したら、ESPは設計ドキュメントを技術責任者またはプロジェクト設計者に発行して承認を求めることができます。このシナリオは、プロジェクト・ライフサイクル・ガバナンス・モデルを提示し、プロジェクト・マイルストンのレビューを円滑化するものです。

輸出管理

通常、輸出管理規制により、一部の国へのソフトウェアおよびその他のタイプの知的財産の輸出が禁止されています。このシナリオでは、輸出管理の対象となるアセットに対して、それらが特定の輸出管理分類番号(ECCN)で制限されていることを示すカスタム・アクセス設定を割り当てます。制限の対象となる個人には、従業員としての通常の職責のために付与されているロールに加え、該当する輸出管理分類番号(ECCN)ロールを割り当てます。たとえば、暗号化ソフトウェアは、ECCN 5D002により、イラク、イラン、リビア、北朝鮮、スーダン、シリアまたはキューバへの輸出が禁止されています。Oracle Enterprise Repository内のすべての暗号化ソフトウェア・アセットには、それらが輸出管理の対象となっていることを示すカスタム・アクセス設定Access_Restricted_by_ECCN_5D002を割り当てます。さらに、イラク、イラン、リビア、北朝鮮、スーダン、シリアまたはキューバ出身の個人に、暗号化ソフトウェアへのアクセスが制限されていることを示すロール「ユーザー - ECCN 5D002による制限」を割り当てます。輸出管理の制限事項が変更された場合は、影響を受ける個人およびアセットを容易に識別し、アクセス設定を変更できます。

11.8.2.3 ソリューション

この項では、このユースケースのソリューションについて説明します。この項には次のトピックが含まれます:

- 11.8.2.3.1項「アウトソース先の開発チームに関するソリューション」

- 11.8.2.3.2項「輸出管理に関するソリューション」

11.8.2.3.1 アウトソース先の開発チームに関するソリューション

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

前提条件

外部サービス・プロバイダがOracle Enterprise Repositoryのユーザー・アカウントを持っていることを確認してください。

ロールの作成

1. 「ロール」をクリックします。

2. 「新規作成」をクリックします。

3. 「User - ESP Project X」という新規ロールを作成します。
このロールは、特定のプロジェクトで作業する外部サービス・プロバイダを表します。このロール内のユーザーは、プロジェクト・プロファイルで指定されているアセットのみを表示およびダウンロードできます。また、プロジェクトの進行中に、アセットを技術責任者に発行して、レビュー、承認およびアセット登録を求めることもできます。

ロールの割当て

「User - ESP Project X」ロールおよび「1: Create/Submit」ロールを該当するユーザーに割り当てます。

「1: Create/Submit」ロールを持つESPは、プロジェクトの進行中に、プロジェクトで作成されたアセットを技術責任者またはプロジェクト設計者に発行して、レビュー、承認およびアセット登録を求めることもできます。

図11-25に示すように、「ロール」をクリックしてロールにユーザーを割り当てます。

図11-25 「ロールの編集」ダイアログ

図11-26に示すように、「ユーザー」をクリックしてユーザーにロールを割り当てます。

図11-26 ユーザー

カスタム・アクセス設定の作成

1. 「カスタム・アクセス設定」をクリックします。

2. 「新規作成」をクリックします。

3. 「Access_Project_X_Assets」という新規CASを作成します。このCASは、Project X用として指定されているアセットへのアクセスを提供するものです。

4. 図11-27に示すように、次の権限を設定します。

- ロール: User - ESP Project X

- 権限: 「表示」、「使用」、「ダウンロード」、「確認」

図11-27 カスタム・アクセス設定の編集ダイアログ

5. 図11-28に示すように、プロジェクト・プロファイルでProject X用として指定されているアセットを識別します。

図11-28 アセットのプロジェクト・プロファイル - Project X (1.0)

6. 図11-29に示すように、Project Xのプロジェクト・プロファイルおよびその中で指定されている各アセットにCAS Access_Project_X_Assetsを追加します。

図11-29 カスタム・アクセス設定

検証テスト

Project Xに割り当てられている外部サービス・プロバイダを対象にした次の条件を検証してください。

- ロール

- Outsourced_Dev_User:

- アクセス

- Project Xのプロジェクト・プロファイルを参照できます。

- Project Xのプロジェクト・プロファイルで指定されているアセットのみを参照できます。

- Project Xのプロジェクト・プロファイルで指定されているアセットをダウンロードできます。

- 「アセット」画面には、アセットの発行リンクが表示されます。

- アセット詳細画面には、使用/ダウンロード・ボタンが表示されます。「編集」ボタンは表示されません。

- Oracle Enterprise Repositoryには、「アセット」タブおよびMy Stuffタブのみが表示されます。

11.8.2.3.2 輸出管理に関するソリューション

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

前提条件

輸出管理による制限を受ける個人がOracle Enterprise Repositoryのユーザー・アカウントを持っていることを確認してください。

ロールの作成

1. 「ロール」をクリックします。

2. 「新規作成」をクリックします。

3. 「User - Restricted by ECCN 5D002」というロールを作成します。このロールは、イラク、イラン、リビア、北朝鮮、スーダン、シリアまたはキューバ出身の個人、つまり暗号化ソフトウェアまたはECCN 5D002で輸出が制限されているソフトウェアへのアクセスを制限するユーザーに割り当てます。

4. 図11-30に示すように、新規ロール「User - Restricted by ECCN 5D002」を該当するユーザーに割り当てます。

図11-30 ロールの編集

カスタム・アクセス設定の作成

1. 「カスタム・アクセス設定」をクリックします。

2. 「新規作成」をクリックします。

3. 「Access_Restricted_by_ECCN_5D002」という新規CASを作成します。このCASは、ECCN 5D002で輸出が制限されているアセットへのアクセスを制限するものです。

4. 図11-31に示すように、次の権限を設定します。

- ロール: User - Restricted by ECCN 5D002

- 権限: アクセス拒否: 「表示」、「使用」、「ダウンロード」、「確認」、「受入れ」、タブの承認、「登録」、「アクセス設定の編集」

図11-31 カスタム・アクセス設定の編集ダイアログ

5. すべての暗号化ソフトウェア・アセットまたはECCN 5D002で輸出が制限されているアセットにCAS Access_Restricted_by_ECCN_5D002を追加します。

図11-32 カスタム・アクセス設定

検証テスト

該当する個人が輸出管理の制限事項により制限されることを検証してください。

- 輸出管理の制限事項により制限されているアセットを参照できません。

- 輸出管理の制限事項により制限されていないすべてのアセットを参照できます。

11.8.3 ユースケース3: フェデレーテッド・リポジトリの確立

この項では、フェデレーテッド・リポジトリを確立する方法を例示するユースケースについて説明します。この項には次のトピックが含まれます:

- 11.8.3.1項「利点」

- 11.8.3.2項「概要」

- 11.8.3.3項「ソリューション」

11.8.3.1 利点

このシナリオで説明する設定を使用すると、Oracle Enterprise Repositoryユーザーに対して企業アセットへのアクセスと表示を許可し、ドメイン固有の情報については関連ドメインに割り当てられているユーザーにアクセスを制限できます。これにより、大規模な組織は、特定のアセット・コンシューマ・グループに対象を絞り、それらのグループのニーズにあわせて最も関連性の高いアセットを提供できるようになります。

11.8.3.2 概要

このシナリオでは、組織内の誰もが表示およびダウンロードできる企業全体のアセット、および特定のビジネス・ドメイン内の開発チームにのみ関連するドメイン固有のアセットを扱います。企業全体のアセットのプロデューサは、それらのアセットを作成、編集および登録できるだけでなく、すべてのドメイン・アセットを表示およびダウンロードできます。ドメイン固有のアセットのプロデューサは、ドメイン内のアセットを作成、編集および登録できます。組織内のすべてのユーザーが企業全体のアセットに加え、それぞれのドメインに固有のアセットも表示およびダウンロードできます。

11.8.3.3 ソリューション

この項では、このユースケースのソリューションについて説明します。

11.8.3.3.1 前提条件

企業全体およびドメインを対象としたプロデューサとすべてのコンシューマがOracle Enterprise Repositoryのユーザー・アカウントを持っていることを確認してください。

11.8.3.3.2 ロールの作成

1. Oracle Enterprise Repositoryのメニュー・バーの「管理」リンクをクリックします。

2. 「管理」画面で、「ロール」をクリックします。

3. 「新規作成」をクリックします。

4. 次のロールを作成します。

- ロール: Enterprise Producer

- アクセス
企業アセットを表示、ダウンロード、編集および登録できます。

ドメイン・アセットを表示およびダウンロードできます。

- ロール: Domain X Producer

- アクセス
ドメインXアセットを表示、ダウンロード、編集および登録できます。

企業アセットを表示およびダウンロードできます。

- ロール: Domain X Consumer

- アクセス
ドメインXアセットおよび企業アセットを表示およびダウンロードできます。

- ロール: Domain Y Consumer

- アクセス
ドメインYアセットを表示、ダウンロード、編集および登録できます。

企業アセットを表示およびダウンロードできます。

11.8.3.3.3 カスタム・アクセス設定の作成

1. Oracle Enterprise Repositoryのメニュー・バーの「管理」リンクをクリックします。

2. 「管理」画面で、「カスタム・アクセス設定」をクリックします。

3. 「新規作成」をクリックします。

4. 次のカスタム・アクセス設定を作成します。

- CAS: Access_Enterprise_Assets

- すべてのOracle Enterprise Repositoryユーザーに対して企業全体のアセットの表示を許可します。

- CAS: Access_Domain_X_Assets

- ドメインXアセットへのアクセスを「Enterprise Producer」ロールまたは「Domain X Producer」ロール(あるいはその両方)に割り当てられているユーザーに制限します。

- CAS: Access_Domain_Y_Assets

- ドメインYアセットへのアクセスを「Enterprise Producer」ロールまたは「Domain Y Producer」ロール(あるいはその両方)に割り当てられているユーザーに制限します。

各ドメイン・アセットまたは企業アセットについて、Basic_Default_Assetsアクセス設定を削除し、上の手順4に示した適切なカスタム・アクセス設定に置き換えます。

- Enterprise_Producerに割り当てられているロール

図11-33 「概要」セクション

- 対応するCAS

図11-34 権限の設定

- Domain_X_Producersに割り当てられているロール

図11-35 「概要」セクション

- Domain_X_Consumersに割り当てられているロール

図11-36 「概要」セクション

- 対応するCAS

図11-37 権限の設定

- Domain_Y_Producersに割り当てられているロール

図11-38 「概要」セクション

- 対応するCAS

図11-39 アクセス設定の編集

5. 各企業アセットまたはドメイン・アセットについて、図11-40に示すように、Basic_Default_Assets設定を削除し、適切なCAS (Access_Enterprise_Assets、Access_Domain_X_AssetsまたはAccess_Domain_Y_Assets)に置き換えます。

図11-40 アセット・エディタ

11.8.3.3.4 検証テスト

各ユーザー/ロールについて次の条件を検証してください。

- Enterprise Producer:

- Oracle Enterprise Repositoryの「アセット」画面には、個々の企業アセット、ドメインXアセットおよびドメインYアセットのメタデータが表示されます。

- アセット・エディタには、企業アセットのみが表示されます(アセット・エディタではドメインXアセットおよびドメインYアセットにはアクセスできません)。

- 企業アセットのメタデータを表示したときに「サブスクライブ」ボタン、使用/ダウンロード・ボタンおよび「編集」ボタンが表示されます。

- アセット・エディタで企業アセットを編集および登録できます。

- ドメインXアセットとドメインYアセットの両方のメタデータ画面には、使用/ダウンロード・ボタンが表示されます。ただし、「編集」ボタンは表示されません。

- Domain X Producer:

- Oracle Enterprise Repositoryの「アセット」画面には、個々の企業アセットおよびドメインXアセットのメタデータが表示されます。ドメインYアセットは表示されません。

- アセット・エディタには、ドメインXアセットが表示されます(アセット・エディタではドメインYアセットおよび企業アセットにはアクセスできません)。

- 企業アセットのメタデータを表示したときに「サブスクライブ」ボタンおよび使用/ダウンロード・ボタンが表示されます。ただし、「編集」ボタンは表示されません。

- 企業アセットからファイルをダウンロードできます。

- ドメインXアセットのメタデータ画面には、「サブスクライブ」ボタン、使用/ダウンロード・ボタンおよび「編集」ボタンが表示されます。

- アセット・エディタでドメインXアセットを編集および登録できます。

- Domain X Consumer:

- Oracle Enterprise Repositoryの「アセット」画面には、個々の企業アセットおよびドメインXアセットのメタデータが表示されます。ドメインYアセットは表示されません。

- 企業アセットおよびドメインXアセットのメタデータを表示したときに「サブスクライブ」ボタンおよび使用/ダウンロード・ボタンが表示されます。ただし、どちらの場合も「編集」ボタンは表示されません。

- 企業アセットおよびドメインXアセットからファイルをダウンロードできます。

- Domain Y Producer:

- Oracle Enterprise Repositoryの「アセット」画面には、個々の企業アセットおよびドメインYアセットのメタデータが表示されます。ドメインXアセットは表示されません。

- アセット・エディタには、ドメインYアセットが表示されます。ただし、アセット・エディタではドメインXアセットおよび企業アセットにはアクセスできません。

- 企業アセットおよびドメインYアセットのメタデータを表示したときに「サブスクライブ」ボタンおよび使用/ダウンロード・ボタンが表示されます。ただし、どちらの場合も「編集」ボタンは表示されません。

- 企業アセットおよびドメインYアセットからファイルをダウンロードできます。

11.8.4 ユースケース4: アセット・ライフサイクルの管理

この項では、Oracle Enterprise Repositoryでアセット・ライフサイクルを管理する方法を例示するユースケースについて説明します。この項には次のトピックが含まれます:

- 11.8.4.1項「利点」

- 11.8.4.2項「概要」

- 11.8.4.3項「ユースケースのソリューションの構成」

- 11.8.4.4項「アセット・ライフサイクル管理ソリューションの検証テスト」

11.8.4.1 利点

このシナリオで説明する設定を使用すると、組織はアセットをそのライフサイクル全体(初期構想からリタイアまで)を通して管理できます。これらの設定では、開発中アセット(進行中のアセット)へのアクセスおよびリタイア済のアセットへの制限付きアクセスを提供しています。これは、開発中のアセットをすべての開発チームに公開して、開発が重複して行われないようにすることができます。このようなアセットを必要とする開発チームは、そのアセットをプロジェクトに含めることを計画したり、アセットの開発時にアセット作成チームと協力することができます。別の設定では、デプロイされたアセットの管理が容易になるように、リタイア済のアセットの配布を制限しています。

11.8.4.2 概要

注意:
このユースケースは、アセット・リリース管理のポリシーおよび手順を背景にしたものです。リリース管理では、アセットおよびその構成要素となるアーティファクトのライフサイクルを管理することに重点が置かれています。アセットの構成要素となるアーティファクトは、アセット・リリース管理の一環として、あらゆるプロジェクトで作成されます。そのプロジェクトの最終的な結果がそのアセット自体であるか、製品全体またはシステム全体であるかは問いません。これらのアーティファクトは、サポート・アーティファクトやその他の情報とともに収集され、すべてを集約したものがアセットとしてパッケージ化されます。これらのアセットは、完全かつ正確であると検証された後でリポジトリに格納され、組織全体に公開されます。登録されたアセットがリポジトリからダウンロードされることにより、不具合が見つかり、改善が求められます。これらの変更リクエストに対応するために、新規バージョンのアセットが作成されます。アセットは、使用停止または別のバージョンへの置換を経て、最終的にリタイアさせられます。リタイア済のアセットは使用できません。

Oracle Enterprise Repositoryを使用すると、アセットをそのライフサイクル全体(構想からリタイアまで)を通して管理できます。このユースケースは、高度なRBACを使用して、アセット・ライフサイクル全体を通して様々な利害関係者グループにアセットを公開したり、アクセスを提供することに重点を置いています。

11.8.4.2.1 アセット・ライフサイクル・ステージ

- 要件収集
組織は、今後のプロジェクトで特定のアセットが必要になることを認識しています。作成チームは、提案された進行中のアセットを作成します。このアセットのメタデータには、アセットとその目的に関する簡単な説明が含まれています。また、該当するプロジェクトに関連付けられている一連の対象分野の専門家によるレビューやコメントを付加することができます。アセットのリポジトリ表示には、今後のプロジェクトのメンバーから機能要件を集めるための専用仮想フォーラムへのリンクが含まれています。アセットは、この時点ではアセット作成者と該当するプロジェクトの対象分野の専門家にのみ表示されます。提案されたアセットが承認され、次のライフサイクル・ステージに進むと、さらに幅広い人に表示されるようになります。

注意:
Oracle Enterprise Repositoryで進行中のアセット・オプションを使用する必要があります。

- 設計および開発
要件収集が終了し、アセット開発のための予算が承認されたら、プロデューサはサポート・アーティファクト(設計ドキュメント、コードなど)を生成し、リポジトリ内のアセットに関連付けます。この時点では、アセットのプロデューサのみが、アーティファクトやメタデータをアセットに追加したり、アセットのコードをダウンロードできます。ただし、利害関係者が進行状況を追跡できるように、アセットは幅広い開発者コミュニティに表示されます。

- ベータ・リリース
コードのテストが終了したら、アセットの使用が予定されている今後のプロジェクトを担当する対象分野の専門家にベータ・リリースとして公開されます。

- リリース
アセットが十分にテストされ、文書化が終了したら、ユーザー・コミュニティ全体に公開されます。

- リタイア・スケジュールの決定
アセットの有用性がなくなった時点で、リタイア・スケジュールが決定されます。リポジトリ・ステータスは非アクティブに変わります。非アクティブ・アセットはリポジトリに残りますが、非アクティブ・アセットへのアクセスはメタデータに制限されます。つまり、アセットは使用できず、そのファイルもダウンロードできません。これらの制限がきっかけとなって、プロジェクトを最新バージョンのアセットに移行することになります。アセットの管理担当者は、実際のリタイア日まで引き続きアセットの表示権限および編集権限を持ちます。

- リタイア
すべてのプロジェクトを新規バージョンのアセットに移行したら、元のアセットのリポジトリ・ステータスはリタイア済に変わります。アセットがリポジトリ内の別のアセットに関連している場合は、リポジトリ・ユーザー限定(ロールを問わず)で表示されます。ユーザーは、リレーションシップ・リンクを使用してアセットのメタデータを表示できます。

このシナリオでは、進行中のアセットおよびリタイア済のアセットへのアクセスを管理するための各種戦略の1つについてのみ説明します。これらの戦略の詳細は、Oracle Supportに問い合せてください。

11.8.4.2.2 一般構成

この項で説明する各種アセット・ライフサイクル管理ソリューションを使用するには、次のロールおよびアクセス設定を構成する必要があります。

(前提条件: アセット作成チームおよび対象分野の専門家がOracle Enterprise Repository内のユーザーであることを確認してください)

11.8.4.2.3 ロールの作成

1. Oracle Enterprise Repositoryのメニュー・バーの「管理」リンクをクリックします。

2. 「管理」画面で、「ロール」をクリックします。

3. 「新規作成」をクリックします。

4. 次のロールを作成します。

- User - Production Team Project X

- User - Subject Matter Experts Project X

11.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: ロール

図11-41 ユーザー: Project_X_Producer

- Project_X_Subject_Matter_Expert: ロール

図11-42 ユーザー: Project_X_Subject_Matter_Expert

- User_Community: ロール

図11-43 ユーザー: User_Community

- アセット・ライフサイクル・ステージ - 提案

- CAS: Access_Project_X_Assets_Propose

図11-44 アクセス設定の編集

- アセット・ライフサイクル・ステージ - 計画

- CAS: Access_Project_X_Assets_Plan

図11-45 アセット設定の編集

- アセット・ライフサイクル・ステージ - ビルド

- CAS: Access_Project_X_Assets_Build

図11-46 アクセス設定の編集

- アセット・ライフサイクル・ステージ - リリース

- CAS: Access_Project_X_Assets_Release

図11-47 アクセス設定の編集

11.8.4.3 ユースケースのソリューションの構成

次の項では、アセット・ライフサイクル管理ユースケースの各フェーズに必要な手順について簡単に説明します。

11.8.4.3.1 要件収集ステージのソリューション

(前提条件: 選択したアセット・タイプの一部としてアセット・ライフサイクルのカテゴリ分けの分類が含まれていることを確認してください)

1. Oracle Enterprise Repositoryのメニュー・バーの「アセット」リンクをクリックします。

2. アセットの編集/管理をクリックして、アセット・エディタを起動します。

3. アセット・エディタで「ファイル」メニューを開きます。

4. 「新規」をクリックします。

5. 図11-48に示すように、初期状態が未発行のアセットを作成します。

図11-48 アセットの新規作成ダイアログ

6. アセット・エディタの新規アセットの分類タブで、アセット・ライフサイクル・ステージ・カテゴリ分けを探します。

7. ステージ1 - 提案を選択します。

8. 図11-49に示すように、アセットの「管理」タブで、新規アセットCAS Access_Project_X_Assets_Proposeを追加します。

図11-49 アセット・エディタ

9. アセット・エディタでアセットの「一般」タブを開き、該当するテキスト・ボックスにアセットの説明および目的を簡単に入力し、アセットの機能要件を収集するためのフォーラムを追加します。

10. 図11-50に示すように、アセット・ライフサイクル・ステージ・カテゴリ分けのステージ1 - 提案フォルダに格納されているアセットを表示します。

図11-50 アセット・ツリーの参照

11.8.4.3.2 設計および開発ステージのソリューション

1. アセット・エディタでは、このアセットは未発行状態のままです。

2. アセット・ライフサイクル・ステージ・カテゴリ分けでステージ2 - 計画を選択します。

3. アセットCAS Access_Project_X_Assets_Proposeを削除し、アセットCAS Access_Project_X_Assets_Planを追加します。

図11-51 アセット・エディタ

11.8.4.3.3 ベータ・リリース・ステージのソリューション

1. アセット・エディタでは、このアセットは未発行状態のままです。

2. アセット・ライフサイクル・ステージ・カテゴリ分けでステージ3 - ビルドを選択します。

3. アセットCAS Access_Project_X_Assets_Planを削除し、アセットにアセットCAS Access_Project_X_Assets_Buildを追加します。

11.8.4.3.4 リリース・ステージのソリューション

1. アセット・エディタで、アセットを発行します。アセットがレジストラによって受け入れられて登録されると、ステータスが未発行から「登録済」に変わります。

2. アセット・ライフサイクル・ステージ・カテゴリ分けでステージ4 - リリースを選択します。

3. アセットCAS Access_Project_X_Assets_Buildを削除し、アセットにアセットCAS Access_Project_X_Assets_Releaseを追加します。

11.8.4.3.5 リタイア・スケジュールの決定ステージのソリューション

1. アセット・エディタで、アセットのステータスを「アクティブ」から「非アクティブ」に変更します。

11.8.4.3.6 リタイア・ステージのソリューション

1. アセット・エディタで、アセットのステータスを「非アクティブ」から「リタイア」に変更します。

11.8.4.4 アセット・ライフサイクル管理ソリューションの検証テスト

該当する各ロールについて次の条件を確認してください。

- ロール

- Project_X_Producer

- アクセス

- アセット・ライフサイクル全体を通してレジストラの権限を持ちます。

- Oracle Enterprise Repository内のアセットを表示できます。

- 使用/ダウンロード・ボタンおよび「編集」ボタンが表示されます。

- アセット・エディタでアセットの受入れ、タブの承認、アセットの登録およびアクセス設定の編集を行うことができます。

- リタイア・フェーズでは、リポジトリのアセット・リスト(検索結果)にアセットが表示されなくなります。アセットが別のアセットに関連しており、リレーションシップ・リンクを使用できる場合にのみ、このロールに対してそのアセットへのリポジトリ・アクセスが許可されます。ただし、アセット・エディタではそのアセットに引き続きアクセスできます。

- ロール

- Project_X_Subject_Matter_Expert

- アクセス

- 要件収集フェーズ:

- アセットの表示、レビューの発行およびアセットのサブスクライブ(「サブスクライブ」ボタンを使用)を行うことができます。

- アセットのフォーラムにアクセスし、コメントを投稿できます。

- 設計および開発フェーズ:

- アセットの表示、レビューの発行およびアセットのサブスクライブ(「サブスクライブ」ボタンを使用)を行うことができます。

- アセットのフォーラムにアクセスし、コメントを投稿できます。

- ベータ・リリース・フェーズ:

- アセットの表示、レビューの発行およびアセットのサブスクライブ(「サブスクライブ」ボタンを使用)を行うことができます。

- アセットをダウンロードできます(使用/ダウンロード・ボタンを使用)。

- アセットのフォーラムにアクセスし、コメントを投稿できます。

- リリース・フェーズ:

- アセットの表示、レビューの発行およびアセットのサブスクライブ(「サブスクライブ」ボタンを使用)を行うことができます。

- アセットをダウンロードできます(使用/ダウンロード・ボタンを使用)。

- アセットのフォーラムにアクセスし、コメントを投稿できます。

- リタイア・スケジュールの決定フェーズ:

- アセットの表示、レビューの発行およびアセットのサブスクライブ(「サブスクライブ」ボタンを使用)を行うことができます。

- アセットのフォーラムにアクセスし、コメントを投稿できます。

- リタイア・フェーズでは、リポジトリのアセット・リスト(検索結果)にアセットが表示されなくなります。アセットが別のアセットに関連しており、リレーションシップ・リンクを使用できる場合にのみ、そのアセットへのリポジトリ・アクセスが許可されます。そのアセットに対する機能/権限は、リタイア・スケジュールの決定フェーズに示したものと同じです。

- ロール

- User_Community

- アクセス

- 要件収集フェーズ:

- アセットにはアクセスできません。

- 設計および開発フェーズ:

- アセットの表示、レビューの発行およびアセットのサブスクライブ(「サブスクライブ」ボタンを使用)を行うことができます。

- アセットのフォーラムにアクセスし、コメントを投稿できます。

- ベータ・リリース・フェーズ:

- アセットの表示、レビューの発行およびアセットのサブスクライブ(「サブスクライブ」ボタンを使用)を行うことができます。

- アセットのフォーラムにアクセスし、コメントを投稿できます。

- リリース・フェーズ:

- アセットの表示、レビューの発行およびアセットのサブスクライブ(「サブスクライブ」ボタンを使用)を行うことができます。

- アセットをダウンロードできます(使用/ダウンロード・ボタンを使用)。

- アセットのフォーラムにアクセスし、コメントを投稿できます。

- リタイア・スケジュールの決定フェーズ:

- アセットの表示、レビューの発行およびアセットのサブスクライブ(「サブスクライブ」ボタンを使用)を行うことができます。

- アセットをダウンロードできます(使用/ダウンロード・ボタンを使用)。

- アセットのフォーラムにアクセスし、コメントを投稿できます。

- リタイア・フェーズでは、リポジトリのアセット・リスト(検索結果)にアセットが表示されなくなります。アセットが別のアセットに関連しており、リレーションシップ・リンクを使用できる場合にのみ、そのアセットへのリポジトリ・アクセスが許可されます。そのアセットに対する機能/権限は、リタイア・スケジュールの決定フェーズに示したものと同じです。

11.8.5 ユースケース5: ソース・コード・ファイルへのアクセスのアセット作成チームのみへの制限

このユースケースは、ユースケース#1 (Webサービス)とある程度似ています。そのユースケースでは、社内公開および外部公開のアセット・メタデータの表示や使用可否を管理できるように、各Webサービス・アセットに対して2つの異なるアセット・タイプを使用しました。ユースケース#5でもアセット・メタデータおよびファイルへのアクセスを制限しますが、使用するアセット・タイプは1つのみです。

この項には次のトピックが含まれます:

- 11.8.5.1項「利点」

- 11.8.5.2項「概要」

- 11.8.5.3項「ソリューション」

11.8.5.1 利点

このシナリオで説明する設定を使用すると、特定のユーザー/ロールのアクセス権限をコンパイル済コードを含むアセットに制限して、ブラック・ボックス再利用を促進できます。このようなブラック・ボックス・アセットは、ソース・コードを変更することなく、そのまま使用できます。ブラック・ボックス・アセットは、プロジェクトで使用すると一般にメンテナンスの手間を大幅に削減できることから、非常に価値の高いアセットです。

11.8.5.2 概要

このシナリオでは、特定のアセット・コンシューマ・ロール内の開発者にはコンパイル済コードへのアクセスのみを許可し、アセットの作成およびメンテナンスの担当者にはソース・コードとコンパイル済コードの両方へのアクセスを許可します。

11.8.5.3 ソリューション

この説では、次の使用例について説明します。

11.8.5.3.1 ロールの作成

1. Oracle Enterprise Repositoryのメニュー・バーの「管理」リンクをクリックします。

2. 「管理」画面で、「ロール」をクリックします。

3. 「新規作成」をクリックします。

4. 次のロールを作成します。

- Production Team

- Maintenance Team

- Consumer

11.8.5.3.2 カスタム・アクセス設定の作成

1. Oracle Enterprise Repositoryのメニュー・バーの「管理」リンクをクリックします。

2. 「管理」画面で、「カスタム・アクセス設定」をクリックします。

3. 「新規作成」をクリックします。

4. 次のカスタム・アクセス設定を作成します。

- Access_Domain_X_Compiled_Code_Files

- コンパイル済コード・ファイルの参照を許可するユーザー用です。

- Access_Domain_X_Source_Code_Files

- ソース・コード・ファイルの参照を許可するユーザー用です。

5. 対象のアセットからCAS Basic_Default_Filesを削除します(ここでは、デフォルトのファイルCASが設定されているものと仮定しています)。図11-52を参照してください。

図11-52 「編集」ダイアログ

6. 図11-53に示すように、すべてのコンパイル済コード・ファイルに対してCAS Access_Domain_X_Compiled_Code_Filesを割り当てます。

図11-53 「編集」ダイアログ

7. すべてのソース・コード・ファイルに対してCAS Access_Domain_X_Source_Code_Filesを割り当てます。

図11-54、図11-55、図11-56、図11-57、図11-58および図11-59に、Production Team、Maintenance TeamおよびConsumerの各ロールおよびそれぞれに対応するCAS設定を示します。

- Production_Team (作成担当のすべてのユーザー): ロール

図11-54 ユーザー: Production_Team

- Maintenance_Team (メンテナンス担当のすべてのユーザー): ロール

図11-55 ユーザー: Maintenance_Team

- Consumer (すべてのコンシューマ): ロール

図11-56 ユーザー: Consumer

- Access_Domain_X_Compiled_Code_Files

図11-57 カスタム・アクセス設定

- Access_Domain_X_Source_Code_Files

図11-58 カスタム・アクセス設定

11.8.5.3.3 結果

Production Team、Maintenance TeamおよびConsumerのユーザーがOracle Enterprise Repository内のアセットを表示するときには、図11-59に示すように、同じメタデータ情報が表示されます。

図11-59 アセット: サンプル・コンポーネント

Production TeamとMaintenance Teamのユーザーがアセットをダウンロードするときには、図11-60に示すように、コンパイル済コード・ファイルとソース・コード・ファイルの両方が表示されます。

図11-60 使用/抽出ダイアログ

Consumerがアセットをダウンロードするときには、図11-61に示すように、コンパイル済コード・ファイルのみが表示されます。

図11-61 使用/抽出ダイアログ

11.8.5.3.4 検証テスト

各ロールについて次の条件を検証してください。

- Production_TeamおよびMaintenance_Team:

- 使用/ダウンロード・ボタンをクリックすると、ソース・コード・ファイルとコンパイル済コード・ファイルの両方が表示されます。

- Oracle Enterprise Repository内のアセットを表示したときに「編集」ボタンが表示されます。

- Consumer

- 使用/ダウンロード・ボタンをクリックすると、コンパイル済コード・ファイルのみが表示されます。

- Consumerがコンパイル済コードにしかアクセスできない場合、そのアセットには「編集」ボタンは表示されません。Consumerがソース・コードを含むアセットの編集権限を持っている場合、アセット・エディタでConsumerにソース・コード・ファイルが表示されます。

11.8.6 ユースケース6: 特定のグループへのブラウザ限定リポジトリ・アクセスの付与

この項では、特定のグループにブラウザ限定リポジトリ・アクセスを付与する方法を例示するユースケースについて説明します。この項には次のトピックが含まれます:

- 11.8.6.1項「利点」

- 11.8.6.2項「概要」

- 11.8.6.3項「ソリューション」

- 11.8.6.4項「検証テスト」

11.8.6.1 利点

このシナリオで説明する設定を使用すると、全員にブラウザ限定リポジトリ・アクセスを提供して、組織内でのリポジトリのロールアウトを制御できます。これは、大規模な開発者チームのグループに対してリポジトリの使用をプロモートする場合に役立ちます。アクセス管理者は、組織のポリシーに従って、必要に応じて追加のアクセス権限を適切なロールに割り当てることができます。

11.8.6.2 概要

このシナリオでは、すべてのリポジトリ・ユーザーにブラウザ限定アクセスが自動的に割り当てられます。ユーザーはLDAPに対して認証され、組織によって割り当てられた標準のログイン・ユーザー名およびパスワードを使用してリポジトリにアクセスするものと想定されます。これらのユーザーが追加の機能を必要とすることを決定した場合は、リポジトリ管理者が追加のロールを割り当てることができます。

11.8.6.3 ソリューション

この項では、このユースケースのソリューションについて説明します。

1. 次のロールを作成します。

- user - browse only

2. 図11-62に示すように、このロールが新規ユーザーに自動的に割り当てられるようにします。

図11-62 ロールの編集: user-browse only

3. 図11-63に示すように、ユーザー・ロールを編集して、新規ユーザーに自動的に割り当てられないようにします。

図11-63 ロールの編集: user

4. CAS Basic_Default_Assetsを編集します。

図11-64 カスタム・アクセス設定の編集: Basic_Default_Assets

- 使用可能なすべてのロールを表示するオプションをクリックして、使用可能なロールの完全なリストを表示します。

- 該当するチェック・ボックスを選択して、「user - browse only」に表示アクセスを割り当てます。

- CASを保存します。

11.8.6.4 検証テスト

システムに新規ユーザーを追加します。

- 新規ユーザーにブラウザ限定権限が割り当てられていることを確認します。

- すべてのアセットを表示し、サブスクライブできます。

- My Stuffにアクセスできます。

- アセットを発行できません。

- アセットをダウンロードできません。

- アセットをレビューできません。

12 パスワードの暗号化

この章では、パスワードを暗号化する方法について説明します。

Oracle Enterprise Repositoryでは、パスワードの暗号化はデフォルトで有効になっていますが、JVM起動パラメータcmee.passwordencryption=falseを使用してパスワードの暗号化を無効にすることができます。

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

- 12.1項「暗号化されたパスワードの生成」

- 12.2項「構成ファイルのパスワードの暗号化」

12.1 暗号化されたパスワードの生成

Oracle Enterprise Repositoryの「診断」ページの使用とパスワード暗号化ツールの使用という2つの異なる方法を使用して、パスワードを暗号化できます。暗号化されたパスワードを生成するには、次の手順を実行する必要があります。

1. Oracle Enterprise Repositoryの「診断」ページにアクセスします。
http://host_name:port/application_name/diag/index.jspに移動します(host_nameは適切な場所に置き換えます)。

注意:
Oracle Enterprise Repository 12cリリースでは、Oracle Enterprise Repositoryの「診断」ページはデフォルトで無効になっています。
「診断」ページが現在無効かどうかを確認するには、http://host_name:port/application_name/diag/index.jspに移動します(host_nameは適切な場所に置き換えます)。「診断」ページが無効な場合は、次のメッセージが表示されます。

診断ページは現在無効です。Oracle Enterprise Repositoryに問い合せてください。

「診断」ページの有効化の詳細は、1.9項「Oracle Enterprise Repositoryの「診断」ページへのアクセス」を参照してください。

2. 「ツール」セクションにスクロールして、パスワードの文字列の暗号化リンクをクリックし、パスワードの暗号化ページを表示します。

3. クリア・テキストのパスワードを暗号化する文字列テキスト・ボックスに入力します。

4. 「問合せの発行」ボタンをクリックします。

5. 暗号化されたパスワード文字列をコピーして、適切なコンテキスト・ファイルまたはプロパティ・ファイルに貼り付けます。

パスワード暗号化ツールは、<FMW_HOME>/oer/modules/tools/solutions/12.1.3.0.0-OER-PasswordTools.zipにあります。12.1.3.0.0-OER-PasswordTools.zipファイルには、次の2つのスクリプトがあります(Windows用とUNIX用)。

- encrypt.bat/encrypt.sh - xml構成ファイルのパスワード要素の暗号化

- encryptpassword.bat/encryptpassword.sh - コマンド行からの単一のパスワードの暗号化

この項には次のトピックも含まれます。

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

- 12.1.2項「その他のパスワード」

12.1.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.xml)ファイル内
workflow.xmlファイル内に格納されるパスワード。

- APIカタログへのエクスポート構成ファイル内
oac.xmlファイル内に格納されるパスワード。

12.1.2 その他のパスワード

システムのその他のパスワードは、自動的に暗号化されます。この操作はユーザーには表示されません。次に示すような、プロパティ・ファイルに格納される多くのフィールドは、デフォルトで暗号化されます。

- ldap.bindPassword

- enterprise.guest.password

この暗号化は、プロパティが編集されて保存されるときに行われます。アップグレード時のパスワードの自動暗号化は、現時点では使用できません。

アーティファクト・ストアとともに格納されるパスワードは、暗号化された形式でデータベースに格納されます。

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

セキュリティを確実にするために、構成ファイル内のパスワードを暗号化する必要があります。次の構成ファイルのパスワードを暗号化する必要があります。

- 12.2.1項「ハーベスタ構成ファイル」

- 12.2.2項「Exchange Utility構成ファイル」

- 12.2.3項「ワークフロー構成ファイル」

- 第12.2.4項「APIカタログへのエクスポート構成ファイル」

12.2.1 ハーベスタ構成ファイル

セキュリティを確実にするために、ハーベスタ構成内のパスワードを暗号化する必要があります。oer/modules/tools/solutions/12.1.3.0.0-OER-PasswordTools.zipにあるパスワード暗号化ツール(encrypt.bat/encrypt.sh)を使用すると、ハーベスタ構成(HarvesterSettings.xml)ファイルに格納されるパスワードを暗号化できます。

1. <Harvester Home>ディレクトリに移動します。

2. 次のように、コマンド・プロンプトからパスワード暗号化ツールを実行します。
> encrypt.bat HarvesterSettings.xml HarvesterSettings.xml

説明:

HarvesterSettings.xml = ハーベスタ構成ファイル。

12.2.2 Exchange Utility構成ファイル

セキュリティの強化のために、Exchange Utilityキットとともにパッケージ化されたパスワード暗号化ツール(encrypt.bat/encrypt.sh)がインストール・ディレクトリ内にあり、Oracle Registry Repository Exchange Utility構成(orrxu.xml)ファイルに格納されるパスワードを暗号化できます。

1. <ExchangeUtility Tool Home>ディレクトリに移動します。

2. 図12-1に示すように、コマンド・プロンプトから次のようにパスワード暗号化ツールを実行します。

> encrypt.bat orrxu.xml orrxu.xml

説明:

orrxu.xml = Oracle Registry Repository Exchange Utility構成ファイル

図12-1 パスワード暗号化ツール

図12-2のサンプル・イメージは、暗号化前にパスワード・フィールドがどのように表示されるを示しています。

図12-2 暗号化前のパスワードのサンプル・イメージ

図12-3のサンプル・イメージは、パスワード暗号化ツールを実行した後にパスワード・フィールドがどのように表示されるかを示しています。

図12-3 暗号化後のパスワードのサンプル・イメージ

12.2.3 ワークフロー構成ファイル

セキュリティの強化のために、12.1.3.0.0-OER-PasswordTools.zipファイルにあるパスワード暗号化ツール(encrypt.bat/encrypt.sh)を使用して、ワークフロー構成(workflow.xml)ファイルに格納されるパスワードを暗号化できます。

1. ORACLE_HOME/oer/modules/tools/solutionsディレクトリに移動します。

2. 12.1.3.0.0-OER-PasswordTools.zipファイルをディレクトリに解凍し、コマンド・プロンプトを開いてこのディレクトリの場所に移動します。

3. 次のように、コマンド・プロンプトからパスワード暗号化ツールを実行します。

> encrypt.bat workflow.xml workflow.xml

説明:

workflow.xml = ワークフロー構成ファイル

12.2.4 APIカタログへのエクスポート構成ファイル

セキュリティを確保するため、APIカタログへのエクスポート構成ファイル(oac.xml)内のパスワードは暗号化する必要があります。oer/modules/tools/solutions/12.1.3.0.0-OER-PasswordTools.zipにあるパスワード暗号化ツール(encrypt.bat/encrypt.sh)を使用すると、APIカタログへのエクスポート構成ファイル(oac.xml)に格納されるパスワードを暗号化できます。

1. ORACLE_HOME/oer/modules/tools/solutionsディレクトリに移動します。

2. 12.1.3.0.0-OER-PasswordTools.zipファイルをディレクトリに解凍し、コマンド・プロンプトを開いてこのディレクトリの場所に移動します。

3. 次のように、コマンド・プロンプトからパスワード暗号化ツールを実行します。
> encrypt.bat <Middleware_Home>/user_projects/domains/<oer_domain>/config_oer/oac.xml <Middleware_Home>/user_projects/domains/<oer_domain>/config_oer/oac.xml

説明:

oac.xml = APIカタログへのエクスポート構成ファイル

<Middleware_Home> = OERがインストールされる「ミドルウェア・ホーム」ディレクトリ

<oer_domain> = OERドメイン・ホーム・ディレクトリ。

第IV部

高度なライフサイクル管理

この部では、Oracle Enterprise Repositoryのライフサイクルの高度な管理タスクについて説明します。

この部は、次の章で構成されています。

- 第13章「Oracle Enterprise Repositoryエクスプレス・ワークフローの構成」

- 第14章「プリスクリプティブな再利用の構成」

- 第15章「コード・コンプライアンス・インスペクタとの統合」

- 第16章「ポリシー管理の構成」

- 第17章「Enterprise Manager統合ユーティリティ」

- 第18章「メトリックの構成」

- 第19章「進行中のアセットの構成」

- 第20章「契約管理の構成」

- 第21章「Oracle Service Registryとの間でメタデータを交換するためのOracle Enterprise Repositoryの構成」

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

この章では、Oracle Enterprise Repository (OER)エクスプレス・ワークフローを設定および構成する方法について説明します。

この章の内容は、次の概念をよく理解していることを前提としています。

- アセットとアセット・タイプ、アセット発行、アセット登録ステータス、アセット・カテゴリ分け。詳細は、『Oracle Fusion Middleware Oracle Enterprise Repositoryコンセプト・ガイド』を参照してください。

- プロジェクトおよびユーザー。詳細は、第1章「基本構成」を参照してください。

- Oracle SOA Suiteアプリケーションのデプロイメント。詳細は、Oracle Fusion Middleware Oracle SOA Suite開発者ガイドを参照してください。

注意:
Oracle BPM Suiteの使用制限付きライセンスがOERに含まれています。このライセンスにより、OERで提供される既存のワークフローを変更できます。このライセンスを使用すると、新しいOER中心のワークフローを作成することもできます。OERを含まないワークフローを作成する場合、Oracle BPM Suiteの完全なライセンスを入手してください。

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

- 13.1項「Oracle Enterprise Repositoryエクスプレス・ワークフローの概要」

- 13.2項「エクスプレス・ワークフローの構成」

- 13.3項「サンプル・ワークフローの実行」

- 13.4項「サンプル・ワークフローの変更」

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

この項で説明するエクスプレス・ワークフローを使用するには、Oracle SOA SuiteおよびOracle BPM Suite (どちらもバージョン11.1.1.7以上)が必要です。

注意:
エクスプレス・ワークフローSCAがデプロイされるSOA Suiteは独自の管理対象サーバーに配置することをお薦めします。エクスプレス・ワークフローは、SOA Suiteを管理サーバーにデプロイするSOA Suite Developer Editionでは正しく機能しない可能性があります。

Oracle Enterprise Repositoryのエクスプレス・ワークフローは、共通のアセット・ライフサイクル承認プロセスを自動化するためのメカニズムです。OERには、アセットを初期状態から最終状態まで移行するための一連の機能およびオプションが用意されています。エクスプレス・ワークフローでは、OERアセット・エディタによって提供される次のアクションの組合せを組み込むために、アセット承認プロセスを必要とします。

- アセット発行

- アセット受入れ

- アセット・タブの承認

- アセット登録

カテゴリ分けAssetLifeCycleStageおよびClassificationの値の変更も必要です。

より複雑なワークフロー自動化を必要とする組織は、他のツール(Oracle Business Process Management Suiteなど)を使用して外部ワークフローを開発し、REX APIインタフェース(『Oracle Fusion Middleware Oracle Enterprise Repository開発者ガイド』のRepository Extensibility Frameworkの使用に関する項を参照)を使用してOER機能にアクセスすることもできます。

エクスプレス・ワークフローのコンポーネントは次のとおりです。

- アセット

- プロジェクト

- ユーザー

- 承認フロー

- イベントおよびアクション

これらのコンポーネントは、エクスプレス・ワークフローによって次のように関連付けられています。

- アセットは作成するプロジェクトとともにリポジトリに発行されます。エクスプレス・ワークフローでは、アセットが持つ作成するプロジェクトは1つのみであることが必要です。

- 指定された作成するプロジェクトに承認フローが割り当てられており、その承認フローに対してアセット・タイプが指定されている場合、アセットはその発行時または受入れ時に自動的にフローに入ります。プロジェクトには1つの承認フローを割り当てることができ、そのフローは該当するプロジェクト内の関連アセットが発行されるか、受け入れられた場合にのみ開始されます。

- 承認フローは、アセット・タブのグループ、つまり層で構成されます。層ごとに担当承認者がいます。担当承認者が層内のすべてのタブを承認した場合、アセットは次の層に移ります。

承認フローの設定により次のことが決定されます。

- フローをアセット発行時またはアセット受入れ時に開始するかどうか。

- 指定したタブが承認されたときにアセットを自動的に登録するかどうか。

OER管理者は任意の数の承認フローを作成でき、1つの承認フローを任意の数のプロジェクトに割り当てることができます。アセットは、アセットが登録されたときにカスタム・アクセス設定を適用したり、アセット・ライフサイクル・ステージのカテゴリ分けの値が変更されたときにサブスクライバに通知するなど、個別のイベントに特定のアクションをマップすることによって操作します。

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

エクスプレス・ワークフローは次のコンポーネントに依存します。

- エクスプレス・ワークフローSOAコンポジット・アプリケーション(SCA)

- OER Event Manager

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

エクスプレス・ワークフローを構成するには、次の手順を実行します。

1. OER Express Workflow SOAコンポジット・アプリケーション(SCA)をインストールします。

2. デプロイしたSCAにイベントを配信するようにOER Event Managerを構成します。

3. エクスプレス・ワークフローを定義および構成します。

この項では、Oracle Enterprise RepositoryワークフローをOracle BPM 11gおよび12cにインストールする方法について説明します。内容は次のとおりです。

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

- 13.2.2項「手順2: デプロイしたSCAにイベントを配信するためのOER Event Managerの構成」

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

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

エクスプレス・ワークフローSOAコンポジット・アプリケーションでは、OER Event ManagerからWebサービス・エンドポイントに配信されるイベントをリスニングします。このアプリケーションをインストールするには、インストール済のOracle SOA SuiteおよびOracle BPM Suiteインスタンス(どちらもバージョン11.1.1.7以上)が必要です。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のzipファイルに含まれているコンポジットをアップロードします。

1. <FMW_Home>/oer/modules/tools/solutions/ディレクトリに移動します。

2. 12.1.3.0.0-ExpressWorkflows.zipファイルを展開します。

3. sca_OERWorkflows_rev1.0.jarファイルを選択します。

9. 「次」をクリックします。

10. デフォルトのSOAパーティションを選択します。「次」をクリックします。

11. 「デプロイ」をクリックします。

13.2.2 手順2: デプロイしたSCAにイベントを配信するためのOER Event Managerの構成

Event Managerは、イベント・サブスクリプション、イベント永続性、イベント・フィルタ処理およびイベント配信の管理用としてOracle Enterprise Repository内に組み込まれているコンポーネントです。

外部アプリケーションは、アセットのライフサイクル内を移動するときに生成されるイベントをサブスクライブします。エクスプレス・ワークフローにおいてOracle SOA Suiteサーバー・インスタンスにデプロイされたSOAコンポジット・アプリケーションは、OER構成ファイルに定義されているWebサービス・エンドポイントを介してこれらのイベントにアクセスします。

エクスプレス・ワークフローでは次のイベントがサポートされています。

- アセット発行

- アセット未発行

- アセット受入れ

- アセット受入れ不可

- アセット・タブの承認: 値=<tab name>

- すべてのアセット・タブの承認

- アセット登録

- アセット未登録

- アセット・ステータスの変更: 値="DELETED/INACTIVE/RETIRED"

- ポリシー・アサーションの変更: 値="pass/fail"

- カテゴリ分けの変更: AssetLifecycleStage (すべての変更に影響を与える)

- カテゴリ分けの変更: AssetLifecycleStage: 値="stage name"

- カテゴリ分けの変更: Classification (すべての変更に影響を与える)

- カテゴリ分けの変更: Classification: 値="stage name"

13.2.2.1 Webサービス・エンドポイントの構成

Event Managerは、構成ファイルを使用して、イベントが配信されるWebサービス・エンドポイントに関する情報をロードします。このファイルは、<FMW_HOME>oer/modules/tools/solutionsにあるExpressWorkflows.zipファイルに含まれています。ExpressWorkflows.zipからEndPointEventSubscription.xmlファイルを抽出し、適宜変更した後で<FMW_HOME>/oer/applications/oer/oer-app/WEB-INF/classesディレクトリに貼り付ける必要があります。

このファイルで、イベントを受け取るSCAエンドポイントを追加するには、次の例に示すように、<sub:eventSubscription>要素の新規インスタンスを作成します。

<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="SOACompositeEndpoint">

<!--The host of the SOA Server hosting the composite -->
<sub:host>localhost</sub:host>
<!--The SOA Server listener port -->
<sub:port>9000</sub:port>
<!--The URI of the deployed composite -->
<sub:uri>soa-infra/services/default/OERWorkflows/HandleStatusChange.service</sub:uri>
<!--Unless a custom WSDL Contract is used, the namespace 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\eventNotifier.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 SOA Suite server.  Use HTTPS if SSL-enabled  -->
<sub:protocol>HTTP</sub:protocol>
<!--The user and password to authenticate the composite deployed on the SOA Suite server. -->
<sub:authenticationData>
<sub:basicAuthentication>
<sub:username>oer_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>

このファイルで、上の例に示すように、エクスプレス・ワークフローSOAコンポジット・エンドポイントのホスト、ポート、ユーザー名およびパスワードを手動で構成する必要があります。上の例は、<FMW_HOME>oer/modules/tools/solutionsディレクトリにある12.1.3.0.0-ExpressWorkflows.zipファイル内のEndPointEventSubscription.xmlから引用したものです。

注意:
パスワードは、OERに付属の2つの暗号化ツールのいずれかを使用して暗号化する必要があります。第12章「パスワードの暗号化」を参照してください。

このファイルに対する変更を有効にするには、OER管理対象サーバーを停止してから再起動する必要があります。この作業は、次にEvent Managerを有効にした後で行います。Event Managerがすでに有効になっている場合は、OERを今すぐ再起動できます。

13.2.2.2 Event Managerの有効化

Event Managerの構成が完了したら、Oracle Enterprise RepositoryでEvent Managerを有効にして、外部Webサービス・エンドポイントにイベントが送信されるようにする必要があります。

1. Oracle Enterprise Repositoryの「管理」画面のサイドバーにある「システム設定」をクリックします。

2. システム設定検索にeventと入力して、Event Managerに関連するすべての設定を表示します。

3. Event Managerの有効化プロパティcmee.eventframework.enabledの横にある「True」をクリックします。

4. 「保存」をクリックします。

5. Oracle Enterprise Repositoryを再起動して構成の変更を有効にします。

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

エクスプレス・ワークフローのコンポーネントとそのリレーションシップはXMLファイルで定義および構成されており、OERイベントがエクスプレス・ワークフローSOAコンポジット・アプリケーションのWebサービス・エンドポイントに配信されるたびに、そのアプリケーションによって読み取られます。

このファイル(およびそのXSD)のサンプル・バージョンが、構成手順の完了時に実行されるよう事前定義されたサンプル・ワークフローに付属しています。このサンプル・ファイルは<FMW_HOME>/oer/modules/tools/solutions/12.1.3.0.0-ExpressWorkflows.zipにあります。

このXMLの各種要素の詳細は、13.4項「サンプル・ワークフローの変更」を参照してください。

構成ファイルの設定およびサンプル・ワークフローの有効化

1. アセット・エディタの起動、アセットの編集およびタブの承認に必要な各権限を持つ新規OERユーザーを作成します。ユーザー、ロールおよび基本アクセス設定の詳細は、第1章「基本構成」を参照してください。

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. Tier2の承認者として新規OERユーザーのユーザー名を入力します。

<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. 第12章「パスワードの暗号化」の説明に従って、ファイル内のパスワードを暗号化します。

6. ファイルを保存します。

7. OERサーバーが稼働中であることを確認してから、<FMW_Home>/oer/modules/tools/solutions/12.1.3.0.0-ExpressWorkflows.zipに含まれているエクスプレス・ワークフロー検証スクリプトを実行してexpressWorkflow.xmlファイルをチェックします。
validateWorkflow.sh -settings [your expressWorkflow.xml file]

8. 次に示すように、Oracle SOA Suiteドメイン内にoerconfigという新規フォルダを作成します。
<FMW_Home>\user_projects\domains\<SOAdomain>\oerconfig

9. 検証後のファイルをExpressWorkflow.xmlという名前でoerconfigフォルダにコピーします。

これで、有効にしたサンプルを使用するエクスプレス・ワークフローの設定および構成が終了しました。13.3項に進み、サンプルを実行することができます。

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

OERおよびSOAサーバーが稼働している状態で、「サービス」タイプの新規アセットをリポジトリに作成します。

新規アセットの作成

1. adminユーザーまたはアセット作成権限を持つ任意のユーザーとしてOERにログインします。

2. アセット・エディタで、「ファイル」メニューから「新規」を選択します。

3. アセットの新規作成フィールドにアセット名を入力します。

4. タイプとして「サービス」、初期状態として未発行を選択します。

5. 「OK」をクリックします。新規アセット・タブが表示されます。

6. 「概要」タブで、作成するプロジェクトの共通プロジェクトを選択します。「保存」をクリックします。

サンプルの実行

1. 管理ユーザーとしてOERにログインします。

2. My Stuffに移動し、新規に作成および発行したアセットがキューに含まれていることを確認します。

3. アセット・エディタを開き、「概要」、「技術的」および「ドキュメント」の各タブを承認します。アセット・エディタを終了します。

4. OERからログアウトし、再びログインします。

5. My Stuffに移動し、サービス・アセットを検索および編集して分類タブを承認します。アセット・エディタを終了します。

6. OERコンソールで、登録ステータスが「登録済」に設定されたサービス・アセットを名前で検索します。

検索結果にアセットが表示されます。

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

サンプル・ワークフローを正常に実行できた場合、次の手順に従ってそのワークフローを変更したり、新規ワークフローを作成できます。

1. インストール済のExpressWorkflow.xmlを新しい場所にコピーし、それを編集して新規プロジェクト、ユーザー、アセット・タイプ、イベントとアクションのマッピングおよび承認フローを追加します。

2. 検証スクリプトを実行して、変更した内容が稼働中のOERインスタンスと互換性があるかどうかを確認します。

3. インストール済のExpressWorkflow.xmlファイルを新規バージョンに置き換えます。

注意:
OER Event Managerからエクスプレス・ワークフローSOAコンポジットにイベントが配信されるたびに、インストール済のファイルが読み取られるため、新規にインストールしたExpressWorkflow.xmlバージョン内の変更は再起動しなくても即座に有効になります。

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

これまでに、次のことを目的としてExpressWorkflow.xmlファイルを変更しました。

- 使用するOERサーバー・インスタンスを指定します。

- OER管理ユーザーの暗号化済のパスワードを提供します。

- 承認フローFlow1のアセット・タブの第2層を担当する承認者名を変更します。

13.4.1.1 作成するプロジェクト

次に、作成するプロジェクト「共通プロジェクト」のデフォルトのExpressWorkflow.xmlファイルからの抜粋を示します。

<producingProject name="Common Project" approvalFlow="Flow1"/>
<assetTypes>
<assetType name="Business Process"/>
<assetType name="Composite"/>
<assetType name="Service"/>
</assetTypes>
</producingProject>

- nameは、既存のOERプロジェクトを表します。指定したプロジェクトがOERインスタンスに存在しない場合は、検証スクリプトによりエラーが生成されます。

- approvalFlowは、このプロジェクト内に作成されたアセットを対象として、階層化されたタブの承認フロー(つまり、ガバナンス・フロー)を指定するオプション属性です。作成するプロジェクトにはapprovalFlowを1つ割り当てるか、何も割り当てないかのいずれかです。

- assetTypeは、既存のタイプを表します。作成するプロジェクト内で発行された特定タイプのアセットは、プロジェクトに指定されたapprovalFlowおよびそのアセット・タイプに指定されたイベントとアクションのマッピングに必ず従います。

注意:
アセットに対してExpressWorkflow.xmlファイルで作成するプロジェクトが1つのみ指定されている場合にかぎり、エクスプレス・ワークフローでアセットを管理できます。

13.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>

- approvalFlow nameは、フロー名を表し、producingProjectのapprovalFlow属性で使用されます。この属性はexpressWorkflow.xmlファイル以外では使用されません。

- acceptOnAssetSubmissionは、指定したアセットがその発行時に自動的に受け入れられるようにするか(値="true")、または十分なアクセス権限を持つOERユーザーが手動で受け入れるようにするか(値="false")を決めるオプション属性です。この属性を指定しなかった場合、デフォルト値として"false"が使用されます。

- registerOnFlowCompletionは、承認フローに指定されたすべてのタブが承認されたときに、指定したアセットが自動的に登録されるようにする(value="true")かどうかを決めるオプション属性です。この属性を指定しなかった場合、デフォルト値として"false"が使用されます。

- <tier>要素内のtier nameは、アセット・タブの組合せを表します。

- <tier>要素内のapproverは、最初に指定した層でアセットが受け入れられるか、前の層のすべてのタブが承認されるかのいずれかの時点でアセットが割り当てられる既存のOERユーザーを表します。

- <tier>要素内のtab nameは、指定したアセット・タイプに存在する必要があり、特定の層内で承認される特定のアセット・タブを表します。

13.4.1.3 イベントとアクションのマッピング

イベントとアクションのマッピングは、アセットを自動的に受け入れて登録する場合に承認フローのかわりに使用できる方法です。これらのマッピングは指定したアセット・タイプにのみ適用されます。プロジェクト内の各種アセット・タイプにそれぞれ異なるマッピングを使用することも、同じマッピングを使用することもできます。

エクスプレス・ワークフローには、Event Managerによって生成される多数のアセット・ライフサイクル・イベントを認識し、これらのイベントを特定のアセットに対する特定のアクションに関連付けるためのメカニズムがあります。ExpressWorkflow.xmlファイルに必要な構文でサポートされているイベントとアクションの完全なリストについては後述しています。

次のサンプルproducingProject要素について考えます。

<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に承認フローは指定されていません。ただし、「サービス」タイプのアセットに対してイベントとアクションのマッピングが指定されています。1つ目のマッピングにより、「サービス」タイプのアセットはその発行時に自動的に受け入れられます。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に移動します。

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

この章では、コンプライアンス・テンプレートの概要と、プリスクリプティブな再利用でのその役割について説明します。

この章の内容は、次のとおりです。

- 14.1項「概要」

- 14.2項「コンプライアンス・テンプレート・タイプの作成」

- 14.3項「コンプライアンス・テンプレートの作成」

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

- 14.5項「コンプライアンス・テンプレートに関連付けられたアセット(規定されるアセット)の使用」

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

14.1 概要

Oracle Enterprise Repositoryは、プロジェクト評価に関わるステークホルダーとプロジェクトの実装に関わる開発者間の通信メカニズムとして機能します。ビジネス・アナリストまたは設計者は、プロジェクトの要件の確認を担当します。このプロセスで、プロジェクトの機能要件および非機能要件を満たす既存のサービスまたは機能が特定される場合があります。

Oracle Enterprise Repositoryを使用すると、これらのステークホルダーは、プロジェクトに関連する可能性がある既存のアセットのリストを含むコンプライアンス・テンプレートを作成できます。このプロセスはプリスクリプティブな再利用と呼ばれ、請負組織において非常に重要なものです。請負組織は、入札が顧客によって受け入れられる数か月前に、プロジェクトの具体化または入札を行う場合があります。コンプライアンス・テンプレートは、これらの組織が、プロジェクト入札の作成時に設定された想定を捕捉するための方法になります。入札が受け入れられると、作業を実行するチームは、再利用することが想定されたアセットを確認できます。

コンプライアンス・テンプレートという用語は、Oracle Enterprise Repositoryアーティファクトの特定のファミリを示します。具体的なコンプライアンス・テンプレート・タイプの例として、次のものがあります。

- プロジェクト・プロファイル

- アーキテクチャ設計図

コンプライアンス・テンプレートは、アセット要件セットまたはアセット・ソリューション・セットを内部またはアウトソーシングされたプロジェクト・チームに示すために使用されます。プロジェクト・プロファイルは、通常、個々のプロジェクトに対して作成されますが、アーキテクチャ設計図は複数のプロジェクトで使用できる再利用可能なソリューション・セットです。

コンプライアンス・テンプレートは、通常、アセットおよびプロジェクト・ポートフォリオを担当する個人またはチームによって生成されます。

- プロジェクトの計画担当者がポートフォリオの各プロジェクトのプロジェクト・プロファイルを作成し、計画および見積りの想定の概要を示す場合があります。

- プロジェクト設計者がプロジェクト・プロファイルを作成し、プロジェクトのビジネス要件を満たすアセットを特定する場合があります。

- 企業の設計者がアーキテクチャ設計図を作成し、これに新しいプロジェクトによって使用される標準のフレームワークおよびサーバーを指定する場合があります。

- サービス指向アーキテクチャの担当者がアーキテクチャ設計図を作成し、特定のビジネス機能を編成するサービスを判定する場合があります。

- 製品ラインの設計者がアーキテクチャ設計図を作成し、これに特定の製品ラインで使用するアセットを指定する場合があります。

以前の製品バージョンからアップグレードする場合、インポート/エクスポート・ツールを使用してポリシー管理データパック内の例をインストールすることによって、コンプライアンス・テンプレートの例を取得できます。インポート/エクスポート・ツールの詳細は、第5章「インポート・エクスポート・ツール」を参照してください。

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

この手順は、タイプ・マネージャで実行されます。タイプ・マネージャの実行の詳細は、第7章「タイプ・マネージャの使用」を参照してください。この例では、プロジェクト・プロファイルのコンプライアンス・テンプレート・タイプの作成を示します。

注意:
コンプライアンス・テンプレートを追加すると、Oracle Enterprise Repositoryシステムは永続的に変更されます。

データベースの整合性を維持するには、アセットが現在関連付けられていないコンプライアンス・テンプレートのみを削除できます。

タイプ・マネージャでコンプライアンス・テンプレート・タイプを使用できる場合:

1. 「ファイル」メニューで「新規」を選択します。図14-1に示すように、新しいタイプの作成ダイアログが表示されます。

図14-1 新しいタイプの作成ダイアログ

2. タイプ名テキスト・ボックスに適切な情報を入力します。

3. デフォルトのタイプ・リストで、リストからコンプライアンス・テンプレート・タイプを選択します。

4. 「OK」をクリックします。図14-2に示すように、新しいタイプがタイプ・マネージャのサイドバーのツリーに表示されます。

図14-2 タイプ・マネージャ

タイプ・マネージャでコンプライアンス・テンプレート・タイプを使用できない場合:

インポート/エクスポート・ツールを使用して、Oracle Enterprise Repositoryベース・データパックからコンプライアンス・テンプレートおよび例を取得できます。

別の方法が必要な場合に、新しいコンプライアンス・テンプレート・タイプを手動で生成する手順:

1. 「ファイル」メニューで「新規」を選択します。新しいタイプの作成ダイアログが表示されます。

2. タイプ名テキスト・ボックスに適切な情報を入力します。

3. デフォルトのタイプ・リストで、リストから任意のタイプを選択します。

4. 「OK」をクリックします。新しいタイプがタイプ・マネージャのサイドバーのツリーに表示されます。

5. タイプ・マネージャで新しいコンプライアンス・テンプレート・タイプを開きます。

6. 新しいコンプライアンス・テンプレート・タイプのエディタ・タブをクリックします。

7. 図14-3に示すように、エディタ・タブの「一般」セクションのアーキタイプ・リストでコンプライアンス・テンプレート・タイプを選択します。

図14-3 エディタ・タブ

8. 「ファイル」メニューで「保存」をクリックします。

9. 図14-4に示すように、タブ・セクションにリストされるタブのいずれかを選択します。

図14-4 タブ・セクション

そのタブに割り当てられている要素が「要素」セクションのリストに表示されます。

10. 「要素」セクションの「追加」ボタンをクリックします。図14-5に示すように、追加する要素タイプの選択ダイアログが表示されます。

図14-5 追加する要素タイプの選択ダイアログ

11. 追加する要素タイプの選択ダイアログのリストからテンプレートの適用先プロジェクトを選択します。

12. 「OK」をクリックします。追加する要素タイプの選択が閉じます。

13. 図14-6に示すように、プロンプトに従って新しい要素のラベルを入力します。

図14-6 テンプレートの適用先プロジェクトの編集ダイアログ

14. 「OK」をクリックします。新しい要素が「要素」セクションのリストに表示されます。

15. 「ファイル」メニューで「保存」をクリックします。

16. 新しいコンプライアンス・テンプレート・タイプの「ビューア」タブをクリックします。

17. 図14-7に示すように、非表示要素のリストで新しい要素を見つけて選択します。

図14-7 非表示要素セクション

18. グループでの表示ボタンをクリックします。図14-8に示すように、要素の移動ダイアログが表示されます。

図14-8 要素の移動ダイアログ

19. 要素の移動ダイアログのリストを使用して、新しい要素の場所を選択します。

20. 「OK」をクリックします。新しい要素が「ビューア」タブの「要素」セクションのリストに表示されます。

図14-9 「要素」セクション

21. 「ファイル」メニューで「保存」をクリックします。

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

この手順は、アセット・エディタで実行し、9.4項「高度なアセット発行」で説明されている高度なアセット発行に非常に似ています。

1. 「ファイル」メニューで「新規」を選択します。図14-10に示すように、アセットの新規作成ダイアログが表示されます。

図14-10 アセットの新規作成ダイアログ

2. 「名前」テキスト・ボックスと「バージョン」テキスト・ボックスに適切な情報を入力します。

3. リストから適切な「タイプ」テンプレートを選択します。

4. 「OK」をクリックします。図14-11に示すように、新しいコンプライアンス・テンプレートがアセット・エディタに表示されます。

図14-11 アセット・エディタ

5. 分類タブをクリックし、「リレーションシップ」セクションで、「追加」をクリックしてリレーションシップを追加します。

6. プロジェクトで使用する必要があるアセットを選択します。

7. 必要に応じて、適切なリレーションシップ(規定されるアセット、規定されるプロセスおよび規定される環境)を割り当てます。

8. アセット・エディタで、「ファイル」メニューの「保存」をクリックします。

レビューと登録を行うアセットが発行されます。

この手順に従って、プロジェクト・プロファイル、アーキテクチャ設計図などのコンプライアンス・テンプレートを作成します。

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

この手順は、Oracle Enterprise Repositoryの「アセット」画面で開始します。

1. 「検索」またはその他の方法を使用して、プロジェクトに適用するコンプライアンス・テンプレートを見つけます。(「検索」セクションの「タイプ」リストで目的のコンプライアンス・テンプレートを選択して、検索結果をフィルタ処理します。)

2. 「プロジェクトに適用」をクリックします。図14-12に示すように、プロジェクトに適用ダイアログが表示されます。

図14-12 プロジェクトに適用ダイアログ

3. 「すべてのプロジェクトをリスト」をクリックするか「検索」を使用して、プロファイルが適用されるプロジェクトを見つけます。使用可能なプロジェクト列にリストが表示されます。

4. プロファイルが適用されるプロジェクトを選択します。

5. 右矢印ボタンをクリックして、使用可能なプロジェクト列から適用先プロジェクト列にプロジェクトを移動します。使用可能なプロジェクトから適用先プロジェクトにプロジェクトが移動します。

6. 「保存」をクリックします。図14-13に示すように、確認ダイアログが表示されます。

図14-13 プロジェクトに適用の確認ダイアログ

7. 「閉じる」をクリックします。

8. Oracle Enterprise Repositoryのメニュー・バーの「プロジェクト」リンクをクリックします。「プロジェクト」画面が表示されます。

9. 「検索」またはその他の方法を使用して、プロジェクト・プロファイルが適用されたプロジェクトを見つけます。

10. プロジェクトの詳細でコンプライアンス・テンプレート・タブをクリックします。適用されたコンプライアンス・テンプレートがコンプライアンス・テンプレート・タブに表示されます。

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

コンプライアンス・テンプレートを使用して、そのコンプライアンス・テンプレートが適用される任意のプロジェクトで使用される特定のアセットを規定できます。この項では、規定されるアセットを使用するためのプロセスについて説明します。

この手順は、Oracle Enterprise Repositoryの「プロジェクト」画面で開始します。

1. 図14-14に示すように、「検索」またはその他の方法を使用してプロジェクトを見つけます。

図14-14 「プロジェクト」画面

2. 図14-15に示すように、プロジェクトに適用されるコンプライアンス・テンプレートがプロジェクト詳細のコンプライアンス・テンプレート・セクションに表示されます。

図14-15 コンプライアンス・テンプレート

3. リストされているコンプライアンス・テンプレートの名前の右側にある「アセットを使用」をクリックします。図14-16に示すように、使用 - ダウンロード・ダイアログが表示されます。

図14-16 使用 - ダウンロード・ダイアログ

注意:
アセットを使用ボタンは、プロジェクトに割り当てられているユーザーにのみ表示されます。

4. 「使用」列のオプションを使用して、ダウンロードするアセットを選択します。

5. 「次」ボタンをクリックします。図14-17に示すように、「使用 - ダウンロード」ダイアログに、アセットの選択の確認が表示されます。

図14-17 使用 - ダウンロード・ダイアログ

6. 下矢印ボタンをクリックして、選択したアセットのペイロードをダウンロードします。

7. 終了したら、「閉じる」をクリックします。図14-18に示すように、ダウンロードされたアセットが、プロジェクト詳細の使用されるアセット・セクションにリストされます。

図14-18 「使用されるアセット」タブ

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

プロジェクト・コンプライアンス・レポートは、コンプライアンス・テンプレートで使用が規定されたアセットに対するプロジェクトの準拠を検証する方法です。

この手順は、Oracle Enterprise Repositoryの「レポート」画面で実行します。

1. 図14-19に示すように、「レポート」のサイドバーでプロジェクト・コンプライアンス・リンクをクリックします。

図14-19 「レポート」セクション

図14-20に示すように、プロジェクト・コンプライアンス・レポート・フォームがメイン・ペインで開きます。

図14-20 プロジェクト・コンプライアンス・レポート・フォーム

2. 「日付範囲」、「ソート順序」および「出力形式」のリストを使用して、レポート・パラメータを設定します。

注意:
「日付範囲」は、プロジェクトの作成日に基づきます。

3. 「レポートの実行」ボタンをクリックします。図14-21に示すように、選択した形式でレポートが表示され、各プロジェクトがリストされ、使用されているコンプライアンス・テンプレート、規定されるアセット、規定されるアセットの使用ステータス、およびプロジェクトで使用されるその他のアセットが示されます。

図14-21 プロジェクト・コンプライアンス・レポート

15 コード・コンプライアンス・インスペクタとの統合

この章では、概要について説明し、Oracle Enterprise Repository (OER)でコード・コンプライアンス・インスペクタ(CCI)を使用する方法について解説します。

この章では、次の項目について説明します。

- 概要

- コンプライアンスのチェックおよびOERのレポート・データの同期

- OERの「レポート」メニューからのアクセスに関するレポートの構成

15.1 概要

オープンな標準を遵守し、正しいコーディングを実行することは、SOAガバナンスの重要な原則です。コード・コンプライアンス・インスペクタは、SOAスイート・プロジェクトで正しいコーディングが行われているかどうかをチェックするツールです。

CCIは、設計の一貫性および正しいコーディングとドキュメントをチェックするためのWeb Services Interoperability Organization Basic Profile (WS-I BP)に基づいた事前定義済のアサーションのセットとともに提供されます。CCIでは、コードを、オープンな標準とベスト・プラクティスに対して、準拠性、一貫性または完全な一貫性があると評価します。

結果はコード・コンプライアンス・レポートに表示されます。これには、コンプライアンスのレベルや合格と不合格の割合が示され、優先度とポリシーで結果をグループ分けするグラフィカルな棒グラフが表示されます。結果には、上位10の違反コンポジットも記載されます。SOAスイート・プロジェクトの全体のコンプライアンス・スコアは、レポートのヘッダー部分に表示されます。

コード・コンプライアンス・インスペクタは、Oracle Application Integration Architecture (AIA)統合プロジェクトで正しいコーディングが行われているかどうかをチェックするために使用することもできます。WS-I BPに基づいたアサーションに加えて、コード・コンプライアンス・インスペクタでは、設計の一貫性およびコーディングをチェックするためのAIA統合開発者のガイドラインに基づいたアサーションも提供されます。CCIのコンプライアンス結果およびレポートは、AIAコンポジットに対してもサポートされています。

図15-1に、全体のコード・コンプライアンス・レポートの例を示します。このレポートは、OERの「レポート」ページを介してリンクされています。コンポジットをクリックすると、コンポジットの詳細を表示できます。OERの「アセット詳細」ページを使用すると、各コンポジットを個別に表示することもできます。さらに、レポート・ファイルをサーバーにポストし、同僚とコンプライアンスの結果を共有できます。

図15-1 全体のコード・コンプライアンス・レポート

15.1.1 CCIレポートの生成およびOERへの公開の手順の概要

この項では、OERで収集されたコンポジットと関連付け、OERユーザーによる表示用に公開する準備ができたCCIレポートを収集するために必要な手順の概要を説明します。

OERのCCIは、OERで公開できるレポートを生成するためにビルド管理者が使用する2つのコマンド行ユーティリティで構成されます。

1. checkComplianceコマンドでは、HTMLコンプライアンス・レポート・ファイルを作成します。

2. cci-oerSynchコマンドでは、結果をリポジトリと同期し、ユーザーがOERコンソールからレポートにアクセスできるようにします。

概要手順

1. OERアーティファクト・ストアを構成します。
詳細は、15.2.1項「CCIレポートのOERアーティファクト・ストアの構成」を参照してください。

2. ビルド環境で、cci-oerSynch.propertiesファイルを構成します。
詳細は、15.2.2項「cci-oerSynch.propertiesファイルの構成」を参照してください。

3. ビルド環境から、コマンド行コンプライアンス・スクリプトを実行してプロジェクトのCCIレポートを生成し、OER公開用にレポートを準備します。コマンド行ツールを実行してOERとの同期を有効にする必要があります。
詳細は、15.2.3項「checkComplianceコマンドの実行」を参照してください。

4. レポートの生成元のSOAまたはAIAプロジェクトがOERに収集されていることを確認します。
収集の詳細は、『Oracle Fusion Middleware Oracle Enterprise Repository構成ガイド』の設計時環境およびランタイム環境での自動収集の構成と使用に関する項を参照してください。

5. コンプライアンス・チェック・コマンドによって生成されたCCIレポートが含まれたビルド環境から、CCIとOERの同期コマンドを実行します。
詳細は、15.2.5項「CCIとOERの同期コマンドの実行」を参照してください。

6. 新しく生成されたCCIレポート・フォルダを、OERアーティファクト・ストアに関連付けられた物理的な場所にコピーします。この場所が元のレポート・フォルダと同じシステムでホストされている場合、CCIとOERの同期によってこの移動は自動化されます。それ以外の場合、これは手動手順です。
詳細は、15.2.6項「ファイルのコピー」を参照してください。

アーティファクト・ストアの詳細は、9.3.3項「新しいアーティファクト・ストアの選択」を参照してください。

7. OERインストールで、OERの「レポート」メニューからCCIレポートにアクセスできるようにコンプライアンス・レポートのプロパティ・ファイルを構成します。
詳細は、15.3項「OERの「レポート」メニューからのアクセスに関するレポートの構成」を参照してください。

15.2 コンプライアンスのチェックおよびOERのレポート・データの同期

CCIコマンド行ツールは、OERの<OER_Home>/modules/tools/solutions/12.1.3.0.0のComplianceInspector.zip内に配布されています。

zipファイルの内容は、ビルド環境が存在するマシンにインストールされます。

設定手順は、次のとおりです。

1. コンプライアンス・インスペクタのzipファイルを一時フォルダにコピーします。

2. コンプライアンス・インスペクタのzipファイルを解凍します。

3. ComplianceInspector/config/cci-oerSynch.propertiesにあるコンプライアンス・インスペクタのcci-oerSynch.propertiesファイルを構成します。
プロパティ・ファイルによって、環境の静的な情報を設定できます。

注意:
このファイルを解凍すると、常に、プロパティ・ファイルはComplianceInspectorディレクトリに対して相対的な位置にあり、configの下に置かれています。このディレクトリの名前を変更できます。この場所をComplianceInspector_Homeと呼びます。

15.2.1 CCIレポート用のOERアーティファクト・ストアの構成

1. OER内で適切なタイプ(HTTPなど)のアーティファクト・ストアを作成および構成します。
アーティファクト・ストアの使用の詳細は、9.3.2項「アーティファクト・ストアの構成」を参照してください。

2. アーティファクト・ストアに目的に合った名前を付けます(CCI-Reports-Productionなど)。

15.2.2 cci-oerSynch.propertiesファイルの構成

このコマンドは、指定したSOAまたはAIAプロジェクト・フォルダでコード・コンプライアンス・インスペクタを実行し、CCIレポートを含む新しいフォルダを作成します。

また、checkComplianceコマンドはcci-oerSynch.propertiesファイルを使用してOERインスタンスのURLを取得し、コンポジットのアセット・タイプIDと接続する際に使用するユーザー名の両方を検索します。

cci-oerSynch.propertiesファイル内のcompliance.report.web.rootプロパティの一部として、rep://<ARTIFACTSTORE-NAME>を使用します。

例: compliance.report.web.root=rep://CCI-Reports-Production/reports

レポートには次のURLパターンが含まれます。

rep://CCI-Reports-Production/reports/cci/AIADemo/reports/composites/AIADemoBatchJMSAdapter.html#hide_link

2つ目のプロパティであるcompliance.report.web.rootは、コンプライアンス・レポートのHTMLファイルを格納するホストのベースURIを表します。このプロパティで指定された値は、CCIとOERの同期ツールの実行時にinputDirパラメータと連結されます。この連結された値が、コンプライアンス・レポートのリンク用のアセットのメタデータに埋め込まれます。

ほとんどの場合、compliance.report.web.rootプロパティの値は、15.2.1項で構成されたアーティファクト・ストアを指します。

次に例を示します。

<a target="_blank" href="rep://CCI-REPORTS">rep://CCI-REPORTS</a>

15.2.3 checkComplianceコマンドの実行

次のスイッチを使用して、LinuxではcheckCompliance.shコマンドで、WindowsではcheckCompliance.batコマンドでCCIを起動します。

- -inputDir {コンポジットが含まれるフォルダの絶対パス}
これは、入力ディレクトリが存在する場所を指定する必須のスイッチです。-inputMetaFileスイッチを指定しない場合、これは必ずしもSOAスイート・プロジェクトを表しません。-inputMetaFileスイッチを指定すると、プロジェクトのルート・ディレクトリ(ComplianceInspector_Homeのプロジェクト・フォルダが含まれるソース・フォルダ)が指定されます。

- -outputDir {コンプライアンス・レポートが生成される出力フォルダ}
これは、出力レポートが格納される場所を指定するための必須のスイッチです。次に例を示します。

コンポジットが/tmp/cci/composites/AIADemoにる場合、

かつ、出力ディレクトリを/tmpとして渡す場合は、次のようになります。

CCIでは、生成したファイルは/tmp/AIADemoに置かれます。

- -policiesFile {ポリシー・ファイル名}
このオプションのスイッチを使用して、CCIが実行されるポリシー・ファイルを指定します。たとえば、Policies-WS-I_11.x.xmlなどです。ファイルは、ComplianceInspector/libまたはComplianceInspector/config (ツール・クラス・パス)の下にあるか、compliance.policy.engine.jarに組み込まれています。

- -policy {ポリシー名}
これは、実行するポリシーを指定するためのオプションのスイッチです。指定しない場合、Policies.xmlのデフォルト・ポリシーが実行されます。

- -assertion {アサーション名}
このオプションのスイッチを使用して、CCIが実行されるアサーションを指定します。これは、定義済の特定のアサーション用のツールを実行します。たとえば、ABCSTargetNameSpacesCheckなどです。

- -inputMetaFile {SOAスイート・プロジェクトのメタファイルの絶対パス}
特定のSOAスイート・プロジェクトに対してレポートを実行する場合に、このオプションのスイッチを使用します。入力メタファイルには、出力結果がSOAスイート・プロジェクト固有になるように、コード・コンプライアンス・インスペクタがスキャンする必要がある、特定のディレクトリを指すパスが含まれています。このファイルには、指定されたSOAスイート・プロジェクトで使用されるすべてのサービスの名前が含まれています。このオプションを指定すると、入力メタファイルにこのルートに対する相対ディレクトリ・パスが含まれるので、-inputDirスイッチはプロジェクトのルート・ディレクトリを指します。いくつか例を挙げます。

-inputMetaFile <ファイルのディレクトリ・パス>/GenerateScriptInput.xml

-inputMetaFile <ファイルのディレクトリ・パス>/MyPIPDP.xml

- -inputMetaFile ALL
すべてのSOAスイート・プロジェクトに対してレポートを実行する場合に、このオプションのスイッチを使用します。このオプションを指定すると、入力メタファイルにこのルートに対する相対ディレクトリ・パスが含まれるので、-inputDirスイッチはプロジェクトのルート・ディレクトリを指します。

- -version
-versionフラグでは、使用しているCCI(CCIビルドの日時)のバージョン。これは、バージョン情報を示すオプションの引数です。

例

次に、コマンド行からコード・コンプライアンス・インスペクタを起動する例を示します。

- Windows: checkCompliance.bat -inputDir D:\composites\demo -outputDir D:\ComplianceOut

- Linux: checkCompliance.sh -inputDir /composites/demo -outputDir /ComplianceOut

15.2.4 OERへのSOAまたはAIAプロジェクトの収集

収集の詳細は、第8章「自動収集の構成および使用」を参照してください。

15.2.5 CCIとOERの同期コマンドの実行

CCIとOERの同期では、OERのコンポジット・アセットが、関連付けられたCCIレポートへのリンクで更新されます。CCIとOERの同期コマンドを実行する前に、OERアーティファクト・ストアを構成しておくか、そうでない場合はOERによるレポートの公開元の場所を決定しておきます。

OERによるレポートの公開元のシステムでCCIとOERの同期コマンドを実行する場合、cci-oerSynch.propertiesファイルでoer.app.report.locationプロパティを使用してフォルダの場所を指定でき、コマンドを実行すると、レポートは入力フォルダから指定したフォルダに自動的に移動されます。

宛先のOERレポートの場所が別のシステムにある場合、-reportLocation引数で指定したフォルダをOERレポートの場所に手動で移動する必要があり、この場所のパス名がcompliance.report.web.rootプロパティで指定したものと一致するようにします。

次に例を示します。

アーティファクト・ストアの場合:

compliance.report.web.root=rep\://INSTANCE/reports

直接HTTPリソースの場合:

compliance.report.web.root=http://www.example.com/CCI-REPORTS-Production

CCIとOERの同期の実行

1. OERをインストールしたマシンの詳細情報で、ComplianceInspector/configディレクトリに存在するcci-oerSynch.propertiesファイルを更新します。

2. ComplianceInspector/binディレクトリに存在する、cci-oerSynch.batまたはcci-oerSynch.shを実行します。表15-1に、渡すことができるコマンド行の引数のリストを示します。

表15-1 OER同期のコマンド行引数

引数

タイプ

説明

-url <OERのWebサービスのURL>

オプション

OERのWebサービスのURL。

次に例を示します。

http://example.com:port/oer/services

-user <OERのユーザー名>

オプション

有効なOERのユーザー・ログイン。このユーザーは、アセットのインスタンスを更新する権限を持っている必要があります。

-pwd <指定したユーザー名のパスワード>

オプション

OERのユーザー・ログインのパスワード。

-reportLocation <CCIで生成された出力ディレクトリのパス>

必須

CCI HTMLコンプライアンス・レポートの場所。OERに統合するコンプライアンス・インスペクタ・ツールによって作成されます。

注意:
コマンド行のオプションの引数を指定しない場合、値はcci-oerSynch.propertiesファイルから取得されます。コマンド行の引数は、cci-oerSynch.propertiesファイルで指定したプロパティよりも優先されます。また、コマンド行の引数でパスワードを指定しない場合、入力するように要求されます。

15.2.6 ファイルのコピー

1. 新しく生成されたCCIレポート・フォルダを、OERアーティファクト・ストアに関連付けられた物理的な場所にコピーします。
この場所が元のレポート・フォルダと同じシステムでホストされている場合、CCIとOERの同期によってこの移動は自動化されます。それ以外の場合、これは手動手順です。

2. これが実行されたことを確認するには、OERのコンポジット・アセットでリンクが作成されたことを確認します。

15.3 OERの「レポート」メニューからのアクセスに関するレポートの構成

CCIとOERの同期によってCCIレポートがOERのコンポジット・アセットにリンクされると、レポートへのリンクがコンポジットの詳細ページに表示されます。次の構成手順の実行後、OERの「レポート」メニューからCCIレポートにアクセスできます。

注意:
ComplianceReport.xmlファイルのレポート要素の名前属性は、<OER_Home>/applications/oer/oer-app/WEB-INF/config/reports/custom.tocファイル内で参照されます。これらの要素が一致しない場合、displayNameおよび説明要素の値はOERのレポート・ページに表示されません。
<OER_Home>/applications/oer/oer-app/WEB-INF/config/reports/custom.tocファイルを使用すると、OERの外部の統合したレポート・システムにURLパターンを追加できます。custom.tocファイルは、カスタム・レポート・グループ情報を収集し、custom.tocファイルで参照されている対応する情報を表示するために、他のどのXMLファイルにアクセスするかを示します。

コンプライアンス・レポートを追加および構成する手順

1. アプリケーション・サーバーを停止します。

2. <OER_Home>/applications/oer/oer-app/WEB-INF/config/reports/ComplianceReport.xmlファイルを編集します。
次に、すぐに使用できるComplianceReport.xmlの例を示します。

<?xml version="1.0" ?>
<reports>
<report name="complianceReportDoc">
<displayName>Compliance Report Documentation</displayName>
<description>Documentation for setting up Compliance Reports.
</description>
</report>
<report name="complianceReport">
<displayName>Compliance Report</displayName>
<description>This is the index page for all technical compliance
reports.</description>
<!-- update the host and port, according the your http enabled server
where you have hosted the compliance reports. Use the OER download servlet to
map the OER artifact store URL for browser consumption. Example:
<externalLink>http://server.example.com:7101/oer/com.flashline.cmee.
servlet.enterprisetab.Download?path=rep://INSTANCE/reports/cci/FPDemo/
index.html</externalLink> -->
<externalLink>http://host.example.com/CCI/reports/index.html</externalLink>
</report>
</reports>

3. 要約されているSOAスイート・プロジェクトが1つしかない場合、complianceReportという名前の既存のレポートを変更して、手順9に進みます。

- OERアーティファクト・ストアを使用してレポートの場所を参照している場合(これをお薦めします)、次のURLパターンをCustomReport.xmlファイルのexternalLink要素の一部として使用する必要があります。
http://host.example.com:port/oer/com.flashline.cmee.servlet.enterprisetab.Download?path=rep://<ARTIFACTSTORENAME>/relative_path/index.html

アーティファクト・ストアが示す正しいURLをユーザーに提供するために、URLをデコードして再フォーマットするダウンロード・サーブレットが必要です。OERアーティファクト・ストアを使用すると、OER管理者は、複数のアセットの再同期または変更によってこれらの詳細情報を更新しないで、レポート・サーバーのホスト名/ポートおよびパスを変更できます。

4. 2つ以上のSOAスイート・プロジェクトが要約される場合、チェック・コンプライアンス・ツールで報告されるプロジェクト数分、レポート・セクションを複製します。

5. 各レポート要素の名前属性を意味のある名前(一意にする必要があります)に更新します。

6. SOAスイート・プロジェクトの要約ページに適切なdisplayName、説明および外部リンク要素を更新し、編集内容を保存します。

7. <OER_Home>/applications/oer/oer-app/WEB-INF/config/reports/custom.tocファイルを編集します。
例:

<?xml version="1.0" ?>
<reportSections>
<reportSection name="Custom">
<summary></summary>
<description>Custom reports provide you with the flexibility
to customize reports for your organization or build new reports that align
your organizational metrics with your program goals.</description>
</reportSection>
<reportSection name="Compliance Reports">
<summary></summary>
<description>Code Compliance Inspector report for design-time
compliance information</description>
<report name="complianceReportDoc"/>
<report name="complianceReport"/>
</reportSection>
</reportSections>

8. CustomReport.xmlファイルに追加または変更したものと一致するように、レポート名要素を変更します。

9. 図15-2に示すとおり、変更内容が反映されるようにOERアプリケーション・サーバーを再起動します。

図15-2 OERコンプライアンス・レポートのリンク

次に、OERアーティファクト・ストアを使用してコンプライアンス・レポートの要約ページに移動するComplianceReport.xmlファイルの例を示します。

<?xml version="1.0" ?>
<reports>
<report name="complianceReport_project1">
<displayName>Compliance Report (Project 1)</displayName>
<description>This is the compliance report summary page for Composite
Project 1.</description>
<!-- update the host and port, according the your http enabled server
where you have hosted the compliance reports -->
<externalLink>http://host.example.com/CCI/reports/project1/index.html
</externalLink>
</report>
<report name="complianceReport_project2">
<displayName>Compliance Report (Project 2)</displayName>
<description>This is the compliance report summary page for Composite
Project 2.</description>
<!-- update the host and port, according the your http enabled server
where you have hosted the compliance reports -->
<externalLink>http://example.com:8080/tr130107/com.flashline.cmee
.servlet.enterprisetab.Download?path=rep://INSTANCE/reports/cci/FPDemo/
index.html</externalLink>
</report>
</reports>

この場所の実際のURLパスは、次のとおりです。

http://example.com:8080/tr130107/reports/cci/FPDemo/index.html

前述のURLの斜体部分はレポート・ファイルの相対パスです。リポジトリ名の後ろが相対パスです。

15.3.1 レポートの確認

OERでは、図15-3に示すように、コンプライアンス・レポートのリンクをクリックして、図15-4に示す、すべてのコンポジットの全体のレポートを表示します。

図15-3 コンプライアンス・レポートのリンク

図15-4 全体のコード・コンプライアンス・レポート

図15-4に示すように、違反しているコンポジットをクリックして、違反の詳細を表示し、コンプライアンスの問題を修正します。

図15-5に示すように、OERで個々のコンポジットのコンプライアンス情報を表示することもできます。

図15-5 技術的なコンプライアンス・レポート

「コンプライアンス・レポート」ボックスの「開く」リンクをクリックして、図15-6に示すような詳細な結果を表示します。

図15-6 コンポジットのコンプライアンス・レポート

16 ポリシー管理の構成

この章では、ポリシー管理の様々な側面およびOracle Enterprise Repositoryでのポリシーの使用方法について説明します。

この章には次の項が含まれます:

- 16.1項「概要」

- 16.2項「ポリシー管理機能のアクティブ化」

- 16.3項「ポリシー・タイプの作成」

- 16.4項「ポリシー・タイプへのポリシー・アサーション要素の追加」

- 16.5項「ポリシーの作成」

- 16.6項「適用されたアセット・ポリシー要素のタイプへの追加」

- 16.7項「アセットへのポリシーの適用」

- 16.8項「ポリシー・ステータスの表示」

- 16.9項「ポリシー・アサーションの検証」

- 16.10項「Oracle Enterprise Repositoryポリシー・レポートの実行」

16.1 概要

ポリシーは、設計および開発の段階で考慮する必要があるアセット要件を伝えたり、ガバナンス、アーキテクチャおよびその他の組織標準にアセットを準拠させ、その状況を監視する手段を管理者に提供する目的で、アセットに適用されます。たとえば、アセットを実行するプラットフォームや許容される不具合密度レートを指定して、企業品質標準を規定するポリシーなどがあります。

ポリシーは複数のアセットに適用できます。複数のポリシーを任意のアセットに適用できます。各ポリシーは、少なくとも1つのアサーション文から構成されます。

- 各アサーションには名前と説明があり、技術的な定義が含まれています。技術的な定義には追加のメタデータが含まれており、これは、サード・パーティのテスト/検証ツールを使用してアサーションを自動的に検証する場合に必要となることがあります。このメタデータは、Webサービス固有のポリシー情報、XML、または外部システムで読取り可能な他の形式である場合があります。

- たとえば、不具合密度に関するアサーション文では、不具合密度を1%未満にする必要がある旨を宣言できます。

Oracle Enterprise Repositoryベース・データパックにはサンプル・ポリシーが用意されており、それらをOracle Enterprise Repositoryインスタンスにインポートできます。Oracle Enterprise Repositoryのインポート/エクスポート機能の詳細は、第5章「インポート・エクスポート・ツール」を参照してください。

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

ポリシー管理機能をアクティブにするには、次の手順を実行します。

手順1: ポリシー管理システム設定の有効化

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

1. 左ペインの「システム設定」をクリックします。

2. 図16-1に示すように、「ポリシー管理」セクションにナビゲートします。

図16-1 ポリシー管理

3. アセット・ポリシーの有効化プロパティがTrueに設定されていることを確認します。

4. ポリシー・アサーションを閉じるプロパティについて適切なオプションを選択します。

- Trueの場合、アサーションのデフォルトのアセット詳細表示が閉じます。

- Falseの場合、アサーションのデフォルトのアセット詳細表示が開きます。

5. アセット・ポリシー・リレーションシップのリストからポリシーの適用先を選択します。

6. 終了したら、「保存」ボタンをクリックします。これで、ポリシー管理機能がアクティブになります。

注意:
この設定は、インストール時にはデフォルトでオフの状態で表示されます。この機能をオンにするには、ドキュメントの説明に従って、ユーザーがプロパティを適切な値に設定する必要があります。

手順2: ポリシー管理ソリューション・パックのインポート

ポリシー管理システム設定の構成が終了したら、<ORACLE_HOME>/oer/modules/tools/solutionsからPolicy-Management-Solution-Pack.zipをインストールし、インポート/エクスポート・ツールにより対象環境にインポートすることによって、サンプル・ポリシー・タイプとポリシーの例を入手できます。

注意:
ポリシー管理ソリューション・パックは、「手順1: ポリシー管理システム設定の有効化」に従ってシステム設定を有効化した後にインポートしてください。これらの設定を有効化する前にソリューション・パックをインポートすると、問題が発生する可能性があります。

16.3 ポリシー・タイプの作成

必要に応じて、ベース・データ内のポリシー・テンプレートを使用するかわりに独自のポリシーを作成することもでき、この項ではその方法について説明します。ポリシー・タイプ・テンプレートは、既存のアセット・タイプまたはコンプライアンス・テンプレート・タイプを基準に作成できます。ポリシー・タイプはポリシー管理ソリューション・パックに含まれています。

1. Oracle Enterprise Repositoryの「アセット」画面にある「アセットの編集/管理」をクリックしてアセット・エディタを起動します。

図16-2 「アセット」セクション

2. アセット・エディタの「アクション」メニューを開きます。

3. 「タイプの管理」をクリックしてタイプ・マネージャを起動します。

4. 「ファイル」メニューを開き、「新規」をクリックします。新しいタイプの作成ダイアログが表示されます。

5. 図16-3に示すように、「タイプ名」フィールドに「Policy」と入力し、デフォルトのタイプのリストからテンプレートを選択します。

図16-3 新しいタイプの作成ダイアログ

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

7. タイプ・マネージャのエディタ・タブで、アーキタイプのリストから「ポリシー・タイプ」を選択します。

図16-4 タイプ・マネージャ

独自のポリシー・タイプが正常に作成されます。

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

ポリシー・アサーションは、アセットに関する条件を満たす必要があることを宣言するものです。たとえば、アセットの不具合密度レートが1%未満であることを条件とするようにポリシー・アサーションで宣言します。各アサーションは個別に検証されます。アセットがすべてのアサーションを満たした場合(つまり、Oracle Enterprise Repositoryですべてのアサーションが可ステータスになった場合)、適用対象ポリシーにアセットが準拠していることになります。新規ポリシー・テンプレートが正しく機能するようにするには、ポリシー・アサーション要素を追加する必要があります。この単純な手順は、タイプ・マネージャで実行します。

ポリシー・アサーション要素は、ポリシー・テンプレートの任意のタブに追加できます。次の説明では、「概要」タブにポリシー・アサーション要素を追加しています。

1. タイプ・マネージャのタブ・セクションで「概要」を選択します。
図16-5に示すように、「概要」タブにすでに割り当てられている要素がタイプ・マネージャの「要素」セクションに一覧表示されます。

図16-5 「要素」セクション

2. 「追加」をクリックします。追加する要素タイプの選択ダイアログが表示されます。

3. 図16-6に示すように、「要素タイプ」リストからポリシー・アサーションを選択します。

図16-6 追加する要素タイプの選択

4. 「OK」をクリックします。図16-7に示すように、ポリシー・アサーションの編集ダイアログが表示されます。

5. 「表示名」テキスト・ボックスにポリシー・アサーションの名前を入力します。(次の例では、要素の名前として「Policy Assertions」を使用しています。)

図16-7 ポリシー・アサーションの編集

6. 「OK」をクリックします。これで、ポリシー・アサーション要素が「要素」リストに表示されるようになります。

注意:
ポリシーに関連付けられたアセットを扱うアセット・タイプでは、ポリシー・アサーション要素が必要になります。

16.5 ポリシーの作成

ポリシーは、他のアセットと固有のリレーションシップを持つ特殊なタイプのアセットです。ポリシーはポリシー・タイプに基づいて作成されます。

この手順は、アセット・エディタで実行されます。

1. 「ファイル」メニューを開き、「新規」をクリックします。アセットの新規作成ダイアログが表示されます。

2. 図16-8に示すように、「名前」テキスト・ボックスにポリシーの名前を入力します。

図16-8 アセットの新規作成ダイアログ

3. バージョン番号を入力します(オプション)。

4. 「タイプ」プルダウンから適切なポリシー・タイプを選択します。

5. 初期状態プルダウンから適切な状態を選択します。

6. 「OK」をクリックします。ポリシーがアセット・エディタに開きます。

図16-9 「概要」タブ

7. ポリシー・アサーション・セクションで「追加」をクリックします。「編集」ダイアログが表示されます。

8. 「名前」、「説明」および技術的な定義の各セクションに適宜入力します。

図16-10 「編集」ダイアログ

注意:
「名前」と「説明」は、人間が読める情報です。技術的な定義は、アサーションをその他のプロセスやツールに渡して検証できるように、マシンで読取り可能な(XMLのような)情報にする必要があります。

9. 「OK」をクリックします。新規ポリシー・アサーションがポリシー・アサーション・セクションに表示されます。

図16-11 ポリシー・アサーション

10. 同じ手順を繰り返して、ポリシーに別のアサーションを追加します。

16.6 適用されたアセット・ポリシー要素のタイプへの追加

ポリシーは、適用されたアセット・ポリシー要素が追加されているタイプのアセットにのみ適用できます。たとえば、企業品質ポリシーがすべてのサービスに当てはまる場合、そのポリシーが適用されるようにするには、「サービス」アセット・タイプに、適用されたアセット・ポリシー要素を追加する必要があります。

適用されたアセット・ポリシー要素を追加する手順は、タイプ・マネージャで実行し、「ポリシー・タイプへのポリシー・アサーション要素の追加」の手順とほぼ同じです。

注意:
Oracle Enterprise Repositoryでポリシーを有効化する前に、次の手順を記載の順序で実行してください。

1. 「手順1: ポリシー管理システム設定の有効化」ですでに実行したとおり、ポリシー有効化のシステム設定をtrueを設定します。

2. Harvester Solution Packをインポートします。Harvester Solution Packのインポートの詳細は、『Oracle Fusion Middleware Oracle Enterprise Repositoryインストレーション・ガイド』を参照してください。

3. 「手順2: ポリシー管理ソリューション・パックのインポート」ですでに実行したとおり、ポリシー管理パックおよび修正パックをインポートします。

1. 選択したアセット・タイプを開きます。右側のパネルで、エディタ・タブを選択します。

2. タブ・セクションで、適用されたアセット・ポリシー要素の追加先のタブを選択します。

3. 「要素」セクションで、「追加」をクリックします。追加する要素タイプの選択ダイアログが表示されます。

4. 「要素タイプ」リストから適用されたアセット・ポリシー・オプションを選択します。

5. 「OK」をクリックします。適用されたアセット・ポリシーの編集ダイアログが表示されます。

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

7. 「OK」をクリックします。割り当てた名前を持つ、適用されたアセット・ポリシー要素が「要素」セクションのリストに表示されます。

8. 右側のパネル表示を「ビューア」タブに切り替えます。

9. 非表示要素セクションで、適用されたアセット・ポリシー要素を選択します。要素の移動ダイアログが表示されます。

10. 適用されたアセット・ポリシーの移動先のリストから適切な適用されたアセット・ポリシー要素を選択します。

11. アセット・タイプを保存します。

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

注意:
ポリシーの基本アクセス設定で、ユーザーにポリシーの適用権限を割り当てる必要があります。

アセットにポリシーを追加する手順は、アセット詳細表示で実行します。

1. Oracle Enterprise Repositoryの検索機能またはその他の手段を使用して、ポリシーの追加先のアセットを探します。

2. 図16-12に示すように、アセット詳細表示でポリシーの適用ボタンをクリックします。

図16-12 概要

3. 図16-13に示すように、「すべてのポリシーの一覧表示」をクリックして、使用可能なアセット・ポリシー・ボックスにリストを表示します。

図16-13 ポリシーの適用

4. 矢印ボタンを使用して、選択したポリシーを適用されたアセット・ポリシー・ボックスに移動します。
上の例では、サンプル・ポリシー - 企業品質標準というポリシーが適用されています。

5. 「保存」をクリックします。

6. 図16-14に示すように、確認メッセージが表示されます。

図16-14 ポリシーの適用

7. 「閉じる」をクリックします。

8. アセット詳細フレームをリフレッシュします。

9. ポリシーが適用された場合は、アセット詳細の「概要」セクションに図16-15に示すようなアイコンが表示されます。(検索結果リストのアセットにポリシーが割り当てられている場合は、同じアイコンの小さいバージョンが表示されます。)

図16-15 「概要」 - サンプル・ポリシー - 企業品質標準

図16-16に示すように、アセット詳細の「リレーションシップ」セクションでは、サンプル・ポリシー - 企業品質標準が適用対象ポリシーとして指定されています。指定されたポリシーのテキスト・リンクをクリックすると、その詳細が表示されます。

図16-16 サンプル・ポリシー - 企業品質標準

ポリシー詳細の「リレーションシップ」セクションには、サンプル・ポリシー - 企業品質標準が適用されているアセットが一覧表示されます。サンプル・サービス - アカウント詳細(2.0)のリンクをクリックすると、そのアセットの詳細表示に戻ります。

注意:
適格な任意のアセットに複数のポリシーを適用することもできます。

16.8 ポリシー・ステータスの表示

ポリシー・ステータスは、アセット詳細表示と検索結果に表示される特定のアイコンで示されます。(また、ポリシー・ステータスはオプションのナビゲータにも示されます。)

ポリシー・ステータスは、適用対象ポリシー内のアサーション文にアセットが準拠しているかどうかによって決定されます。複数のポリシーが適用される場合は、それぞれのポリシーに準拠しているアセットのみが可ステータスになります。

同様に、ポリシーは複数のアサーション文で構成されている場合があるため、すべての適用対象ポリシー内のすべてのアサーション文に準拠しているアセットのみが可ステータスになります。

image

説明

ステータス: 適用済
1つ以上のポリシーがアセットに適用されていて、可/不可ステータスが不明であることを示します。

可と不明のアサーション文が混在している場合、アセット・ステータスは不明になります。

ステータス: 可
アセットがすべての適用対象ポリシー内のすべてのアサーション文に準拠していることを示します。

ステータス: 不可
アセットがすべての適用対象ポリシー内のすべてのアサーション文に必ずしも準拠しているわけではないことを示します。

いずれかの適用対象ポリシー内のいずれかのアサーション文に準拠していない場合は、不可ステータスになります。

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

ポリシー・アサーションは、Oracle Enterprise Repositoryを使用して手動で検証することも、テスト/検証ツールを使用して自動的に検証することもできます。このドキュメントでは、ポリシー・アサーションの手動検証について説明します。自動検証プロセスについては、特定のテスト/検証ツールのドキュメントを参照してください。

ポリシー・アサーションの手動検証はアセット・エディタで実行します。アセット・エディタの詳細は、第9章「アセット・エディタの使用」を参照してください。

1. 更新するアセットを探します。

2. アセット内の適用されたアセット・ポリシー・セクションを探します。
このセクションの特定のラベルおよび場所は、タイプ・テンプレート内のポリシー要素の構成によって決まります。

3. 図16-17に示すように、更新するポリシーを選択します。

図16-17 適用されたアセット・ポリシー

4. 「詳細」をクリックします。図16-18に示すように、「ポリシーの表示」ダイアログが表示されます。

図16-18 「ポリシーの表示」ダイアログ

「ポリシーの表示」セクションに表示されるポリシーへのアセットの準拠ステータスは、「結果」列に示されます。上の例の「不明」ステータスは、ポリシーがアセットに適用されているが、そのポリシーのアサーション文への準拠はまだ評価されていないことを示します。

5. 更新するアサーション文を選択します。

6. 「編集」をクリックします。図16-19に示すように、アサーション結果の編集ダイアログが表示されます。

図16-19 アサーション結果の編集ダイアログ

7. 図16-20に示すように、評価値リストをクリックし、適切なステータスを選択します。

図16-20 評価値リスト

この例では、可ステータスが選択されています。その他の詳細は、評価情報に入力できます。

8. 「OK」をクリックします。図16-21に示すように、更新されたステータスが「ポリシーの表示」ダイアログの「結果」列に表示されます。

図16-21 「ポリシーの表示」ダイアログ

注意:
アサーション値を「不明」に戻すには、アサーションを選択し、「クリア」をクリックします。

9. 残りのアサーションについても同じ手順で検証します。

10. 終了したら、「OK」をクリックして「ポリシーの表示」ダイアログを閉じます。

11. アサーションに加えた変更を保存します。

12. 図16-22に示すように、緑のチェック・マーク付きのアイコンがアセット詳細に表示されます。

図16-22 サンプル・サービス - アカウント詳細(2.0)

図16-23に示すように、検索結果内のポリシー準拠のアセット名の横にも同じものが表示されます。

図16-23 検索結果

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

この項で説明する2種類のポリシー・レポートが用意されています。

- アセット・ポートフォリオ・ポリシー・ステータス

- ポリシー・ステータス・レポート

アセット・ポートフォリオ・ポリシー・ステータス

このレポートは、組織のアセット・ポートフォリオ全体に関して、ポリシー・ステータス(可、不可、不明)の概要を示します。このレポートを使用すると、各ステータスのアセットのリスト(たとえば、不可となるすべてのアセット)を表示できます。詳細なレポートには、各アセットに適用されるすべてのポリシーと、すべてのポリシー・アサーションのステータスがリストされます。

ポリシー・ステータス・レポート

このレポートは、組織のポリシー・ポートフォリオのすべてのポリシーの概要と、ステータスが可、不可、または不明のアセットの数を示します。このレポートは、各ポリシーで管理されるアセットの詳細リストと、ステータスが可、不可または不明のアサーションの数も示します。

Oracle Enterprise Repositoryレポートを実行するには、次の手順を実行します。

1. Oracle Enterprise Repositoryの「レポート」ページで、レポート名をクリックします。図16-24に示すように、BI Publisherの「レポート」タブが新しいブラウザ・ウィンドウで開きます。

図16-24 「レポート」タブ

2. 「View」ボタンをクリックします。図16-25に示すように、選択したレポートの詳細が表示されます。

図16-25 「レポート」タブ - 詳細ビュー

3. 図16-26に示すように、「テンプレート」の横に表示される2つ目のリストから様々な形式を選択できます。

図16-26 形式のリスト

4. アセット・ポートフォリオ管理セクションで、アセット・ポートフォリオ・ポリシー・ステータス・オプションをクリックします。図16-27に示すように、アセット・ポートフォリオ・ポリシー・ステータス・ページが表示されます。

図16-27 アセット・ポートフォリオ・ポリシー・ステータス・ページ

5. 一連のアセットの詳細を表示するには、該当するポリシー・ステータスのアイコンの横にある数字をクリックします。図16-28に示すように、アセット・ポートフォリオ・ポリシー・ステータスのステータス詳細レポートが表示されます。

図16-28 アセット・ポートフォリオ・ポリシー・ステータス・レポート・ページ

6. アセット・ポートフォリオ管理セクションで、ポリシー・ステータス・オプションをクリックします。図16-29に示すように、ポリシー・ステータス・レポート・ページが表示されます。

図16-29 ポリシー・ステータス・レポート・ページ

17 Enterprise Manager統合ユーティリティ

この章では、Enterprise Manager統合ユーティリティを使用および構成して、Oracle Enterprise ManagerとOracle Enterprise Repositoryを統合する方法について説明します。

この章では、次の項目について説明します。

- 概要

- Enterprise Manager統合ユーティリティの使用

- Enterprise Manager統合ユーティリティの構成

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

- 既知の問題

17.1 概要

Oracle Enterprise Manager(EM)は、包括的な監視ツールです。これは、OracleのSOA製品、J2EEサーバー、データベース、JVMおよびオペレーティング・システムの監視をサポートしています。

EM統合ユーティリティでは、EMからOracle Enterprise Repositoryに実行時のパフォーマンス・メトリックの要約を提供することで、実行時と設計時の間のループを終了させます。EM統合ユーティリティは、EMからメトリックをプルし、Oracle Enterprise Repositoryにプッシュします。EM統合ツールは現在、EM 12cをサポートし、連携しています。

EMでは、1つのEMGCインスタンスで複数のバージョンの製品またはターゲットを同時に監視できます。たとえば、Oracle Service Bus 11gおよび12cはEMで同時に監視できるため、これらの両方のインスタンスのメトリックを1つのOracle Enterprise Repositoryインスタンスにプルでき、これには、Oracle Service Bus 11gまたは12cから収集したプロジェクトが含まれます。Oracle Enterprise RepositoryとEMの統合では、Oracle Enterprise Repositoryへの複数の製品バージョン・ターゲットのメトリックの収集もサポートされます。

17.1.1 前提条件

EM統合ユーティリティを使用する前に、次の前提条件を実行する必要があります。

- EM統合ユーティリティでは、OERハーベスタ・データパックをOracle Enterprise Repositoryにインストールする必要があります。

- EMからメトリックを受け取るアセットが、Oracle Enterprise Repositoryに存在している必要があります。これらは、Oracle Enterprise Repositoryハーベスタを使用して、SOAスイート/BPEL-PM、WebLogicまたはOracle Service BusからOracle Enterprise Repositoryに発行されます。
収集の詳細は、第8章「自動収集の構成および使用」を参照してください。

- EM統合ユーティリティでは、Enterprise Managerの共有データベース・ビューへの読取り権限が必要です。

- EM統合ユーティリティでは、Java SDKバージョン6以上が必要です。

- EM 12cをインストールして、EM統合ツールでメトリックをOracle Enterprise Repositoryに収集できるようにします。Oracle Enterprise RepositoryとEMの統合ツールは、EMと統合し、11gおよび12cバージョンのSOAと連携します。

- EM 12cと統合する場合、em-integration-settings.xml構成ファイルを使用します。ただし、いくつかの変更が必要です。

- SOASuiteメトリックの場合、metricName属性をsoainfra_binding_rollupからsoa_composite_services_rollupに変更します。

- Weblogic Webサービスの場合、metricName属性をj2ee_app_jee_ws_port_rollupからj2ee_app_jrf_ws_port_propertiesに変更します。

- ターゲットのマッピングで、ターゲット・タイプがj2ee_applicationの場合、primaryMetrics metricNameをj2ee_app_jee_ws_port_propertiesからj2ee_app_jrf_ws_port_propertiesに変更します。

- ターゲットのマッピングで、ターゲット・タイプがoracle_soa_compositeの場合、次のtargetMetricを追加します。
<targetMetric name="primaryMetrics" metricName="soainfra_composite_label_rollup_by_revision" metricColumn="soainfra_composite" />

17.1.2 Enterprise Manager統合ユーティリティの取得

Enterprise Manager統合ユーティリティを取得するには、次の手順を実行します。

1. コンピュータのOracle_HOME\oer\modules\tools\solutionsディレクトリに移動します。Oracle Enterprise Repositoryのすべてのソリューション・パックの一覧が表示されます。

2. 12.1.3.0.0-EM-Integration.zipファイルを一時ディレクトリに解凍します。

3. インポート/エクスポート・ツールを使用して、12.1.3.0.0-OER-Harvester-Solution-Pack.zipファイルをOracle Enterprise Repositoryにインポートします。詳細は、第5章「インポート・エクスポート・ツール」を参照してください。

17.1.3 高レベルなユースケース

EM統合ユーティリティは次の用途に使用できます。

- EMのOracle Service Busサービスから既存のOracle Enterprise Repositoryアセットにメトリックを発行します。

- EMのBPEL-PMプロセスから既存のOracle Enterprise Repositoryアセットにメトリックを発行します。

- EMのWebサービスから既存のOracle Enterprise Repositoryアセットにメトリックを発行します。

- Oracle Enterprise RepositoryのエンドポイントおよびDeployment: BPELアセットをEMのデプロイメント情報から発行します。

- Oracle Enterprise RepositoryのWeb UIからEMの詳細なメトリックへのリンクをサポートします。

- EMの新しいターゲットをOracle Enterprise Repositoryアセットにマップできるように、構成可能性と拡張性をサポートします。

- EMのOracle SOA Suiteコンポジットのターゲットのメトリック取得をサポートします。EM統合を行うと、サービスを起動し、EMで監視される、コンポジットのメトリックを発行できます。ただし、Oracle Service Bus、BPELまたはWebLogicなどのターゲットと異なり、サービス・エンドポイントがOracle Enterprise Repositoryに存在しない場合、これは統合プロセス中に作成されません。アセットが存在する場合、これらはメトリックで更新されます。

17.2 Enterprise Manager統合ユーティリティの使用

この項では、Enterprise Manager統合ユーティリティの使用方法について説明します。

17.2.1 コマンド行からの実行

EM統合ユーティリティはコマンド行で実行できます。Windowsでは、em-integration.batユーティリティを、LinuxとUNIXでは、em-integration.shを使用します。

em-integration.batまたはem-integration.shを実行する前に、表17-1で示された環境変数が設定されていることを確認します。

Windowsでは、コマンド・ウィンドウからset JAVA_HOMEと入力して、変数JAVA_HOMEの値を表示し、set JAVA_HOME=C:\Jdk6\bin\javaと入力してJAVA_HOMEの値にC:\Jdk6\bin\javaを設定します。

Linuxでは、echo $JAVA_HOMEと入力して変数JAVA_HOMEの値を表示し、設定されていない場合、export JAVA_HOME=/usr/bin/javaを使用して、JAVA_HOMEに値/usr/bin/javaを設定します。

表17-1コマンド行スクリプト

環境変数

説明

JAVA_HOME

JAVA_HOME環境変数がインストール済のJavaランタイム(JRE)またはSDKを指していることを確認します。Javaバージョン5以上である必要があります。

JAVA_OPTS

次のようにJAVA_OPTSパラメータが設定されていることを確認します。

set JAVA_OPTS=-Dhttp.proxyPort=80 -Dhttp.proxyHost=www-proxy.example.com -Dhttp.nonProxyHosts= "*.example.com¦localhost" ..."

JAVA_OPTSは、Java実行可能ファイルの追加のオプションです。通常、この変数を設定する必要はありません。ただし、コンピュータがファイアウォール内にある場合や、外部サーバーへのアクセスにHTTPプロキシを使用する必要がある場合には、この変数を設定してください。

関連項目: http://java.sun.com/javase/6/docs/technotes/guides/net/proxies.html

表17-2に、EM統合コマンド行ユーティリティを使用して指定できるオプションを示します。

表17-2 EM統合のコマンド行オプション

EM統合オプション

説明

-settings <file>

XMLファイルで指定された構成設定のことです。

-er_url <URL>

Oracle Enterprise RepositoryインスタンスのURLを指定します。

-er_user <User Name>

Oracle Enterprise Repositoryユーザーの名前を指定します。

-er_password <Password>

Oracle Enterprise Repositoryユーザーのパスワードを指定します。

セキュリティを確実にするために、パスワードを暗号化する必要があります。

Oracle Enterprise Repository Webコンソールには、次のようなパスワードを暗号化するツールがあります。http://<host>:<port>/<domain>/diag/encryptstrings.jsp

-em_url <URL>

EMデータベースのJDBC URLを指定します。

-em_user <User Name>

EMデータベースのユーザー名を指定します。

-em_password <Password>

EMデータベースのパスワードを指定します。

セキュリティを確実にするために、パスワードを暗号化する必要があります。

Oracle Enterprise Repository Webコンソールには、次のようなパスワードを暗号化するツールがあります。http://<host>:<port>/<domain>/diag/encryptstrings.jsp

コマンド行からのパスワードの暗号化の詳細は、17.4項「構成ファイルのパスワードの暗号化」を参照してください。

-version

バージョン情報を表示します。

-help

EM統合ユーティリティのオンライン・ヘルプを表示します。

注意:
前述のオプションは必須ではなく、省略可能です。オプションが省略された場合、ユーティリティはem-integration.batが存在するカレント・ディレクトリのem-integration-settings.xmlファイルにある情報を使用します。コマンド行パラメータが指定された場合、em-integration-settings.xmlの情報よりも優先されます。

図17-1に、em-integration.sh -helpコマンドで表示されるコマンド行ユーティリティのオプションとオンライン・ヘルプを示します。

図17-1 Enterprise Manager統合のコマンド行ユーティリティのオプション

17.2.2 Enterprise Managerからのスケジュール

Enterprise Managerでは、コマンド行アプリケーションが定期的に実行されるようにスケジュールできます。EM統合ユーティリティも、このように実行されるようにスケジュールできます。

詳細は、Oracle Enterprise Manager管理者ガイドのジョブ・システムに関する項を参照してください。

EM統合を1日に1回、夜やシステムのアクティビティの少ない時間にスケジュールすることをお薦めします。

17.2.3 メトリックの発行

この項では、様々なメトリック発行オプションについて説明します。

17.2.3.1 Oracle Service Bus

EM統合では、タイプがEndpointであり、Oracle Service Busプロキシ・サービスおよび外部サービス用にEM内のendpointURIメトリックと一致するendpointURI属性を持つ、Oracle Enterprise Repositoryの既存のアセットを更新します。

注意:
外部サービスは、Oracle Service Busビジネス・サービスによって起動されるサービスです。

一致するendpointURIを持つEndpointアセットが見つからない場合、ツールは名前とOracle Service Busのサービス・タイプ(BusinessServiceまたはProxyService)で、一致するサービス・アセットを検索しようとします。見つかった場合、新しいEndpointアセットを作成し、これをサービスに関連付けます。ビジネス・サービスの場合、エンドポイントはビジネス・サービスによって起動された外部サービスに関連付けられます。

メトリックが収集されていない、あるいはOracle Service Busサービスのメトリックを収集する際にEM Grid Controlにエラーが生じるなど、EM内のOracle Service Busターゲットのためのメトリック収集に問題がある場合、『Oracle Enterprise Manager Oracle Fusion Middleware Managementスタート・ガイド』を参照してください。

注意:
Oracle Service Busサービスのメトリックが最初にEMにアップロードされたとき、値は0です。メトリックが収集されない場合、Oracle Service Busコンソールの「グローバル設定」を使用して、監視フラグをOnにします。
また、Oracle Service Busのプロキシ・サービス/ビジネス・サービス用の別の監視フラグ(操作の設定内)がある場合、これらを有効にしてすべてのサービスのためにメトリックを収集します。

17.2.3.2 BPEL PM

EM統合では、タイプがDeployment:BPELであり、EM内のendpointURIメトリックと一致するendpointURI属性を持つEndpointアセットに対してEntryPointリレーションシップを持つ、Oracle Enterprise Repositoryの既存のアセットを更新します。EMでは、エンドポイントのWSDLの場所が格納されます。

一致するendpointURIを持つEndpointアセットが見つからない場合、ツールはWSDLの修飾名で、一致するサービス・アセットを検索しようとします。見つかった場合、新しいEndpointアセットを作成し、これをサービスに関連付けます。

Deployment:BPELアセットが見つからない場合、ツールは一致するBusiness Process: BPELアセットをプロセス名で検索しようとします。見つかった場合、新しいDeployment:BPELアセットを作成し、これをサービスに関連付けます。

17.2.3.3 WebLogic Webサービス

EM統合では、タイプがEndpointであり、EM内のendpointURIメトリックと一致するendpointURI属性を持つ、Oracle Enterprise Repositoryの既存のアセットを更新します。

一致するendpointURIを持つEndpointアセットが見つからない場合、ツールはWSDLの修飾名で、一致するサービス・アセットを検索しようとします。見つかった場合、新しいEndpointアセットを作成し、これをサービスに関連付けます。

17.2.3.4 Oracle SOA Suite 11g

EM統合を行うと、コンポジット・レベルのみでメトリックを発行できます。エンドポイント・アセットがEM 11gで監視されているコンポジット・サービスのためにOERに存在する場合、メトリックはOER内で更新されます。ただし、Oracle Service Bus、BPELまたはWebLogicなどのターゲットと異なり、サービス・エンドポイントがOracle Enterprise Repositoryに存在しない場合、これは統合プロセス中に作成されません。

17.2.3.5 アーティファクトの作成

Oracle Enterprise RepositoryにArtifact:WSDLアセットが存在しない場合、作成されているすべてのEndpointに対して、EM統合ユーティリティでは対応するアセットが作成されます。EM統合ユーティリティでは、任意のインポート済のファイル用にArtifact:WSDLアセットとArtifact:XSDアセットも作成されます。Oracle Enterprise Repository内の既存のアーティファクトを検索するには、Oracle Enterprise Repositoryハーベスタのフィンガープリント・ルールに従います。

17.2.3.6 エンドポイントの作成

本番エンドポイントがOracle Enterprise Repositoryで取得されていない場合でも、通常、これらをEMで監視できます。一致するサービスを見つけることができて、Deployment:BPELアセットを作成した場合や、一致するBusiness Process:BPELを見つけることができた場合、EM統合ユーティリティはエンドポイント・アセットを作成します。

17.2.3.7 更新するメトリック

EM統合では、デフォルトの構成で、Oracle Enterprise Repositoryの次のメトリックを更新しようとします。Oracle Enterprise RepositoryのWebユーザー・インタフェースの「運用」タブでアセットをすべて表示できます。

前述のターゲット・タイプのすべてについて、これらのメトリックのすべてがEMで収集されるわけではないので、一部は除外されることがあります。em-integration-settings.xmlファイルでは、どのターゲットのどのメトリックを収集するかを構成します。

関連項目:
17.3.2.1項「メトリックのマッピング」

- 日次平均レスポンス時間

- 週次平均レスポンス時間

- 月次平均レスポンス時間

- 最小レスポンス時間

- 最大レスポンス時間

- 日次リクエスト

- 週次リクエスト

- 月次リクエスト

- 日次障害

- 週次障害

- 月次障害

- 可用性 - 日次%

- 可用性 - 週次%

- 可用性 - 月次%

- 現在の最大リクエスト/秒

- メトリック監視の開始日

- 最終更新日時

- EMの詳細メトリックへのリンク

17.3 Enterprise Manager統合ユーティリティの構成

この項では、Enterprise Manager統合ユーティリティの構成方法について説明します。

17.3.1 コマンド行ユーティリティのリポジトリおよびEnterprise Manager接続情報の設定

<EM Integration Home> (12.1.3.0.0-EM-Integration.zipファイルを解凍したディレクトリ)にあるem-integration-settings.xmlファイルを開き、適切な資格証明でOracle Enterprise Repositoryインスタンス、EMデータベースおよびWebコンソールを指す次のXMLチャンクを変更します。

EMデータベースを使用して、Oracle Enterprise Repositoryに送信されるメトリック情報を取得します。EMコンソールのURLは、EMへのリンクのベースURLとして使用されます。これはOracle Enterprise Repository内で作成されます。

ユーティリティが作成する任意のエンドポイント・アセットのプロパティを構成するには、introspectionSettingsセクションを使用します。createMissingEndpoints属性は、EMがエンドポイントまたはDeployment:BPELを監視するが、一致するサービスに対応するアセットがOERに存在しないシナリオで、エンドポイント・アセットとDeployment:BPELアセットを作成するかどうかを示します。それ以外の場合、次のコードの残りのセクションは無視されます。

matchMultipleEndpoints属性は、ユーティリティで、EMのターゲットと一致する複数のエンドポイント・アセットまたはDeployment:BPELアセットがOracle Enterprise Repositoryで見つかった場合、実行する必要のあるアクションを示します。見つかった場合、メトリックですべてのエンドポイントを更新します(および警告をログに記録します)。見つからなかった場合、ターゲットをスキップします(および警告をログに記録します)。

matchMultipleServices属性は、エンドポイントの作成時に、ユーティリティで、EMのターゲットと一致する複数のサービスまたはBusiness Process:BPELアセットがOracle Enterprise Repositoryで見つかった場合、実行する必要のあるアクションを示します。見つかった場合、一致するそれぞれのアセットに新しいエンドポイントまたはDeployment:BPELをアタッチします(および警告をログに記録します)。見つからなかった場合、ターゲットをスキップします(および警告をログに記録します)。

introspectionDescription、introspectionVersionおよびregistrationStatus属性は、作成された任意のアセットに設定されているプロパティを示します。

例17-1 em-integration-settings.xmlのリポジトリおよびEnterprise Manager接続情報の設定

<repository>
<uri>http://localhost:7131/oer30/services/FlashlineRegistry</uri>
<credentials>
<user>admin</user>
<password>*****</password>
<enableTransaction>false</enableTransaction>
<triggerEvent>false</triggerEvent>
</credentials>
<timeout>120000</timeout>
</repository>
<introspectionSettings>
<createMissingEndpoints>true</createMissingEndpoints>
<introspectionDescription>Found in EM </introspectionDescription>
<introspectionVersion>1.0</introspectionVersion>
<namespace>mythings</namespace>
<!-- The Valid Registration states are 1)Unsubmitted 2)Submitted - Pending
Review 3)Submitted - Under Review 4) Registered -->
<registrationStatus>Submitted</registrationStatus>
</introspectionSettings>
<emDatabase>
<driverClass>oracle.jdbc.driver.OracleDriver</driverClass>
<url>jdbc:oracle:thin@remotehost.there.com:1501:mysid</url>
<credentials>
<user>sysman</user>
<password>*****</password>
</credentials>
</emDatabase>

注意:
アセットの表示、編集、承認および登録を行うための基本的なアクセス権が設定されたユーザーとしてEnterprise Manager統合ユーティリティを実行することをお薦めします。

また、次のように接続情報をコマンド行ユーティリティにパラメータとして渡すこともできます。

C:\test\em-integration> em-integration - er_url http://localhost:7101/oer/services/FlashlineRegistryTr -er_user admin -em_url jdbc:oracle:thin:@remotehost.there.com:1501:mysid - em_user sysman

注意:
セキュリティを確実にするために、パスワードはコマンド行では渡さず、暗号化する必要があります。詳細は、17.4項「構成ファイルのパスワードの暗号化」を参照してください。

17.3.2 拡張構成

この項では、Enterprise Manager統合ユーティリティの次の拡張構成オプションについて説明します。

17.3.2.1 メトリックのマッピング

図17-2で示すように、EMのメトリックとOracle Enterprise Repositoryのフィールド間のマッピングはem-integration-settings.xmlで構成されます。これらをデフォルト設定から変更するには、このファイルを開いて、次のように変更します。

- <metricMappingGroup>: EMデータベース・ビューで同じメトリック名を持つメトリック・セット用のマッピング。EMでは、関連するメトリック・セットを同じメトリック名でグループ化します。個々のメトリックには異なるメトリック列があります。この要素には次の属性があります。

- metricName: EMデータベース・ビューのEMメトリック名。

- <metricMapping>: 単一のメトリックのマッピング。この要素には、次の属性があります。

- metricColumn: EMデータベース・ビューのEMメトリック列。

- rollupPeriod: EMデータベース・ビューの問合せの対象およびデータの集計方法を示します。DAILY、WEEKLY、MONTHLY、CURRENTのいずれかです。

- viewColumn: データをプルする、EMデータベース内の列を示します。VALUE、AVERAGE、SUM、MINIMUM、MAXIMUM、STANDARD_DEVIATION、SAMPLE_COUNT、COLLECTION_TIMESTAMP、ROLLUP_TIMESTAMP、NOW()、DETAILS_URLのいずれかです。

- ロールアップ期間がCURRENTの場合、AVERAGE、SUM、MINIMUM、MAXIMUM、STANDARD_DEVIATION、SAMPLE_COUNTまたはROLLUP_TIMESTAMP列はサポートされていません。

- ロールアップ期間がDAILY、WEEKLYおよびMONTHLYの場合、VALUEまたはCOLLECTION_TIMESTAMP列はサポートされていません。

- NOW()は、EMに対する問合せの時間が含まれる仮想の列です。

- DETAILS_URLは、EM内の詳細情報のURLが含まれる仮想の列です。これは、EM統合コードによって作成されます。EMデータベース・ビューにはありません。

- oerField: カスタム・データが格納される、Oracle Enterprise Repository内のカスタム・データ・フィールドの内部名。

- overwrite: Oracle Enterprise Repository内のカスタム・データ・フィールドがすでに存在する場合に、これを上書きするかどうかを示します。trueまたはfalseを指定します。指定されていない場合、デフォルト値はtrueです。

図17-2 メトリックのマッピング

17.3.2.2 ターゲット・ファインダ

Oracle Enterprise Repository内のアセットと関連するEM内のターゲットのロジックは、各ターゲット・タイプで異なっています。EM統合には、Oracle Service Bus、BPEL-PM、WebLogicのためのターゲット・ファインダがあります。

上級ユーザーの場合、専用のターゲット・ファインダ・クラスを作成できます。図17-3で示すように、これらはem-integration-settings.xmlで構成する必要があります。

- <targetFinder>: EM内のターゲット・タイプ用のターゲット・ファインダ・クラスへのマッピング。この要素には次の属性があります。

- targetType: EMデータベース・ビューのEMターゲット・タイプ。

- targetFinderClass: ファインダ・クラスの完全修飾クラス名。これは、em-integration.jar内にあるcom.oracle.oer.integration.em.TargetFinderを実装する必要があります。

図17-3 ターゲット・ファインダ

17.3.2.3 ロギング

EM統合では、実行される詳細タスクをロギングするためにlog4jを使用します。このログ・ファイルは<EM Integration Home>にあります。ロギング・オプションの変更は、<EM Integration>フォルダにあるlog4fl.propertiesファイルを更新して行うことができます。

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

セキュリティを確実にするために、Enterprise Manager統合ユーティリティを実行する前に、構成ファイル内のパスワードを暗号化する必要があります。次の方法のいずれかを使用して、EMの構成ファイルのパスワードを暗号化できます。

- コマンド・プロンプトによる方法

- Oracle Enterprise Repository Webコンソールによる方法

コマンド・プロンプトによる方法

1. <em_integration_home>ディレクトリに移動します。

2. 次のように、コマンド・プロンプトからパスワード暗号化ツールを実行します。
> encrypt.bat em-integration-settings.xml em-integration-settings.xml

<Oracle_home>/oer/modules/tools/solutions/12.1.3.0.0-OER-PasswordTools.zipにある、パスワード暗号化ツール(encrypt.batまたはencrypt.sh)を使用すると、構成ファイルem-integration-settings.xmlに格納されているパスワードを暗号化できます。

Oracle Enterprise Repository Webコンソールによる方法

1. 次の場所にあるOracle Enterprise Repository Webコンソールに移動します。
http://<host>:<port>/<domain>/diag/encryptstrings.jsp (使用しているコンピュータの資格証明に合ったホスト、ポートおよびドメインに置き換えます)

2. 「ツール」セクションにスクロールして、パスワードの文字列の暗号化リンクをクリックし、パスワードの暗号化ページを表示します。

3. クリア・テキストのパスワードを暗号化する文字列テキスト・ボックスに入力します。

4. 「問合せの発行」ボタンをクリックします。

5. 暗号化されたパスワード文字列をコピーして、適切なコンテキスト・ファイルまたはプロパティ・ファイルに貼り付けます。

17.5 既知の問題

この項では、次の既知のEnterprise Manager統合ユーティリティの問題について説明します。

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

不正な暗号化パスワードでem-integration-settings.xmlファイルを構成した場合、非常に長いスタック・トレースが表示されます。非常に長いスタック・トレースは、次のとおりです。

at org.apache.xerces.impl.XMLNSDocumentScannerImpl.scanStartElement
(Unknown Source)
at org.apache.xerces.impl.XMLDocumentFragmentScannerImpl$FragmentConten
Dispatcher.dispatch(Unknown Source)
at org.apache.xerces.impl.XMLDocumentFragmentScannerImpl.scanDocument
(Unknown Source)
at org.apache.xerces.parsers.XML11Configuration.parse(Unknown Source)
at org.apache.xerces.parsers.DTDConfiguration.parse(Unknown Source)
at org.apache.xerces.parsers.XMLParser.parse(Unknown Source)
at org.apache.xerces.parsers.AbstractSAXParser.parse(Unknown Source)
at javax.xml.parsers.SAXParser.parse(SAXParser.java:395)
at org.apache.axis.encoding.DeserializationContext.parse
(Deserialization
Context.java:227)
at org.apache.axis.SOAPPart.getAsSOAPEnvelope(SOAPPart.java:696)
at org.apache.axis.Message.getSOAPEnvelope(Message.java:424)
at org.apache.axis.handlers.soap.MustUnderstandChecker.invoke(MustUnder
tandChecker.java:62)
at org.apache.axis.client.AxisClient.invoke(AxisClient.java:206)
at org.apache.axis.client.Call.invokeEngine(Call.java:2765)
at org.apache.axis.client.Call.invoke(Call.java:2748)
at org.apache.axis.client.Call.invoke(Call.java:2424)
at org.apache.axis.client.Call.invoke(Call.java:2347)
at org.apache.axis.client.Call.invoke(Call.java:1804)
at com.flashline.registry.openapi.service.v300.FlashlineRegistryTrSoap
BindingStub.authTokenCreateWithLicense(FlashlineRegistryTrSoapBindingStub.
java:741)at com.oracle.oer.sync.plugin.writer.oer.ALERConnectionCache.
getAuthToken(ALERConnectionCache.java:128)
at com.oracle.oer.sync.plugin.writer.oer.ALERAssetQueries.getToken
(ALERAssetQueries.java:82)
at com.oracle.oer.sync.plugin.writer.oer.ALERAssetQueries.assetTypeQuery
ByUUID(ALERAssetQueries.java:159)
at com.oracle.oer.sync.framework.MetadataManager.putAssetType
(MetadataManager.java:204)atcom.oracle.oer.sync.framework.impl.
DefaultPluginManager.processIntrospector(DefaultPluginManager.java:104)
... 5 more

18 メトリックの構成

この章では、組織のメトリックを構成する方法について説明します。

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

- 18.1項「概要」

- 18.2項「アセット・タイプの要素の検証」

- 18.3項「データベースに対する問合せの実行」

18.1 概要

この項では、Oracle Enterprise Repositoryで使用できるメトリックの拡張について説明します。このガイドの情報は、メトリック・フィールドがないアセット・タイプにメトリック・フィールドを追加するユーザーに役立ちます。このガイドで説明するメトリック・フィールドは、合計開発時間(TDH)、本番投資(Pinv)、消費係数(Cfac)、年間再利用機会の予測数(n)および1時間当たりの間接費配賦率(B)です。これらのフィールドは、通常、アセット・エディタの「メトリック」タブに表示されます。

18.1.1 メトリック要素

この項では、メトリック要素をタイプに追加する方法について説明します。これらのメトリックは、各アセットの価値を予測し、アセット・ポートフォリオのROIを判断するために使用します。

合計で5つのメトリック要素を追加する必要があり、「開発時間」要素がタイプにすでに存在している必要があります。存在しない場合または削除されている場合は、これも追加する必要があります。必要な変更はタイプ・マネージャおよびデータベースで行います。ここでは、両方の手順について説明しています。新しいメトリック要素を次に示します。

- 合計開発時間(TDH) - このアセットを作成するために費やされる開発作業の合計。

- 本番投資(Pinv) - アセットの構築または収集や、アセットを再利用可能にするためのパッケージ化およびドキュメント化に関係する追加の時間または作業。この値は、アセットを1回の使用を目的として構築するために最初に必要となった時間に占める割合として表されます。

- 消費係数(Cfac) - アセット・コンシューマがアセットの検索、評価および使用に費やす時間であり、アセットを最初から構築するために必要な時間の割合として表されます。

- 年間再利用機会の予測数(n) - 1年間にアセットが使用される回数の予測を示します。

- 1時間当たりの間接費配賦率(B) - アセットを作成した個人の1時間当たりの間接費。

メトリックは、システムに追加された他のアセット・タイプに加えて、次の10個の基本アセット・タイプに含まれている必要があります。

- アプリケーション

- ビジネス・プロセス

- 通信アダプタ

- コンポーネント

- 環境

- フレームワーク

- パターン

- プロセス

- サービス

- XMLスキーマ

18.1.2 再利用可能なメトリックのタブの追加

Oracle Enterprise Repositoryを初めてインストールしている場合は、この手順を実行する必要はありません。これらのメトリックが含まれていなかった古いバージョンの製品にのみ、再利用メトリックを追加する必要があります。この手順は、アセット・エディタで実行されます。

このテキストを使用し、要素名を切り取って貼り付けます。

- 合計開発時間(TDH)

- 本番投資(Pinv)

- 消費係数(Cfac)

- 年間再利用機会の予測数(n)

- 1時間当たりの間接費配賦率(B)

注意:
ValidateMetrics.sqlファイルをデータベースに対して実行する必要があります。

1. 「アクション」メニューで、タイプの管理を選択します。タイプ・マネージャが起動します。

2. タイプ・マネージャのサイドバーから、メトリックの追加先となるタイプを選択します。

3. エディタ・ビューを選択します。

4. タブ・セクションで、「メトリック」をクリックします。

5. 「要素」セクションで、「追加」をクリックします。

6. リストから数値テキスト・フィールドを選択し、「OK」をクリックします。数値テキスト・フィールドの編集ダイアログが表示されます。

7. 要素名をコピーして「表示名」テキスト・ボックスに貼り付けます。

8. 図18-1に示すように、小数点以下の桁数の値を0に変更します。

図18-1 数値テキスト・フィールドの編集ダイアログ

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

10. メトリックごとに手順4 - 9を繰り返します。

11. すべてのメトリックがタイプに追加されたら、「保存」をクリックします。

- 現時点では、「ビューア」タブに要素を追加しないでください。

12. 基本アセット・タイプそれぞれに対して、このプロセスを繰り返します。

18.2 アセット・タイプの要素の検証

アセット・タイプの要素を検証するには、次の手順を実行します。

1. 変更したアセット・タイプのいずれかに属するアセットを選択します。そのようなアセットを見つける最も簡単な方法は、アセット・エディタで「登録済」フォルダを右クリックし、アセット・タイプでソートすることです。

2. アセットの各メトリック要素に一意の値を追加します。図18-2に示すように、推奨値は1、2、3、4および5です。

図18-2 「管理」タブ

3. 編集したアセットのステータス・バーで、アセット名、バージョンおよびアセット・タイプ名を確認します。

4. アセットを保存します。

18.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

18.3.1 dbqueries

この項では、メトリック問合せを実行する手順について説明します。

1. データベースへの接続を開き、前述の6個の問合せを実行します。アセット名、バージョン、アセット・タイプおよびメトリックが結果として返されます。メトリックが返されない場合は、メトリック名が正確にコピーされて貼り付けられていない可能性があります。各メトリックには固有の問合せがあり、これらの問合せは個別に実行することをお薦めします。予測した結果が返されるメトリックは、検証されています。

2. メトリック問合せが失敗した場合は、要素を削除し、手順に従ってメトリック要素を作成して検証し、データベースに対して実行します。選択したアセット・タイプにPNHS要素がない場合は、次に示すように、追加する必要があります。

1. 文字列「開発時間」を追加します。

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

3. 「開発時間」要素を編集し、名前を「実質予測節約時間(PNHS)」に変更します。(メトリック内の要素名は、「開発時間」プログラム関連名に基づきます。)「実質予測節約時間」というラベルがアセット・エディタに表示されます。

3. すべてのメトリックが検証された後、Oracle Enterprise Repositoryのタイプ・マネージャでアセット・タイプを開きます。

4. 「ビューア」タブを選択します。

注意:

- 追加したすべての要素が非表示要素領域に表示されます。

- 実質予測節約時間(PNHS)メトリックのみが、アセット・コンシューマにとって意味があります。

- 実質予測節約時間(PNHS)が概要グループの最初の列に表示されるようにすることをお薦めします。

5. アセット・タイプを保存します。

6. 手順1 - 5を繰り返して、メトリック要素を他のアセット・タイプに追加します。

7. 問合せをテストするために追加されたサンプル・データがある場合は削除し、データを保存します。

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

この章では、進行中のアセット機能を使用して、まだ開発中のアセットの進行状況および可用性を追跡する方法について説明します。

この章は次の項で構成されています:

- 19.1項「概要」

- 19.2項「進行中のアセットの表示」

- 19.3項「進行中のアセットの有効化」

- 19.4項「進行中のアセットの無効化」

- 19.5項「Oracle JDeveloperによる進行中のアセットの表示の有効化」

19.1 概要

Oracle Enterprise Repositoryの進行中のアセット機能を使用すると、ユーザーは、まだ開発中のアセットの進行状況および可用性を追跡できます。これにより、組織は、アセットのプロデューサ、コンシューマおよびメンテナンス・チームをコラボレーション・プロセスに関与させることで生産性において複合的なメリットを実現し、ソフトウェア・エンジニアリングの自然な過程でアセット・ポートフォリオの価値を高めることができます。組織では、この機能により、開発が重複して行われることを事前に防ぐことができます。まだ開発中のアセットを公開することで、プロジェクトでは、これらのアセットをプロジェクト計画で使用でき、重複した開発に時間と労力が無駄に使用されないようにできます。

進行中のアセットは、未登録のアセットとしてOracle Enterprise Repositoryに表示されます。進行中の任意のアセットの実際の登録ステータス(検索結果およびアセット詳細の「ステータス」列で示される)は、アセット発行時に決定されます。

進行中のアセット機能が有効な場合、Oracle Enterprise Repositoryの「アセット」画面のアセットの発行リンクで発行されたアセットには、未登録ステータスが自動的に割り当てられます。これらは、未登録のアセットを対象にフィルタ処理された検索で表示されます。

図19-1 Oracle Enterprise Repositoryの「アセット」画面

図19-1に、Oracle Enterprise Repositoryの「アセット」画面を示します。アセットの発行で発行されたアセットは、図19-2に示すように、アセット・エディタのファイル・ツリーの「発行済」 - 「レビュー保留」フォルダに入れられます。

図19-2 アセット・エディタ - ファイル・ツリー

アセット・エディタで発行されたアセットは、図19-3に示すように、初期状態リストで未発行または発行済 - レビュー保留として示される場合があります。

図19-3 アセットの新規作成

どちらの状態のアセットも、未登録のアセットとしてOracle Enterprise Repositoryに入れられ、未登録のアセットを対象にフィルタ処理された検索で表示されます。

19.2 進行中のアセットの表示

進行中のすべてのアセットのリストを表示します。

この手順は、Oracle Enterprise Repositoryの「アセット」画面で実行されます。

1. 「検索文字列の入力」テキスト・ボックスは空白のままにします。

2. 「タイプ」リストで「すべてのタイプ」を選択します。

3. アセット機能リストですべてのアセット機能を選択します。

4. 図19-4に示すように、「登録状態」リストから未登録を選択します。

図19-4 「検索」ダイアログ

5. 「検索」をクリックします。進行中のすべてのアセットのリストが、メイン・ペインの上部フレームに表示されます。

19.3 進行中のアセットの有効化

進行中のアセットをアクティブにするには、2つのプロパティを有効にする必要があります。この手順は、Oracle Enterprise Repositoryの「管理」画面で実行します。

1. 左ペインの「システム設定」をクリックします。

2. 「検索」フィールドに進行中のアセットと入力します。図19-5に示すように、機能設定ペインに進行中のアセット設定が表示されます。

3. プロパティをTrueに設定します。

4. 「保存」をクリックします。

5. 新しいシステム設定の有効化テキスト・ボックスにcmee.asset.in-progress.visibleを入力します。

6. 「有効化」をクリックします。図19-5に示すように、機能設定ペインに進行中のアセットの表示プロパティが表示されます。

図19-5 進行中のアセットのプロパティ

7. プロパティをTrueに設定します。

8. 「保存」をクリックします。図19-6に示すように、「登録状態」リストがOracle Enterprise Repositoryの「アセット」画面の「検索」セクションに表示されます。

図19-6 「検索」ダイアログ

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

oer.newasset.initial.stateを有効にして、デフォルトのアセット・ステータスを設定します。

1. 新しいシステム設定の有効化テキスト・ボックスに、oer.newasset.initial.stateプロパティを入力します。

2. 「有効化」をクリックします。

3. 使用可能なステータス・オプションのいずれかを選択し、「保存」をクリックします。

19.4 進行中のアセットの無効化

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

注意:
進行中のアセット機能を無効にすると、アセット・エディタで、未発行状態のアセットにアクセスできなくなります。発行済 - レビュー保留状態のアセットには、アセット・エディタで引き続きアクセスできます。進行中のアセットを無効にする前に、必要なすべてのアセットを未発行から発行済 - レビュー保留にプロモートさせることをお薦めします。

1. 「システム設定」をクリックします。

2. 進行中のアセット・プロパティをFalseに設定します。

3. 進行中のアセットの表示プロパティをFalseに設定します。

4. 「保存」をクリックします。

19.5 Oracle JDeveloperによる進行中のアセットの表示の有効化

Oracle Enterprise RepositoryオープンAPI (Oracle Enterprise Repository拡張性フレームワークの一部)により、Oracle JDeveloperによる検索結果で、登録済と未登録の両方のアセットを表示することが可能になります。

Oracle Enterprise Repositoryの「管理」ページで次の手順を実行することによって、必要なプロパティを有効にすることができます。

1. 左ペインの「システム設定」をクリックします。

2. 新しいシステム設定の有効化テキスト・ボックスに、プロパティcmee.asset.in-progress.openapi.visibleを入力します。

3. 「有効化」をクリックします。図19-7に示すように、進行中のアセットの表示 - オープンAPIが、メイン・ペインのプロパティのリストに表示されます。

図19-7 進行中のアセットの表示

4. プロパティをTrueに設定します。

5. 「保存」をクリックします。

20 契約管理の構成

この章では、Oracle Enterprise Repositoryで契約管理ソリューション・パックを使用する方法について解説します。

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

- 20.1項「概要」

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

- 20.3項「サービス・プロバイダの手順」

- 20.4項「サービス・コンシューマ向けの手順」

20.1 概要

契約管理では、サービス・プロバイダとコンシューマ間の契約の交渉がサポートされます。また、使用条件(つまり、サービスが提供または使用される条件)、および使用条件に関連した実行時ポリシーの強制も提供されます。

本稼働サービスへのアクセスが非常に重要なあらゆる環境で、サービスを使用するための正式な契約をお薦めします。本稼働サービスにアクセスするコンシューマの意図に関する事前通告を受けることにより、プロバイダはアクセスを明示的に認可し、追加容量を計画し、ポリシーを確実に強制し、すべてのコンシューマに対してサービス・レベルをより簡単に管理できます。

契約管理では次のことが提供されます。

- サービス・プロバイダおよびコンシューマは、サービス・レベルとアクセス要件を規定および交渉して、サービスの使用に関する期待が決定されていない状態を回避できます。

- サービス・プロバイダは、加入してサービスを再利用するコンシューマに関するサービス・レベル、スケーラビリティおよびセキュリティ・リスクを管理できます。

- サービス・プロバイダは、顧客獲得、契約交渉、権利の提供およびポリシーの強制を伴う場合がある複雑な手順を自動化できます。

- ポリシー管理者は、契約に指定されているように、ビジネスに必要なポリシーを強制するよう通知されます。

20.1.1 前提条件

- Harvester Solution Pack (12.1.3.0.0-OER-Harvester-Solution-Pack.zip)

- ポリシー・ソリューション・パック(Policy-Management-Solution-Pack.zip)

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

サンプルの契約がOracle Enterprise Repositoryベース・データパックに含まれており、Oracle Enterprise Repositoryインスタンスにインポートされます。Oracle Enterprise Repositoryのインポート/エクスポート機能の詳細は、第5章「インポート・エクスポート・ツール」を参照してください。

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

これは標準的な合意であり、コンシューマはこれを使用してプロバイダの指定のサービス・エンドポイントへのアクセスを要求できます。この契約は、[サービス名] Webサービスへのアクセスに関する[コンシューマ]と[プロバイダ]間の合意を表します。

20.3.1 契約の作成

Oracle Enterprise Repositoryのアセット・エディタの「コピー/移行」オプションを使用して、このサンプルに基づいて新しい契約を作成します。アセット・エディタの詳細は、第9章「アセット・エディタの使用」を参照してください。

1. 契約を選択し、「編集」をクリックします。アセット・エディタが表示されます。

2. 「ファイル」メニューから、「コピー/移行」を選択します。「コピー/移行」ダイアログが表示されます。

3. 新しい契約の「名前」および「バージョン番号」を入力します。

4. 「タイプ」リストから「契約」を選択し、初期状態を選択します。

20.3.2 契約の編集

プロバイダ情報および契約に関する追加情報を「概要」タブで入力します。コンシューマ情報のフィールドは変更しないでください。

1. 「概要」タブを選択し、プロバイダ、目的、サービス料および追加フィールドに関する情報を入力します。

2. 「説明」フィールドの大カッコ[]で示されているプレースホルダ・テキストを変更します。

3. 変更を保存します。

20.3.3 リレーションシップの作成

契約の各コピーで、契約で管理されるサービス、WSDLおよびエンドポイント・アセットに対して、分類タブで、規定されるアセットのリレーションシップを作成します。

1. 分類タブを選択し、「リレーションシップ」セクションで「追加」をクリックします。リレーションシップの追加ダイアログが表示されます。

2. 「リレーションシップ・タイプ」として規定されるアセットを選択します。

3. 関連付けるアセットの検索セクションで、検索する用語を入力するか、すべてのアクティブ・アセットをリストを選択します。

4. サービス、WSDLおよびエンドポイント・アセットを選択し、リレーションシップを確認します。

20.3.3.1 使用条件

プロバイダは契約要求を受け取ると、承認のために契約をコンシューマに返信する前に詳細を完成する必要があります。

この契約で管理されるサービス・エンドポイントに使用条件(ポリシー)を適用します。

1. エンドポイントへのコンシューマ・アクセスを提供する前に、エンドポイントがセキュアであることを確認します。

2. 定型のサービス契約のEasyLink URLのコピー(このアセットのコピー)を作成します。EasyLinkの使用の詳細は、『Oracle Fusion Middleware Oracle Enterprise Repository開発者ガイド』のEasyLinkの使用に関する項を参照してください。

3. サービス・アセットに移動し、EasyLink URLを{ここをクリックして、サービス・エンドポイントを使用する契約を要求します}フィールドに貼り付けます。

4. オプション: 契約のコンシューマ・バージョンについて、プロバイダ向けの手順を削除します。コンシューマ向けの手順を削除しないでください。

5. 「概要」タブから、「説明」フィールドを編集してプロバイダ向けの手順テキストを削除します。

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

この契約のコピーを作成します。Oracle Enterprise Repositoryのアセット・エディタの「コピー/移行」を使用して、この契約の独自のコピーを作成します。アセット・エディタの詳細は、第9章「アセット・エディタの使用」を参照してください。

1. 契約を選択し、「編集」をクリックします。アセット・エディタが表示されます。

2. 「ファイル」メニューから、「コピー/移行」を選択します。「コピー/移行」ダイアログが表示されます。

3. 「概要」タブから、コンシューマのフィールドに情報を入力します。プロバイダ情報のフィールドは変更しないでください。

4. 「管理」タブから、「発行」をクリックして契約を発行します。これは、承認および登録のためにプロバイダに対して発行されます。プロバイダによってサービスへのアクセスが付与されると、電子メール通知を受信します。

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

この章では、Oracle Service Registryとの間でメタデータを交換するようにOracle Enterprise Repositoryを構成する方法について説明します。

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

- 21.1項「Oracle Registry Repository Exchange Utilityの使用の開始」

- 21.2項「Oracle Registry Repository Exchange Utilityの構成」

- 21.3項「Oracle Enterprise Repository Exchange Utilityの使用」

21.1 Oracle Registry Repository Exchange Utilityの使用の開始

この項では、Oracle Registry Repository Exchange Utilityを使用する際の基本事項およびユーティリティを使用したサンプル・ユースケースについて説明します。

この項には次のトピックが含まれます:

- 21.1.1項「Oracle Registry Repository Exchange Utilityとは」

- 21.1.2項「サンプル・ユースケース」

21.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に自動的に公開できます。

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

Oracle Registry Repository Exchange Utilityでは、次のメタデータ・エンティティが処理されます。

- すべてのUDDI対応サービス、SCAサービス・タイプ、およびエンド・ユーザーが開発したOracle Enterprise Repositoryアセット・タイプのすべてのカスタム・サービス。

- ビジネス・サービスを提供するビジネス・エンティティ。
Oracle Registry Repository Exchange Utilityがビジネス・エンティティに到達する仕組みの詳細は、21.3.2.1項および21.3.2.2項を参照してください。

- サービスへのアクセス・ポイントとなる「サービス」にリンクされているエンドポイント・アセット。たとえば、ステージングまたは本番としてタグ付けし、UDDIバインディング・テンプレートに適切にマップされる複数のエンドポイントがある場合があります。

- Oracle Enterprise Repositoryのカテゴリ分けはUDDI t-modelにマップされます。カテゴリ分けをサービス・アセットに適用すると、対応するエントリがUDDIカテゴリ・バッグに追加され、適切な分類t-modelにリンクされます。これらのt-modelは、初回検出時にOracle Service Registryに自動的にロードされるか、またはOracle Enterprise Repository Exchange Utilityを使用して手動でロードできます。
詳細は、表21-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によりサービスが他のサービス・レジストリにプロモートされるときに常にそのサービス・キーが使用されます。

21.1.1.2 前提条件

Oracle Registry Repository Exchange Utilityを使用するには、事前に次の前提条件を満たしておく必要があります。

- Oracle Registry Repository Exchange UtilityではJava SDKバージョン6以上が必要になります。

21.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 Registry Repository Exchange Utilityを使用してOracle Enterprise RepositoryのメタデータとOracle Service Registryを同期する場合、エンドポイントの変更が保持されるようにすべての変更がマージされます。

- 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の同期が開始されるようにすることができます。

21.2 Oracle Registry Repository Exchange Utilityの構成

この項では、Oracle Registry Repository Exchange Utilityをインストールして構成する方法について説明します。

この項には次のトピックが含まれます:

- 21.2.1項「Oracle Registry Repository Exchange Utilityのインストールおよび構成」

- 21.2.2項「Oracle Service Registryのインストール」

- 21.2.3項「Oracle Registry Repository Exchange Utilityの構成ファイルの構成」

- 21.2.4項「UDDIマッピング・ファイルでのOracle Enterprise Repositoryのカテゴリ分けの構成」

- 21.2.5項「tModelKey UDDI設定の構成」

- 21.2.6項「Oracle Registry Repository Exchange Utilityのプロパティ・ファイルについて」

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

Oracle Registry Repository Exchange Utilityを使用してOracle Enterprise RepositoryのメタデータをOracle Service Registryに公開したり、Oracle Service Registryから受け取るには、事前に次の構成手順を完了しておく必要があります。

- 21.2.1.1項「Oracle Registry Repository Exchange Utilityのインストール」

- 21.2.1.2項「アセット・タイプ名の使用の構成」

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

デフォルトでは、Oracle Enterprise Repositoryをインストールすると、Oracle Registry Repository Exchange Utilityファイルが次の場所に配置されます。

<Oracle_HOME>\oer\modules\tools\solutions

Oracle Enterprise Repository用のOracle Registry Repository Exchange Utilityファイルは次のとおりです。

- 12.1.3.0.0-RR-ExchangeUtility.zip: Exchange Utilityのパッケージが格納されています。

12.1.3.0.0-RR-ExchangeUtility.zipファイルは、Oracle Enterprise Repositoryをインストールしたファイル・システム上のディレクトリ(通常はOracle_HOME\oer)に解凍できます。Oracle Registry Repository Exchange Utilityが格納されたzipファイルをファイル・システムに解凍すると、次の構造が作成されます。

orrxu  <ExchangeUtility Tool Home>
|      lib

<ExchangeUtility Tool Home>ディレクトリ内には、orrxu.xml、UDDIMappings.xml、orrxu.properties、orrxu.bat、encrypt.batファイルなどのOracle Registry Repository Exchange Utilityファイルが含まれています。

21.2.1.2 アセット・タイプ名の使用の構成

システムにソリューション・パックをインポートするときに、パックとは異なるUUIDを持つ既存のアセット・タイプがある場合、アセット・タイプはバージョン付きで作成されます。orrxu.propertiesファイルではアセット・タイプを名前で指定しているため、結果は不正確になります。これは、新しいソリューション・パックに含まれていたアセット・タイプではなく、すでに存在するアセット・タイプの使用が試行されるためです。

以前のバージョンのOracle Enterprise Repositoryでは、一部のアセット・タイプはソリューション・パックでは作成されず、手動で作成していましたが、このため、生成されるUUIDがランダムでした。

データパックと同名のアセットがすでに存在する場合は、回避策として、システム内のアセットの名前を変更してから新しいデータパックをインポートします。

21.2.2 Oracle Service Registryのインストール

Oracle Service Registryをインストールし、http://host:port/registry/uddi/inquiryなどのUDDI照会URLを取得できます。

Oracle Service Registryのインストールの詳細は、http://download.oracle.com/otndocs/tech/soa/OSR11gR1ProductDocumentation.pdfを参照してください。

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

この項では、Oracle Registry Repository Exchange Utilityの構成ファイルを環境にあわせて構成する方法について説明します。内容は次のとおりです。

- 21.2.3.1項「リポジトリ接続情報の設定」

- 21.2.3.2項「レジストリ接続情報の設定」

- 21.2.3.3項「リポジトリ問合せの設定」

- 21.2.3.4項「宛先レジストリの設定」

- 21.2.3.5項「レジストリ問合せの設定」

- 21.2.3.6項「ソース・レジストリの設定」

21.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>/oer/modules/tools/solutions/12.1.3.0.0-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を実行することをお薦めします。

パスワードの暗号化の詳細は、第12章「パスワードの暗号化」を参照してください。

21.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>/oer/modules/tools/solutions/12.1.3.0.0-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>/oer/modules/tools/solutions/12.1.3.0.0-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>

21.2.3.3 リポジトリ問合せの設定

次の構成スニペットは、Oracle Enterprise Repositoryに対して実行し、Oracle Service Registryに公開する必要のあるサービスのリストを得るための問合せを作成する方法を例示しています。これにより、Oracle Service Registryにプッシュされるサービスが問合せの形式でフィルタ処理されます。いくつかの方法でサービスを問い合せることができ、1つ以上の問合せを作成できます。ここでは、サービスの問合せ方法の一部を紹介します。

- 21.2.3.3.1項「名前による問合せ」

- 21.2.3.3.2項「登録ステータスによる問合せ」

- 21.2.3.3.3項「カテゴリ分けによる問合せ」

- 21.2.3.3.4項「フィルタによる問合せ」

21.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内のすべてのサービスが返されます。

21.2.3.3.2 登録ステータスによる問合せ

<registrationStatus>要素を構成した場合、指定した登録ステータスに当てはまるサービスのみが公開されます。たとえば、このフィールドをRegisteredに設定すると、登録済のサービスのみがOracle Service Registryに公開され、一致するサービスであってもこのステータス以外のものはすべて無視されます。

<registrationStatus>Registered</registrationStatus>

登録ステータスとして指定可能な値は次のとおりです(大/小文字は区別されません)。

- registered

- rejected

- under_review

- pending_review

- submitted

- unsubmitted

- undefined

21.2.3.3.3 カテゴリ分けによる問合せ

<serviceCategorizations>要素を構成した場合、指定したカテゴリ分けに当てはまるサービスのみが公開されます。たとえば、次のカテゴリ分けを使用すると、リリース済のサービスのみがOracle Service Registryに公開されます。

<serviceCategorizations type="AssetLifecycleStage" value="Stage 4 - Release"/>

注意:
serviceCategorizationsのtypeでは、サービス・アセットの分類にあるすべてのカテゴリ分けがサポートされています。次に例を示します。

<serviceCategorizations type="Classification" value="Approved"/>
<serviceCategorizations type="AssetFuntion" value="Governance"/>

21.2.3.3.4 フィルタによる問合せ

必要に応じて、Oracle Enterprise RepositoryからUDDIレジストリにプロモートされるサービスの種類を制限できます。フィルタ要素を使用すると、登録ステータス、サービスのカテゴリ分け、エンドポイントのアセット・ライフサイクルに加えて、サービスのタイプに基づいて選択をさらに絞り込むことができます。構成した場合、指定した基準を満たすサービスのみが公開されます。各<filter>要素ではそれぞれtype、excludeおよびvalueの3つの属性を使用します。

- type (必須フィールド): フィルタにはmetadataとwsdllocationの2つのタイプがあります。

- metadata: Oracle Enterprise Repositoryでは、サービス・アセットにいくつかのタイプのメタデータが使用されます。このデータは、メタデータ・タイプの名前およびフィールドのxpathに基づいてフィルタ処理できます。
サービス・タイプを例として考えます。このメタデータは、ハーベスタによって作成されたすべてのサービスに適用されます。メタデータ・タイプは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の値: remoteまたはlocalです。リモートWSDLを使用するサービスを公開する場合、次のようにします。
<filter type="wsdllocation" value="remote" />

- exclude (オプション・フィールド): excludeフラグの値をtrueに設定した場合、フィルタ基準を満たすサービスを除き、すべてのサービスが公開されます。ローカル・ファイル情報として格納されているWSDLを使用するサービスを除き、すべてのサービスを公開するには、次のようにします。
<filter exclude="true" type="wsdllocation" value="local" />

excludeフラグを設定した場合は、同じタイプのフィルタを複数使用できます。この場合、タイプがビジネス・サービスまたは分割-結合サービスのサービスを検索できます。ただし、excludeフラグを設定しなかった場合は、同じタイプのフィルタを複数指定しても機能しません。この場合、タイプがビジネス・サービスと分割-結合サービスのサービスを検索できません。

検索結果からその基準を除外する場合にのみ、複数のフィルタ基準を組み合せることができます。ビジネス・サービスの除外とプロキシ・サービスの除外は機能します。しかし、ビジネス・サービスの包含とプロキシ・サービスの包含は機能しません。

次に例を示します。

<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のデフォルト構成です。Oracle Service Busからのサービスで、サービス・タイプがプロキシ・サービスではなく、かつ、リモートWSDLを使用するもののみを公開します。

<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とローカルに格納されたWSDLのどちらを使用するかを問わず、タイプがプロキシ・サービスのサービスのみを公開するには、次のようにします。

<filters>
<filter type="metadata.internal.introspector.store/sync/Service_Type" value="Proxy Service" />
</filters>

例3

Webサービスのみを公開し、ビジネス・サービス、プロキシ・サービスおよび分割-結合サービスを除外するには、次のようにします。

<filters>
<filter type="metadata.internal.introspector.store/sync/Service_Type" value="Web Service" />
</filters>

21.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要素を追加してください。

21.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に配置されます。ビジネス・エンティティ名は正確に指定する必要があります。ワイルドカードはサービスに対してのみサポートされており、ビジネス・エンティティに対してはサポートされていません。

警告:

ビジネス・エンティティの問合せとサービスの問合せの両方を指定した場合は、ビジネス・エンティティの問合せがサービスの問合せよりも優先されます。

21.2.3.6 ソース・レジストリの設定

<sourceRegistry>要素では、Oracle Enterprise Repositoryに配置するサービスの取得元のレジストリを指定します。このレジストリは、Oracle Service Registryからサービスを取得し、Oracle Enterprise Repositoryに移動するとき(Oracle Service Registry > Oracle Enterprise Repository)に使用されます。

<sourceRegistry>osr</sourceRegistry>

21.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で受け付けられるようにする必要があります。

21.2.5 tModelKey UDDI設定の構成

この項では、Oracle Enterprise Repositoryで新規カテゴリ分けタイプを作成するときにtModelKey UDDI設定を構成する手順について説明します。

Oracle Service Registryから公開された一部のサービスには、特別なメタデータがカテゴリ分けの形式で含まれており、Oracle Enterprise Repositoryにそのメタデータを取り込む必要があります。これにより、Oracle Enterprise Repositoryにカスタム・カテゴリ分けタイプを作成し、このようなカスタム・カテゴリ分けにバインドできます。

Oracle Registry Repository Exchange Utilityを使用すると、Oracle Service Registryのカスタム・カテゴリ分けをOracle Enterprise Repositoryのカスタム・カテゴリ分けにバインドできます。そのためには、図21-1に示すように、Oracle Enterprise Repositoryでカテゴリ分けタイプを作成するときに、tModelキーv3オプションを使用します。このフィールドには、Oracle Service Registryの関連するカテゴリ分けのtModelキーを入力する必要があります。

図21-1 カテゴリ分けの編集ダイアログ

tModelKey UDDI設定を構成する手順は次のとおりです。

1. アセット・エディタ・ウィンドウで、「アクション」、カテゴリ分けの構成の順に選択します。カテゴリ分けの構成ダイアログが表示されます。この際、Oracle Service Registryのカテゴリ分けを反映したカスタム・カテゴリ分けタイプが作成されます。

注意:
tModelキーv3フィールドは、Oracle Service Registryのサービス・カテゴリのtModelキーであるuddi:oracle.com:aia:service:lifecyclestatusに設定されています。

2. 「追加」をクリックしてカテゴリ分けを追加します。カテゴリ分けの追加ダイアログが表示されます。たとえば、AIA-LifeCylceStatusカテゴリ分けを追加します。

3. 図21-2に示すように、カテゴリ分けの追加ダイアログに値を入力します。

図21-2 カテゴリ分けの追加ダイアログ

4. tModelキーv3フィールドの下にあるペインで「AIA-LifeCycleStatus」を選択し、「追加」をクリックします。カテゴリ分けの追加ダイアログが表示されます。

5. 図21-3に示すように、「名前」フィールドに「Active」と入力します。

図21-3 カテゴリ分けの追加ダイアログ

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

7. 同様に、図21-4に示すように、カテゴリ分けに「Deprecated」、「Obsolete」および「Planned」という値を追加します。

図21-4 カテゴリ分けの追加ダイアログ

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

9. アセット・エディタ・ウィンドウで、「アクション」、タイプの管理の順にクリックします。タイプ・マネージャ・ウィンドウが表示されます。

10. 「サービス」アセット・タイプを選択します。「サービス」アセット・タイプの詳細が右側のペインに表示されます。

11. タブ・ペインで、分類を選択します。分類に対応する要素が「要素」ペインに表示されます。

12. 「要素」ペインの隣にある「追加」ボタンをクリックします。追加する要素タイプの選択ダイアログが表示されます。

13. 図21-5に示すように、「要素タイプ」リストからカテゴリ分け: AIA-LifeCycleStatusを選択します。

図21-5 追加する要素タイプの選択ダイアログ

14. 「OK」をクリックします。カテゴリ分けの編集: AIA-LifeCycleStatusダイアログが表示されます。

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

16. 「ビューア」タブをクリックします。

17. 非表示要素ペインで、「AIA-LifeCycleStatus」を選択し、「グループでの表示」をクリックします。要素の移動ダイアログが表示されます。

18. 図21-6に示すように、AIA-LifeCycleStatusの移動先フィールドで分類を選択します。

図21-6 要素の移動ダイアログ

19. Exchange Utilityツールで、UDDIMappings.xmlファイルを生成します。orrxu.xmlファイルにOracle Enterprise Repositoryインスタンスへの接続情報を指定します。

20. Exchange Utilityツールから、orrxu.bat -mapをインストールします。

21. 新規に作成したOracle Enterprise Repositoryカテゴリ分けがUDDIMappings.xmlファイルに含まれていることを確認します。

図21-7 UDDIMappings.xmlファイル

Oracle Service RegistryのサービスがOracle Enterprise Repositoryに格納されると、Oracle Enterprise Repositoryのサービス・アセットにこのカテゴリ分けの値が設定され、そのアセットがOracle Enterprise RepositoryのWeb UIに表示されるようになります。

21.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つ以上のエンドポイントがない場合、または既存のエンドポイントに無効なアクセス・ポイントがある場合、Exchange Utilityにより公開対象から除外されます。この設定を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のその他のシステム設定の詳細は、第2章「システム設定の概要」を参照してください。

21.2.7 XUサポート

XUをデフォルトのまま使用した場合、Harvester Solution Packに用意されているアセット・タイプを使用してOERからWSDLベースのHTTPサービスを収集し、それをOSRに公開できます。これらのサービスは、そのインタフェース、アーティファクト、エンドポイントおよびシステム供給リレーションシップとともにOSRにレンダリングされ、Oracle Service Busコンソールを含め、OSRに統合されているツールから利用できるようになります。

注意:
特に指定のないかぎり、Oracle Service RegistryではOracle Service Busによってすべてのサービスを利用できます。

表21-1 収集されたWSDLサービスに対するXUサポート

サービス・タイプ/起点

OERのサービス・モデルの内容

XUによりOERからOSRに公開されるか

備考

収集されたWSDLベースのHTTPサービス、WSDLアタッチメント付き

WSDLアーティファクトがインタフェースにアタッチされています。

はい(WSDLがリモートURIを持つ場合)。

サービスを公開するためにエンドポイントは不要ですが、サービスをOSBで利用するためにはエンドポイントが必要です。

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

XUの構成を変更すると、異なるソースを起点とし、異なるモデルを使用するOER内の多様な非WSDL HTTPサービス・タイプも扱えるようになります。

表21-2 手動で作成*されたサービスに対するXUサポート

サービス・タイプ/起点

OERのサービス・モデルの内容

XUによりOERからOSRに公開されるか

備考

収集ではなく、手動で作成されたWSDLベースのHTTPサービス、アタッチメント付き

WSDLアーティファクトがインタフェースに手動でアタッチされています。

はい(WSDLがリモートURIを持つ場合)。

サービス、インタフェース、エンドポイント、WSDLアーティファクトを扱うSOAモデルと整合したモデルであれば、異なるアセットやリレーションシップを使用してXUマッピング・ファイルでマップできます。

手動で作成された非WSDLベースのHTTPサービス、XSDアタッチメント付き

XUでマップされたリレーションシップに基づいて、XSDアーティファクトまたは類似のアーティファクトがインタフェースに手動でアタッチされています。インタフェース・タイプは定義されていません。

はい(XSDがリモートURIを持つ場合)。XSDは、tModel: uddi-org:resource:typeに値xsdを設定することで公開されます。

- XSDはOSBでは利用されません。

- 入力XML/出力XMLを使用するメッセージング・サービス・タイプとして公開されます。

手動で作成された非WSDL HTTPサービス、アーティファクト付き(WADLを使用したRESTなど)

XUでマップされたリレーションシップに基づいて、様々なタイプのアーティファクト(WADLなどの非XSD)がインタフェースにアタッチされています。

はい(アーティファクトがリモートURIを持つ場合)。アーティファクトは、tModel: uddi-org:resource:typeに値xmlを設定することで公開されます。

- XSDはOSBでは利用されません。

- 入力XML/出力XMLを使用するメッセージング・サービス・タイプとして公開されます。

手動で作成された非WSDL HTTPサービス、アーティファクトなし(RESTなど)

XSDまたは類似のアーティファクトはアタッチされていません。

はい

入力XML/出力XMLを使用するメッセージング・サービス・タイプとして公開されます。

注意:
OERに手動で作成されたサービス(収集されたもの以外)をOracle Service Busで利用可能な形式でOSRに公開するには、少なくともエンドポイントとインタフェースが必要です。
*REX APIを使用して作成されたサービスにも当てはまります。

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

XUの構成を変更すると、異なるソースを起点とし、異なるモデルを使用するOER内の多様な非WSDL HTTPサービス・タイプも扱えるようになります。

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

サービス・タイプ/起点

OERのサービス・モデルの内容

XUによりOERからOSRに公開されるか

備考

OSBから収集されたWSDLベースのHTTPサービス、WSDLアタッチメント付き

WSDLアーティファクトがインタフェースにアタッチされています。

はい(WSDLがリモートURIを持つ場合)。

OERハーベスタによって収集されたWSDLサービスと似ています。

OSBから収集された非WSDLベースのHTTPサービス

あらゆるXMLが扱われます(RESTは扱われません)。

はい

OSBから収集された非WSDLベースのHTTPサービス

あらゆるSOAPが扱われます(RESTは扱われません)。

はい

OSBから収集された非WSDLベースのHTTPサービス

MFLを使用したメッセージングのみが扱われます。MFLアーティファクトがアタッチされています。

いいえ

- OSRでOSBにより利用することはできません。

- OERではMFLアーティファクトはリモートURIを持ちません。

OSBから収集された非WSDLベースのHTTPサービス(RESTプロキシ・サービスを含む)

MFLを除くすべてのメッセージングが扱われます。XSDアーティファクトは状況に応じて扱われます。

はい。ただし、リモートURIを持たないXSDアーティファクトは公開されません。

OSBから収集されたREST HTTPビジネス・サービス

XSDアーティファクトまたは類似のアーティファクトはアタッチされていません。

OSRでOSBにより利用することはできません。

注意:
サービスをOracle Service Busで利用可能な形式でOSRに公開するには、少なくともエンドポイントとインタフェースが必要です。

非WSDLサービスまたは手動で作成されたサービスをXUセッションで公開する際には、XUでマップされたリレーションシップ(インタフェースとアーティファクトのリレーションシップなど)を1つのタイプにかぎり使用できます。これは、収集されたWSDLベースのサービスに対しても同時にサポートされます。XUでは、指定されたシステム供給リレーションシップ(システム供給または手動指定のいずれか)に基づいて非WSDLサービスを公開できますが、同時に扱えるタイプは1つのみです。

21.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タイプの名前は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レジストリに公開するサービスのアクセス・ポイントを手動で移入する必要があります。

例21-1 WSDLにおけるサービス定義

<service name="OERSearchService">
<port name="OERSearchPort" binding="typens:OERSearchBinding">                          <soap:address location="http://api.oracle.com/search/oer"/>                   </port>      </service>

21.3 Oracle Enterprise Repository Exchange Utilityの使用

この項では、Oracle Registry Repository Exchange Utilityを使用してメタデータを同期したり、交換されたメタデータをOracle Enterprise Repositoryで検索する方法について説明します。

この項には次のトピックが含まれます:

- 21.3.1項「Oracle Registry Repository Exchange Utilityの実行」

- 21.3.2項「交換されるメタデータの同期方法」

- 21.3.3項「Oracle Service Registryとの間で交換されたメタデータのOracle Enterprise Repositoryでの検索」

- 21.3.4項「Oracle Registry Repository Exchange Utilityのログ・ファイルの確認」

- 21.3.5項「既知の問題」

21.3.1 Oracle Registry Repository Exchange Utilityの実行

Oracle Registry Repository Exchange Utilityは、次の構文を使用してコマンド・プロンプトから実行します。

> orrxu.bat <options>

表21-4に、Oracle Registry Repository Exchange Utilityの実行時に使用できる構成オプションの定義を示します。

表21-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>

オプション

Oracle Enterprise Repositoryに接続し、構成済のカテゴリ分けに基づいてt-modelを移入することによって、UDDIMappings.xmlファイルを生成します。また、-configパラメータを使用して、デフォルトの場所からOracle Registry Repository Exchange Utilityの構成をロードします。Oracle Service Registryにt-modelがすでに存在する場合は、このファイルをカスタマイズして、Oracle Enterprise Repositoryのカテゴリ分けをt-modelにマップできます。

使用例: orrxu.bat -map c:/rm/uddi

UDDIMappings.xmlファイルの詳細は、21.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ファイルの詳細は、21.2.4項「UDDIマッピング・ファイルでのOracle Enterprise Repositoryのカテゴリ分けの構成」を参照してください。

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

ワークフローを使用してOracle Registry Repository Exchange Utilityを起動すると、Oracle Enterprise RepositoryとOracle Service Registryの同期を自動化できます。

この項には次のトピックが含まれます:

- 21.3.1.1.1項「前提条件」

- 21.3.1.1.2項「タイマー・ベースのワークフローを使用した同期」

- 21.3.1.1.3項「イベントのトリガー時の同期」

- 21.3.1.1.4項「サンプル・ユースケース」

workflow.xmlファイルおよびワークフローの構成の詳細は、第13章「Oracle Enterprise Repositoryエクスプレス・ワークフローの構成」を参照してください。

21.3.1.1.1 前提条件

この項では、Oracle Registry Repository Exchange Utilityワークフローを実行するための前提条件となる構成手順について説明します。

1. <Oracle_HOME>\oer\modules\tools\solutionsからOracle Registry Repository Exchange Utilityソリューション・パック12.1.3.0.0-RR-ExchangeUtility.zipをダウンロードします。

2. zipファイルを解凍し、その中に含まれている次のファイルを<Oracle_Home>\obpm\enterprise\server\aler_engineディレクトリにコピーします。

- plugins

- orrxu.properties

- orrxu.xml

- log4fl.properties

- types.properties

- UDDIMappings.xml

これらのファイルは、Oracle BPMからOracle Registry Repository Exchange Utilityワークフローを実行するために必要です。

3. orrxu.xmlの構成として、イベントの生成元となるOracle Enterprise RepositoryインスタンスとOracle Service Registryインスタンスの接続情報、さらにアセットの公開/受取りに関する情報を指定します。

4. ファイル内のパスワードが暗号化ツールにより暗号化されるようにします。

21.3.1.1.2 タイマー・ベースのワークフローを使用した同期

タイマー・ベースのワークフローを使用すると、Oracle Service RegistryからOracle Enterprise Repositoryへの同期、またOracle Enterprise RepositoryからOracle Service Registryへの同期が可能になります。

表21-5に、タイマー・ベースのワークフローの名前と説明を示します。

表21-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>

21.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フォルダに保存されます。

異なるレジストリを参照するように構成された複数の構成ファイルを使用することもできます。ライフサイクルによっては、アセット・ライフサイクル・トリガーに基づいて別のレジストリにサービスを移動できます。

21.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に移動されます(そのように構成されている場合)。

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

この項では、Oracle Enterprise RepositoryとOracle Service Registryとの間でアセットが交換されるときのメタデータの同期方法について説明します。この項には次のトピックが含まれます:

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

- 21.3.2.2項「Oracle Service RegistryからOracle Enterprise Repositoryへのメタデータの同期」

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

この項では、Oracle Enterprise RepositoryからOracle Service Registryにアセットを公開するときのメタデータの同期方法について説明します。内容は次のとおりです。

- 21.3.2.1.1項「ビジネス・エンティティ」

- 21.3.2.1.2項「サービス・キー」

- 21.3.2.1.3項「エンドポイント」

- 21.3.2.1.4項「カテゴリ分け」

- 21.3.2.1.5項「登録ステータスおよびアクティブ・ステータス」

- 21.3.2.1.6項「Oracle Enterprise RepositoryからOracle Service Registryへのメタデータのサンプル・フロー」

注意:
以前に同期されたサービスをOracle Service Registryと同期するときに、Oracle Service Registryブラウザ・インスタンスがすでに開いている場合、更新された値は表示されません。そのため、更新された値を参照するには、すべてのOracle Service Registryブラウザ・インスタンスを再起動する必要があります。
詳細は、21.3.5項「既知の問題」を参照してください。

21.3.2.1.1 ビジネス・エンティティ

公開対象のサービス・アセットに関連する(構成済のリレーションで指定されている)ビジネス・エンティティ・アセットが存在するかどうかを確認します。

- 存在する場合は、構成済のリレーションを使用して、既存のビジネス・エンティティ・アセットを新規に作成されるサービス・アセットに関連付けます。

- 存在しない場合は、次に示すように、デフォルトのビジネス・エンティティ名を構成から取得します。

- デフォルトのビジネス・エンティティ・アセットがOracle Enterprise Repositoryのシステム設定で構成されているかどうかを確認します。

- 構成されている場合は、それをデフォルトのビジネス・エンティティとして使用します。

- 構成されていない場合は、orrxu.propertiesファイル内のデフォルトのビジネス・エンティティ名を使用します。

21.3.2.1.2 サービス・キー

サービスをOracle Service Registryに公開すると、Exchange Utilityにより新しいサービス・キーが自動的に生成され、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レジストリを選択します。また、このプラグインを「ビューア」タブに追加してください。

21.3.2.1.3 エンドポイント

次に示すように、公開対象のサービス・アセットに関連するエンドポイント・アセットが1つ以上存在するかどうかを確認します。

- 存在する場合は、UDDIバインディング・テンプレートを作成します(初回のみ)。以前に同期したことがある場合は、既存のバインディング・テンプレートを更新します。UDDIアクセス・ポイントに到達するには、エンドポイント・アセットでエンドポイントURIを使用します。エンドポイント・アセットのファイル情報にアタッチされているWSDLからポートを導出します。WSDLがOracle Enterprise Repositoryにローカルに格納されている場合は、Oracle Service Registry内の既存のバインディング・テンプレートは更新されません。

- 存在しない場合は、サービス・アセットのファイル情報にアタッチされているWSDLに基づいてバインディング・テンプレートを作成します(WSDLにポート情報が含まれている場合)。バインディング・テンプレートはリモート(http://)にあるWSDLに対してのみ作成されます。Oracle Enterprise Repositoryにローカルに格納されているWSDLは対象外です。

- アセット・ライフサイクルがエンドポイントにアタッチされていて、エンドポイント・アセット・ライフサイクル問合せが使用される場合は、アセット・ライフサイクルに基づいてエンドポイントをフィルタ処理します。たとえば、ステージング・エンドポイントをステージング・レジストリに公開し、本番エンドポイントを本番レジストリに公開できます。

21.3.2.1.4 カテゴリ分け

次に示すように、サービス・アセットおよびエンドポイント・アセットに適用されるカテゴリ分けが存在するかどうかを確認します。

- 存在する場合は、適用される各カテゴリ分け用のカテゴリ分けマッピングをUDDIMappings.xmlファイルからロードします。

- マッピングが見つかった場合は、カテゴリ・バッグ(ビジネス・サービスまたはバインディング・テンプレートのいずれか)にエントリを追加します。

- t-modelがOracle Service Registryに見つからなかった場合は、自動的にt-modelを作成します。

- 存在しない場合は、Oracle Service Registry内のサービスにカテゴリ分けは適用されません。

21.3.2.1.5 登録ステータスおよびアクティブ・ステータス

登録ステータスおよびアクティブ・ステータスはカテゴリ・バッグに追加されます。図21-8に、参照がOracle Service Registryでどのように表示されるかを示します。

図21-8 Oracle Service RegistryにおけるWSDLサービスのt-modelカテゴリ

図21-9に、Oracle Enterprise Repository内のサービスにリンクされている2つのエンドポイントがOracle Service Registryでどのように表示されるかを示します。

図21-9 Oracle Service RegistryにおけるWSDLバインディング

図21-10および図21-11に、異なるエンティティとそれらのリレーションシップがOracle Enterprise Repository Navigatorでどのように表示されるかを示します。

図21-10 Oracle Enterprise Repository Navigatorにおけるエンティティのリレーションシップ

図21-11 Oracle Enterprise Repository Navigatorにおける別のエンティティのリレーションシップ

21.3.2.1.6 Oracle Enterprise RepositoryからOracle Service Registryへのメタデータのサンプル・フロー

図21-12に、この項で説明したOracle Enterprise RepositoryからOracle Service Registryへのメタデータ同期を示します。

図21-12 Oracle Enterprise RepositoryからOracle Service Registryに公開されるメタデータのフロー

21.3.2.2 Oracle Service RegistryからOracle Enterprise Repositoryへのメタデータの同期

この項では、Oracle Service Registryからアセットを受け取ってリポジトリに格納するときのメタデータの同期方法について説明します。内容は次のとおりです。

- 21.3.2.2.1項「ビジネス・エンティティ」

- 21.3.2.2.2項「エンドポイント」

- 21.3.2.2.3項「カテゴリ分け」

- 21.3.2.2.4項「Oracle Service RegistryからOracle Enterprise Repositoryへのメタデータのサンプル・フロー」

21.3.2.2.1 ビジネス・エンティティ

次に示すように、受取り対象のサービス・アセットが存在し、そのアセットがビジネス・エンティティ・アセットに関連付けられているかどうかを確認します。

- 関連付けられている場合は、同じビジネス・エンティティ・リレーションシップが使用されます。

- 関連付けられていない場合は、Oracle Service Registry側のビジネス・エンティティが使用されます。ビジネス・エンティティがOracle Enterprise Repositoryに存在しない場合は作成されます。

サービス・アセットが新規に作成される場合は、次に示すように、UDDIビジネス用のデフォルトのビジネス・エンティティ・アセットをOracle Enterprise Repositoryの構成から取得します。

- システム設定に見つかる場合は、そこから取得します。

- 見つからない場合は、orrxu.propertiesファイルから取得します。

次に示すように、その名前とタイプのアセットが存在するかどうかを確認します。

- 存在する場合は、構成済のリレーションを使用して、既存のアセットを新規に作成されるサービス・アセットに関連付けます。

- 存在しない場合は、新規アセットを作成し、構成済のリレーションを使用して、そのアセットを新規に作成されるサービス・アセットに関連付けます。

21.3.2.2.2 エンドポイント

次に示すように、受取り対象のサービス・アセットに関連するエンドポイント・アセットが1つ以上存在するかどうかを確認します。

- 存在する場合は、UUIDを使用して、エンドポイント・アセットが既存のバインディング・テンプレートと同じかどうかを確認します。同じであれば、エンドポイントを更新します。

- 存在しない場合は、各バインディング・テンプレート用のエンドポイントを作成し、それらをサービス・アセットに関連付けます。

21.3.2.2.3 カテゴリ分け

次に示すように、カテゴリ分けがカテゴリ・バッグに存在するかどうかを確認します。

- 存在する場合は、適用される各カテゴリ分け用のカテゴリ分けマッピングをUDDIMappings.xmlファイルからロードします。

- マッピングが見つかった場合は、サービス・アセットのカテゴリ分けを設定します。

21.3.2.2.4 Oracle Service RegistryからOracle Enterprise Repositoryへのメタデータのサンプル・フロー

図21-13に、この項で説明したOracle Service RegistryからOracle Enterprise Repositoryへのメタデータ同期を示します。

図21-13 Oracle Service Registryから受け取るメタデータのフロー

21.3.3 Oracle Service Registryとの間で交換されたメタデータのOracle Enterprise Repositoryでの検索

Oracle Registry Repository Exchange Utilityでは、公開されたサービスまたは受け取られたサービスに対して、問合せに使用できる次のような情報がタグ付けされます。

- 公開または受取りの日時

- ソース・レジストリと宛先レジストリ

公開されたサービスまたは受け取られたサービスに関する情報を問い合せるには、次の手順に従って、Oracle Enterprise Repositoryの詳細な検索オプション機能を使用します。

1. Oracle Enterprise Repository Webコンソールで、「アセット」ページを開きます。

2. サイドバーにある「検索」ボックスで、詳細な検索オプション・リンクをクリックします。詳細な検索オプション・ダイアログが表示されます。

3. 追加基準によるフィルタ・オプションを選択して、フィルタ処理の追加基準オプションを表示します。

4. フィールドの選択リストで、「internal.alrr.exchange.store」オプションを選択します。

5. 図21-14に示すように、「追加」ボタンの横にあるフィールドに、メタデータが交換された日付を入力します。

図21-14 「詳細な検索オプション」ダイアログ

6. ダイアログの下部にある「検索」ボタンをクリックします。
Oracle Enterprise Repositoryの検索オプションの使用方法の詳細は、『Oracle Fusion Middleware Oracle Enterprise Repository開発者ガイド』のアセットの検索に関する項を参照してください。

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

Oracle Registry Repository Exchange Utilityでは、log4jを使用してタスク実行が詳細にロギングされます。ログ・ファイルは<ExhangeUtility Tool Home>ディレクトリに格納されます。ロギング・オプションを変更するには、<ExhangeUtility Tool Home>ディレクトリにあるlog4fl.propertiesファイルを更新します。

21.3.5 既知の問題

この項では、Oracle Registry Repository Exchange Utilityの使用時に確認されている既知の問題について説明します。内容は次のとおりです。

- 21.3.5.1項「Oracle Service Registry内のサービスの再同期」

- 21.3.5.2項「Oracle Service Registryへのサービスの公開」

- 21.3.5.3項「不正なバージョンのJavaの実行」

21.3.5.1 Oracle Service Registry内のサービスの再同期

以前に同期されたサービスをOracle Service Registryと同期するときに、Oracle Service Registryブラウザ・インスタンスがすでに開いている場合、更新された値が表示されないという問題が確認されています。そのため、更新された値を参照するには、すべてのOracle Service Registryブラウザ・インスタンスを終了してから再起動する必要があります。

21.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からサービス・キーが作成されます。このサービス・キーは、このサービスを複数のレジストリに公開した場合にすべてのレジストリ間で維持されます。
回避策:

ありません。

21.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)

第V部

付録

この部では、Oracle Enterprise Repositoryの管理に関する付録を提供します。

この部は、次の付録で構成されています。

- 付録A「その他の構成」

A その他の構成

この付録では、これまでに取り上げていないカスタマイズおよび構成のオプションについて説明します。

この付録の内容は以下のとおりです。

- A.1項「発行アップロード・ディレクトリの作成および構成」

- A.2項「アセット監査ログの作成」

- A.3項「Oracle Enterprise Repositoryのデフォルトのアーティファクト・ストアの統合」

- A.4項「PDFへのエクスポート機能で使用するXSLTテンプレートの管理」

- A.5項「UTF-8/Unicode文字のサポート」

- A.6項「データ・ルール」

- A.7項「ハーベスタ・プロパティ」

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

発行アップロード・ディレクトリを作成および構成できます。

発行アップロード・ディレクトリの作成

アプリケーション・サーバーで、アセット発行時にアップロードされるアセット・ファイルが格納されるディレクトリを作成します。

発行アップロード・ディレクトリ用の共有ディレクトリの設定

使用しているオペレーティング・システムに適した手順を使用して、共有ディレクトリを作成します。

- Windowsでは、通常、これはUNC共有です。

- UNIX系のOSでは、ディレクトリおよびファイルはアプリケーションによって使用可能になります(Samba、Apache、NFSなど)。

この項には次のトピックが含まれます:

- A.1.1項「アセット・アップロードのシステム設定」

- A.1.2項「アーティファクト・ストアの作成および構成」

- A.1.3項「新しいアーティファクト・ストアの選択」

A.1.1 アセット・アップロードのシステム設定

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

1. 左側のパネルで、「システム設定」を選択します。

2. 「サーバー設定」グループでアップロード領域セクションを見つけます。

図A-1 アップロード領域セクション

3. 次の情報を参考として使用し、組織およびその環境に応じてアップロード領域の設定を変更します。
発行アップロード・ディレクトリ

- cmee.server.paths.upload

- アセット発行でアップロードされるファイルを格納するために使用するディレクトリを定義します。空白のままにした場合は、ファイルをアップロードできません。このディレクトリは、Oracle Enterprise Repository Webアプリケーション内に配置されている必要があります。たとえば、<OER_Home>/applications/oer/oer-app/custom/uploadとします。この場合、uploadはcustomディレクトリ内に作成されたディレクトリです。uploadディレクトリがcustomディレクトリの子である必要はありませんが、そのようにすることをお薦めします。このプロパティにより、次の機能が有効になります。

- アセットの発行フォームの今すぐ添付ファイルを追加オプションが有効になります。(発行プロセスでアセットにファイルを添付する場合に必要です。)

- アセット・エディタのアップロードされた発行ファイル・オプションが有効になります。

レジストラ発行アップロード・パス

- cmee.server.paths.upload-registrar

- 発行アップロード・ディレクトリへの直接アクセスを可能にする、レジストラ参照用のディレクトリ・パス(通常はUNCパス)を定義します。アップロード・フォルダには、Windows共有が必要です。たとえば、\\<machineName>\<sharename>\uploadです。アップロード・リポジトリがUNCではない場合は、空白のままにします。

- アセット・エディタによるファイル参照が有効になります(オプション)。

- パス(UNCによってホストされる場合)には、Windows OSまたはSamba/Sharityが必要です。

- アセット・エディタのアップロードされた発行ファイルで「参照」ボタンの表示が有効になります。

発行アップロード用のアーティファクト・ストア

- cmee.server.paths.upload-repository

- 発行されたファイルへの直接パブリック・アクセスを可能にする構成済アーティファクト・ストアを指定します。アセット・エディタでの、発行されたファイルの1ステップ受入れに使用されます。このプロパティを設定すると、次のようになります。

- 使用およびダウンロード可能なアセット・ファイルが表示されます。

- アセット・エディタのアップロードされた発行ファイル・セクションに「受入れ」ボタンが表示されます。

プロキシ・ダウンロード

Oracle Enterprise Repositoryには、Repositoryアプリケーション・サーバーがユーザーのリポジトリ・プロキシとして機能できるようにする追加オプションがあります。この機能では、ファイル・ダウンロード時にHTTP URLに入力されたユーザー名およびパスワード・テキストが自動的に削除されます。この機能はすべてのアーティファクト・ストアに適用されますが、Oracle Enterprise Repositoryにそのストア内のリソースへのネットワーク接続があることが前提になります。詳細は、Oracle Enterprise Repositoryサポートに連絡してください。

アーティファクト・ストア構成の例

次のいずれかのアーティファクト・ストアを構成する手順は、「アーティファクト・ストアの作成および構成」を参照してください。

- UNC

- ホスト名: unc.example.com

- パス: upload/

- ユーザー名: user_oer

- パスワード: flash

- URL: file:////unc.example.com/upload/

- HTTP

- ホスト名: http.example.com

- パス: oer-web/upload

- ユーザー名: user_oer

- パスワード: flash

- URL: http://user_oer:flash@http.example.com/oer-web/upload/

- FTP

- ホスト名: meta.example.com

- パス: upload

- ユーザー名: user_oer

- パスワード: flash

- URL: ftp://user_oer:flash@meta.example.com/upload/

- ClearCase

- ホスト名: clearcase.example.com

- パス: ccaseweb/bin/ccweb

- ユーザー名: user_oer

- パスワード: flash

- URL: http://clearcase.example.com/ccaseweb/bin/ccweb/?dir=/&elem=&cmd=view&user=user_oer&password=flash

- PVCS

- ホスト名: pvcs.example.com

- パス: dav

- ユーザー名: user_oer

- パスワード: flash

- URL: http://user_oer:flash@pvcs.example.com/dav/

- ローURI

- 名前: Example RAW URI

- ローURI: http://www.example.com/path1/path2?parameter1&parameter2

- URL: http://www.example.com/path1/path2?parameter1&parameter2

A.1.2 アーティファクト・ストアの作成および構成

アーティファクト・ストアは、Oracle Enterprise Repositoryのアセットに関連するファイルが格納される場所です。Oracle Enterprise Repositoryのホームページからアセット・エディタ・ウィンドウを起動します。

アーティファクト・ストアの構成の詳細は、9.3.2項「アーティファクト・ストアの構成」を参照してください。

A.1.3 新しいアーティファクト・ストアの選択

9.3.2項「アーティファクト・ストアの構成」の説明に従ってアーティファクト・ストアを構成した後、Oracle Enterprise Repositoryの「管理」ページで発行アップロード用のアーティファクト・ストアのシステム設定を使用して、アーティファクト・ストアを選択する必要があります。

新しいアーティファクト・ストアの選択の詳細は、9.3.3項「新しいアーティファクト・ストアの選択」を参照してください。

A.2 アセット監査ログの作成

システム構成が適切に行われている場合、保存または変更された個別のアセットのXMLメタデータを、監査証跡を作成するためにテキスト・ファイルにエクスポートできます。テキスト・ファイルはアプリケーション・サーバー上にあり、アプリケーションでの確認には使用できません。この機能をアクティブにするために必要なプロパティについては、Oracleサポートに連絡してください。

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

1. 左側のパネルで、「システム設定」を選択します。「システム設定」セクションがメイン・ペインに表示されます。

2. Oracle Enterprise Repositoryサポートから提供されたプロパティを新しいシステム設定の有効化テキスト・ボックスに入力します。

3. 「有効化」ボタンをクリックします。アセット保存エクスポート・ファイル名が、メイン・ペインのプロパティのリストに表示されます。

4. アセット・ログが格納されるファイルの名前を、アセット保存エクスポート・ファイル名テキスト・ボックスに入力します。

5. 「保存」をクリックします。

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

デフォルトのアーティファクト・ストアのいずれかをシステムと統合すると、Oracle Enterprise Repositoryでアーティファクト・ストアを使用できるようになります。通常、デフォルトのタイプのいずれかを使用してファイルにアクセスするために使用するURLは、次のようになります。

http://server.host.com:port/additionalPathStructure/fileName

アセットへのファイルの追加

この手順は、Oracle Enterprise Repositoryのアセット・エディタで実行します。

1. 「検索」またはその他の方法を使用して、ファイルが追加されるアセットを見つけます。

2. 図A-2に示すように、「概要」タブでファイル情報要素を見つけます。

図A-2 ファイル情報セクション

3. 「追加」ボタンをクリックします。図A-3に示すように、「編集」ダイアログが表示されます。

図A-3 「編集」ダイアログ

4. 「名前」および「説明」テキスト・ボックスに入力します。

5. 「編集」ボタン(「URL」フィールドの横)をクリックします。図A-4に示すように、「URLの編集」ダイアログが表示されます。

図A-4 「URLの編集」ダイアログ

6. オプションを使用して、追加するファイルのソースを選択します。
アーティファクト・ストア・ファイル

1. ホスト・リストから項目を選択します。(構成によって、使用可能な選択が決まります。)

2. 必要に応じて、次のことを実行します。
適切なadditionalPathStructure/fileNameを「パス」テキスト・ボックスに入力するか、または...

「参照」をクリックして、追加するファイルを見つけます。

このオプションは、アーティファクト・ストア・タイプClearQuest、ファイル・ストアおよびPVCSを使用する場合に使用可能です。

外部ファイル

1. ファイルのURLを「URL」テキスト・ボックスに入力します。

2. 「テスト」をクリックして、URLが有効であることを確認します。

7. 必要に応じて、補足テキスト・ファイルを作成してファイルに追加できます。

1. テキスト・ファイル・オプションを選択します。

2. 「タイプ」リストからテキスト・ファイルのタイプを選択します。

3. 必要に応じて、「ファイル」テキスト・ボックスにテキストを入力します。

8. 完了後、「OK」をクリックして「URLの編集」ダイアログを閉じます。

9. 「OK」をクリックして、「編集」ダイアログを閉じます。追加したファイルがファイル情報要素のリストに表示されます。

A.4 PDFへのエクスポート機能で使用するXSLTテンプレートの管理

FOは、ページングされたドキュメントを記述するXML形式です。FOプロセッサ(Apache XMLプロジェクトのFOPなど)は、FOを使用してPDF出力を生成します。XMLドキュメントからのPDFドキュメントの生成は、次の2段階のプロセスです。

1. XMLドキュメントが、XSLT (XSL-FO)スタイルシートを使用してFOドキュメントに変換されます。

2. FOドキュメントが処理され、PDF (または処理しているXSLTスタイルシートで定義されたその他の出力)が生成されます。

Oracle Enterprise RepositoryのXSLT出力機能はタイプ・レベルで適用されるため、対応するタイプのアセットを出力するために必要なテンプレートは1つのみです。ただし、作成または特定のタイプに適用できるテンプレートの数または範囲に制限はありません。

A.4.1 Oracle Enterprise Repositoryで使用するXSL:FOテンプレートの管理

この項では、Oracle Enterprise Repositoryで使用するXSL:FOテンプレートの管理方法について説明します。この節では、次のトピックについて説明します。

アセットXMLエクスポートからのXSLテンプレートの管理

前提条件:

- Oracle Enterprise Repositoryが、前述のようにXSLT出力用に構成されています。

- 次に説明するプロセスでは、Altova XML Spyを使用する必要があります。

1. 前述のように、Oracle Enterprise RepositoryのインスタンスをXSLT出力機能を使用して構成します。

2. Oracle Enterprise Repositoryにログインします。

3. 「検索」またはその他の方法を使用して、XSLテンプレートを作成する対象のタイプの登録済アセットを選択します。

注意:
適切にドキュメント化されたアセットを選択すると、XSL:FOテンプレートのプレビューが容易になります。

4. 次のサブディレクトリを含むローカル作業フォルダを作成します。

- xml

- schema

- xsl

- sps

5. XMLドキュメントを<oer_home>/reports/exportディレクトリから、新しく作成したxmlサブディレクトリに転送します。

6. そのXMLドキュメントをAltova XML Spyで開きます。

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ファイルを<oer_home>/reports/xslフォルダ(前述のcmee.asset.xml.paths.xsl-sourceプロパティで指定)にコピーします。

24. Oracle Enterprise Repositoryで、元のXMLスキーマを生成するためにエクスポートされたアセットを選択します。

25. アセット詳細で出力ボタンをクリックして、アセットのXMLスキーマをエクスポートします。ダイアログが表示されます。

26. ダイアログのプロンプトに従って、PDFドキュメントの生成に使用される、新しく作成されたXSL:FOテンプレートを選択します。ジェネレータによってPDFドキュメントが作成されます。

27. ドキュメントの表示ボタンをクリックしてPDFドキュメントを開きます。

28. PDFドキュメントをStyleVisionで作成されたテンプレート設計と比較します。

29. 必要に応じて変更を加えます。

A.5 UTF-8/Unicode文字のサポート

UnicodeをレンダリングできるArialUnicodeまたは同様のフォントがFOPエンジンで使用されている場合を除いて、PDFへのエクスポート機能でUTF-8/Unicode文字を正しく処理できません。

Unicode文字をレンダリングするための構成

1. 適切なTrue Typeフォント(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-family"{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

A.6 データ・ルール

この項には次のトピックが含まれます:

- A.6.1項「アセット・タイプの要素のフラグ」

- A.6.2項「過去に収集されたデータ」

- A.6.3項「要素の格納」

- A.6.4項「アセット・タイプに存在する必要がある要素」

- A.6.5項「機能に関連付けられた要素」

A.6.1 アセット・タイプの要素のフラグ

アセット・タイプに追加できる多くの要素には、Oracle Enterprise Repository機能を拡張する1組のフラグがあります。これらのフラグは、要素の追加または編集時にタイプ・マネージャで切り替えられます。

必須フラグ - これらは、アセット・エディタでアセットを保存するために移入される必要がある要素です。このフラグによって、オープンAPIによる保存は制限されません。

索引付きフラグ - これらは、アセットに対する拡張検索で使用できる要素です。カスタム・データに格納されるアセットにとって最も意味があります。

A.6.2 過去に収集されたデータ

Oracle Enterprise Repositoryには、リポジトリ内のタイプおよびそれらのタイプのアセットに対する今後の操作には影響するが、アセットにすでに関連付けられているメタデータには影響しない、いくつかの操作があります。

- アセット・タイプから削除された要素
要素がアセット・タイプから削除された場合、その要素に対して指定された値を持つアセットでは、それらの値はデータベース内に保持され、アセットの今後の保存でそれらの値は引き続き保持されます。値はUIには表示されませんが、API操作、カスタム・レポート作成および要素がアセット・タイプに再追加された場合のリストアで使用できます。

- 受入れ可能な値リストによって制限された要素内のデータ値
リストまたは複数選択リストを持つアセットに値が割り当てられる場合、受入れ可能な値リストによって正当な値が指定されます。Oracle Enterprise Repositoryでは、要素にすでに割り当てられている値も正当な値とみなされます。リストが変更されると、リストの値を使用するアセットはその後は保存されません。

値リストでの変更をそれらの値を使用するアセットに伝播するために、OpenAPIプログラムを使用できます。このプログラムにより、削除された値を使用しているアセットを返す要素と値のペアが検索されます。次に、それらの値は正当な値に変更され、アセットは保存されます。

たとえば、信号機の値リストに値「赤」、「黄」、「青」が含まれています。新しいアセットには、信号機リストの設定可能な値である「赤」、「黄」、「青」が設定されます。

値が「左折」である既存のアセットがあります。この値は、過去の特定の時点では正当でしたが、信号機の値リストに含まれなくなりました。この既存のアセットについては、信号機リストの正当な値は「赤」、「黄」、「青」、「左折」です。

A.6.3 要素の格納

Oracle Enterprise Repositoryのアセット・メタデータは要素内に格納され、要素は4つの異なるグループのいずれかに属します。これらのグループの保持および動作の方法はそれぞれ異なっています。4つのグループは次のとおりです。

- 必須データ
これらは、アセット・タイプの一部である必要がある要素です。

必須データ要素は厳密なリレーショナル形式でデータベースに保持され、データを保持する列があり、アセットID外部キーでアクセス可能です。すべての必須データ要素には、mandatory-data/で始まるXMLマッピングがあります。

- カスタム・データ
これらは、カスタマイズおよび削除に適した要素です。タイプ・マネージャで新しく作成された要素は、このセクションに表示されます。カスタム・データ要素はXMLの単一ブロック内に保持され、これはCLOBとしてデータベースに格納されます。すべてのカスタム・データ要素には、custom-data/で始まるXMLマッピングがあります。

- 管理データ
これらは、アセット・エディタの「管理」タブに表示される要素です。これらの要素はカスタマイズできません。これらの要素は、登録ワークフローとステータスおよびカスタム・アクセス設定に使用されます。

管理データ要素は厳密なリレーショナル形式でデータベースに保持され、データを保持する列があり、アセットID外部キーでアクセス可能です。このデータは、アセットに対するアクション(AssetRegister()など)の起動によって変更されます。

- カスタム・メタデータ・フレームワーク(CMF)メタデータ
このフレームワークによって保持されるメタデータは、システム供給とみなされ、Oracle Enterprise Repository UIによる変更から保護されます。このフレームワークは主に統合によって使用され、統合ではメタデータの特定の構造が使用され、統合は多くの場合XMLスキーマに関連付けられます。CMFメタデータ要素はBLOBとしてブロックで保持され、これらはCMFエントリ・タイプに準拠します。一般に、これらのブロックはXMLです。

A.6.4 アセット・タイプに存在する必要がある要素

アセット・タイプから削除できない要素がいくつかあります。

- 名前
この要素は、アセットの名前です。名前とバージョンのペアは、Oracle Enterprise Repository内で一意である必要があります。これは128文字に制限されます。接頭辞name:を使用して、検索をこの要素に制限できます。アセット詳細では、名前はアセット・ヘッダーの一部です。

- バージョン
この要素は、アセットのバージョンです。名前とバージョンのペアは、Oracle Enterprise Repository内で一意である必要があります。これは128文字に制限されます。アセット詳細では、バージョンはアセット・ヘッダーの一部です。

- 説明
この要素は、アセットの説明です。この要素にはHTMLを格納でき、アセットがロードされたときにブラウザによってHTMLとして処理されます。これは4000文字に制限されます。接頭辞description:またはdesc:を使用して、検索をこの要素に制限できます。

- 通知電子メール
この要素は、アセットが使用されるときに通知を受信する電子メール・アドレスです。電子メール・アドレスは、カンマなどの区切りを使用しない単一アドレスです。複数の受信者に通知する必要がある場合、電子メール・アドレスは、Oracle Enterprise Repositoryの外部で電子メール・システムによって確立されたグループである必要があります。

- キーワード
この要素には、アセットのキーワードが格納されます。これらは、入力された検索文字列を使用するすべての検索に含まれます。

- ファイル情報
この要素には、アセットのダウンロード可能なファイルのURIが格納されます。この要素は、アセット詳細には表示されません。

- アップロードされた発行ファイル
この要素には、Oracle Enterprise Repositoryにアップロードされ、まだファイル情報に受け入れられていないファイルのリストが格納されます。この要素は、アセット詳細には表示されません。

A.6.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レジストリなど)との統合を可能にします。収集を可能にするには、Harvester Solution Packをインポートし、そのソリューション・パックに含まれているすべてのアセット・タイプが存在していてアクティブである必要があります。ハーベスタによって、アセットの必須データ、カスタム・データおよびCMFメタデータ・セクションの組合せにメタデータが書き込まれます。

- 収集で使用されるフィールドは、次のとおりです。

- 名前: アセット名は、収集された複数の属性を連結したものです。
抽象エンティティの場合、「名前」はinternalName (namespace、shortNameおよびdiscriminatorの組合せ)です。

アーティファクト・エンティティの場合、「名前」はnamespaceとpathの組合せです。タイプ・エンティティの場合、「名前」はinternalName (エンティティのtypeとshortNameの組合せ)です。

- バージョン: ハーベスタによってデフォルトで(1.0)に設定されたアセットのversion。

- ファイル情報: アセット・ファイル情報には、アセットの使用およびダウンロード操作で使用可能なファイルのリストが含まれています。アーティファクト・エンティティの場合、ファイル情報はファイルのURIまたはファイルの内容が格納されるように作成されます。パラメータpathにURIが格納されます。

- harvesterProperties: 収集操作のメタデータのデータは、internal.introspector.storeというCMFメタデータ・エントリ内に配置されます。メタデータは、イントロスペクション標準属性ビューアというビューア内のアセット詳細に公開されます。internal.introspector.store内に必要なプロパティは、収集ソースおよびOracle Enterprise Repositoryアセット・タイプによって異なります。ハーベスタ・プロパティの詳細は、A.7項「ハーベスタ・プロパティ」を参照してください。

Oracle Enterprise Repositoryとの様々な統合で使用されるアセット・タイプのフィールドは、次のとおりです。

フィールド

コアOER

XU

OSBハーベスタ

SOA Suiteハーベスタ

ローWSDLハーベスタ

AIAハーベスタ

EMハーベスタ

Ovationハーベスタ

名前

はい

はい

はい

はい

はい

はい

はい

はい

バージョン

はい

はい

はい

はい

はい

はい

はい

はい

説明

はい

はい

はい

はい

はい

はい

はい

はい

ファイル情報

はい

harvesterProperties

はい

はい

はい

はい

はい

はい

はい

UDDIサービス・キー

はい

はい

UDDIレジストリ

はい

A.6.6 アセット・タイプ・カタログの説明

アセット・タイプ・カタログには、ベース・データパックおよびHarvester Solution Packに付属のアセット・タイプがリストされます。これは、Asset Type Catalog.xlsという名前のExcelスプレッドシートに含まれています。各アセット・タイプには、そのタイプで存在する要素の完全なリストが付随しています。要素ごとに、次のような複数の情報がリストされます。

- アセット・タイプ: 要素が存在するアセット・タイプ。

- ソース: ソリューションまたはデータパック(アセット・タイプに付随して要素を提供するもの)。

- タブ: 要素が存在するエディタのタブ。要素はタブ内で順序付けられていません。

- 要素: アセット・エディタに表示される要素の名前。

- タイプ: タイプ・マネージャで新しい要素を追加するときにリストされるデータ型を使用した、要素のデータ型。

- XMLマッピング: assetRead()操作で生成されるXMLに表示される、データのXPath。

- プロパティ: 要素のデータ型に関連するプロパティのリスト(文字列に最大長がある、数値にスケール、精度および範囲がある、リストに値リスト名があるなど)。

- 値リスト: 受入れ可能な値リストによって指定された値のリストに制限される要素の場合、正式が値が表示されます。Oracle Enterprise Repositoryでは、値が制限された要素に、過去に収集されたデータを保持できます。

- 必須: 要素の必須フラグの値。

- 索引付き: 要素の索引付きフラグの値。

- ノート: Oracle Enterprise Repositoryのお客様が要素の使用に関する独自のノートを追加できるようにするための列。

A.7 ハーベスタ・プロパティ

プロパティ名

適用先アセット・タイプ

説明

収集日

すべて

アセットがOracle Enterprise Repositoryに収集された日付

収集者

すべて

収集を実行したOracle Enterprise Repositoryユーザー

ハーベスタ説明

すべて

ハーベスタの実行時に設定されたオプションの説明

ハーベスタ・バージョン

すべて

使用されたハーベスタのバージョン

ネームスペース

アーティファクト・タイプ以外すべて

ハーベスタの実行時に設定されたプロジェクトのネームスペース

製品名

すべて

アーティファクトが生成された製品

製品バージョン

すべて

アーティファクトが生成された製品のバージョン

intname

アーティファクト・タイプ以外すべて

重複を検出するためにハーベスタによって使用される、アセットの内部的な一意の名前

(各種)

Business Process: BPEL、Deployment: BPEL、サービス(タイプ=メディエータ)、ヒューマン・タスク、ビジネス・ルール、Springコンテキスト

composite.xmlから読み取られた、SCAコンポーネント・プロパティ

(各種)

コンポジット、コンポジット・デプロイメント

composite.xmlから読み取られた、SCAコンポジット・プロパティ

(各種)

アダプタ構成

定義元のWSDLまたは.JCAファイルから読み取られた、アダプタ構成のJCAプロパティ

バインディング・タイプ

エンドポイント、コンポジット・デプロイメント・サービス、コンポジット・デプロイメント参照

エンドポイントによって使用されるバインディングのタイプ

デプロイメントURL

エンドポイント、Deployment: BPEL、コンポジット・デプロイメント、コンポジット・デプロイメント・サービス、コンポジット・デプロイメント参照

プロジェクトがリモートで収集されたサーバーのURL

EJBバージョン

エンドポイント、サービス

composite.xmlから読み取られた、EJBエンドポイントのEJBバージョン・プロパティ。EJB 2.1サービスか3.0サービスかを示します。

エンドポイントURI

エンドポイント

エンドポイントを呼び出すことができるURI。アダプタ構成の場合

公開イベント

Business Process: BPEL、Deployment: BPEL、サービス(タイプ=メディエータ)、ヒューマン・タスク、ビジネス・ルール、Springコンテキスト、コンポジット、コンポジット・デプロイメント

composite.xmlで定義された、このコンポーネント(またはこのコンポジットのコンポーネント)によるサブスクライブ先のイベントのQName

サブスクライブ先イベント

Business Process: BPEL、Deployment: BPEL、サービス(タイプ=メディエータ)、ヒューマン・タスク、ビジネス・ルール、Springコンテキスト、コンポジット、コンポジット・デプロイメント

composite.xmlで定義された、このコンポーネント(またはこのコンポジットのコンポーネント)によるサブスクライブ先のイベントのQName

インタフェース・タイプ

インタフェース、コンポジット・サービス、コンポジット参照

サービスによって提供されるインタフェースのタイプ

呼び出された操作

Business Process: 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

アクセス, 11.4

アクセス管理者, 11.7.1

アクセス制御, 2.5.1.8

アクセス定義, 1.4.4.2, 11.4

アクセス・オプション, 11.7.2

アクセス設定とアセット・エディタ, 1.4.4.1

アクセス設定, 1.4, 11.3.2

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

システム設定へのアクセス, 2.1

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

ポリシー管理機能のアクティブ化, 16.2

adapterAsset, 8.2.9

アダプタおよびアプリケーション, 8.2.9

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

カスタム・レポートの追加, 6.6.2

アセットへのファイルの追加, A.3

タイプ・マネージャ・アイコンのイメージの追加, 7.6

メトリックの追加, 18.1.2

タブの追加, 7.4.1

適用されたアセット・ポリシー要素のタイプへの追加, 16.6

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

タイプへの一意のID要素の追加, 7.7.1

高度なアセット発行, 9.4

拡張構成, 8.2.9, 17.3.2

拡張オプション, 10.2.3

高度なロールベース・アクセス制御, 11.1

上級発行者, 11.7.1

アフィニティ設定, 2.5.1.13

applicationName, 8.2.9

Oracle BSE (WSDL/SOAP)を使用するアプリケーション, 8.3.1.8

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

アセットへのポリシーの適用, 16.7

アーキテクチャ設計図, 14.1

アーティファクトの作成, 17.2.3.5

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

アセット, 9.5

アセット・ポートフォリオ管理レポート, 6.6.1

アセット登録ステータス, 9.7

アセット・リリース管理レポート, 6.6.1

ハーベスタにより作成されるアセット・タイプ, 8.3.1

アセット・アップロードのシステム設定, A.1.1

アセット, 11.4

進行中のアセット, 2.5.1.5, 19.1

「アセット」ペイン - 使用方法, 8.3.4.1

アセットのステータスの割当てまたは変更, 9.7.1

B

ベース・データパック, 3.4

基本概念, 11.3

基本構成, 1

「部署」を参照

「概要」を参照

ベスト・プラクティス, 8.3.6 BI Publisher, 6.1 BPEL, 8.3.1.1 BPEL PM, 17.2.3.2 ビジネス・エンティティ, 21.3.2.1.1

C

カテゴリ分け, 21.3.2.1.4

タブの位置の変更, 7.4.2

Oracle Registry Repository Exchange Utilityのログ・ファイルの確認, 21.3.4

クラスパスURL, 8.2.6.2

ユーザーのクローニング, 1.5.4

プロジェクトの終了, 1.6.6

EM統合のコマンド行オプション, 17.2.1

ハーベスタのコマンド行オプション, 8.2.2.2

共通のメタデータ・ビューア, 7.8

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

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

受入れ可能な値リストの構成, 9.3.1

アーティファクト・ストアの構成, 9.3.2

カテゴリ分けの構成, 9.3.4

コンテナ管理の認証用のOracle Enterprise Repositoryの構成, 10.3.2

シングル・サインオン認証で使用するためのOracle Enterprise Repositoryの構成, 10.2.2

Linux上でのOracle Enterprise Repository Web Startの構成, 1.10.3

拒否理由の構成, 9.3.6

リレーションシップの構成, 9.3.5

システム供給リレーションシップの構成, 9.3.5.1

アセット・タイプ名の使用の構成, 21.2.1.2

ベンダーの構成, 9.3.7

既存のロールのアクセス設定の構成, 11.7

高度なロールベース・アクセス制御の構成, 11

自動収集の構成および使用, 8

進行中のアセットの構成, 19

BI Publisher Enterprise Serverの構成, 6

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

ハーベスタのロギングの構成, 8.2.7

メトリックの構成, 18

UDDIマッピング・ファイルでのOracle Enterprise Repositoryのカテゴリ分けの構成, 21.2.4

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

Oracle Enterprise Repository Workflowの構成, 13

ポリシー管理の構成, 16, 20

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

システム・オプションの構成, 9.3

登録ワークフローに対応するタブの構成, 7.4

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

Enterprise Manager統合ユーティリティの構成, 17.3

ハーベスタの構成, 8.2

コマンド行用のハーベスタの構成, 8.2.2

Oracle Enterprise RepositoryのJDBCデータソースの構成, 6.3

レポートを有効にするためのOracle Enterprise Repositoryシステム設定の構成, 6.5

Oracle Registry Repository Exchange Utilityの構成, 21.2

Oracle Registry Repository Exchange Utilityの構成ファイルの構成, 21.2.3

tModelKey UDDI設定の構成, 21.2.5

XMLスキーマの構成, 7.9.1

使用されるアセット, 1.6.1

コンテナ管理設定, 10.3

発行アップロード・ディレクトリの作成, A.1

新しいユーザーの作成/非承認ユーザーの許可, 10.2.3.2

アセットCASの作成, 11.6.1.2

ファイルCASの作成, 11.6.2.2

コンプライアンス・テンプレートの作成, 14.3

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

新しい部門の作成, 1.2.1

新規ロールの作成, 1.3.2

新しいタイプの作成, 7.3

新しいユーザーの作成, 1.5.1

ポリシーの作成, 16.5

ポリシー・タイプの作成, 16.3, 20.3

プロジェクトの作成, 1.6.2

アセット監査ログの作成, A.2

アーティファクト・ストアの作成および構成, A.1.2

発行アップロード・ディレクトリの作成および構成, A.1

新しいユーザーのデフォルト・ロールの作成/割当て, 10.2.3.1

カスタム・リンク, 2.5.1.11

Oracle Enterprise Repositoryのカスタマイズ, 3

D

データ・ルール, A.6

dbqueries, 18.3.1

セキュリティ・モデルの定義, 6.2

ロールの削除, 1.3.4

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

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

タブの削除, 7.4.4

部門, 1.2

Oracle Enterprise Repository事前構成済BI Publisherコンテンツのデプロイ, 6.1

アセット・タイプ・カタログの説明, A.6.6

重複するアーティファクトの検出, 8.3.2

「診断」ページ, 1.9

進行中のアセットの無効化, 19.4

Java Web Startのダウンロードとインストール, 1.10.1

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

E

プロジェクトの編集, 1.6.3

ロールの編集, 1.3.3

部門情報の編集, 1.2.2

権限の編集, 1.4.2

タブの編集, 7.4.3

ユーザー情報の編集, 1.5.5

要素の格納, A.6.3

アセット・タイプに存在する必要がある要素, A.6.4

機能に関連付けられた要素, A.6.5

電子メール・テンプレート, 4.4

デバッグ・ロギングの有効化, 10.2.3.7

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

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

システム設定プロパティの有効化, 2.3

非承認ユーザー/新しいユーザーのログインの有効化, 10.2.3.3

進行中のアセットの有効化, 19.3

カスタム・アクセス設定の有効化, 11.2.2

IDEよる進行中のアセットの表示の有効化, 19.5

パスワード暗号化ツール, 12.2.2

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

構成ファイルのパスワードの暗号化, 17.4

エンドポイント, 21.3.2.1.3

エンドポイントの作成, 17.2.3.6

エンタープライズ認証設定, 2.5.3

Enterprise Manager統合ユーティリティ, 17

「高レベルなユースケース」を参照

「概要」を参照

「前提条件」を参照

eTrustシングル・サインオン, 10.2 使用例, 21.1.2 Exchange Utility構成ファイル, 12.2.2 Exchange Utilityツール

「既知の問題」を参照

Oracle Enterprise Repositoryからの項目のエクスポート, 5.4 外部統合設定, 2.5.5

F

FileSet, 8.2.3.2

アセット・タイプの要素のフラグ, A.6.1

機能設定, 2.5.1

G

一般的なユーザー・インタフェース, 2.5.1.1

暗号化されたパスワードの生成, 12.1

ハーベスタの使用の開始, 8.1

「ベスト・プラクティス」を参照

「前提条件」を参照

「既知の問題」を参照

過去に収集されたデータ, A.6.2 特定のアセットへのアクセスの付与/拒否, 11.6.1 アセット内の特定のダウンロード・ファイルへのアクセスの付与/拒否, 11.6.2 権限の付与および拒否, 11.6 ロールへの権限の付与, 1.4.1

H

ハーベスタ, 8

ハーベスタ構成ファイル, 12.2.1

ハーベスタの機能, 8.1.2

ハーベスタ・プロパティのマトリックス, A.7

Harvester Solution Pack, 3.4, 3.4

Oracle SOA Suiteサーバーからの収集, 8.2.5.1

アーティファクトの収集, 8.3

Oracle SOA Suiteの収集, 8.3.1.6

Oracle Service BusからのWebサービスの収集, 8.2.5.3

WebLogic ServerからのWebサービスの収集, 8.2.5.2

高レベルなユースケース, 17.1.3

交換されるメタデータの同期方法, 21.3.2

I

アイコン・イメージの要件, 7.6.1

インポート・エクスポート・ツール, 5

インポート・エクスポート・ツール, 5.1

Oracle Enterprise Repositoryへの項目のインポート, 5.5

カスタム・レポート作成に必要な情報, 7.7.2

初期起動, 5.3.3

Java Web Startのインストール, 1.10

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

Oracle Registry Repository Exchange Utilityのインストール, 21.2.1.1

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

Oracle Service Registryのインストール, 21.2.2

WLSTからのハーベスタの起動, 8.2.4

Repository.Submit Antタスクを使用したハーベスタの起動, 8.2.3

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

J

JCAアダプタ, 8.3.1.7

jcaCSAAdapterName, 8.2.9

jcaSpecBinding, 8.2.9

K

既知の問題, 8.3.7, 17.5, 21.3.5

L

Oracle Enterprise Repositoryからの起動, 5.3.1

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

タイプ・マネージャの起動, 7.2

LDAPプロパティの例の表, 10.1.5

LDAP/Active Directory, 10.1

「概要」を参照

「セキュリティに関する考慮事項」を参照

プロジェクトの検索, 1.6.5 ロギング, 17.3.2.3

M

PDFへのエクスポート機能で使用するXSLTテンプレートの管理, A.4

電子メール配信リストの管理, 4.3

メトリック要素

「概要」を参照

メトリックのマッピング, 17.3.2.1, 17.3.2.1 メトリックの発行, 17.2.3 更新するメトリック, 17.2.3.7 アセット、コンプライアンス・テンプレート、ポリシーの移行, 9.5.1 移行, 9.5 その他, 2.5.1.13 LDAP/Active Directoryのプロパティの変更, 10.1.3 Webアプリケーションのweb.xmlファイルの変更, 10.3.3 データベースへの設定の移動, 2.4

N

namespace, 8.2.9

新しいユーザーの通知, 10.2.3.4

部門の同期に関する注意, 10.2.3.5

通知, 2.5.1.7

O

Enterprise Manager統合ユーティリティの取得, 17.1.2

ハーベスタの入手, 8.2.1

オープンAPI, 2.5.4.1

Oracle Enterprise Repositoryのデフォルトのアーティファクト・ストアの統合, A.3

Oracle Metadata ServiceのURL, 8.2.6.1

Oracle Registry Repository Exchange Utility, 21.1

Oracle Service Bus, 17.2.3.1

Oracle Service Bus (OSB)プロジェクト, 8.3.1.10

その他の構成, A

その他のパスワード, 12.1.2

概要, 1.1, 10.1.1, 17.1, 18.1.1

P

parameter.properties, 8.2.1

repository.submit Antタスクのパラメータ, 8.2.3.1

パフォーマンス・レポート, 6.6.1

オプションのハーベスタ構成の実行, 8.2.6

ポリシー, 11.4, 16.1

ポリシー管理, 2.5.1.6

ポリシーの移行, 9.5

前提条件, 8.1.1, 17.1.1

プリスクリプティブな再利用, 14.1

アセット詳細のPDF出力, 2.5.1.3

プロセスの概要, 11.5

作成済アセット, 1.6.1

プログラム管理レポート, 6.6.1

プロジェクト管理者, 11.7.1

プロジェクト・ポートフォリオ生産性レポート, 6.6.1

プロジェクト・プロファイル, 14.1

プロジェクト, 1.6, 11.4

プロジェクトおよびナビゲータ, 2.5.1.4

プロキシ・サービスまたはビジネス・サービス, 8.3.1.9

Q

カテゴリ分けによる問合せ, 21.2.3.3.3

フィルタによる問合せ, 21.2.3.3.4

名前による問合せ, 21.2.3.3.1

登録ステータスによる問合せ, 21.2.3.3.2

R

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

Oracle Enterprise Repositoryの再ブランド設定, 3.2

レジストラ, 11.7.1

レジストラ管理者, 11.7.1

登録ステータスおよびアクティブ・ステータス, 21.3.2.1.5

リレーションシップ図, 1.1

RemoteProject, 8.2.3.2, 8.2.3.2

レポート・タイプ, 6.6.1

レポート, 2.5.1.12, 6.6, 11.4

ロールの同期, 10.2.3.6

ロールベース・アクセス制御のユースケース, 11.8

ロール/部門ベースのホームページ表示, 3.3

ロール, 1.3, 11.3.1

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

レポートの実行, 6.6.3

コマンド行からの実行, 17.2.1

データベースに対する問合せの実行, 18.3

Antからのハーベスタの実行, 8.2.3.3

Oracle Enterprise Repositoryポリシー・レポートの実行, 16.10

Oracle Registry Repository Exchange Utilityの実行, 21.3.1

実行時収集の詳細, 8.2.5

S

parameter.propertiesサンプル・ファイル, 5.2.2.2

Enterprise Managerからのスケジュール, 17.2.2

検索, 2.5.1.2

システム設定の検索, 2.2

Oracle Service Registryの検索, 21.3.3

収集されたアセットの検索, 8.3.4

セキュリティに関する考慮事項, 1.4.4, 10.1.4, 11.2

新しいアーティファクト・ストアの選択, 9.3.3, A.1.3

コマンド行で収集するアーティファクトの選択, 8.2.2.2

サーバー設定, 2.5.2

サービス・キー, 21.3.2.1.2

セッション, 1.7

「単一セッションの削除」を参照

「複数セッションの削除」を参照

「セッションの表示」を参照

発行アップロード・ディレクトリ用の共有ディレクトリの設定, A.1 コマンド行用のリポジトリ接続情報の設定, 8.2.2.1 宛先レジストリの設定, 21.2.3.4 レジストリ接続情報の設定, 21.2.3.2 レジストリ問合せの設定, 21.2.3.5 コマンド行ユーティリティのリポジトリおよびEnterprise Manager接続情報の設定, 17.3.1 リポジトリ接続情報の設定, 21.2.3.1 リポジトリ問合せの設定, 21.2.3.3 ソース・レジストリの設定, 21.2.3.6 Software File Identification (SFID), 2.5.1.9 ネストされた要素としてパラメータの指定, 8.2.3.2 repository.submit Antタスクのパラメータの指定, 8.2.3.1 インポート・エクスポート・ツールの起動, 5.3 UTF-8/Unicode文字のサポート, A.5 parameter.propertiesファイルのサポート対象パラメータ, 5.2.2.1 タイマー・ベースのワークフローを使用した同期, 21.3.1.1.2 イベントのトリガー時の同期, 21.3.1.1.3 部門の同期, 10.2.3.5 ロールの同期, 10.2.3.6 システム管理, 11.4 システム管理者, 11.7.1 Oracle Enterprise Repositoryのシステム設定, 2.5 システム設定の概要, 2

T

タブの要素, 7.5

ターゲット・ファインダ, 17.3.2.2

デフォルトのインポート動作, 5.2.3

エディタ, 7.2.1.1

parameter.propertiesファイル, 5.2.2

ビューア, 7.2.1.2

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

Java Web Startのトラブルシューティング, 1.10.2

タイプ・マネージャのビュー, 7.2.1

U

Oracle Registry Repository Exchange Utilityのプロパティ・ファイルについて, 21.2.6

一意のID, 7.7

配信リストの更新, 4.3.2

URI, 8.2.3.2, 8.2.3.2

使用 - ダウンロード, 2.5.1.10

ユーザー, 11.7.1

ユーザー・ロールの説明, 1.3.1

ユーザー・ロールおよびデフォルト権限, 11.7.1

ユーザー検索, 1.5.3

ユーザー, 1.5, 1.6.1

コンプライアンス・テンプレートに関連付けられたアセットの使用, 14.5

使用方法の使用, 8.3.4.1

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

メタデータの使用, 8.3.4.2

アセット・エディタの使用, 9

Enterprise Manager統合ユーティリティの使用, 17.2

スキーマのエクスポート機能の使用, 7.9.2

インポート・エクスポート・ツールの使用, 5.2

Oracle Enterprise Repository Exchange Utilityの使用, 21.3

サード・パーティ・タスクの使用, 8.2.3.4

タイプ・マネージャの使用, 7

タイプXMLエディタの使用, 7.9.3

V

有効なメタデータ・エンティティ, 21.1.1.1

アセット・タイプの要素の検証, 18.2

ポリシー・アサーションの検証, 16.9

ユーザー権限の検証, 1.4.3

タイプXMLスキーマの表示と編集, 7.9

進行中のアセットの表示, 19.2

ポリシー・ステータスの表示, 16.8

プロジェクト詳細の表示, 1.6.1

セッションの表示, 1.7.1

ユーザー情報の表示, 1.5.2

使用可能なタイプ・アイコンの表示と選択, 7.6.2

W

Webサービス, 17.2.3.3

Oracle Registry Repository Exchange Utilityとは, 21.1.1

電子メールにリスト・メンバーがコピーされる状況, 4.3.3

要素の操作, 7.5.1

WSDL, 8.3.1.2

X

XPath共通メタデータ・ビューア, 7.8.1

XSD, 8.3.1.4

XSL, 8.3.1.5

XSLT共通メタデータ・ビューア, 7.8.2

オラクルの法律上の注意点について

コピーライトについて

Copyright © 1994-2016, Oracle and/or its affiliates.All rights reserved.

ライセンス制約の保証と結果的に生じる損害の免責

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

保証免責

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

制限付権利について

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

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)、その他の対策を講じることは使用者の責任となります。このソフトウェアまたはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、Oracle Corporationおよびその関連会社は一切の責任を負いかねます。

商標と登録商標について

OracleおよびJavaはオラクルおよびその関連会社の登録商標です。その他の社名、商品名等は各社の商標または登録商標である場合があります。

Intel、Intel Xeonは、Intel Corporationの商標または登録商標です。すべてのSPARCの商標はライセンスをもとに使用し、SPARC International, Inc.の商標または登録商標です。AMD、Opteron、AMDロゴ、AMD Opteronロゴは、Advanced Micro Devices, Inc.の商標または登録商標です。UNIXは、The Open Groupの登録商標です。

第三者のコンテンツ、製品、サービスに対する免責事項

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

アルファ版およびベータ版ドラフト・ドキュメントについて

このドキュメントが試作版の場合:

このドキュメントは試作版であり、デモおよび暫定使用のみを目的としたものです。このソフトウェアを使用するハードウェアに限定するものではありません。Oracle Corporationおよびその関連会社は、このドキュメントに関して一切の責任を負わず、いかなる保証もいたしません。また、このドキュメントを使用したことによって損失、費用、あるいは損害が発生しても、一切の責任を負いかねます。

非公開のアルファ版およびベータ版ドラフト・ドキュメントについて

このドキュメントが非公開の試作版の場合:

このドキュメントに含まれる情報は、情報の共有のみを目的としたものであって、顧客諮問委員会(Customer Advisory Board)のメンバーとしてのお客様の立場でのみ、またはお客様のベータ・トライアル契約のみに従って検討されるべきものとします。マテリアル、コード、または機能の提供をお約束するものではなく、購入決定を行う際の判断材料とすべきではありません。このドキュメントに記載されている特徴または機能の開発、リリースおよび時期については、オラクルの裁量により決定されます。

このドキュメントには、ソフトウェアまたは印刷物などの形式を問わず、オラクルが独占的な権利を有する財産的情報が含まれています。この機密資料へのアクセスと使用は、お客様とオラクルとの間で締結され、お客様が遵守に同意した、Oracle Master Agreement、Oracle License and Oracle Services Agreement (オラクル・ライセンスおよびサービスに関する契約書)、Oracle PartnerNetwork Agreement、Oracle Distribution Agreementまたはその他のライセンス契約の条件に従うものとします。このドキュメントとその内容の開示、コピー、複製および配布には、オラクルによる事前の承諾を必要とします。このドキュメントはライセンス契約の一部となるものではなく、オラクルおよびその子会社や関連会社との契約を構成するものではありません。

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

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

Oracle Supportへのアクセス

サポートをご契約のお客様には、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を参照してください。