Oracle® Fusion Middleware

Oracle WebCenter Contentの管理

11g リリース1 (11.1.1)

B72425-07(原本部品番号:E26692-08)

2018年4月

Fusion Middleware Controlとコンテンツ・サーバーのアプリケーション、ユーティリティおよびコマンドを使用してOracle WebCenter Contentシステムを管理する方法について記載された管理者向けの資料。

Oracle Fusion Middleware Oracle WebCenter Contentの管理, 11g リリース1 (11.1.1)

B72425-07

Copyright © 2010, 2018, Oracle and/or its affiliates.All rights reserved.

原本著者: Divya Ramabhadran

原本協力者: Oracle WebCenter Content開発およびサポート

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

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

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

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およびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても一切の責任を負いかねます。

目次

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

はじめに

- 対象読者

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

- 関連ドキュメント

- 表記規則

- WebCenter Content用語

このガイドで説明する新機能

- 11gリリース1 (11.1.1.9.2)の新機能と変更された機能

- 11g リリース1 (11.1.1.9.0)の新機能と変更機能

- 11gリリース1 (11.1.1.8.0)の新機能と変更された機能

第I部 Oracle WebCenter Contentの概要

1 Oracle WebCenter Contentの管理の概要

- 1.1 Oracle WebCenter Contentの概要

- 1.1.1 コンテンツ・サーバー

- 1.1.2 コンテンツ管理

- 1.2 Oracle WebCenter Contentの管理の基本タスク

第II部 スタート・ガイド

2 Oracle WebCenter Contentの管理のスタート・ガイド

- 2.1 システム管理者のロールと職責の理解

- 2.2 システム管理者インタフェースの理解

- 2.2.1 WebCenter Content Server管理インタフェースについて

- 2.2.2 Oracle Enterprise Manager Fusion Middleware Controlについて

- 2.2.3 Oracle WebLogic Server管理コンソールについて

- 2.3 WebCenter Contentシステムの管理ツールの理解

- 2.3.1 コンテンツ・サーバーのツールについて

- 2.3.1.1 管理ページ

- 2.3.1.2 アプリケーション

- 2.3.1.3 ユーティリティ

- 2.3.1.4 IdcShellコマンドライン・ツール

- 2.3.2 Oracle WebLogicスクリプティング・ツール(WLST)について

- 2.4 Oracle WebCenter Contentのアクセス

- 2.4.1 Fusion Middleware Controlを使用したWebCenter Contentへのアクセス

- 2.4.1.1 Fusion Middleware Controlへのログイン

- 2.4.1.2 コンテンツ・サーバーのホーム・ページへのナビゲート

- 2.4.2 Webブラウザを使用したWebCenter Contentインスタンスへのアクセス

- 2.4.2.1 コンテンツ・サーバー・インスタンスへのアクセス

- 2.4.2.2 WebCenter Content: Inbound Refineryインスタンスへのアクセス

- 2.4.2.3 WebCenter Content: Imagingインスタンスへのアクセス

- 2.4.2.4 WebCenter: Recordsインスタンスへのアクセス

3 システム・プロセスの管理

- 3.1 コンテンツ・サーバーおよびInbound Refineryの起動と停止

- 3.2 Fusion Middleware Controlを使用したコンテンツ・サーバーおよびInbound Refineryの起動と停止

- 3.2.1 Fusion Middleware Controlを使用したコンテンツ・サーバーまたはInbound Refineryの起動

- 3.2.2 Fusion Middleware Controlを使用したコンテンツ・サーバーまたはInbound Refineryの停止

- 3.2.3 Fusion Middleware Controlを使用したコンテンツ・サーバーまたはInbound Refineryの再起動

- 3.3 WebLogic Serverを使用したコンテンツ・サーバーの起動と停止

- 3.3.1 WebLogic Server管理コンソールを使用したコンテンツ・サーバーの起動

- 3.3.2 WebLogic Server管理コンソールを使用したコンテンツ・サーバーの停止

- 3.3.3 WebLogic Server管理コンソールを使用したコンテンツ・サーバーの再起動

- 3.4 スクリプトを使用したコンテンツ・サーバーの起動と停止

- 3.4.1 スクリプトを使用したコンテンツ・サーバーの起動

- 3.4.2 スクリプトを使用したコンテンツ・サーバーの停止

- 3.4.3 スクリプトを使用したコンテンツ・サーバーの再起動

- 3.5 コンテンツ・サーバー管理アプリケーションの実行

- 3.5.1 管理アプリケーションのアプレットとしての実行

- 3.5.2 スタンドアロン・モードでの管理アプリケーションの実行

- 3.5.2.1 UNIXシステムでのスタンドアロン・アプリケーションの実行

- 3.5.2.2 Windowsシステムでのスタンドアロン・アプリケーションの実行

- 3.5.2.3 スタンドアロン・モード用のシステム・データベース・プロバイダの構成

- 3.5.2.4 スタンドアロン・モード用のJDBCデータベース・ドライバの構成

- 3.5.2.5 スタンドアロン・モード用の外部データベース・プロバイダの構成

- 3.6 IdcShellコマンドライン・ツールを使用したIdocスクリプトの実行

4 コンテンツのバッチ・ロード

- 4.1 バッチ・ロードについて

- 4.1.1 バッチ・ロード・ファイルのレコードについて

- 4.1.2 バッチ・ロードのアクションについて

- 4.1.3 バッチ・ロードの挿入アクションについて

- 4.1.3.1 挿入の要件

- 4.1.3.2 挿入の例

- 4.1.4 バッチ・ロードの削除アクションについて

- 4.1.4.1 削除の要件

- 4.1.4.2 削除の例

- 4.1.5 バッチ・ロードの更新アクションについて

- 4.1.5.1 更新の要件

- 4.1.5.2 更新の例1

- 4.1.5.3 更新の例2

- 4.1.6 バッチ・ロード・ファイルのオプション・パラメータについて

- 4.1.7 カスタム・メタデータ・フィールドについて

- 4.2 バッチ・ロード・ファイルの準備

- 4.2.1 バッチ・ロード・ファイルの準備について

- 4.2.2 マッピング・ファイル

- 4.2.2.1 マッピング・ファイルのフォーマット

- 4.2.2.2 マッピング・ファイルの値

- 4.2.3 「バッチビルダー」ウィンドウからのバッチ・ロード・ファイルの作成

- 4.2.4 マッピング・ファイルの作成

- 4.2.5 コマンドラインからのバッチ・ロード・ファイルの作成

- 4.2.5.1 Windowsの例

- 4.2.5.2 UNIXの例

- 4.3 バッチ・ローダーの実行

- 4.3.1 バッチ・ローダーの実行について

- 4.3.2 「バッチ・ローダー」ウィンドウからのバッチ・ロード

- 4.3.3 コマンドラインからのバッチ・ロード

- 4.3.3.1 Windowsの例

- 4.3.3.2 UNIXの例

- 4.3.4 IdcCommandユーティリティおよびリモート・アクセスの使用

- 4.3.4.1 バッチ・ロード・コマンド・ファイル

- 4.3.4.2 リモートのバッチ・ロードの準備

- 4.3.5 メタデータとしてのみのコンテンツのバッチ・ロード

- 4.3.6 バッチ・ローダーの-consoleコマンドライン・スイッチ

- 4.3.7 リダイレクトの追加

- 4.3.8 バッチ・ロード・エラーの修正

- 4.4 バッチ・ローダーのパフォーマンスの最適化

- 4.5 ベスト・プラクティス事例

- 4.5.1 背景情報

- 4.5.2 事前トラブルシューティング

- 4.5.3 解決策

第III部 Oracle WebCenter Content Serverの監視

5 コンテンツ・サーバーのステータスの監視

- 5.1 コンテンツ・サーバーのステータスの表示

- 5.2 コンテンツ・サーバーのコンソール出力の表示

- 5.3 システム構成情報の表示

- 5.4 システム監査情報の表示

- 5.4.1 システム監査の一般的な情報

- 5.4.2 システム監査のローカライズ情報

- 5.4.3 システム監査のトレース・セクション情報

- 5.4.4 システム監査のキャッシュ情報

- 5.4.5 システム監査の構成エントリ情報

- 5.4.6 システム監査のコンポーネント・レポート情報

- 5.5 サーバー出力の表示

- 5.6 イベント出力の表示

- 5.7 スキーマ・キャッシュの確認

- 5.8 ローカライズ監査情報の表示

- 5.9 スケジュールされたジョブの監視

- 5.9.1 アクティブなスケジュールされたジョブの表示

- 5.9.2 スケジュールされたジョブの履歴の表示

- 5.9.3 スケジュールされたジョブの変更

- 5.9.4 スケジュールされたジョブの取消しまたは削除

6 コンテンツ・サーバーのログ・ファイルの監視

- 6.1 コンテンツ・サーバーのログ・ファイルの管理の概要

- 6.2 コンテンツ・サーバーのログ・ファイルの特性について

- 6.3 コンテンツ・サーバー・ログへのアクセス

- 6.4 アーカイバ・ログへのアクセス

- 6.5 Inbound Refineryログへのアクセス

7 Fusion Middleware Controlを使用したコンテンツ・サーバーおよびInbound Refineryの監視

- 7.1 Fusion Middleware Controlを使用したログ情報の管理

- 7.1.1 Fusion Middleware Controlを使用したログ情報の表示

- 7.1.2 Fusion Middleware Controlを使用したログ情報の変更

- 7.2 Fusion Middleware Controlを使用したパフォーマンス情報の表示

- 7.3 Fusion Middleware Controlを使用したMBean情報の表示

第IV部 システム構成の管理

8 システム・プロパティの構成

- 8.1 システム・プロパティ

- 8.2 Fusion Middleware Controlを使用したシステム・プロパティの構成

- 8.2.1 Fusion Middleware Controlを使用したコンテンツ・セキュリティ構成の変更

- 8.2.2 Fusion Middleware Controlを使用した一般構成の変更

- 8.2.3 Fusion Middleware Controlを使用したインターネット構成の変更

- 8.2.4 Fusion Middleware Controlを使用した電子メール構成の変更

- 8.3 一般オプションの構成

- 8.3.1 リビジョンのラベル・シーケンス

- 8.3.1.1 リビジョンのラベルの範囲

- 8.3.1.2 リビジョンの例

- 8.3.1.3 リビジョン構成設定

- 8.3.2 チャンク化機能

- 8.4 コンテンツ・セキュリティの構成

- 8.5 コンテンツ・サーバーを使用したインターネット情報の構成

- 8.6 システム・データベース・プロパティの構成

- 8.6.1 コンテンツ・サーバーのシステム・データベースについて

- 8.6.2 IBM DB2データベース検索のためのコンテンツ・サーバーの構成

- 8.7 ドキュメント・クラウド・サービス統合の設定の構成

- 8.8 サーバー・プロパティの構成

- 8.9 ローカライゼーション・プロパティの構成

- 8.9.1 日付書式の構成

- 8.9.2 インタフェース言語の構成

- 8.10 パス・プロパティの構成

9 コンポーネントの管理

- 9.1 コンポーネントについて

- 9.2 コンポーネント・マネージャの使用

- 9.2.1 コンポーネント・マネージャを使用したコンポーネントに関する情報の表示

- 9.2.2 コンポーネント・マネージャを使用したコンポーネントの有効化または無効化

- 9.2.3 コンポーネント・マネージャを使用したコンポーネントのインストール

- 9.2.4 コンポーネント・マネージャを使用したコンポーネントのアンインストール

- 9.2.5 コンポーネント・マネージャを使用したコンポーネントのダウンロード

- 9.2.6 コンポーネント・マネージャを使用したコンポーネント構成の変更

- 9.3 Fusion Middleware Controlを使用したコンポーネントの管理

- 9.3.1 コンポーネント・マネージャの使用

- 9.3.1.1 Fusion Middleware Controlを使用したコンポーネント情報の表示

- 9.3.1.2 Fusion Middleware Controlを使用したコンポーネントの有効化または無効化

- 9.3.2 拡張コンポーネント・マネージャの使用

- 9.3.2.1 Fusion Middleware Controlを使用したコンポーネントの有効化または無効化

- 9.3.2.2 Fusion Middleware Controlを使用したコンポーネントのインストール

- 9.3.2.3 Fusion Middleware Controlを使用したコンポーネントのアンインストール

- 9.3.2.4 Fusion Middleware Controlを使用したコンポーネントのダウンロード

- 9.3.2.5 Fusion Middleware Controlを使用したコンポーネント構成の変更

- 9.4 コマンドラインを使用したコンポーネントの管理

- 9.5 コンポーネント構成の更新

- 9.5.1 ContentTrackerコンポーネント構成の更新

- 9.5.2 ContentTrackerReportsコンポーネント構成の更新

- 9.5.3 DesktopIntegrationSuiteコンポーネント構成の更新

- 9.5.4 EmailMetadataコンポーネント構成の更新

- 9.5.5 Folders_gコンポーネント構成の更新

- 9.5.6 OCMコンポーネント構成の更新

- 9.5.7 PDFWatermarkコンポーネント構成の更新

- 9.5.8 SiteStudioコンポーネント構成の更新

- 9.6 コンポーネント・ウィザードを使用したコンポーネントの作成

- 9.6.1 コンポーネント・ウィザードの概要

- 9.6.2 Javaコードの使用

- 9.6.3 Readmeファイルの編集

- 9.6.4 コンポーネント・ウィザードを使用したコンポーネントの作成

- 9.6.4.1 新規コンポーネントの環境リソースの作成

- 9.6.4.2 テンプレート・リソースの作成

- 9.6.4.3 問合せリソースの作成

- 9.6.4.4 サービス・リソースの作成

- 9.6.4.5 HTMLインクルードの作成

- 9.6.4.6 文字列リソースの作成

- 9.6.4.7 動的表リソースの作成

- 9.6.4.8 静的表リソースの作成

- 9.6.4.9 コンポーネントの有効化

- 9.6.5 コンポーネント・ウィザードの追加タスク

- 9.6.5.1 コンポーネントZipファイルのビルド

- 9.6.5.2 インストール・パラメータの使用

- 9.6.5.3 コンポーネントの有効化と無効化

- 9.6.5.4 コンポーネントの削除

- 9.6.5.5 コンポーネントを開く

- 9.6.5.6 デフォルトHTMLエディタの構成

- 9.6.5.7 コンポーネントのパッケージの展開

- 9.6.5.8 パッケージ展開済のコンポーネントの追加

10 検索機能の管理

- 10.1 OracleTextSearchの管理

- 10.1.1 OracleTextSearchを使用する上での考慮事項

- 10.1.2 Oracle Text 11gの機能と利点

- 10.1.2.1 索引付けおよび問合せの速度と方法

- 10.1.2.2 高速再構築

- 10.1.2.3 問合せ構文

- 10.1.2.4 OracleTextSearchの演算子

- 10.1.2.5 大/小文字の区別およびステミングのルール

- 10.1.2.6 検索結果データのクラスタリング

- 10.1.2.7 スニペット

- 10.1.2.8 その他の変更

- 10.1.3 コンテンツ・サーバー用のOracleTextSearchの構成

- 10.1.4 OracleTextSearchの管理

- 10.1.4.1 最適化するフィールドの決定

- 10.1.4.2 最適化フィールドの割当て/編集

- 10.1.4.3 高速再構築の実行

- 10.1.4.4 検索結果で表示されるフィールドの変更

- 10.1.5 OracleTextSearchによる検索

- 10.1.6 メタデータ・ワイルドカードの使用

- 10.1.7 インターネット・スタイルの検索構文の使用

- 10.1.8 OracleTextSearch結果のスコアの調整

- 10.1.9 OracleTextSearchの検索結果のカスタマイズ

- 10.2 Oracle Secure Enterprise Searchの管理

- 10.2.1 Oracle SESを外部フルテキスト検索エンジンとして使用

- 10.2.1.1 OracleTextSearchとともに使用するようにOracle SESを構成

- 10.2.1.2 Oracle SESをOracleTextSearchとともに使用するように検索エンジンを再構成

- 10.2.2 Oracle SESでSESCrawlerExportを使用してコンテンツ・サーバーのコンテンツを検索

- 10.2.2.1 SESCrawlerExportコンポーネントへのアクセス

- 10.2.2.2 コンテンツのスナップショットの取得

- 10.2.2.3 SESCrawlerExportパラメータの構成

- 10.2.2.4 コンテンツ・サーバー・ソース格納場所スクリプトの構成

- 10.3 フルテキスト・データベース検索索引の構成

11 検索索引の構成

- 11.1 多様な索引付けツールおよび方法

- 11.2 データベースの検索索引の構成

- 11.2.1 すべてのデータベースのメタデータ検索の構成

- 11.2.2 SQL Serverのフルテキスト検索の構成

- 11.2.3 OracleTextSearchのフルテキスト検索の構成

- 11.2.4 全文検索の最適化

- 11.2.5 データベースでサポートされるファイル形式の構成

- 11.2.5.1 FormatMap

- 11.2.5.2 ExceptionFormatMap

- 11.2.6 デフォルトの索引付けの変更

- 11.2.6.1 リソースの索引付けのデフォルト

- 11.2.6.2 リソース・インクルードの索引付けの例

- 11.3 検索索引の使用

- 11.3.1 検索索引

- 11.3.2 検索索引の更新

- 11.3.3 コレクションの再構築

- 11.3.4 検索索引の更新またはコレクションの再構築の構成

- 11.3.5 フルテキストの索引付け

- 11.3.6 フルテキストの索引付けの無効化

- 11.3.7 デフォルトでのネイティブ・ファイルの索引付け

- 11.3.8 電子メールおよび添付ファイルの索引付け

- 11.4 ゾーン・テキスト・フィールドの管理

- 11.4.1 ゾーン・テキスト・フィールド

- 11.4.2 ゾーン・テキスト・フィールドの有効化および無効化

- 11.4.3 テキスト・フィールドの最小限の長さの変更

- 11.4.4 データベース検索の「次を含む」演算子の無効化

- 11.5 Oracle Query Optimizerを使用したコンテンツの検索

- 11.5.1 Oracle Query Optimizerについて

- 11.5.2 問合せ最適化プロセス

- 11.5.2.1 ステージ1: 問合せ分析

- 11.5.2.2 ステージ2: 解析

- 11.5.2.3 ステージ3: 正規化

- 11.5.2.4 ステージ4: ヒントの選択

- 11.5.2.5 ステージ5: 問合せの再フォーマット

- 11.5.3 再フォーマットされた問合せによる検索の最適化

- 11.5.3.1 例1: 1つのヒントの追加による問合せの再フォーマット

- 11.5.3.2 例2: 複数のヒントの追加による問合せの再フォーマット

- 11.5.4 認識されるヒントのタイプ

- 11.5.5 問合せヒントの構文

- 11.5.5.1 Oracleヒントの構文

- 11.5.5.2 コンテンツ・サーバーのヒントの構文

- 11.5.6 サポートされているその他のソート構造体

- 11.5.7 ヒント・ルール表

- 11.5.7.1 キー

- 11.5.7.2 表

- 11.5.7.3 列

- 11.5.7.4 演算子

- 11.5.7.5 索引

- 11.5.7.6 順序

- 11.5.7.7 値

- 11.5.7.8 AllowMultiple

- 11.5.7.9 無効

- 11.5.8 ヒント・ルール・フォームの編集

- 11.5.9 ヒント・キャッシュ

- 11.5.9.1 ヒント・キャッシュ・エントリの再利用

- 11.5.9.2 ヒント・キャッシュ管理

- 11.5.9.3 デフォルトの容量アルゴリズム

- 11.5.9.4 ヒント・キャッシュ・キーの元

- 11.5.9.5 ヒント・キャッシュの持続性

- 11.5.10 ヒント・ルールの使用

- 11.5.10.1 新規ヒント・ルールの追加および有効化

- 11.5.10.2 既存のヒント・ルールの編集

- 11.5.10.3 ヒント・ルールの無効化

- 11.5.10.4 ヒント・ルールの有効化

- 11.5.10.5 ヒント・ルールの削除

- 11.5.11 問合せコンバータの使用

- 11.5.11.1 「問合せコンバータ」ページへのアクセス

- 11.5.11.2 データ・ソースの変換

- 11.5.11.3 問合せの変換

- 11.5.11.4 変換されたデータ・ソースまたは問合せの編集

- 11.5.12 ヒント・キャッシュの更新

- 11.5.12.1 「ヒント・キャッシュ更新機能」ページへのアクセス

- 11.5.12.2 データ・ソースからのヒント・キャッシュのチェック

- 11.5.12.3 問合せからのチェック

- 11.5.12.4 データ・ソースを使用した既存のヒント・キャッシュ問合せの変更

- 11.5.12.5 問合せを使用した既存のヒント・キャッシュの変更

- 11.5.12.6 ヒント・キャッシュ・データ・ソース・エントリの削除

- 11.5.12.7 ヒント・キャッシュ問合せの削除

- 11.6 検索パフォーマンスの向上

- 11.6.1 「タイトル」フィールドでのデータベース検索の向上

- 11.6.2 不要SQL問合せの削減

12 ファイル・ストア・システムの管理

- 12.1 ファイル・ストア・システムの概要

- 12.1.1 データ管理

- 12.1.1.1 ファイル管理

- 12.1.1.2 メタデータ管理

- 12.1.1.3 ファイル・ストア

- 12.1.2 ファイル・ストア・プロバイダの機能

- 12.2 ファイル・ストア・プロバイダのアップグレードについて

- 12.2.1 DefaultFileStoreの設定

- 12.2.2 空のストレージ・ルール

- 12.3 ファイル・ストア・プロバイダの管理

- 12.3.1 ファイル・ストア・プロバイダ・ストレージの原則の理解

- 12.3.1.1 レンディションへのストレージ・ルールの使用によるストレージ・クラスの決定

- 12.3.1.2 パスの構成およびURLの解析の理解

- 12.3.2 ファイル・ストア・プロバイダによるコンテンツ・サーバーへの変更について

- 12.3.2.1 データベースのオプション

- 12.3.2.2 コンテンツ・サーバーのメタデータ・フィールド

- 12.3.3 ファイル・ストア・プロバイダのリソース表

- 12.3.3.1 PartitionList表

- 12.3.3.2 StorageRules表

- 12.3.3.3 PathMetaData表

- 12.3.3.4 PathConstruction表

- 12.3.3.5 FileSystemFileStoreAlgorithmFilters表

- 12.3.3.6 FileStorage表

- 12.3.3.7 FileCache表

- 12.3.4 ファイル・ストア・プロバイダの使用

- 12.3.4.1 パーティションの追加または編集

- 12.3.4.2 ファイル・ストア・プロバイダの編集

- 12.3.4.3 ストレージ・ルールの追加または編集

- 12.4 ファイル・ストア・プロバイダのサンプル実装

- 12.4.1 PathMetaData表のオプションの例

- 12.4.2 標準ファイルパスの構成

- 12.4.2.1 ストレージ・ルールの定義

- 12.4.2.2 パス構成の定義

- 12.4.3 WebレスまたはオプションのWebストアの構成

- 12.4.3.1 ストレージ・ルールの定義の例

- 12.4.3.2 パス構成の定義の例

- 12.4.4 データベース記憶域の構成

- 12.4.5 変更されたパス構成およびアルゴリズム

- 12.4.5.1 パーティション化の使用

- 12.4.5.2 Webレイアウト・パスへのパーティションの追加

- 12.4.5.3 1ディレクトリ内のファイル数の制限

- 12.5 Sun Storage Archive Managerの使用

- 12.5.1 SAM-QFSについて

- 12.5.2 SAM-QFSを使用する上での考慮事項

- 12.5.3 SAM-QFSのインストール

- 12.5.4 WORMを使用するコンテンツ・サーバーおよびSAM-QFSの構成

- 12.5.4.1 ボールト・パスの構成

- 12.5.4.2 WORMを有効にするためのファイル・ストア・プロバイダの構成

13 プロバイダの構成

- 13.1 コンテンツ・サーバーのプロバイダについて

- 13.2 適切なプロバイダの選択

- 13.2.1 送信プロバイダの使用が必要な状況

- 13.2.2 データベース・プロバイダの使用が必要な状況

- 13.2.3 受信プロバイダの使用が必要な状況

- 13.2.4 プレビュー・プロバイダの使用が必要な状況

- 13.2.5 JpsUserプロバイダの使用が必要な状況

- 13.2.5.1 ユーザーの直接および間接グループ・メンバーシップの取得

- 13.2.5.2 LDAPサーバーからのカスタム・フィールドのマッピング

- 13.2.5.3 アカウントの1文字のマッピング

- 13.2.5.4 JpsUserプロバイダの資格証明マップ

- 13.2.6 Ldapuserプロバイダの使用が必要な状況

- 13.3 コンテンツ・サーバーのセキュリティ・プロバイダの理解

- 13.3.1 セキュリティ・プロバイダの使用計画

- 13.3.1.1 キープアライブ接続

- 13.3.1.2 SSL接続

- 13.3.1.3 追加のセキュリティ構成

- 13.3.2 キーストアおよびトラストストア

- 13.3.2.1 キーストアおよびトラストストアの使用が必要な状況

- 13.3.2.2 キーストアおよびトラストストア情報の指定

- 13.3.2.3 キーストアの生成

- 13.3.2.4 トラストストアの作成

- 13.4 プロバイダの管理

- 13.4.1 送信プロバイダの追加

- 13.4.2 データベース・プロバイダの追加

- 13.4.3 受信プロバイダの追加

- 13.4.4 プレビュー・プロバイダの追加

- 13.4.5 受信セキュリティ・プロバイダの追加

- 13.4.6 送信セキュリティ・プロバイダの追加

- 13.4.7 JpsUserプロバイダの追加

- 13.4.8 HTTP送信プロバイダの追加

- 13.4.9 プロバイダ構成の編集

- 13.4.10 プロバイダの削除

14 URLのマッピング

- 14.1 WebUrlMapPluginコンポーネント

- 14.2 スクリプト構成

- 14.3 参照用にサポートされている変数

- 14.4 URLマッピング・エントリの追加/編集

- 14.5 マッピングの例

- 14.5.1 情報更新フォーム

- 14.5.2 動的変換

- 14.5.3 CGIパラメータ

第V部 セキュリティの管理

15 セキュリティおよびユーザー・アクセスの理解

- 15.1 コンテンツ・サーバー・セキュリティの概要

- 15.2 コンテンツ・サーバー内のセキュリティ

- 15.3 追加のセキュリティ・オプション

- 15.4 詳細セキュリティ・オプション

- 15.4.1 Oracle Advanced Security Configurationsページの有効化

- 15.4.1.1 Core QueryTextに対する詳細セキュリティ・オプションの指定

- 15.4.1.2 FrameworkFolders QueryTextに対する詳細セキュリティ・オプションの指定

16 コンテンツ・サーバー用Fusion Middlewareセキュリティの構成

- 16.1 LDAP認証プロバイダ

- 16.2 SSLを使用するためのOracle WebCenter Contentの構成

- 16.2.1 WebCenter Contentの双方向SSL通信の構成

- 16.2.2 Oracle JDeveloperの一方向SSL環境での参照の呼出し

- 16.2.3 WebCenter ContentおよびOracle HTTP ServerのSSL通信の構成

- 16.2.4 WebCenter Contentでの非SSLからSSL構成への切替え

- 16.2.5 WebCenter ContentインスタンスとOracle WebCache間のSSLの構成

- 16.2.6 一方向SSLでのカスタム・トラスト・ストアの使用

- 16.2.7 非同期プロセスの呼び出しのための非同期プロセスの有効化

- 16.2.8 有効な証明書パスのためのRIDC SSLの構成

- 16.3 シングル・サインオン用のWebCenter Contentの構成

- 16.3.1 WebCenter Contentを使用したOracle Access Manager 11gの構成

- 16.3.2 WebCenter Contentを使用したOracle Access Manager 10gの構成

- 16.3.3 WebCenter Content用のOracle Single Sign-Onの構成

- 16.3.4 最初の認証プロバイダの構成

- 16.3.5 シングル・サインオン用のWebCenter Content URLの構成

- 16.3.6 Windowsのネイティブ認証用のWebCenter Contentおよびシングル・サインオンの構成

- 16.4 Oracle Infrastructure Webサービスの構成

17 ユーザー・タイプ、ログインおよびエイリアスの管理

- 17.1 ユーザー・ログイン・タイプの概要

- 17.1.1 外部ユーザー

- 17.1.2 ローカル・ユーザー

- 17.2 ユーザー・ログインおよびエイリアスの概要

- 17.3 ログインとエイリアスの管理

- 17.3.1 ユーザー・ログインの追加

- 17.3.2 ユーザー・ログインの編集

- 17.3.3 ユーザー・ログインの削除

- 17.3.4 エイリアスの作成

- 17.3.5 エイリアスの編集

- 17.3.6 エイリアスの削除

- 17.4 ユーザー情報フィールド

- 17.4.1 新しいユーザー情報フィールドの追加

- 17.4.2 「オプション・リスト」の編集

- 17.4.3 ユーザー情報フィールドの編集

18 セキュリティ・グループ、ロール、および権限の管理

- 18.1 コンテンツ・サーバーのセキュリティ・グループの概要

- 18.1.1 セキュリティ・グループの操作のベスト・プラクティス

- 18.1.2 パフォーマンスに関する考慮事項

- 18.1.2.1 検索効率

- 18.1.2.2 ユーザー管理効率

- 18.2 コンテンツ・サーバーのグループの管理

- 18.2.1 コンテンツ・サーバーでのセキュリティ・グループの追加

- 18.2.2 コンテンツ・サーバーでのセキュリティ・グループの削除

- 18.3 コンテンツ・サーバーのロールおよび権限の概要

- 18.3.1 事前定義済のロール

- 18.3.2 権限について

- 18.3.3 事前定義済の権限

- 18.4 コンテンツ・サーバーのロールおよび権限の管理

- 18.4.1 コンテンツ・サーバーでのロールの作成

- 18.4.2 コンテンツ・サーバーでのロールの削除

- 18.4.3 Oracle WebLogic Serverを使用したユーザーへのロールの割当て

- 18.4.4 Oracle WebLogic Serverを使用した類似ユーザーへのロールの割当て

- 18.4.5 コンテンツ・サーバーでの権限の追加および編集

19 アカウントの管理

- 19.1 コンテンツ・サーバー・アカウントの概要

- 19.1.1 アカウントおよびセキュリティ・グループ

- 19.1.2 階層アカウント

- 19.1.3 パフォーマンスに関する考慮事項

- 19.1.4 外部ディレクトリ・サーバーの考慮事項

- 19.2 コンテンツ・サーバー・アカウントの管理

- 19.2.1 コンテンツ・サーバーでのアカウントの有効化

- 19.2.2 コンテンツ・サーバーでの定義済アカウントの作成

- 19.2.3 コンテンツ・サーバーでのコンテンツのチェックイン時のアカウントの作成

- 19.2.4 コンテンツ・サーバーでの定義済アカウントの削除

- 19.2.5 Oracle WebLogic Serverでのユーザーへのアカウントの割当て

- 19.3 コンテンツ・サーバー・アカウントの事例

- 19.3.1 Xalcoのセキュリティ

- 19.3.2 Xalco社のアカウント

- 19.3.3 Xalco社のロール

- 19.3.4 ロールおよび権限の表

- 19.3.5 ロールおよびユーザーの表

- 19.3.6 アカウントおよびユーザーの表

20 アクセス制御リストのセキュリティの管理

- 20.1 アクセス制御リストのセキュリティの概要

- 20.2 アクセス制御リストのセキュリティの構成

- 20.3 メタデータ・フィールド

- 20.3.1 xClbraUserListメタデータ・フィールド

- 20.3.2 xClbraAliasListメタデータ・フィールド

- 20.3.3 xClbraRoleListメタデータ・フィールド

- 20.4 アクセス制御リストの権限

- 20.4.1 空のアクセス制御リスト・フィールド

21 追加のコンテンツ・サーバーのセキュリティ接続の管理

- 21.1 プロキシ接続

- 21.2 資格証明マッピング

- 21.2.1 資格証明マッピングについて

- 21.2.2 資格証明値

- 21.2.3 アカウントおよびロールの一致

- 21.2.3.1 入力値の参照

- 21.2.3.2 権限レベル

- 21.2.3.3 置換

- 21.2.3.4 特殊文字

- 21.2.4 プロキシ資格証明マップ

- 21.2.5 資格証明マップの作成

- 21.3 コンテンツ・サーバーへのセキュアな接続

- 21.3.1 名前付きパスワード接続について

- 21.3.2 プロキシ接続データのガイドライン

- 21.3.3 プロキシ接続の作成

- 21.4 HTTPプロトコルを使用した接続

- 21.4.1 コンテンツ・サーバー接続用のHTTPプロトコルの使用について

- 21.4.2 HTTPプロバイダの構成

22 コンテンツ・サーバーの通信のカスタマイズ

- 22.1 ログイン/ログアウトのカスタマイズ

- 22.2 ブラウザURLのカスタマイズ

- 22.2.1 BrowserUrlPathのカスタマイズについて

- 22.2.2 影響を受けるIdocスクリプト変数および関数

- 22.2.3 URLパスの判断

- 22.2.4 絶対フル・パスの計算の変更

- 22.3 拡張ユーザー属性

- 22.3.1 ExtUserAttribInfo結果セット

- 22.3.2 拡張ユーザー属性の構成変数

第VI部 システム移行およびアーカイブの管理

23 システム移行およびアーカイブの理解

- 23.1 移行ツールおよびコンポーネントの概要

- 23.2 構成移行ユーティリティ

- 23.3 アーカイバ・アプリケーション

- 23.4 フォルダのアーカイブ・アプリケーション

- 23.5 フォルダ構造のアーカイブ・アプリケーション

- 23.6 ArchiveReplicationExceptionsアプリケーション

- 23.7 アーカイブ・ツールのサマリーと比較

24 システム構成の移行

- 24.1 構成移行ユーティリティの理解

- 24.1.1 移行の構造

- 24.1.2 移行テンプレートおよびバンドルについて

- 24.2 構成移行の管理

- 24.2.1 構成移行テンプレートの作成

- 24.2.2 構成テンプレートの編集

- 24.2.3 テンプレートのインポート

- 24.2.4 1回限りのエクスポートの作成

- 24.2.5 構成のエクスポート

- 24.2.6 バンドルのアップロード

- 24.2.7 バンドルのインポート

- 24.2.8 バンドルのダウンロード

- 24.2.9 アクションのステータスの表示

- 24.2.10 アクションの履歴の表示

- 24.3 移行のヒント

- 24.3.1 制限事項

- 24.3.2 移行ログ

25 アーカイブ、コレクションおよびバッチ・ファイルの管理

- 25.1 アーカイバの動作の理解

- 25.1.1 アーカイブの構造

- 25.1.2 コレクション

- 25.1.3 バッチ・ファイル

- 25.1.4 アーカイブのターゲット

- 25.1.5 アーカイブ・ログの使用

- 25.2 アーカイブの管理

- 25.2.1 新規アーカイブの作成

- 25.2.2 既存のアーカイブのコピー

- 25.2.3 コピーによる新規アーカイブの作成

- 25.2.4 アーカイブの削除

- 25.2.5 スタンドアロン・アプリケーションとしてのアーカイバの実行

- 25.3 コレクションの管理

- 25.3.1 コレクションを開く

- 25.3.2 コレクションの作成

- 25.3.3 コレクションの削除

- 25.3.4 デフォルトのアーカイブ・コレクションの移動

- 25.4 バッチ・ファイルの管理

- 25.4.1 バッチ・ファイルからのリビジョンの削除

- 25.4.2 バッチ・ファイルの削除

26 アーカイブのデータのエクスポート

- 26.1 データのエクスポートの理解

- 26.1.1 エクスポートの用途

- 26.1.2 エクスポートの方法

- 26.2 エクスポートの管理

- 26.2.1 手動でのエクスポート

- 26.2.2 コンテンツ・アイテムのエクスポート問合せの作成

- 26.2.3 構成情報のエクスポート

- 26.2.4 アーカイブへの表の追加

- 26.2.5 表のアーカイブ・プロパティの編集

- 26.2.6 表のエクスポート問合せの作成

- 26.2.7 エクスポート・オプションの設定

- 26.2.8 エクスポートの開始

27 アーカイブからのデータのインポート

- 27.1 ファイルのインポートの理解

- 27.1.1 インポートの用途

- 27.1.2 インポートの方法

- 27.2 インポート・ルールについて

- 27.2.1 インポート・ルール「更新」

- 27.2.2 インポート・ルール「リビジョン挿入」

- 27.2.3 インポート・ルール「作成挿入」

- 27.2.4 インポート・ルール「リビジョンの削除」

- 27.2.5 インポート・ルール「すべてのリビジョンを削除する」

- 27.3 データのインポート

- 27.3.1 アーカイブ済データの手動でのインポート

- 27.3.2 フィールドの変更の設定

- 27.3.3 値の変更の設定

- 27.3.4 インポート・オプションの設定

- 27.3.5 個々のリビジョンのインポート

- 27.3.6 インポートの開始

28 ファイルの転送

- 28.1 ファイルの転送の概要

- 28.1.1 転送の用途

- 28.1.2 転送の方法

- 28.1.3 転送の用語

- 28.2 転送タイプの理解

- 28.2.1 ローカル転送

- 28.2.2 プル転送

- 28.2.3 プッシュ転送

- 28.3 バッチ・ファイルの転送の動作

- 28.3.1 転送プロセスのアクション

- 28.3.2 転送ルール

- 28.4 転送の管理

- 28.4.1 コンテンツの転送

- 28.4.2 アーカイブを転送先として設定

- 28.4.3 送信転送プロバイダの定義

- 28.4.4 転送先(ターゲット)の設定

- 28.4.5 手動転送の開始

- 28.4.6 転送の削除

- 28.4.6.1 転送の削除

- 28.4.6.2 自動転送の削除

29 ファイルのレプリケート

- 29.1 レプリケーションの理解

- 29.1.1 レプリケーションの用途

- 29.1.2 レプリケーションの方法

- 29.1.3 単一リビジョンのレプリケーション

- 29.2 レプリケーションの管理

- 29.2.1 自動エクスポートの設定

- 29.2.2 自動インポートの設定

- 29.2.3 自動転送の設定

- 29.2.4 自動インポートの無効化

- 29.2.4.1 「レプリケーション」タブからのインポータの登録解除

- 29.2.4.2 「インスタンスの自動化の詳細」ページからの登録済インポータの無効化

- 29.2.5 自動エクスポートの無効化

- 29.2.6 自動転送の無効化

- 29.2.7 登録済エクスポータの削除

- 29.2.7.1 「レプリケーション」タブからの登録済エクスポータの削除

- 29.2.7.2 「インスタンスの自動化の詳細」ウィンドウからの登録済エクスポータの削除

30 コントリビューション・フォルダのアーカイブ

- 30.1 フォルダ・アーカイブ機能について

- 30.2 アーカイブ済フォルダ構造のエクスポート

- 30.3 アーカイブ済フォルダ構造のインポート

31 コントリビューション・フォルダ構造のアーカイブ

- 31.1 フォルダ構造アーカイブの理解

- 31.2 実装に関する重要な考慮事項

- 31.3 アーカイブ機能間の相違点

- 31.3.1 機能の相違点

- 31.3.2 処理の相違点

- 31.4 フォルダ構造アーカイブの管理

- 31.4.1 フォルダ構造アーカイブの作成

- 31.4.2 フォルダ構造アーカイブの更新

- 31.4.3 フォルダ構造アーカイブの使用

- 31.4.4 構成変数

- 31.4.4.1 フォルダ構造アーカイブの変数

- 31.4.4.2 Folders_gコンポーネントの変数

32 FoldersへのFolders_gの移行

- 32.1 FoldersへのFolders_gの移行の理解

- 32.2 フォルダの移行の準備

- 32.3 Foldersへの移行

- 32.4 フォルダの移行の完了後

33 Folders構造の移行

- 33.1 Folders構造の移行について

- 33.2 Folders構造データのエクスポート

- 33.3 Folders構造データのインポート

34 アーカイブおよび移行の戦略

- 34.1 エクスポート

- 34.2 インポート

- 34.3 自己エクスポート/インポート

- 34.4 1対1のアーカイブ

- 34.5 1対多のアーカイブ

- 34.6 多対1のアーカイブ

- 34.7 アーカイバの例

- 34.7.1 ラップトップへのコンテンツ・サーバー・インスタンスのコピー

- 34.7.2 「コンテンツ・タイプ」および「作成者」による転送

- 34.7.3 メタデータ・フィールドの変更

- 34.7.4 コンテンツIDの接頭辞の追加

- 34.7.5 リリース日の変更

- 34.8 構成移行のヒント

35 アーカイバ・レプリケーションの例外の使用

- 35.1 アーカイバ・レプリケーションの例外の理解

- 35.1.1 アーカイバ・レプリケーションの例外の動作

- 35.1.2 シナリオ1

- 35.1.3 シナリオ2

- 35.2 アーカイバ・レプリケーションの例外の管理および使用

第VII部 付録

A コンテンツ・サーバー用Oracle Fusion Middleware BPELコンポーネントの管理

- A.1 概要

- A.1.1 ハードウェア要件

- A.1.2 ソフトウェア要件

- A.1.3 ソフトウェアの配布

- A.2 インストール

- A.2.1 統合手順

- A.2.1.1 シナリオ1

- A.2.1.2 シナリオ2

- A.2.1.3 最終手順

- A.2.2 統合コンポーネントの有効化

- A.3 統合コンポーネントの構成

- A.3.1 アーキテクチャ

- A.3.1.1 接続構成

- A.3.2 プロセス構成

- A.3.2.1 プロセスのプロパティ

- A.3.2.2 ペイロード・マッピング

- A.3.2.3 WebCenter Contentの統合のためのBPELコンポジットの準備

- A.4 コンテンツ・サーバーでのワークフローの構成

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

- A.4.2 BPELプロセスの情報

B Need to Knowコンポーネントの管理

- B.1 概要

- B.1.1 機能

- B.1.2 適用

- B.2 Need to Knowコンポーネントのインストール

- B.3 Need to Knowコンポーネントの構成

- B.4 Need to Knowコンポーネントの使用

- B.4.1 セキュリティ構成のカスタマイズ

- B.4.1.1 コンテンツ・セキュリティ

- B.4.1.2 検索結果

- B.4.1.3 ヒット・リスト・ロール

- B.4.1.4 WHERE句の導出

- B.4.1.5 コンテンツ・メタデータ・セキュリティ

- B.4.2 Disclosure Query Securityアプレット

- B.4.3 問合せの構文

- B.4.3.1 Like演算子

- B.4.3.2 ブール演算子

- B.4.3.3 UserName変数

- B.4.3.4 stdSecurity変数

- B.4.3.5 ユーザー属性フィールド

- B.4.3.6 ユーザー・ロール

- B.4.4 コンテンツレベル問合せの定義

- B.5 管理インタフェース

- B.5.1 「NTK構成情報」ページ

- B.5.2 「コンテンツ・セキュリティ構成情報」ページ

- B.5.3 「検索結果構成情報」ページ

- B.5.4 「ヒット・リスト・ロール構成情報」ページ

- B.5.5 「NTKコンテンツ・セキュリティのテスト」ページ

- B.6 セキュリティ・カスタマイズのサンプル

- B.6.1 コンテンツ・セキュリティのサンプル

- B.6.1.1 単純なIdocスクリプト関数

- B.6.1.2 stdSecurityCheckの使用

- B.6.1.3 isStrIntersectの使用

- B.6.1.4 allStrIntersectの使用

- B.6.1.5 includeNTKReadSecurityScriptの使用

- B.6.2 検索結果のサンプル

- B.6.2.1 リンクの無効化

- B.6.2.2 リンクの変更

- B.6.2.3 イメージの変更

- B.6.3 ヒット・リスト・ロールのサンプル

- B.6.3.1 問合せヒット・リスト・ロールの使用

- B.6.3.2 ブラック・ホール・チェックインの作成

C Oracle WebCenter Content用Kofax Capture Export Connectorの管理

- C.1 概要

- C.1.1 製品の概要

- C.1.2 ソフトウェア要件

- C.1.2.1 Oracle WebCenter Contentとの互換性

- C.1.2.2 Kofax Captureとの互換性

- C.1.2.3 Adobe Acrobat Captureとの互換性

- C.2 インストール

- C.2.1 インストールのサマリー

- C.2.2 インストール前のタスクおよび考慮事項

- C.2.3 Kofax Capture Export Connectorのインストール

- C.2.3.1 更新インストールの手順

- C.2.3.2 新規インストールの手順

- C.2.4 Kofax Captureの構成

- C.2.4.1 Kofax Captureクライアント・システムの構成

- C.2.4.2 Kofax Capture Export Connectorを使用するためのKofax Captureクライアントの構成

- C.2.4.3 非デフォルト・ディレクトリでのKofax Capture Export Connectorの構成

- C.3 Kofax Capture Export Connector - Oracle WebCenter Contentの使用

- C.3.1 Kofax Captureバッチ・クラスの処理

- C.3.1.1 フォルダ

- C.3.1.2 フィールド・タイプ

- C.3.1.3 フィールド・タイプの設定

- C.3.1.4 ドキュメント・クラス

- C.3.1.5 ドキュメント・クラス索引フィールドの設定

- C.3.1.6 マップ済索引フィールド

- C.3.1.7 フォーム・タイプ

- C.3.2 リリース・スクリプトのカスタマイズ

- C.3.2.1 設定ダイアログへのアクセス

- C.3.2.2 「索引ストレージ」タブの使用

- C.3.2.3 索引値の設定

- C.3.2.4 「ドキュメント・ストレージ」タブの使用

- C.3.2.5 「イメージ形式」タブの使用

- C.3.2.6 PDF設定の指定

- C.3.2.7 リリース済イメージのファイル・タイプの設定

- C.3.2.8 複数ページのTIFF出力ファイル・タイプの選択

- C.3.2.9 TIFF、JPGまたはPCX出力ファイル・タイプの選択

- C.3.2.10 Adobe Acrobat Capture PDF出力ファイル・タイプの選択

- C.3.2.11 Adobe Acrobat Capture PDF設定の指定

- C.3.2.12 「サーバー」タブの使用

- C.3.2.13 URL、ユーザー名およびパスワードの設定

- C.3.2.14 プライマリ/代替ファイル形式の設定

- C.3.2.15 ワークフロー・ステータスの設定

- C.3.2.16 エラーが発生したAdobe Acrobat Capture PDFファイルに対するオプションの設定

- C.3.2.17 パラメータ・エディタのチェックインへのアクセス

- C.3.3 CHECKINパラメータへのKofax索引フィールドのマッピング

- C.3.3.1 必須パラメータのマッピングの設定

- C.3.3.2 オプション・パラメータのマッピングの設定

- C.3.3.3 日付および時刻パラメータの設定

- C.3.3.4 LIDebugパラメータを使用したデバッグ

- C.3.4 Kofax Captureのインストールの検証

- C.3.4.1 バッチの作成

- C.3.4.2 バッチの処理: スキャン・キュー

- C.3.4.3 バッチの処理: 検証キュー

- C.3.4.4 バッチの処理: リリース・キュー

- C.4 ユーザー・インタフェース

- C.4.1 リリース設定ページ

- C.4.2 「索引ストレージ」タブ

- C.4.3 「ドキュメント・ストレージ」タブ

- C.4.4 「イメージ形式」タブ

- C.4.5 Adobe Acrobat Captureの設定

- C.4.6 「サーバー」タブ

- C.5 Adobe Acrobat Captureの使用

- C.5.1 Adobe Acrobat Captureの構成

- C.5.1.1 監視ディレクトリの作成

- C.5.1.2 ワークフローの作成

- C.5.1.3 TIFFワークフローの作成

- C.5.1.4 JPGワークフローの作成

- C.5.2 Adobe Acrobat Capture PDFファイルのチェックイン

- C.5.2.1 プライマリ/代替ファイル形式の設定

- C.5.2.2 Adobe Acrobat Captureを実行しているコンピュータの設定

- C.5.2.3 イメージ・ファイル・リリース・ディレクトリの設定

- C.5.3 グローバル・オプションの設定

- C.5.3.1 グローバル・オプションについて

- C.5.3.2 PDFドキュメントのサルベージ

- C.5.3.3 Adobe Acrobat Captureログのエラー・チェックの制限

D Oracle WebCenter Contentのトラブルシューティング

- D.1 Oracle WebCenter Contentのトラブルシューティングの概要

- D.2 Oracle WebCenter Contentの基本のトラブルシューティングのスタート・ガイド

- D.2.1 トレースの使用

- D.2.1.1 サーバー全体のトレース

- D.2.1.2 アプレット固有のトレース

- D.2.2 スタック・トレースの使用

- D.2.3 環境パッケージャの使用

- D.2.4 Content Serverアナライザの使用

- D.2.4.1 Content Serverアナライザへのアクセス

- D.2.4.2 カスタム・アナライザのログ・ディレクトリの指定

- D.2.4.3 解析プロセスの起動

- D.2.4.4 コンテンツ・サーバー・データベースの分析

- D.2.4.5 コンテンツ・サーバー検索索引の分析

- D.2.4.6 コンテンツ・サーバー・ファイル・システムの分析

- D.2.4.7 解析の進行状況および結果の表示

- D.2.4.8 ステータス・レポートの生成

- D.2.4.9 ステータス・レポートの取消

- D.2.5 デバッグ構成変数の使用

- D.2.6 HDAファイルの分析

- D.3 Oracle WebCenter Contentのアーカイブのトラブルシューティング

- D.3.1 インポートの問題

- D.3.1.1 インポート・システムでのファイル拡張子のエラー

- D.3.1.2 インポートでの特定のバッチ・ファイルの選択

- D.3.1.3 アーカイブのインポート後にインポート時の変更設定が機能しない

- D.3.1.4 アーカイブからのインポート済コンテンツ・アイテムの識別

- D.3.1.5 コンテンツ・サーバーの重複するコンテンツ・アイテム

- D.3.1.6 プロキシ・サーバーへのアーカイブ済コンテンツのインポートが失敗する

- D.3.1.7 インポート・エラーがないのにドキュメントが欠落する

- D.3.1.8 無効な選択リスト値に関するエラー

- D.3.1.9 必須フィールドの欠落によりインポートが失敗する

- D.3.1.10 変更されたメタデータ・フィールドによりインポート中にアーカイバがフリーズする

- D.3.2 エクスポートの問題

- D.3.2.1 「エクスポート問合せ」を空白にすると全部のエクスポートが可能

- D.3.2.2 新しいチェックインおよびバッチ・ファイル転送

- D.3.2.3 ユーザー属性のエクスポート

- D.3.2.4 コレクション表のレコード数が多すぎる場合にフォルダ・アーカイブ・エクスポートが機能しない

- D.3.3 転送の問題

- D.3.3.1 ターゲットがロックアップして転送が停止される

- D.3.3.2 実行中の転送の中止/削除

- D.3.3.3 転送されたファイルの整合性の確認

- D.3.3.4 転送プロセスが機能しない

- D.3.4 レプリケーションの問題

- D.3.4.1 自動インポート機能の停止

- D.3.5 Oracle Databaseの問題

- D.3.5.1 割り当てられた表領域の超過

- D.3.5.2 Oracle DatabaseのOracle WebCenter Contentのパフォーマンスの低下

- D.3.6 その他の問題

- D.3.6.1 共有ファイル・システムを使用するアーカイブが機能しない

- D.3.6.2 送信プロバイダを経由するアーカイブが機能しない

- D.4 My Oracle Supportを使用したその他のトラブルシューティング情報

はじめに

このガイドでは、Oracle WebCenter ContentとOracle WebCenter Content Serverを管理する方法について説明します。コンテンツ・サーバーのインスタンスを起動したり停止する方法、コンテンツ・サーバーのユーティリティにアクセスして使用する方法、WebCenter Contentのコンポーネントとセキュリティを構成する方法、WebCenter Contentのリポジトリ構造とコンテンツ・アイテムのアーカイブ、取得および移行を行う方法について説明します。

対象読者

このドキュメントは、WebCenter Contentインストールとコンテンツ・サーバーのデプロイを担当するOracle Fusion Middleware管理者を対象としています。

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

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

Oracle Supportへのアクセス

サポートをご購入のOracleのお客様は、My Oracle Supportにアクセスして電子サポートを受けることができます。詳細情報は(http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info) か、聴覚に障害のあるお客様は (http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs)を参照してください。

関連ドキュメント

詳細は、Oracle WebCenter Contentドキュメント・セットに含まれる次のドキュメントを参照してください。

- Oracle WebCenter Contentリリース・ノート

- Oracle WebCenter Contentのマネージング

- Oracle WebCenter Contentでの開発

- Oracle WebCenter Contentのインストールおよび構成

- Oracle WebCenter Content評価インスタンスのインストール

- Oracle WebCenter Contentの使用方法

- WebLogic Scripting Toolコマンド・リファレンス

表記規則

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

規則

意味

太字

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

イタリック体

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

固定幅フォント

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

WebCenter Content用語

WebCenter Contentのドキュメントでは、WebCenter Contentとコンテンツ・サーバーの構成に関連するディレクトリの変数を参照するするとき、次の用語を使用しています。

- IdcHomeDir: この変数は、Oracle WebCenter Contentサーバー・メディアが配置されているOracle WebCenter Contentホームのucm/idcディレクトリを参照します。サーバー・メディアは、Oracle WebCenter Content Server、Oracle WebCenter Content: Inbound RefineryまたはOracle WebCenter Content: Recordsのソフトウェアを実行できます。これは、基本的に読取り専用のディレクトリです。デフォルトの場所はWCC_ORACLE_HOME/ucm/idcです。デフォルトの場所の変数部分は変更可能ですが、パスをucm/idcから変更することはできません。

- DomainHome: この変数は、Oracle WebLogic Serverのアプリケーション・サーバー上で実行するためにOracle WebCenter Contentアプリケーションがデプロイされるユーザー指定ディレクトリを参照します。DomainHome/ucm/short-product-id/binディレクトリには、intradoc.cfgファイルおよび実行可能ファイルがあります。DomainHomeのデフォルトの場所はMW_HOME/user_projects/domains/base_domainですが、このパスとドメイン名(base_domain)は、アプリケーション・サーバーにOracle WebCenter Contentアプリケーションをデプロイするときに変更できます。

- short-product-id: この変数は、アプリケーション・サーバーにデプロイされるOracle WebCenter Contentサーバーのタイプを参照します。この名前はコンテキスト・ルート(デフォルトはHttpRelativeWebRoot構成値)として使用されます。可能な値には、次のものが含まれます。

- cs (Oracle WebCenter Content Server)

- ibr (Oracle WebCenter Content: Inbound Refinery)

- urm (Oracle WebCenter Content: Records)

- IntradocDir: この変数は、アプリケーション・サーバーにデプロイされているOracle WebCenter Contentアプリケーションの一部であるOracle WebCenter Contentインスタンスに固有の、構成およびデータ・ファイルのルート・ディレクトリを参照します。Oracle WebCenter Contentインスタンスのいずれかのタイプ(コンテンツ・サーバー(cs)、Inbound Refinery (ibr)またはRecords (urm))用に、このIdocスクリプト変数を構成します。このディレクトリは別の場所にあってもかまいませんが、デフォルトの場所はDomainHome/ucm/short-product-idです。指定したディレクトリは、インスタンス・ディレクトリへの絶対パスで、特定のサーバーまたはノードに一意である必要があります。このディレクトリにはbin/ディレクトリがあり、ここには起動ファイル(intradoc.cfgおよび実行可能ファイル)が格納されています。

このガイドで説明する新機能

次のトピックでは、Oracle WebCenter Contentの新機能と変更された機能について、およびこのガイドに記載されるその他の重要な変更について紹介し、詳細情報へのリンクを提供します。

このガイドは、以前Oracle Fusion Middleware Oracle WebCenter Contentのシステム管理者ガイドと呼ばれていたガイドの新しいエディションです。他のOracle Fusion Middleware管理ドキュメントとの情報の一貫性を維持するために再構築されました。

11gリリース1 (11.1.1.9.2)の新機能と変更された機能

Oracle Documents Cloud ServiceへのOracle WebCenter Content統合の構成に関する追加情報。「ドキュメント・クラウド・サービス統合の設定の構成」を参照してください。

11g リリース1 (11.1.1.9.0)の新機能と変更機能

このガイドは、11gリリース1 (11.1.1.9.0)でいくつかの点が更新されました。追加または変更の内容は次のとおりです。

- コンテンツ・アイテムにチェックイン中の接頭辞として別のアカウントを使用したアカウントの作成に関する項に注意が追加されました。第19.2.3項「コンテンツ・サーバーでのコンテンツのチェックイン時のアカウントの作成」を参照してください。

- ストップワードの使用を推奨しないアカウントの作成に関する項に注意が追加されました。第19.1項「コンテンツ・サーバー・アカウントの概要」を参照してください。

- Oracle Access Managerでのコンテンツ・サーバー・ソースの構成に説明が追加されました。第10.2.2.3.3項「Oracle Access Managerでのコンテンツ・サーバー・ソースの構成」を参照してください。

- OracleTextSearch結果のスコアの調整に関する項が追加されました第10.1.8項「OracleTextSearch結果のスコアの調整」を参照してください。

- ブログ記事「About Access Control for Lis」へのリンクが追加されました。第20.2項「アクセス制御リストのセキュリティの構成」を参照してください。

- ブログ記事「Expanding on requestaudit – Tracing who is doing what…and for how long」へのリンクが追加されました。第D.2.1.1項「サーバー全体のトレース」を参照してください。

- 不要SQL問合せの削減に関する項が追加されました。第11.6.2項「不要SQL問合せの削減」を参照してください。

- アクセス制御リストの許可に注意が追加されました。第20.4項「アクセス制御リストの権限」を参照してください。

11gリリース1 (11.1.1.8.0)の新機能と変更された機能

このガイドは、リリース11g (11.1.1.8)でいくつかの点が更新されました。追加または変更の内容は次のとおりです。

- 「管理サーバー」ページには、専用のユーザー・インタフェース・ページがなくなりました。「管理サーバー」ページから起動するために使用されるツールが、「管理」トレイまたはメニュー「一般構成」、「コンポーネント・マネージャ」、「インターネットの構成」および「コンテンツ・セキュリティ」から呼び出せるようになりました。第2.3.1.1項を参照してください。

- コンテンツ・サーバーのステータス情報にアクセスするための「システム監査情報」ページの使用に関する情報が更新されました。第5.4項を参照してください。

- Inbound Refineryインスタンスの起動および停止に関する情報が追加されました。第3.2項を参照してください。

- Oracle Fusion Middleware Enterprise Managerを使用したInbound Refineryインスタンスの監視に関する情報が追加されました。参照してください。

- コンテンツ・サーバー・インスタンスの一部のインターネット構成設定が、SSL、HTTPアドレスおよびSMTPポートを使用するユーザー・インタフェースから変更できなくなりました。第8.2.3項および第8.5項を参照してください。

- WebブラウザURLカスタマイズで使用される構成変数HttpBrowserAdminUsesAbsolutePathおよびHttpBrowserUseAdminSSLがサポートされなくなりました。これは、(管理サーバーの)管理サービスの場所が変更されたためです。管理サーバーのパス(httpAdminCgiPathで設定)が、通常のコンテンツ・サーバーのパス(httpCgiPathで設定)と同じ方法で計算されるようになりました。

- 特定のContent Serverコンポーネントの構成設定を変更するために、「コンポーネント構成の更新」ページを使用する方法の説明が追加されました。第9.5項を参照してください。

第I部

Oracle WebCenter Contentの概要

この部では、Oracle WebCenter Contentの概要を説明し、システムを管理するためのプライマリ・タスクを要約します。

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

- 第1章「Oracle WebCenter Contentの管理の概要」

1 Oracle WebCenter Contentの管理の概要

この章では、Oracle WebCenter Contentシステムの概要および基本的なシステム管理タスクの概要について説明します。

この章の内容は、次のとおりです。

- Oracle WebCenter Contentの概要

- Oracle WebCenter Contentの管理の基本タスク

1.1 Oracle WebCenter Contentの概要

Oracle WebCenter Contentを使用すると、ユーザーは、エンドツーエンド(作成からアーカイブまで)のコンテンツ・ファイル・サイクル管理で、ドキュメント・ファイル、イメージ・ファイル、およびリッチ・メディア・ファイルを管理できます。

WebCenter Contentシステムには、コア・コンテンツ管理機能を提供するOracle WebCenter Content Serverがデフォルトで含まれています。この管理機能により、コンテンツ、イメージ、デジタル・アセット、レコード、コンテンツ変換およびデスクトップ操作を管理するための多様な機能をサポートします。

WebCenter Contentの概念とアプリケーションは、Oracle WebCenter Contentの理解に関する項を参照してください。

1.1.1 コンテンツ・サーバー

コンテンツ・サーバーは、多種多様なWebCenter Content管理機能の基盤になります。それによって提供される柔軟かつセキュアで集中化されたWebベースのリポジトリによって、コンテンツ・ライフサイクルのすべてのフェーズ(作成と承認から公開、検索、失効およびアーカイブや配置に至るまで)を管理できます。

Oracle WebCenter Content管理には、コンテンツ・サーバーの構成と管理が必要になります。コンテンツ・サーバーには、システム・データベースと、その他のソフトウェア(ユーザー認証や認可用のOracleソフトウェア、ドメインレベルのシステム制御と監視用のOracle Fusion Middlewareなど)が含まれています。また、最適なシステム・パフォーマンスの維持に必要なソフトウェアも含まれています。

WebCenter Content管理では、システム機能を管理するために、高度な機能を提供するコンテンツ・サーバー・コンポーネントを使用します。WebCenter Contentシステムには、自動的に有効化されるコンポーネントと、システムのインストール後に有効化できるコンポーネントがあります。また、Content Serverでは、カスタマイズされたコンポーネントの作成に使用できるソフトウェアも提供されます。コンポーネントをカスタマイズする方法の詳細は、『Oracle WebCenter Contentでの開発』を参照してください。

1.1.2 コンテンツ管理

コンテンツ・リポジトリは、WebCenter Contentシステムの中核部です。コンテンツには、ドキュメント、レコード、イメージ、オーディオ・ファイルなど、多様な形式を使用できます。システムにチェックインされたすべてのコンテンツはリポジトリに保存され、そのコンテンツへの適切な権限を持つユーザーによってそこから管理されます。

組織全体のすべてのコントリビュータが、ネイティブ・デスクトップ・アプリケーションからコンテンツを簡単に提供し、リッチ・ライブラリ・サービスを使用してビジネス・コンテンツを効率的に管理し、Webブラウザを使用してどこからでもそれらのコンテンツに安全にアクセスできます。

コンテンツ・タイプに関係なく、すべてのコンテンツが、管理、再利用およびアクセスのためにWebリポジトリまたはデータベースに保存されます。リポジトリに保存されている間、すべてのコンテンツ・タイプ(電子メール、ディスカッション、ドキュメント、レポート、スプレッドシート、およびレコードからイメージ、マルチメディアまたはその他のデジタル形式まで)に、一連の同じ基本コア・サービスが提供されます。

WebCenter Content管理には、コンテンツ変換、ワークフロー、メタデータ、レコード管理などをサポートする、内部機能およびアプリケーションの管理が必要になります。これらのOracle WebCenter Contentの機能を管理する方法の詳細は、『Oracle WebCenter Contentのマネージング』を参照してください。

1.2 Oracle WebCenter Contentの管理の基本タスク

表1-1のロードマップは、アプリケーションをインストールして初期構成を完了した後で、WebCenter Contentを管理するためにシステム管理者が実行できる一般的なタスクの概要を示しています。

WebCenter Contentのインストールの詳細は、『Oracle WebCenter Contentのインストールと構成』を参照してください。

表1-1 ロードマップ: Oracle WebCenter Contentの管理

タスク

ドキュメント

管理対象サーバーの起動と停止

構成の変更内容を有効にする場合や定期メンテナンスのために、Oracle WebCenter ContentアプリケーションがデプロイされているOracle WebLogic Server管理対象サーバーを再起動します。

- コンテンツ・サーバーおよびInbound Refineryの起動と停止

パフォーマンスの監視

WebCenter Contentアプリケーションに関するパフォーマンスの分析と現在のステータスの監視を行います。

- Fusion Middleware Controlを使用したコンテンツ・サーバーおよびInbound Refineryの監視

- コンテンツ・サーバーのステータスの監視

ログ・ファイルの表示および管理

ログ・ファイルによって問題の特定と診断を行います。WebCenter Contentのログには、多種のイベント(起動と停止の情報、エラー、警告、その他の情報など)が記録されます。

- コンテンツ・サーバーのログ・ファイルの監視

- Oracle WebCenter Contentのトラブルシューティング

リポジトリへのコンテンツのロード

コンテンツ・サーバー・アプリケーションを使用して、大量のコンテンツをコンテンツ・サーバー・リポジトリにロードします。

- コンテンツのバッチ・ロード

データのバックアップおよび移行

コンテンツ・サーバーのメタデータとコンテンツをアーカイブ、復元、および移行します。

- システム構成の移行

- アーカイブ、コレクションおよびバッチ・ファイルの管理

- アーカイブのデータのエクスポート

- アーカイブからのデータのインポート

- ファイルの転送

- ファイルのレプリケート

- コントリビューション・フォルダのアーカイブ

- コントリビューション・フォルダ構造のアーカイブ

- Folders構造の移行

アプリケーション・プロパティの調整

WebCenter Content環境とコンテンツ・サーバーのパフォーマンスに関連する設定を構成または再構成します。

- システム・プロパティの構成

- プロバイダの構成

- コンポーネントの管理

- 検索機能の管理

- 検索索引の構成

- ファイル・ストア・システムの管理

内部コンテンツ・サーバー・アプリケーションの詳細は、『Oracle WebCenter Contentのマネージング』を参照してください。

セキュリティ・プロパティの調整

WebCenter Content環境とContent Serverのセキュリティに関連する設定を構成または再構成します。

- コンテンツ・サーバー用Fusion Middlewareセキュリティの構成

- ユーザー・タイプ、ログインおよびエイリアスの管理

- セキュリティ・グループ、ロール、および権限の管理

- アカウントの管理

- アクセス制御リストのセキュリティの管理

- 追加のコンテンツ・サーバーのセキュリティ接続の管理

- コンテンツ・サーバーの通信のカスタマイズ

デフォルトでは、ユーザー、グループ、およびアカウントは、選択したLDAPプロバイダ、Oracle WebLogic Server、およびその他のOracleセキュリティ・ソフトウェアで管理される点に注意してください。一部の構成は、コンテンツ・サーバーのセキュリティ設定で実行します。

関連アプリケーションの構成

関連アプリケーションの構成または再構成を行います。

- Need to Knowコンポーネントの管理

- コンテンツ・サーバー用Oracle Fusion Middleware BPELコンポーネントの管理

- Oracle WebCenter Content用Kofax Capture Export Connectorの管理

第II部

スタート・ガイド

この部では、Oracle WebCenter Content管理インタフェースとツールの使用、およびコンテンツ・サーバー・インスタンスにアクセスして制御する方法を説明します。

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

- 第2章「Oracle WebCenter Contentの管理のスタート・ガイド」

- 第3章「システム・プロセスの管理」

- 第4章「バッチ・ロード・コンテンツ」

2 Oracle WebCenter Contentの管理のスタート・ガイド

この章では、Oracle WebCenter Contentのシステム管理職責、インタフェース、アプレット、ユーティリティおよびその他のツールに関する情報を提供します。

このドキュメントは、WebCenter Contentソフトウェアがすでにインストールされ、使用できる状態であると仮定して書かれています。WebCenter Contentソフトウェアとコンテンツ・サーバー・インスタンスのインストールおよび初期構成オプションの設定の詳細は、『Oracle WebCenter Contentのインストールと構成』を参照してください。

この章の内容は次のとおりです。

- システム管理者のロールと職責の理解

- システム管理者インタフェースの理解

- WebCenter Contentシステムの管理ツールの理解

- Oracle WebCenter Contentのアクセス

2.1 システム管理者のロールと職責の理解

Oracle WebCenter Contentシステム管理者が管理タスクを実行するためには、2つの管理ロールが割り当てられている必要があります。1つ目はサイトの認証および認可ソフトウェアが使用されているOracle WebLogic Serverドメインの管理ロール、2つ目はOracle WebLogic Serverを介するOracle WebCenter Contentの管理ロールです。ユーザーがEnterprise Management Fusion Middleware Control、WebCenter ContentがデプロイされているOracle WebLogic Serverドメイン、およびWebCenter Contentシステムとコンテンツ・サーバー・インスタンスに対して完全な管理権限を持つためには、両方のロールが必要です。

通常、管理者はWebCenter Contentソフトウェアのインストール中に指定されます。WebCenter Contentには、特定のアプリケーションの管理に権限が制限された管理者やWebCenter Contentインスタンスごとの管理者など、複数のシステム管理者を割り当てられます。管理者アカウントおよびロールの構成の詳細は、『Oracle WebCenter Contentのインストールと構成』を参照してください。

WebCenter Content管理者は、Oracle Enterprise Manager Fusion Middleware Controlインタフェース、Oracle WebLogic Server管理コンソール、およびコンテンツ・サーバーのアプリケーションとユーティリティを使用して、次のタスクを含む管理タスクを実行できます。

- コンテンツ・サーバー・インスタンスの起動と停止

- WebCenter Contentシステム設定の構成

- WebCenter Contentセキュリティの構成(内部およびFusion Middlewareコンポーネントとの統合の両方)

- WebCenter Contentユーザー・アカウント、ロール、権限、ユーザー・グループおよびグループ・アカウントの作成および割当て(サイトに使用される認証/認可およびデータベース・ソフトウェアの管理者と共有できます)

- WebCenter Content検索ツールの構成と実装

- WebCenter Contentシステムおよびカスタム・コンポーネントの管理

- WebCenter Contentシステムの移行およびアーカイブの管理

- WebCenter Contentインスタンスの監視およびトラブルシューティング

追加の管理タスクとして、リポジトリ、ワークフロー、コンテンツ変換、イメージング、レコードなどのコンテンツ・サーバー機能の構成と管理があります。これらのタスクについては、『Oracle WebCenter Contentのマネージング』で説明されています。

2.2 システム管理者インタフェースの理解

Oracle WebCenter Contentシステム管理者は、特定のタスクを実行するためのブラウザ・インタフェースをいくつか持っています。

- 第2.2.1項「WebCenter Content Server管理インタフェースについて」

- 第2.2.2項「Oracle Enterprise Manager Fusion Middleware Controlについて」

- 第2.2.3項「Oracle WebLogic Server管理コンソールについて」

2.2.1 WebCenter Content Server管理インタフェースについて

「管理」トレイはWebCenter Content Serverブラウザ・インタフェースのデフォルト・レイアウトで、ここからコンテンツ・サーバーの管理ログ・ファイルにアクセスしたり、コンテンツ・サーバーのアプリケーションやツールを構成および管理するためのページにアクセスできます。

「管理」トレイにアクセスするには、コンテンツ・サーバー管理者としてログインし、「管理」を選択して、使用可能な管理オプションを表示します。コンテンツ・サーバー・インスタンスがメニューを使用するように構成されている場合は、「管理」を選択すると同じオプションがメニュー・レイアウトで表示されます。図2-1に、オプションを表示するように「管理」が開かれたOracle WebCenter Contentのトレイ・レイアウトの例を示します。

図2-1 Oracle WebCenter Contentの「管理」トレイの例

注意:
WebCenter Content管理者は、ネイティブ11インタフェースを使用して、管理ページおよびアプリケーションにより管理タスクを実行します。Oracle WebCenter Contentアプリケーションは、デフォルトでは、管理者とユーザーの両方に対してネイティブ11gインタフェースを使用するように構成されています。WebCenter ContentがWebCenter Contentユーザー・インタフェース(11.1.1.8時点で最新)を使用するように構成されている場合でも、管理者はネイティブ11gインタフェースを使用する必要があります。詳細は、『Oracle WebCenter Contentのインストールと構成』のWebCenter Contentユーザー・インタフェースによるコンテンツ・サーバーの構成に関する項および『Oracle WebCenter Contentの使用』のWebCenter Contentユーザー・インタフェースのスタート・ガイドに関する項を参照してください。

コンテンツ・サーバーの管理アプレットや構成ツールには、「管理アプレット」ページからアクセスできます。このページにアクセスするには、WebCenter Content管理者としてログインし、「管理」を選択してから「管理アプレット」を選択します。

Webブラウザを使用してアクセスした管理アプレットは、ネイティブ11gインタフェースにのみ表示され、このインタフェースでのみ使用できます。

図2-2 「管理アプレット」ページ

注意:
、管理アプレット・ページからアクセスするコンテンツ・サーバー管理アプレットおよびツールは、Apple Safariブラウザと互換性がありません。

注意:
Sun JDK 1.3/1.4 Javaプラグインを使用中のブラウザからJavaアプレット(コンテンツ・サーバーの管理アプレットや複数ファイル・アップロード・アプレットなど)を開始した場合に問題が発生することがあります。これらの問題は、初めてアプレットを起動する場合の認証や、親ウィンドウが変更された場合のアプレットの終了に関連します。

2.2.2 Oracle Enterprise Manager Fusion Middleware Controlについて

Fusion Middleware Controlは、ファーム、ドメインおよびWebCenter Contentインスタンスの監視と管理に使用できるWebベースのインタフェースです。

ファームとは、Fusion Middleware Controlによって管理されるコンポーネントのコレクションのことです。これには、1つのOracle WebLogic Serverドメイン、1つの管理サーバー、1つ以上の管理対象サーバー、複数のクラスタ、1つ以上のOracleインスタンス、およびOracle WebCenter ContentなどのドメインまたはOracleインスタンスにインストールされ、構成され、実行されているOracle Fusion Middlewareコンポーネントを含めることができます。

Fusion Middleware Controlでは、ファーム、ドメイン、サーバー、コンポーネントおよびアプリケーションについて、幅広いパフォーマンス・データと管理機能がWebベースの個別のホームページにまとめられています。このホームページを使用すると、あるコンポーネントの最も重要な監視データや最も頻繁に使用される管理機能に対して、Webブラウザから簡単にアクセスできます。

Fusion Middleware Controlの用途は次のとおりです。

- Oracle WebLogic Serverの起動と停止

- コンポーネントの起動と停止

- アプリケーションの起動と停止

- ログ・ファイルへのアクセスとログ構成の管理

- Oracle BPEL Process ManagerのMBeanプロパティの変更

- Oracle BPEL Process Managerアプリケーションなどのデバッグ・アプリケーション

- ADFアプリケーションのデプロイ

- Java EEアプリケーションのデプロイ

- 監査の構成および管理

- SSLの構成

- Oracle HTTP Serverの管理

- Oracle Web Cacheの管理

Fusion Middleware ControlにアクセスしてWebCenter Contentを管理する方法の詳細は、第2.4.1項を参照してください。Fusion Middleware Controlにアクセスして使用する方法の詳細は、『管理者ガイド』のOracle Enterprise Manager Fusion Middleware Controlのスタート・ガイドに関する項を参照してください。

Fusion Middleware Controlコンソールの使用中に詳細を参照するには、ページ上部の「ヘルプ」をクリックしてください。ほとんどの場合、「ヘルプ」ウィンドウが表示され、現在のページに関するヘルプ・トピックが表示されます。「ヘルプ」ウィンドウの「目次」をクリックしてヘルプ・トピックのリストを参照したり、「検索」をクリックして特定の語や句を検索できます。

2.2.3 Oracle WebLogic Server管理コンソールについて

Oracle WebLogic Server管理コンソールはWebベースのインタフェースであり、WebLogic Serverドメインを管理するために使用します。これは、管理サーバーへのネットワーク・アクセスでサポートされるWebブラウザからアクセスできます。WebLogic Serverドメインには、1つ以上のWebLogic Serverが含まれます。アプリケーションはドメインの一部として管理します。

各ドメイン内のWebLogic Serverインスタンスの1つは、管理サーバーとして構成されます。管理サーバーはWebLogic Serverドメインを管理するための中枢になります。ドメイン内の他のすべてのWebLogic Serverインスタンスは、管理対象サーバーと呼ばれます。WebLogic Serverインスタンスが1つしかないドメインでは、そのサーバーが管理サーバーと管理対象サーバーの両方として機能します。管理サーバーは、管理コンソールをホストします。これは、管理サーバーへのネットワーク・アクセス権を持つ、サポートされているWebブラウザからアクセスできるWebアプリケーションです。管理対象サーバーでアプリケーションがホストされます。

管理コンソールの用途は次のとおりです。

- WebLogic Serverドメインの構成、起動および停止

- WebLogic Serverクラスタを構成します。

- データベース接続(JDBC)やメッセージング(JMS)などの、WebLogic Serverサービスを構成します。

- ユーザー、グループおよびロールの作成、管理などの、セキュリティ・パラメータを構成します。

- アプリケーションの構成およびデプロイ

- サーバーおよびアプリケーションのパフォーマンスを監視します。

- サーバーおよびドメインのログ・ファイルを表示します。

- アプリケーション・デプロイメント記述子を表示します。

Oracle WebLogic Server管理コンソールの使用方法の詳細は、いずれかの「管理コンソール」ページから「ヘルプ」をクリックするか、または『管理者ガイド』を参照してください。

2.3 WebCenter Contentシステムの管理ツールの理解

オラクル社では、WebCenter Contentシステムおよびコンテンツ・サーバー・インスタンスの管理用ソフトウェア・ツールを提供しています。WebCenter Content管理者は、特定の手順でファイルを編集する必要がある場合を除き、構成ファイルを直接編集するのではなく、これらのツールを使用してコンテンツ・サーバーの管理タスクを実行する必要があります。ファイルを編集すると、設定に不整合が生じて問題が発生する場合があります。

WebCenter Contentシステムには、プロセス、プロバイダ、アーカイブ、ユーザーなどを管理するための個別の管理ユーティリティおよびアプリケーションが備えられています。

- 第2.3.1項「コンテンツ・サーバーのツールについて」

- 第2.3.2項「Oracle WebLogicスクリプティング・ツール(WLST)について」

Javaブラウザ・プラグインおよびアプレット表示の問題の詳細は、インストレーション・ガイドおよびデプロイメント・ガイドのブラウザの注意事項の項を参照してください。

2.3.1 コンテンツ・サーバーのツールについて

コンテンツ・サーバーには、システムの操作を構成およびメンテナンスするための次の管理ソフトウェア・ツールが用意されています。

- 第2.3.1.1項「管理ページ」

- 第2.3.1.2項「アプリケーション」

- 第2.3.1.3項「ユーティリティ」

- 第2.3.1.4項「IdcShellコマンドライン・ツール」

2.3.1.1 管理ページ

管理ページにアクセスするには、Webブラウザを使用して「管理」を選択してから、コンテンツ・サーバー・インタフェースで管理オプションを選択します。一般的な管理ページのいくつかをここに示します。

注意:
WebCenter Content管理者は、ネイティブ11インタフェースを使用して、管理ページおよびアプリケーションにより管理タスクを実行します。Oracle WebCenter Contentアプリケーションは、デフォルトでは、管理者とユーザーの両方に対してネイティブ11gインタフェースを使用するように構成されています。WebCenter ContentがWebCenter Contentユーザー・インタフェース(11.1.1.8時点で最新)を使用するように構成されている場合でも、管理者はネイティブ11gインタフェースを使用する必要があります。WebCenter Contentユーザー・インタフェースの詳細は、『Oracle WebCenter Contentのインストールと構成』のWebCenter Contentユーザー・インタフェースによるコンテンツ・サーバーの構成に関する項および『Oracle WebCenter Contentの使用』のWebCenter Contentユーザー・インタフェースのスタート・ガイドに関する項を参照してください。

- 管理サーバー: 特定のコンテンツ・サーバーの設定を構成します。コンテンツ・サーバー・インスタンスには独自の管理サーバー・インスタンスがあり、WebCenter Contentドメインのコンテンツ・サーバー・インスタンスを管理します。コンテンツ・サーバー・インスタンス用の管理サーバーによって提供される機能は、Fusion Middleware Controlを使用しても実行できます。

- コンポーネント・マネージャ: コンテンツ・サーバーに機能を追加するコンポーネントの表示、有効化または無効化、インストールまたはアンインストールおよびダウンロードを行います。

- 一般構成: WebCenter Content Serverを構成するために使用される様々な設定(アカウントの有効化、独自のコンテンツ・サーバー・デプロイメントに固有の構成変数の追加など)を指定します。

- コンテンツ・セキュリティ: コンテンツ・サーバーで選択したコンテンツ・セキュリティ・オプションを設定または変更します。

- インターネットの構成: コンテンツ・サーバーのインターネット・オプションを表示または変更します。

- ローカライズ: コンテンツ・サーバー・インスタンスに対して有効化または無効化したロケールを表示および変更します。

- プロバイダ: プロバイダの追加、プロバイダ情報の構成およびプロバイダのテストを行います。

2.3.1.2 アプリケーション

次のコンテンツ・サーバー・アプリケーションは、「管理アプレット」ページからスタンドアロン・アプリケーションとして、Webブラウザでアプレットとして、または各ツール・インタフェースで「アプリケーション」メニューを選択することによって起動できます。

注意:
WebCenter Content管理者は、ネイティブ11インタフェースを使用して、管理ページおよびアプリケーションにより管理タスクを実行します。Oracle WebCenter Contentアプリケーションは、デフォルトでは、管理者とユーザーの両方に対してネイティブ11gインタフェースを使用するように構成されています。WebCenter ContentがWebCenter Contentユーザー・インタフェース(11.1.1.8時点で最新)を使用するように構成されている場合でも、管理者はネイティブ11gインタフェースを使用する必要があります。WebCenter Contentユーザー・インタフェースの詳細は、『Oracle WebCenter Contentのインストールと構成』のWebCenter Contentユーザー・インタフェースによるコンテンツ・サーバーの構成に関する項および『Oracle WebCenter Contentの使用』のWebCenter Contentユーザー・インタフェースのスタート・ガイドに関する項を参照してください。

構成マネージャ、リポジトリ・マネージャ、Webレイアウト・エディタおよびワークフロー管理アプリケーションの詳細は、『Oracle WebCenter Contentのマネージング』を参照してください。

- アーカイバ: コンテンツ・サーバーのファイルと情報をエクスポート、インポート、転送およびレプリケートします。詳細は、システムのアーカイブと移行の管理に関する章を参照してください。

- 構成マネージャ: コンテンツ・タイプ、ファイル形式およびカスタム・メタデータ・フィールドを管理します。

- リポジトリ・マネージャ: ファイル診断、ファイル管理機能、検索データの索引再作成およびサブスクリプション管理機能を実行します。

- ユーザー管理: ローカル・ユーザー・ベースの管理、セキュリティの設定(ロールおよび権限をユーザーに割り当てることによって)、エイリアスの定義、セキュリティ・グループの管理を実行します。

- Webレイアウト・エディタ: Webサイトの構築、レポートの操作、問合せの書込みを実行します。

- ワークフロー管理: コンテンツを特定のユーザーにルーティングしてアクションを求めるようにワークフローを設定します。

2.3.1.3 ユーティリティ

次のユーティリティは、コンテンツ・サーバー・インスタンスがインストールされているコンピュータからスタンドアロン・アプリケーションとしてのみ起動できます。スタンドアロン・アプリケーションの実行方法の詳細は、第3.5.2項を参照してください。

- バッチ・ローダー: 大量のコンテンツ・アイテムを同時に更新またはチェックします。

- コンポーネント・ツール: コマンドラインを使用して、コンテンツ・サーバーのコンポーネントをインストールおよび有効化または無効化します。

- コンポーネント・ウィザード: コンテンツ・サーバーの動作を変更するカスタム・コンポーネントを作成およびインストールします。

- コンテンツ・アナライザ: ファイル・システム、データベース、検索索引など、コンテンツ・サーバー・リポジトリ・コンテンツの整合性を確認します。

- システム・プロパティ: コンテンツ・サーバー・インスタンスのシステム・オプションおよび機能を構成します。

2.3.1.4 IdcShellコマンドライン・ツール

IdcShellツールを使用すると、管理者はコマンド・ラインからIdocスクリプトを実行できます。Idocスクリプトは、WebCenter Content用の独自のサーバー側スクリプト言語です。詳細は、第3.6項および『Oracle WebCenter Contentでの開発』を参照してください。

2.3.2 Oracle WebLogicスクリプティング・ツール(WLST)について

Oracle WebLogic Scripting Tool (WLST)は、コンテンツ・サーバー・インスタンスを持つOracle WebCenter ContentなどのFusion Middlewareコンポーネントをコマンドラインから管理するために使用できます。

WebLogic Scripting Toolは、Oracle WebLogic Serverドメインを作成、管理および監視するためのコマンドライン・スクリプト環境です。これは、Javaのスクリプト・インタプリタであるJythonがベースとなっています。WebLogic Scripting Toolでは、ローカル変数、条件変数、フロー制御文などの標準のJython機能がサポートされている以外に、Oracle WebLogic Serverインスタンスに固有の一連のスクリプト関数(コマンド)が用意されています。管理者は、Jython言語構文に従って、サイト固有の要件を満たすよう、WebLogicスクリプト言語を拡張できます。

Oracle WebCenter Contentは、コンテンツ・サーバー・アプリケーション接続(リポジトリ、ポートレット・プロデューサ、外部アプリケーションなどのバックエンド・サービスへの接続)を管理するカスタムWLSTコマンドと、WebCenter Contentのユーザー・インタフェース(Oracle Development Application Frameworkに基づいたインタフェース)を構成するWLSTコマンドでサポートされます。Oracle WebCenter Content Serverに固有のすべてのWLSTコマンドについては、『WebLogic Scripting Toolコマンド・リファレンス』で説明されています。

2.4 Oracle WebCenter Contentのアクセス

Oracle WebCenter Content管理者は、WebCenter Contentインスタンスを管理するための複数のインタフェースと、データベースおよびセキュリティのための関連ソフトウェアを使用します。WebCenter Contentインスタンスの日々のタスクを管理するための主な2つのインタフェースは、管理機能を含む、Fusion Middleware ControlおよびOracle WebCenter Contentユーザー・インタフェースです。次で、これらのインタフェースを使用方法の手順とともに説明しています。

- 第2.4.1項「Fusion Middleware Controlを使用したWebCenter Contentへのアクセス」

- 第2.4.2項「Webブラウザを使用したWebCenter Contentインスタンスへのアクセス」

2.4.1 Fusion Middleware Controlを使用したWebCenter Contentへのアクセス

Oracle Enterprise Manager Fusion Middleware Controlインタフェースからも、WebCenter Contentおよびコンテンツ・サーバーの関連画面にアクセスして基本管理タスクを実行できます。この項では、次のタスクについて説明します。

- 第2.4.1.1項「Fusion Middleware Controlへのログイン」

- 第2.4.1.2項「コンテンツ・サーバーのホーム・ページへのナビゲート」

注意:
Oracle Fusion MiddlewareをIBM WebSphereとともに使用できます。IBM WebSphereの管理ツールの使用の詳細は、Oracle Fusion Middlewareサード・パーティ・アプリケーション・サーバー・ガイド.のIBM WebSphereでのOracle Fusion Middleware管理ツールのサマリーに関する項を参照してください。

2.4.1.1 Fusion Middleware Controlへのログイン

Oracle Fusion Middleware管理者は、Fusion Middleware Controlを使用して、コンテンツ・サーバー・インスタンスに対してアクセスおよび管理を行うことができます。Fusion Middleware Controlはドメインに対して構成され、Oracle WebLogic Server管理サーバーが起動すると自動的に起動されます。

Fusion Middleware Controlにアクセスする:

1. WebブラウザにFusion Middleware ControlのURLを入力します。URLには、ホストの名前とインストール時に割り当てられたポート番号が含まれている必要があります。

http://adminServerHost:adminServerPort/em

adminServerHostに、ドメインのWebLogic Server管理サーバーをホストするコンピュータの名前を指定します。adminServerPortに、管理サーバーをリスニングするポート番号を指定します。デフォルトのポート番号は7001です。次に例を示します。

http://myHost.example.com:7001/em

管理ポート番号を含む正確なURLは、次の場所にあるconfig.xmlファイルを参照してください。

- Windows: DOMAIN_HOME\config\config.xml

- UNIX: ORACLE_INSTANCE/config/config.xml

2. 有効なFusion Middleware管理者のユーザー名とパスワードを入力して、「ログイン」をクリックします。
管理ユーザーのデフォルト・ユーザー名は、ソフトウェアで提供されます。これは、Fusion Middleware Controlに初回ログインするときに使用できるアカウントです。パスワードは、Fusion Middlewareのインストール時に指定したものです。

Fusion Middleware Controlで表示される最初のページは、ファーム・ドメインのホーム・ページです。このページは、ナビゲーション・ペインでファームの名前を選択することによって、いつでも表示できます。

ナビゲーション・ペインから、ツリーを展開してターゲットを選択し、ファームのコンポーネントを表示および管理できます。

2.4.1.2 コンテンツ・サーバーのホーム・ページへのナビゲート

Fusion Middleware Controlインタフェースでは、コンテンツ・サーバーのホーム・ページがコンテンツ・サーバー・インスタンスを管理する際の出発点になります。

コンテンツ・サーバーのホーム・ページから、次のことを実行できます。

- インスタンスの現在のステータスの確認

- サービスの全体応答時間の表示

- 概念およびタスクのリソース情報の表示

コンテンツ・サーバーのホーム・ページには、「コンテンツ・サーバー」メニューが表示されます。「コンテンツ・サーバー」メニューから、次のことを実行できます。

- インスタンスの起動および停止

- インスタンスのパラメータおよび電子メール設定の構成

- インスタンスのパフォーマンス・メトリックの監視

- 診断情報およびログ・ファイルの分析

- システムMBeanブラウザを使用している属性の変更

- システム構成に関する一般情報の表示

図2-3 Fusion Middleware Controlの「Content Server」メニュー

コンテンツ・サーバーのホーム・ページに移動するには:

1. Fusion Middleware Controlにログインします。第2.4.1.1項「Fusion Middleware Controlへのログイン」を参照してください。

2. ナビゲーション・ペインで、ツリーを展開して、適切なターゲット・ドメイン名(Farm_base_domainなど)を選択します。

3. 「WebCenter」、「コンテンツ」、「コンテンツ・サーバー」の順に展開します。

4. コンテンツ・サーバー・インスタンスを選択して、ホーム・ページにナビゲートします。
図2-4に、WebLogic Serverでのインスタンス(Oracle WebCenter Content - Content Server (UCM_server1))へのナビゲーションの例を示します。

図2-5に、IBM WebSphere Application Serverでのインスタンス(Oracle WebCenter Content - Content Server)へのナビゲーションの例を示します。

図2-4 WebLogic Serverでのコンテンツ・サーバーへのナビゲーション

図2-5 WebSphereでのコンテンツ・サーバーへのナビゲーション

2.4.2 Webブラウザを使用したWebCenter Contentインスタンスへのアクセス

実行中のWebCenter Contentインスタンスに管理者としてアクセスするには、Webブラウザを起動し、特定のWebCenter Content構成のURLを入力します。

- 第2.4.2.1項「コンテンツ・サーバー・インスタンスへのアクセス」

- 第2.4.2.2項「WebCenter Content: Inbound Refineryインスタンスへのアクセス」

- 第2.4.2.3項「WebCenter Content: Imagingインスタンスへのアクセス」

- 第2.4.2.4項「WebCenter: Recordsインスタンスへのアクセス」

2.4.2.1 コンテンツ・サーバー・インスタンスへのアクセス

コンテンツ・サーバー・インスタンスにアクセスするには:

1. URLを入力します。

http://managedServerHost:managedServerPort/cs

2. WebLogic Serverの管理者ユーザー名とパスワードでログインします。

- managedServerHostには、コンテンツ・サーバー・インスタンスがインストールされたWebCenter ContentドメインのWebLogic Server管理対象サーバーをホストするコンピュータの名前を指定します。

- managedServerPortには、コンテンツ・サーバー・インスタンスがインストールされたWebCenter ContentドメインのWebLogic Server管理対象サーバーのリスニング・ポート番号を指定します。

コンテンツ・サーバー・インスタンスのデフォルトのポート番号は、16200です。次に例を示します。

http://myHost.example.com:16200/cs

注意:
コンテンツ・サーバー・インスタンスに管理者以外のユーザーとしてアクセスする必要があり、そのインスタンスがネイティブの11gインタフェースのかわりにWebCenter Contentユーザー・インタフェースを使用するように構成されている場合、WebCenter Contentユーザー・インタフェースがコンテンツ・サーバーとは別のドメインに存在し、異なるポート(デフォルトでは16225)で実行されることに注意してください。

2.4.2.2 WebCenter Content: Inbound Refineryインスタンスへのアクセス

WebCenter Content: Inbound Refineryインスタンスにアクセスするには:

1. URLを入力します。

http://managedServerHost:managedServerPort/ibr

2. WebLogic Serverの管理者ユーザー名とパスワードでログインします。

- managedServerHostには、Inbound RefineryインスタンスがインストールされたWebCenter ContentドメインのWebLogic Server管理対象サーバーをホストするコンピュータの名前を指定します。

- managedServerPortには、Inbound RefineryインスタンスがインストールされたWebCenter ContentドメインのWebLogic Server管理対象サーバーのリスニング・ポート番号を指定します。

Inbound Refineryのデフォルトのポート番号は16250です。次に例を示します。

http://myHost.example.com:16250/ibr

2.4.2.3 WebCenter Content: Imagingインスタンスへのアクセス

WebCenter Content: Imagingインスタンスにアクセスするには、次の手順を実行します。

1. URLを入力します。

http://managedServerHost:managedServerPort/imaging

2. WebLogic Serverの管理者ユーザー名とパスワードでログインします。

- managedServerHostには、ImagingインスタンスがインストールされたWebCenter ContentドメインのWebLogic Server管理対象サーバーをホストするコンピュータの名前を指定します。

- managedServerPortには、ImagingインスタンスがインストールされたWebCenter ContentドメインのWebLogic Server管理対象サーバーのリスニング・ポート番号を指定します。

Imagingのデフォルトのポート番号は、16000です。次に例を示します。

http://myHost.example.com:16000/imaging

2.4.2.4 WebCenter: Recordsインスタンスへのアクセス

WebCenter Content: Recordsインスタンスにアクセスするには、次の手順を実行します。

1. URLを入力します。

http://managedServerHost:managedServerPort/urm

2. WebLogic Serverの管理者ユーザー名とパスワードでログインします。

- managedServerHostには、RecordsインスタンスがインストールされたWebCenter ContentドメインのWebLogic Server管理対象サーバーをホストするコンピュータの名前を指定します。

- managedServerPortには、RecordsインスタンスがインストールされたWebCenter ContentドメインのWebLogic Server管理対象サーバーのリスニング・ポート番号を指定します。

Recordsのデフォルトのポート番号は16300です。

http://myHost.example.com:16300/urm

3 システム・プロセスの管理

この章では、Oracle Content ServerまたはInbound Refineryインスタンスを起動および停止する方法、コンテンツ・サーバー管理アプリケーションを起動する方法およびコマンドライン・ツールを使用してシステム変数を構成する方法を説明します。

この章の内容は次のとおりです。

- コンテンツ・サーバーおよびInbound Refineryの起動と停止

- Fusion Middleware Controlを使用したコンテンツ・サーバーおよびInbound Refineryの起動と停止

- WebLogic Serverを使用したコンテンツ・サーバーの起動と停止

- スクリプトを使用したコンテンツ・サーバーの起動と停止

- コンテンツ・サーバー管理アプリケーションの実行

- IdcShellコマンドライン・ツールを使用したIdocスクリプトの実行

3.1 コンテンツ・サーバーおよびInbound Refineryの起動と停止

コンテンツ・サーバー・インスタンスを起動、停止および再起動する方法は、複数あります。どの方法を選択するかは、要件、認可、および実行するタスクに応じて異なります。たとえば、コンポーネントの有効化や無効化のタイミングなど、コンテンツ・サーバー・インスタンスに特定の構成変更を行う場合、インスタンスを再起動する必要があります。

Inbound Refinery (IBR)インスタンスの場合、使用できる唯一のメソッドはOracle Enterprise Manager Fusion Middleware Controlを使用することです。

コンテンツ・サーバー・インスタンスを管理するために使用できるメソッドは次のとおりです。

- Oracle Enterprise Manager Fusion Middleware Control (第3.2項を参照)

- Oracle WebLogic Server管理コンソール(第3.3項を参照)

- Oracle WebLogic Serverスクリプト(第3.4項を参照)

注意:
以前のリリースでは、コンテンツ・サーバー・インスタンスの起動、停止および再起動に、コンテンツ・サーバーの管理サーバーを使用できました。この機能は、11gリリース1 (11.1.1)の時点で置き換えられています。

3.2 Fusion Middleware Controlを使用したコンテンツ・サーバーおよびInbound Refineryの起動と停止

管理者は、Oracle Enterprise Manager Fusion Middleware Controlを使用して、コンテンツ・サーバー・インスタンスまたはInbound Refineryインスタンスを含むWebCenter Contentドメインを実行しているOracle WebLogic Serverサーバーを管理できます。

コンテンツ・サーバー・インスタンスおよびInbound Refineryインスタンスは、Oracle WebLogic Serverドメインの管理対象サーバー上にインスタンスをインストールおよびデプロイする処理中に、最初に起動します。コンポーネントの有効化や無効化などの構成を変更する場合など、様々な理由でコンテンツ・サーバー・インスタンスおよびInbound Refineryインスタンスを停止および再起動できます。

- 第3.2.1項「Fusion Middleware Controlを使用したコンテンツ・サーバーまたはInbound Refineryの起動」

- 第3.2.2項「Fusion Middleware Controlを使用したコンテンツ・サーバーまたはInbound Refineryの停止」

- 第3.2.3項「Fusion Middleware Controlを使用したコンテンツ・サーバーまたはInbound Refineryの再起動」

3.2.1 Fusion Middleware Controlを使用したコンテンツ・サーバーまたはInbound Refineryの起動

コンテンツ・サーバー・インスタンスまたはInbound Refinery (IBR)インスタンスを起動するには、次の手順を実行します。

1. Fusion Middleware Controlにログインします。

2. ナビゲーション・ツリーで、適切なドメイン名(Farm_base_domainなど)、「WebCenter」、「コンテンツ」の順に展開します。

- コンテンツ・サーバー・インスタンスに対して、「コンテンツ・サーバー」を展開し、コンテンツ・サーバー・インスタンス名(Oracle WebCenter Content - Content Server (UCM_server1)など)を選択します。

- Inbound Refineryインスタンスに対して、「Oracle Inbound Refinery」を展開し、Inbound Refineryインスタンス名(IBR (IBR_server1)など)を選択します。

3. インスタンスのホームページで、「コンテンツ・サーバー」または「IBR」メニューから、「制御」→「起動」を選択します。

詳細は、『管理者ガイド』のOracle WebLogic Serverインスタンスの起動および停止に関する項を参照してください。

3.2.2 Fusion Middleware Controlを使用したコンテンツ・サーバーまたはInbound Refineryの停止

コンテンツ・サーバー・インスタンスまたはInbound Refinery (IBR)インスタンスを停止するには、次の手順を実行します。

1. Fusion Middleware Controlにログインします。

2. ナビゲーション・ツリーで、適切なドメイン名(Farm_base_domainなど)、「WebCenter」、「コンテンツ」の順に展開します。

- コンテンツ・サーバー・インスタンスに対して、「コンテンツ・サーバー」を展開し、コンテンツ・サーバー・インスタンス名(Oracle WebCenter Content - Content Server (UCM_server1)など)を選択します。

- Inbound Refineryインスタンスに対して、「Oracle Inbound Refinery」を展開し、Inbound Refineryインスタンス名(IBR (IBR_server1)など)を選択します。

3. インスタンスのホームページで、「コンテンツ・サーバー」または「IBR」メニューから、「制御」→「停止」を選択します。

詳細は、『管理者ガイド』のOracle WebLogic Serverインスタンスの起動および停止に関する項を参照してください。

3.2.3 Fusion Middleware Controlを使用したコンテンツ・サーバーまたはInbound Refineryの再起動

コンテンツ・サーバー・インスタンスまたはInbound Refinery (IBR)インスタンスを再起動するには、次の手順を実行します。

1. Fusion Middleware Controlにログインします。

2. ナビゲーション・ツリーで、適切なドメイン名(Farm_base_domainなど)、「WebCenter」、「コンテンツ」の順に展開します。

- コンテンツ・サーバー・インスタンスに対して、「コンテンツ・サーバー」を展開し、コンテンツ・サーバー・インスタンス名(Oracle WebCenter Content - Content Server (UCM_server1)など)を選択します。

- Inbound Refineryインスタンスに対して、「Oracle Inbound Refinery」を展開し、Inbound Refineryインスタンス名(IBR (IBR_server1)など)を選択します。

3. インスタンスのホームページで、「コンテンツ・サーバー」または「IBR」メニューから、「制御」→「停止」を選択します。

4. インスタンスが停止していることを確認します。

5. 「コンテンツ・サーバー」または「IBR」メニューから、「制御」を選択し、次に「起動」を選択します。

詳細は、『管理者ガイド』のOracle WebLogic Serverインスタンスの起動および停止に関する項を参照してください。

3.3 WebLogic Serverを使用したコンテンツ・サーバーの起動と停止

コンテンツ・サーバー管理者は、コンテンツ・サーバー・インスタンスを使用してWebCenter Contentを管理する管理権限を持つ必要があるため、Oracle WebLogic Server管理コンソールを使用できます。コンテンツ・サーバー・インスタンスを使用してWebCenter Content管理対象サーバーを起動または停止するには、ノード・マネージャを構成し、実行している必要があります。

コンテンツ・サーバー・インスタンスは、Oracle WebLogic ServerドメインのWebCenter Content Server上にインストールおよびデプロイする処理中に、最初に起動します。コンテンツ・サーバーの構成設定の変更時に、インスタンスの停止後に起動する場合など、別の時点でコンテンツ・サーバー・インスタンスを起動することが必要な場合があります。

サーバー・コンポーネントの有効化や無効化などの構成を変更する場合など、様々な理由でコンテンツ・サーバー・インスタンスを停止および再起動できます。

- 第3.3.1項「WebLogic Server管理コンソールを使用したコンテンツ・サーバーの起動」

- 第3.3.2項「WebLogic Server管理コンソールを使用したコンテンツ・サーバーの停止」

- 第3.3.3項「WebLogic Server管理コンソールを使用したコンテンツ・サーバーの再起動」

3.3.1 WebLogic Server管理コンソールを使用したコンテンツ・サーバーの起動

コンテンツ・サーバー・インスタンスを起動するには:

1. 管理コンソールのホームページの「ドメイン構成」領域で、「環境」→「サーバー」を選択します。

2. 「サーバーのサマリー」ページの「構成」タブで、コンテンツ・サーバー・インスタンスのWebCenter Content Serverの名前を選択します。

3. server_nameの設定セクションで、「制御」タブをクリックします。

4. 「開始/停止」タブの「サーバーのステータス」領域で、サーバー名(例: UCM_server1)を選択し、「開始」をクリックします。

詳細は、『管理者ガイド』のOracle WebLogic Serverインスタンスの起動および停止に関する項を参照してください。

3.3.2 WebLogic Server管理コンソールを使用したコンテンツ・サーバーの停止

コンテンツ・サーバー・インスタンスを停止するには:

1. 管理コンソールのホームページの「ドメイン構成」領域で、「環境」→「サーバー」を選択します。

2. 「サーバーのサマリー」ページの「構成」タブで、コンテンツ・サーバー・インスタンスのWebCenter Content Serverの名前を選択します。

3. server_nameの設定セクションで、「制御」タブをクリックします。

4. 「開始/停止」タブの「サーバーのステータス」領域で、サーバー名(例: UCM_server1)を選択し、「停止」をクリックします。

詳細は、『管理者ガイド』のOracle WebLogic Serverインスタンスの起動および停止に関する項を参照してください。

3.3.3 WebLogic Server管理コンソールを使用したコンテンツ・サーバーの再起動

コンテンツ・サーバー・インスタンスを再起動するには:

1. 管理コンソールのホームページの「ドメイン構成」領域で、「環境」→「サーバー」を選択します。

2. 「サーバーのサマリー」セクションの「構成」タブで、コンテンツ・サーバー・インスタンスのWebCenter Content Serverの名前を選択します。

3. server_nameの設定セクションで、「制御」タブをクリックします。

4. 「開始/停止」タブの「サーバーのステータス」領域で、サーバー名(例: UCM_server1)を選択し、「停止」をクリックします。

5. コンテンツ・サーバー・インスタンスが停止していることを確認してから、「起動」(または「再開」)をクリックします。

詳細は、『管理者ガイド』のOracle WebLogic Serverインスタンスの起動および停止に関する項を参照してください。

3.4 スクリプトを使用したコンテンツ・サーバーの起動と停止

スクリプトを使用して、Oracle WebLogicサーバー上のアクションを迅速に実行できます。アプリケーションの管理対象サーバーを起動する前に、Oracle WebLogic Serverドメインの管理サーバーを起動する必要があります。

次のスクリプトの例では、ソフトウェアのインストール・プロセスの一部としてコンテンツ・サーバー・インスタンスを事前に起動していることを前提としています。詳細は、『Oracle WebCenter Contentのインストールと構成』の管理サーバーの起動に関する項および管理対象サーバーの起動に関する項を参照してください。

注意:
次のスクリプト・コマンドは、WebCenter Content Serverを含むOracle WebLogic Server管理対象サーバー、および管理コンソールを含むWebLogic Server管理サーバーを制御します。Oracle WebLogic Server管理サーバーを起動または停止しない場合、コンテンツ・サーバー・インスタンスを起動するための別の方法を使用します。

- 第3.4.1項「スクリプトを使用したコンテンツ・サーバーの起動」

- 第3.4.2項「スクリプトを使用したコンテンツ・サーバーの停止」

- 第3.4.3項「スクリプトを使用したコンテンツ・サーバーの再起動」

3.4.1 スクリプトを使用したコンテンツ・サーバーの起動

コンテンツ・サーバー・インスタンスを起動するには:

1. 適切なタイプのスクリプトを実行して、Oracle WebLogic Server管理コンソールを起動します。

2. コンテンツ・サーバー・インスタンスを含むWebCenter Content Serverを含むOracle WebLogic Server管理対象サーバーを起動する適切なタイプのスクリプトを実行します。次のスクリプト例では、インスタンスはUCM_Server1という名前です。

Windowsスクリプト:

MW_HOME\user_projects\domains\DOMAIN_HOME\bin\startWebLogic.sh
MW_HOME\user_projects\domains\DOMAIN_HOME\bin\startManagedWebLogic.sh UCM_server1

UNIXスクリプト:

MW_HOME/user_projects/domains/DOMAIN_HOME/bin/startWebLogic.sh
MW_HOME/user_projects/domains/DOMAIN_HOME/bin/startManagedWebLogic.sh UCM_server1

3.4.2 スクリプトを使用したコンテンツ・サーバーの停止

コンテンツ・サーバー・インスタンスを停止するには:

1. Oracle WebLogic Server管理対象サーバー上で、コンテンツ・サーバー・インスタンスを含むWebCenter Content Serverを停止する適切なスクリプトを実行します。次のスクリプト例では、インスタンスはUCM_server1という名前です。

2. 次に、必要に応じて、Oracle WebLogic Server管理コンソールを停止する次のスクリプトを実行します。

Windowsスクリプト:

MW_HOME\user_projects\domains\DOMAIN_HOME\bin\stopManagedWebLogic.sh UCM_server1
MW_HOME\user_projects\domains\DOMAIN_HOME\bin\stopWebLogic.sh

UNIXスクリプト:

MW_HOME/user_projects/domains/DOMAIN_HOME/bin/stopManagedWeblogic.sh UCM_server1
MW_HOME/user_projects/domains/DOMAIN_HOME/bin/stopWebLogic.sh

3.4.3 スクリプトを使用したコンテンツ・サーバーの再起動

コンテンツ・サーバー・インスタンスを再起動するには:

1. WebCenter Contentを含むOracle WebLogic Server管理対象サーバーおよびコンテンツ・サーバー・インスタンスを停止する適切なスクリプトを実行します。次のスクリプト例では、インスタンスはUCM_server1という名前です。

2. 次に、必要に応じて、Oracle WebLogic Server管理サーバーを停止するスクリプトを実行します。

3. サーバーが停止したら、Oracle WebLogic Server管理サーバーを起動するスクリプトを実行します(適切な場合)。

4. WebCenter Contentを含むOracle WebLogic Server管理対象サーバーおよびコンテンツ・サーバー・インスタンスを起動するスクリプトを実行します。

Windowsスクリプト:

MW_HOME\user_projects\domains\DOMAIN_HOME\bin\stopManagedWeblogic.sh UCM_server1
MW_HOME\user_projects\domains\DOMAIN_HOME\bin\stopWeblogic.sh
MW_HOME\user_projects\domains\DOMAIN_HOME\bin\startWeblogic.sh
MW_HOME\user_projects\domains\DOMAIN_HOME\bin\startManagedWeblogic.sh UCM_server1

UNIXスクリプト:

MW_HOME/user_projects/domains/DOMAIN_HOME/bin/stopManagedWeblogic.sh UCM_server1
MW_HOME/user_projects/domains/DOMAIN_HOME/bin/stopWeblogic.sh
MW_HOME/user_projects/domains/DOMAIN_HOME/bin/startWeblogic.sh
MW_HOME/user_projects/domains/DOMAIN_HOME/bin/startManagedWeblogic.sh UCM_server1

3.5 コンテンツ・サーバー管理アプリケーションの実行

Content Server管理アプリケーションを、アプレットとして、またはスタンドアロン・モードで実行できます。スタンドアロン・モードでアプリケーションを実行するには、データベース接続の追加構成およびコンテンツ・サーバー管理者をローカル・ユーザーにすることが必要になります。

- 第3.5.1項「管理アプリケーションのアプレットとしての実行」

- 第3.5.2項「スタンドアロン・モードでの管理アプリケーションの実行」

3.5.1 管理アプリケーションのアプレットとしての実行

Content Server管理アプリケーションには、コンテンツ・サーバー・インスタンスにアクセス可能な任意のWebブラウザからアプレットとして実行できるものがあります。アプレットは、リモート管理に役立ちます。

注意:
バッチ・ローダー、コンポーネント・ウィザード、システム・プロパティおよびContent Serverアナライザの各ユーティリティは、アプレットとして実行できず、セキュリティ上の理由から、これらは、コンテンツ・サーバー・インスタンスがデプロイされているコンピュータから、スタンドアロン・モードで実行する必要があります。詳細は、第3.5.2項を参照してください。
アプリケーションのスタンドアロン・バージョンで使用可能な機能の一部は、アプレット・バージョンでは使用できません。詳細は、各アプリケーションのドキュメントを参照してください。

管理アプリケーションを Java対応のブラウザ内でJavaアプレットとして実行するには、次の手順に従ってください。

1. ブラウザ・ウィンドウを開きます。

2. コンテンツ・サーバー・インスタンスに管理者としてログインします。

3. 「管理」→「管理アプレット」を選択します。

4. アプレットのリストから管理アプリケーションを選択します。

3.5.2 スタンドアロン・モードでの管理アプリケーションの実行

コンテンツ・サーバー管理のJavaアプリケーションには、コンテンツ・サーバー・インスタンスがデプロイされているコンピュータからスタンドアロン・モードで実行できるものがあります。構成マネージャやリポジトリ・マネージャなどの一部のアプリケーションは、Webブラウザを使用してアクセスするアプレットと同じです。システム・プロパティやバッチ・ローダーなどの一部のユーティリティは、スタンドアロン・モードでのみ実行できます。これらのプログラムを起動するのに必要な方法は、WindowsインストールとUNIXインストールとで若干異なります。

アプリケーションのスタンドアロン版を実行することによって、ブラウザ・アプレットよりセキュリティが強力になり、パスワードをWebやネットワークで捕捉またはコピーされないように送信できるようになります。

スタンドアロンの管理アプリケーションでは、アプリケーションを実行するコンテンツ・サーバー・システム管理者を、Oracle WebLogic Serverで定義されたユーザーではなく、ローカル管理ユーザーにする必要があります。(そうでない場合、Oracle WebLogic Serverではローカル・ユーザーは使用されません。)ログインが必要なスタンドアロンの管理アプリケーションを使用するには、ユーザー管理アプレットを実行して、コンテンツ・サーバーで管理権限を持つ新しいローカル・ユーザーを定義します。ローカル・ユーザーの詳細は、第17.1.2項を参照してください。ユーザー管理アプレットを使用したローカル・ユーザー作成の詳細は、第17.3.2項を参照してください。

重要:
コンテンツ・サーバー管理アプリケーションをスタンドアロン・モードで実行するには、Oracle WebLogic Serverでアプリケーションを認証してシステム・データベースへのJDBC接続を確立し、Oracle WebLogic Serverのデータベース接続にアクセスするための追加構成が必要です。第3.5.2.3項および第3.5.2.5項を参照してください。
スタンドアロン・アプリケーションが、認証にデジタル証明書を使用するSSL対応のデータベースに接続する必要がある場合は、信頼できるソースをチェックする際にそのアプリケーションが使用する標準Javaキー・ストアに、ルートCA証明書をインポートする必要があります。構成の詳細は、『Oracle WebCenter Contentのインストールと構成』を参照してください。

- 第3.5.2.1項「UNIXシステムでのスタンドアロン・アプリケーションの実行」

- 第3.5.2.2項「Windowsシステムでのスタンドアロン・アプリケーションの実行」

- 第3.5.2.3項「スタンドアロン・モード用のシステム・データベース・プロバイダの構成」

- 第3.5.2.4項「スタンドアロン・モード用のJDBCデータベース・ドライバの構成」

- 第3.5.2.5項「スタンドアロン・モード用の外部データベース・プロバイダの構成」

3.5.2.1 UNIXシステムでのスタンドアロン・アプリケーションの実行

Content Server管理アプリケーションをUNIXオペレーティング・システム上でスタンドアロン・モードで実行するには:

1. DomainHome/ucm/cs/bin/ディレクトリにナビゲートします。実行可能なアプリケーションが一覧表示されます。

2. ./application_nameと入力します。application_nameは、実行可能ファイルの名前です。アプリケーションが一覧表示されない場合は、IntradocAppアプリケーションへのパラメータとしてアプリケーション名を入力できます。次に例を示します。

% ./intradocApp workflow

3. 「入力」をクリックします。コンポーネント・ウィザードおよびシステム・プロパティ・ユーティリティを除くすべてのアプリケーションでは、ログイン・ウィンドウが開きます。コンポーネント・ウィザードおよびシステム・プロパティ・ユーティリティでは、アプリケーションのメイン・ウィンドウが開きます。

4. 管理者のログイン名とパスワードを入力します。

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

3.5.2.2 Windowsシステムでのスタンドアロン・アプリケーションの実行

Content Server管理アプリケーションをWindowsオペレーティング・システム上でスタンドアロン・モードで実行するには:

1. Windowsの「スタート」メニューからアプリケーションまたはユーティリティを選択します。

- 管理アプリケーションを実行するには、「スタート」メニューから「プログラム」→「コンテンツ・サーバー」を選択し、次にインスタンス、アプリケーションの順に選択します。

- 管理ユーティリティを実行するには、「スタート」メニューから「プログラム」→「コンテンツ・サーバー」→「ユーティリティ」を選択し、次にユーティリティを選択します。

コンポーネント・ウィザードおよびシステム・プロパティ・ユーティリティを除くすべてのアプリケーションでは、ログイン・ウィンドウが開きます。コンポーネント・ウィザードおよびシステム・プロパティ・ユーティリティでは、アプリケーションのメイン・ウィンドウが開きます。

ヒント:
ログイン・ウィンドウまたはアプリケーション・ウィンドウが表示されるまで数秒かかることがあります。または、ウィンドウが他のウィンドウで隠れている場合があります。

2. 管理者のログイン名とパスワードを入力します。

3. 「OK」をクリックします。
アプリケーションのメイン・ウィンドウが開きます。

3.5.2.3 スタンドアロン・モード用のシステム・データベース・プロバイダの構成

スタンドアロン・モードでのみ実行できるコンテンツ・サーバー管理アプリケーションおよびユーティリティは、Oracle WebCenter Contentを含むOracle WebLogic Serverドメインおよびコンテンツ・サーバー・インスタンスで実行するための特定の構成が必要です。アプリケーションでOracle WebLogic Serverユーザーを認証し、Oracle WebLogic Serverシステム・データベースへのJDBC接続を設定するように標準の(カスタマイズされていない)Oracle WebLogic Server接続の構成を変更する必要があります。

スタンドアロン・モード用の接続を構成するには、次の手順に従います。

1. システム管理者として、VNC(またはputtyやXmingなどの類似したツール)を使用して、DOMAIN_HOME/ucm/cs/bin/ディレクトリに移動します。次に例を示します。

MW_HOME/user_projects/domains/ucm_domain/ucm/cs/bin

2. ./SystemPropertiesを実行します。

3. 「システム・プロパティ」ウィンドウの「パス」タブでは、「データベース・ドライバ・クラスパスの指定」チェック・ボックスがデフォルトで選択されるため、「データベース・ドライバ・クラスパス」フィールドに、システム・データベースのJDBCドライバへのパスを入力する必要があります。
Enterprise Content Managementのインストールで、Oracleドライバojdbc6dms.jarが、次のディレクトリに指定されます。

MW_HOME/oracle_common/modules/oracle.jdbc_11.1.1/ojdbc6dms.jar

4. 「データベース」タブで、システム・データベースに対して必要なすべてのJDBC接続情報(データベース・タイプ、データベース・ユーザー名、データベース・ユーザー・パスワードなど)をフィールドに入力します。

5. 「OK」をクリックします。これで、スタンドアロン・アプリケーションを実行できます。たとえば、コンテンツ・サーバー・インスタンスで作成した管理者ユーザーとして、./BatchLoaderを実行します。

3.5.2.4 スタンドアロン・モード用のJDBCデータベース・ドライバの構成

スタンドアロン・モードのみで実行される管理アプリケーション(バッチ・ローダー、システム・プロパティ、コンテンツ・サーバー・アナライザ・ユーティリティなど)を処理するコンテンツ・サーバーの場合、システム・データベースまたは外部データベース・プロバイダに対してJDBCドライバを構成する必要があります。コンテンツ・サーバー・スタンドアロン・アプリケーションをサポートするために、SQL ServerおよびIBM DB2データベース用のOracle Fusion Middleware DataDirect JDBCドライバを使用できます。システム・プロパティ・ユーティリティを使用して、構成情報を入力できます。

スタンドアロン・アプリケーションのJDBCドライバを構成するには、次の手順を実行します。

1. WebCenter Contentシステム管理者として、コンテンツ・サーバー・インスタンスのbinディレクトリからSystemPropertiesを実行し、システム・プロパティ・ユーティリティを起動します。

- UNIXパス: DomainHome/ucm/cs/bin/SystemProperties

- Windowsパス: DomainHome\ucm\cs\bin\SystemProperties

2. 「システム・プロパティ」画面で、「データベース」タブをクリックしてから、適切なドライバを選択し、接続文字列、ユーザー名およびパスワードを入力します。
クラスパスやドライバ名を入力する必要はありません。また、JARファイルをコピーする必要もありません。

Oracle WebLogic Server管理コンソールで、JDBC接続文字列およびユーザー名情報を検索できます。管理コンソールにログインし、「サービス」、「データ・ソース」、「CSDS」(または「URMDS」)、「接続プール」の順に選択します。「接続プール」タブでは、接続文字列は「URL」フィールドにあり、ユーザー名は「プロパティ」フィールドにあります。セキュリティ上の理由から、パスワードは表示されません。

3. 「データベース」タブで、適切なドライバを「JDBC (Java Database Connectivity) の使用」で選択し、接続文字列を入力します。

- Microsoft SQL Serverの場合、「DataDirect SQL Server JDBCドライバ」を選択し、次の形式の接続文字列を入力します。

jdbc:weblogic:sqlserver://database_hostname:database_port_number;databaseName=database_name

- IBM DB2の場合、「DataDirect DB2 JDBCドライバ」を選択し、次の形式の接続文字列を入力します。

jdbc:weblogic:db2://database_hostname:database_port_number;databaseName=database_name

4. データベースのユーザー名とパスワードを「JDBCユーザー名」および「JDBCユーザー・パスワード」フィールドに入力します。

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

6. コンテンツ・サーバー・インスタンスを再起動します。

3.5.2.5 スタンドアロン・モード用の外部データベース・プロバイダの構成

スタンドアロン・アプリケーションがOracle WebLogic Serverのデータ・ソースのシステム・データベース・プロバイダを使用せずにJDBCを使用してデータベースに直接接続できるように、コンテンツ・サーバー・インスタンスに外部データベース・プロバイダを作成できます。

スタンドアロン・アプリケーションでOracleTextSearch機能を外部検索エンジンとして使用するには、JDBC接続情報を含むように外部データベース・プロバイダを構成する必要があります。

デフォルトでは、受信プロバイダの構成にJDBC DriverおよびJDBC Connection Stringの値は含まれていません。これらの値を追加する必要がありますが、既存のプロバイダの名前は変更できないため、プロバイダ名を変更しないように注意してください。プロバイダ名を変更するには、プロバイダを削除して、再度追加する必要があります。

3.6 IdcShellコマンドライン・ツールを使用したIdocスクリプトの実行

IdcShellツールを使用すると、管理者はコマンド・ラインからIdocスクリプトを実行できます。Idocスクリプトは、WebCenter Contentシステム用の独自のサーバー側カスタム・スクリプト言語です。このスクリプト言語によって、管理者は変数を参照し、HTMLページにコンテンツを条件的に追加し、問合せから返される結果をループできるようになります。

Idocスクリプトは、主に構成の設定およびHTMLテンプレートのプレゼンテーションに使用されます。Idoc変数(構成変数または環境変数と呼ばれることもあります)は、Idocスクリプトおよび構成ファイルで使用できます。構成変数の詳細は、『Oracle WebCenter Content構成リファレンス』を参照してください。Idocスクリプトの詳細は、『Oracle WebCenter Contentでの開発』を参照してください。

IdcShellツールには、追加のIdocスクリプト関数(表3-1を参照)、および一部の動的HTML定義(表3-2を参照)も含まれており、コンテンツ・サーバー・インスタンスやInbound Refineryインスタンスを管理する場合に役立ちます。

IdcShellツールにはヘルプが組み込まれており、次のコマンドを実行してアクセスできます。

bin/IdcShell "include shell_help"

表3-1に、通常IdcShellコマンドライン・ツールで使用されるIdocスクリプト関数とその説明を示します。

表3-1 コマンドラインIdocスクリプト関数

関数

説明

doService(serviceName)

serviceNameを現在のコンテキストで実行します。

formatBinder()

DataBinderをフォーマットして読みやすくします。

getWithTrace()

get()関数をトレースし、データのソースについてレポートします。

promptUser(text, flags)

textをコンソールに表示し、ユーザー・レスポンスを読み取ります。flagsがNO_ECHOの場合、入力はエコーされません。

表3-2では、通常IdcShellコマンドライン・ツールで使用される動的HTML定義について説明します。

表3-2 動的HTML定義

動的HTML定義

説明

get_username

コンソールでユーザー名を要求し、userNameに代入します。

get_password

コンソールでパスワードを要求し、dPasswordに代入します。

set_user_password

ユーザーのパスワードを設定します。

create_user

新しいユーザーを作成し、デフォルトで管理者ロールに設定します。

4 コンテンツのバッチ・ロード

この項では、バッチ・ローダー・ユーティリティを使用して、Oracle WebCenter Content Serverインスタンスで大量のファイルを同時にチェックイン(挿入)、削除および更新する方法を説明します。

この章の項目は次のとおりです。

- バッチ・ロードについて

- バッチ・ロード・ファイルの準備

- バッチ・ローダーの実行

- バッチ・ローダーのパフォーマンスの最適化

- ベスト・プラクティス事例

4.1 バッチ・ロードについて

大量のファイルのバッチ・ロードは、バッチ・ローダー・ユーティリティを使用して自動化することで、時間と労力を削減できます。バッチ・ローダーを使用する場合の例を次に示します。

- WebCenter Contentソフトウェアを購入したばかりで、データベースに存在するメタデータを含むすべての既存のファイルをチェックインします。

- コンテンツ・サーバー・リポジトリにチェックインされたドキュメントがあり、新規カスタム・メタデータ・フィールドを作成したばかりです。バッチ・ローダーを使用して、新規メタデータ・フィールドに指定する値を、既存の各コンテンツ・アイテムに追加できます。

- 特定の大量のファイルをシステムから削除します。

バッチ・ローダーは、バッチ・ロード・ファイルで指定したアクションを実行します。このファイルは、バッチ・ローダーに実行するアクションと、バッチ内の各コンテンツ・アイテムに割り当てるメタデータを指示するテキスト・ファイルです。

注意:
バッチ・ローダー・ユーティリティがOracle WebLogic Serverインスタンスを使用して正しく機能するには、JDBC接続設定を構成する必要があります。詳細は、3.5.2項を参照してください。

この項の項目は次のとおりです。

- 第4.1.1項「バッチ・ロード・ファイルのレコードについて」

- 第4.1.2項「バッチ・ロードのアクションについて」

- 第4.1.3項「バッチ・ロードの挿入アクションについて」

- 第4.1.4項「バッチ・ロードの削除アクションについて」

- 第4.1.5項「バッチ・ロードの更新アクションについて」

- 第4.1.6項「バッチ・ロード・ファイルのオプション・パラメータについて」

- 第4.1.7項「カスタム・メタデータ・フィールドについて」

4.1.1 バッチ・ロード・ファイルのレコードについて

バッチ・ロード・ファイルは、実行するアクションまたは個々のコンテンツ・アイテムに対するメタデータ(あるいはその両方)を指定する名前と値のペアのセットである、ファイル・レコードで構成されています。

重要:
フィールド名およびパラメータは、大文字と小文字が区別されます。これらは、次の項で表示されているとおりに、バッチ・ロード・ファイルに表示される必要があります。たとえば、dDocNameは、ddocname、dDocnameまたはDDOCNAMEと同じになりません。

- 各ファイル・レコードは、<<EOD>>(end of data)マーカーで終了します。

- 行頭にあるポンド記号(#)に続く空白は、コメントを示します。コメント記号の後には、空白を続ける必要があります。たとえば、# primaryFile=test.txtは正常に機能しますが、#primaryFile=test.txtはエラーが発生します。

- 次に、ファイル・レコードの例を示します。

# This is a comment
Action=insert
dDocName=Sample1
dDocType=Document
dDocTitle=Batch Load record insert example
dDocAuthor=sysadmin
dSecurityGroup=Public
primaryFile=links.doc
dInDate=8/15/2001
<<EOD>>

4.1.2 バッチ・ロードのアクションについて

バッチ・ロードの有効なアクションには、挿入、削除および更新があります。

- ファイルにアクションが指定されていない場合、システムは更新を実行しようとします。

- 各ファイル・レコードには1つのアクションのみ存在しますが、同じバッチ・ロード・ファイルに異なるアクションを持つファイル・レコードが存在する可能性があります。

- 各アクションのロジック・プロセスは異なります。

4.1.3 バッチ・ロードの挿入アクションについて

挿入アクションでは、新規ファイルをコンテンツ・サーバー・リポジトリにチェックインします。図4-1は、挿入アクションを示しています。

- コンテンツID (dDocName)がコンテンツ・サーバー・データベースに存在しない場合は、新規のファイルが作成されます。

- コンテンツID (dDocName)がコンテンツ・サーバー・データベースに存在し、リビジョン(dRevLabel)が指定されていない場合は、新規のリビジョンが作成されます。

- コンテンツID (dDocName)および指定したリビジョン(dRevLabel)がコンテンツ・サーバー・データベースに存在する場合、アクションは実行されません。

図4-1 新規ファイルにチェックインする挿入アクションの順序

4.1.3.1 挿入の要件

次の表では、挿入アクションが正常に動作するために必要なフィールドが定義されています。

注意:
バッチ・ロードされたリビジョンは、アクティブ・ワークフローの基準を満たしている場合でも、ワークフローを入力しません。

- フィールド長: フィールドで許可された最大文字数。

- 継承: 次のレコードにこのフィールドが含まれない場合、このフィールドの値は前のレコードから引き継がれます。

重要:
カスタム・メタデータ・フィールドは、必須フィールドとして定義した場合、挿入アクションの際にも定義する必要があります。

必須項目

フィールド長

継承

定義

Action=insert

該当なし

あり

ファイルを挿入するコマンド。
Actionの語は大文字と小文字が区別され、最初は大文字にする必要があります。

dDocName

30

なし

「コンテンツID」という名前のメタデータ・フィールド。

dDocType

30

あり

「タイプ」という名前のメタデータ・フィールド。

dDocTitle

80

なし

「タイトル」という名前のメタデータ・フィールド。

dDocAuthor

30

あり

「作成者」という名前のメタデータ・フィールド。

dSecurityGroup

30

あり

「セキュリティ・グループ」という名前のメタデータ・フィールド。

primaryFile

該当なし

該当なし

「プライマリ・ファイル」という名前のメタデータ・フィールド。プライマリ・ファイル名は、完全パスまたはファイル名そのものになります。ファイル名のみが指定されている場合、ファイルの場所は次のように決定されます。

- SetFileDirオプション・パラメータが現在のファイル・レコードまたは前のファイル・レコードで設定されている場合、SetFileDirに指定されたディレクトリが使用されます。

- SetFileDirパラメータが設定されていない場合、バッチ・ロード・ファイルのパスが使用されます。(パスは、「バッチ・ローダー」ウィンドウの「バッチロード・ファイル」フィールドに指定します。)

デフォルトでは、プライマリ・ファイル名は80文字を超えることはできません(このうち、拡張子に使用できるのは最大8文字のみです)。

dInDate

該当なし

なし

「リリース日」という名前のメタデータ・フィールド。

- dInDateは、バッチ・ローダーを実行しているユーザーのロケールの日付フォーマットを使用する必要があります。たとえば、米国英語の日付フォーマットはmm/dd/yy hh:mm:ss am/pmです。

- 時間情報はオプションです。時間を指定する場合、hh:mmの部分のみが必須です。ssおよびam/pmの部分はオプションです。

<<EOD>>

該当なし

該当なし

ファイル・レコードのデータの終端を示します。

4.1.3.2 挿入の例

次のコード・フラグメントは、ファイルを挿入するためのバッチ・ロード・ファイルの構文を示しています。次の例では、2つのファイル・レコードがあります。

最初のファイル・レコードには、すべての必須フィールドおよびアクション文Action=insertが含まれています。2番目のファイル・レコードには、次の必須フィールドが示されていません: dDocType、dDocAuthorまたはdSecurityGroup。ただし、これらの項目の情報は、前のレコードから引き継がれます。また、2番目のレコードではアクションが指定されていないため、挿入アクションが継承されます。そのため、コンテンツID HR003が存在しない場合、このファイルは挿入されます。ただし、このコンテンツIDが存在する場合、アクションは更新ではなく挿入であるため、これは挿入されません。

- 最初のレコード:

Action=insert
dDocName=HR001
dDocType=Form
dDocTitle=New Employee Information Form
dDocAuthor=Olson
dSecurityGroup=Public
primaryFile=hr001.doc
dIndate=3/15/97
<<EOD>>

- 2番目のレコード:

dDocName=HR003
dDocTitle=Performance Review
primaryFile=hr003.doc
dIndate=3/15/97
<<EOD>>

4.1.4 バッチ・ロードの削除アクションについて

削除アクションでは、既存のファイルの1つまたはすべてのリビジョンを、コンテンツ・サーバー・リポジトリから削除します。指定したコンテンツID (dDocName)がコンテンツ・サーバー・データベースに存在しない場合、アクションは実行されません。図4-2は、削除アクションを示しています。

図4-2 削除アクションの順序

4.1.4.1 削除の要件

次の表では、削除アクションが正常に動作するために必要なフィールドが定義されています。

必須項目

定義

Action=delete

ファイルを削除するコマンド。
Actionの語は大文字と小文字が区別され、最初は大文字にする必要があります。

dDocName

「コンテンツID」という名前のメタデータ・フィールド。

<<EOD>>

ファイル・レコードのデータの終端を示します。

4.1.4.2 削除の例

次の例は、ファイルを削除するためのバッチ・ロード・ファイルの構文を示しています。次の例では、2つのファイル・レコードがあります。最初のファイル・レコードは、コンテンツID HR001のすべてのリビジョンを削除します。2番目のファイル・レコードは、コンテンツ・アイテムHR002のリビジョン2を削除します。

Action=delete
dDocName=HR001
<<EOD>>
Action=delete
dDocName=HR002
dRevLabel=2
<<EOD>>

4.1.5 バッチ・ロードの更新アクションについて

更新アクションでは、既存のコンテンツ・アイテムを更新します。ファイル・レコードに存在する項目およびシステムに存在するコンテンツに応じて、次のアクションのうちの1つが発生します。

- 既存のコンテンツ・アイテムの新規リビジョンが作成されます。

- 既存のファイルのメタデータが更新されます。

- 新規コンテンツ・アイテムが挿入されます(Action=insertが実行されます)。

注意:
バッチ・ロードされたリビジョンは、アクティブ・ワークフローの基準を満たしている場合でも、ワークフローを入力しません。

次のシナリオのうち1つが発生すると、新規リビジョンが作成されます。

シナリオ

コンテンツID (dDocName)

リビジョン(dRevLabel)

バッチ・ロード・ファイル内のリリース日(dInDate)

シナリオ1

コンテンツ・サーバー・インスタンスに存在します。

バッチ・ロード・ファイルで指定されません。

システム内のファイルの最新リビジョンのリリース日の後。

シナリオ2

コンテンツ・サーバー・インスタンスに存在します。

バッチ・ロード・ファイルで指定されますが、コンテンツ・サーバー・インスタンスに存在しません。

システム内のファイルの最新リビジョンのリリース日の後。

図4-3 更新アクションの順序

4.1.5.1 更新の要件

次の表では、更新アクションが正常に動作するために必要なフィールドが定義されています。

必須項目

フィールド長

継承

定義

Action=update

該当なし

あり

ファイルを更新するコマンド。
Actionの語は大文字と小文字が区別され、最初は大文字にする必要があります。

dDocName

30

なし

「コンテンツID」という名前のメタデータ・フィールド。

dDocType

30

あり

「タイプ」という名前のメタデータ・フィールド。

dDocTitle

80

なし

「タイトル」という名前のメタデータ・フィールド。

dDocAuthor

30

あり

「作成者」という名前のメタデータ・フィールド。

dSecurityGroup

30

あり

「セキュリティ・グループ」という名前のメタデータ・フィールド。

primaryFile

該当なし

該当なし

「プライマリ・ファイル」という名前のメタデータ・フィールド。
メタデータのみが更新されている場合、primaryFileフィールドは必須ではありませんが、dRevLabelは必須です。

オプションのdRevLabelフィールドが指定され、コンテンツ・サーバー・インスタンスに存在するリビジョン・ラベルと一致する場合、primaryFileフィールドは必須ではなく、そのリビジョンで指定されたプライマリ・ファイルが使用されます。

dRevLabelは必須フィールドではありませんが、primaryFileが存在しない場合、dRevLabelが必須フィールドになる点に注意することが重要です。

プライマリ・ファイル名は、完全パスまたはファイル名そのものになります。ファイル名のみが指定されている場合、ファイルの場所は次のように決定されます。

- SetFileDirオプション・パラメータが現在のファイル・レコードまたは前のファイル・レコードで設定されている場合、SetFileDirに指定されたディレクトリが使用されます。

- SetFileDirパラメータが設定されていない場合、バッチ・ロード・ファイルのパスが使用されます。(パスは、「バッチ・ローダー」ウィンドウの「バッチロード・ファイル」フィールドに指定します。)

dInDate

該当なし

なし

「リリース日」という名前のメタデータ・フィールド。

- dInDateは、バッチ・ローダーを実行しているユーザーのロケールの日付フォーマットを使用する必要があります。たとえば、米国英語の日付フォーマットはmm/dd/yy hh:mm:ss am/pmです。

- 時間情報はオプションです。時間を指定する場合、hh:mmの部分のみが必須です。ssおよびam/pmの部分はオプションです。

<<EOD>>

該当なし

該当なし

ファイル・レコードのデータの終端を示します。

4.1.5.2 更新の例1

この例では、次のメタデータを持つ2つのファイルがすでにシステムにチェックインされていることを前提としています。

- HR001では、リリース日が1998年9月26日で、リビジョン1です

- HR002では、リリース日が1999年3月15日で、リビジョン2です

最初のファイル・レコードであるコンテンツID HR001は、システムに存在しますが、バッチ・ロード・ファイルで指定されたリビジョン(dRevLabel)がありません。そのため、バッチ・ローダーは、バッチ・ロード・ファイルに指定されたリリース日と、システム内の最新リビジョンのリリース日を比較します。1999年2月20日は1998年9月26日より後であるため、HR001の新規リビジョン2が追加されます。

2番目のファイル・レコードであるコンテンツID HR002は、システムに存在し、リビジョン(dRevLabel)が指定されていますが、リビジョン3がシステムに存在しません。そのため、HR002の新規リビジョン3が追加されます。

Action=update
dDocName=HR001
dDocType=Form
dDocTitle=New Employee Form
dDocAuthor=Olson
dSecurityGroup=Public
primaryFile=hr001.doc
DInDate=2/20/99
<<EOD>>
dDocName=HR002
dDocTitle=Payroll Change Form
primaryFile=hr002.doc
DIndate=2/20/99
dRevLabel=3
<<EOD>>

4.1.5.3 更新の例2

この例では、次のメタデータを持つ1つのファイルがすでにシステムにチェックインされていることを前提としています。

- コンテンツID = HR003

- リリース日 = 1997年3月15日

- リビジョン = 1

- タイトル = Performance Review

- 作成者 = Smith

コンテンツID HR003のリビジョン1がシステムに存在し、アクティブ・ワークフローにないため、このリビジョンは新しいタイトル、作成者およびリリース日のメタデータで更新されます。

Action=update
dDocName=HR003
dDocType=Form
dDocTitle=Performance Review Template
dDocAuthor=Smith
primaryFile=hr003.doc
dIndate=2/20/99
dRevLabel=1
<<EOD>>

4.1.6 バッチ・ロード・ファイルのオプション・パラメータについて

次の表は、バッチ・ロード・ファイル内のファイル・レコードで使用できるオプション・パラメータを示しています。

バッチ・ロード・ファイルでは、コンテンツ・アイテムのチェックインに割り当てられたプライマリ・フォーマットおよび代替フォーマットをオーバーライドするために、2つの方法があります。

- primaryFile:formatパラメータの値を指定、またはalternateFile:formatパラメータの値を指定、あるいはその両方。ただし、primaryOverrideFormatパラメータまたはalternateOverrideFormatパラメータを使用して、これらの値をオーバーライドできます。コンポーネントを特定のタイプのチェックインで特定のフォーマットにしたり、別々のフォーマットにする特定のアプリケーション機能がいくつかのコンポーネントに存在するようにすることも可能です。

- primaryOverrideFormatパラメータの値を指定、またはalternateOverrideFormatパラメータの値を指定、あるいはその両方。ただし、これらは、IsOverrideFormat構成変数を有効にする場合にバッチ・ロード・ファイルのパラメータとしてのみ機能します。この方法を使用すると、primaryFile:formatパラメータおよびalternateFile:formatパラメータに設定する値をオーバーライドすることに注意してください。

オプション・パラメータ

定義

dRevLabel

「リビジョン」という名前のメタデータ・フィールド。
最大フィールド長は10文字です。

値は整数であるか、システム・プロパティ設定で設定されたメジャー/マイナー・リビジョンのラベル・シーケンスに準拠している必要があります。

dDocAccount

「アカウント」という名前のメタデータ・フィールド。
最大フィールド長は30文字です。

このフィールドは、次のファイル・レコードに継承されません。

アカウントが有効になっていない場合は、このフィールドを指定しないでください。

アカウントが有効になっていて、このフィールドが指定されていない場合、dDocAccountは空の値に設定されます。

xComments

「コメント」という名前のメタデータ・フィールド。最大フィールド長は255文字です。

dOutDate

「有効期限」という名前のメタデータ・フィールド。
dOutDateは、バッチ・ローダーを実行しているユーザーのロケールの日付フォーマットを使用する必要があります。たとえば、米国英語の日付フォーマットはmm/dd/yy hh:mm:ss am/pmです。

時間情報はオプションです。時間を指定する場合、hh:mmの部分のみが必須です。ssおよびam/pmの部分はオプションです。

primaryFile:path

ファイルの場所を指定します。primaryFile:pathの値が指定されている場合、その値はprimaryFileパラメータに指定した値をオーバーライドします。ただし、primaryFile:pathの値は、ファイル変換フォーマットを決定するために使用されません。primaryFile:pathの値が指定されていない場合、場所はprimaryFileの値から決定されます。
このパラメータでは、次の構文が使用されます。

primaryFile:path=complete_path/primary_file_name

primaryFile:format

プライマリ・ファイルに使用するファイル形式を指定します。このファイル形式は、ファイルのファイル拡張子によって指定されたもの、およびprimaryFileパラメータに指定した値をオーバーライドします。primaryFile:formatの値が指定されていない場合、ファイル形式はprimaryFileの値のファイル拡張子から決定されます。
このパラメータでは、次の構文が使用されます。

primaryFile:format=application/conversion_type

alternateFile

「代替ファイル」という名前のメタデータ・フィールド。代替ファイル名は、完全パスまたはファイル名そのものになります。ファイル名のみが指定されている場合、ファイルの場所は次のように決定されます。
SetFileDirオプション・パラメータが現在のファイル・レコードまたは前のファイル・レコードで設定されている場合、SetFileDirに指定されたディレクトリが使用されます。

SetFileDirパラメータが設定されていない場合、バッチ・ロード・ファイルのパスが使用されます。(パスは、「バッチ・ローダー」ウィンドウの「バッチロード・ファイル」フィールドに指定します。)

alternateFile:path

代替ファイルの場所を指定します。alternateFile:pathの値が指定されている場合、その値はalternateFileパラメータに指定した値をオーバーライドします。ただし、alternateFile:pathの値は、ファイル変換フォーマットを決定するために使用されません。alternateFile:pathの値が指定されていない場合、場所はalternateFileパラメータの値が指定されている場合はその値から決定されます。そうでない場合、デフォルトでは、primaryFileの値は計算に使用されます。
このパラメータでは、次の構文が使用されます。

alternateFile:path=complete_path

alternateFile:format

代替ファイルに使用するファイル形式を指定します。このファイル形式は、ファイルのファイル拡張子によって指定されたもの、およびalternateFileパラメータに指定した値をオーバーライドします。alternateFile:formatの値が指定されていない場合、ファイル形式はalternateFileパラメータの値が指定されている場合はその値のファイル拡張子から決定されます。そうでない場合、デフォルトでは、primaryFileの値は計算に使用されます。
このパラメータでは、次の構文が使用されます。

alternateFile:format=application/conversion_type

webViewableFile

Web表示可能ファイル名は、完全パスまたはファイル名そのものになります。webViewableFileの値が指定されている場合、変換プロセスは実行されません。ファイル名のみが指定されている場合、ファイルの場所は次のように決定されます。
SetFileDirオプション・パラメータが現在のファイル・レコードまたは前のファイル・レコードで設定されている場合、SetFileDirに指定されたディレクトリが使用されます。

SetFileDirパラメータが設定されていない場合、バッチ・ロード・ファイルのパスが使用されます。(パスは、「バッチ・ローダー」ウィンドウの「バッチロード・ファイル」フィールドに指定します。)

webViewableFile:path

Web表示可能ファイルの場所を指定します。webViewableFile:pathの値が指定されている場合、その値はwebViewableFileパラメータに指定した値をオーバーライドします。ただし、webViewableFile:pathの値は、ファイル変換フォーマットを決定するために使用されません。webViewableFile:pathの値が指定されていない場合、場所はwebViewableFileパラメータの値が指定されている場合はその値から決定されます。そうでない場合、デフォルトでは、primaryFileの値は計算に使用されます。
このパラメータでは、次の構文が使用されます。

webViewableFile:path=complete_path

webViewableFile:format

Web表示可能ファイルに使用するファイル形式を指定します。このファイル形式は、ファイルのファイル拡張子によって指定されたもの、およびwebViewableFileパラメータに指定した値をオーバーライドします。webViewableFile:formatの値が指定されていない場合、ファイル形式はwebViewableFileパラメータの値が指定されている場合はその値のファイル拡張子から決定されます。そうでない場合、デフォルトでは、primaryFileの値は計算に使用されます。
このパラメータでは、次の構文が使用されます。

alternateFile:format=application/conversion_type

primaryOverrideFormat

プライマリ・ファイルに使用するファイル形式を指定します。このファイル形式は、ファイルのファイル拡張子によって指定されたものをオーバーライドします。このオプションは、IsOverrideFormat構成変数を有効にする場合にパラメータとしてのみ機能します。この変数は、システム・プロパティ・ユーティリティでフォーマットのオーバーライドを許可を選択することで設定できます。ただし、これよりも、primaryFile:formatパラメータを使用することをお薦めします。

alternateOverrideFormat

代替ファイルに使用するファイル形式を指定します。このファイル形式は、ファイルのファイル拡張子によって指定されたものをオーバーライドします。このオプションは、IsOverrideFormat構成変数を有効にする場合にパラメータとしてのみ機能します。この変数は、システム・プロパティ・ユーティリティでフォーマットのオーバーライドを許可を選択することで設定できます。ただし、これよりも、代替のFile:formatパラメータを使用することをお薦めします。

SetFileDir

プライマリ・ファイルおよび代替ファイルがあるディレクトリを指定します。このフィールドは、次のファイル・レコードに継承されます。

4.1.7 カスタム・メタデータ・フィールドについて

構成マネージャに定義されている任意のカスタム・メタデータ・フィールドを、ファイル・レコードに含めることができます。

- カスタム・メタデータ・フィールドは、必須フィールドとして定義した場合、挿入アクションや更新アクションの際に定義する必要があります。

- カスタム・メタデータ・フィールドが必須フィールドではないが、空白であってもそれにデフォルト値がある場合、そのデフォルト値は、バッチ・ロード・ファイルで指定されていない場合は使用されます。

- カスタム・メタデータ・フィールドの値を指定する際には、フィールド名の前にxを付けます。たとえば、Locationというカスタム・メタデータ・フィールドがある場合、バッチ・ロード・ファイル・エントリはxLocation=valueになります。

- アドオン製品には、カスタム・メタデータ・フィールドを使用しているものがあることに注意してください。たとえば、PDF Watermarkがある場合、Watermarkというフィールドを作成します。このフィールドをバッチ・ロード・ファイルに含めるには、他のカスタム・メタデータ・フィールドと同様に、それの前にxを付けます(例: xWatermark)。

4.2 バッチ・ロード・ファイルの準備

この項の項目は次のとおりです。

- 第4.2.1項「バッチ・ロード・ファイルの準備について」

- 第4.2.2項「マッピング・ファイル」

- 第4.2.3項「「バッチビルダー」ウィンドウからのバッチ・ロード・ファイルの作成」

- 第4.2.4項「マッピング・ファイルの作成」

- 第4.2.5項「コマンドラインからのバッチ・ロード・ファイルの作成」

4.2.1 バッチ・ロード・ファイルの準備について

生成されるテキスト・ファイルがバッチ・ロード・ファイルの構文要件に従っていれば、希望する方法で、バッチ・ロード・ファイルを作成できます。ただし、バッチ・ローダーには、バッチ・ロード・ファイルを作成する際に役立つバッチビルダーというツールが用意されています。

- バッチビルダーは、指定したディレクトリにあるファイルに基づいて、バッチ・ロード・ファイルを作成します。バッチビルダーは、バッチ・ロード・ファイルを作成するすべてのサブディレクトリ全体を再帰的に読み取ります。

- マッピング・ファイルは、各ファイル・レコードのメタデータを決定する方法をバッチビルダーに説明します。バッチビルダーを使用して、カスタム・マッピング・ファイルを作成および保存できます。

- バッチビルダーは、スタンドアロンのユーティリティ・インタフェースまたはコマンドラインから実行できます。

- バッチビルダーは、コンテンツの外部コレクションを作成するために使用することもでき、これはコンテンツ・サーバー・データベース内ではなく別の検索コレクションに索引付けおよび格納されます。読取り専用の外部コレクションを設定でき、この場合、ユーザーは、コンテンツの検索はできますが、メタデータの更新やコンテンツの削除はできません。外部コンテンツが別のコンテンツ・サーバー・インスタンスにも含まれている場合に、このオプションをお薦めします。

バッチ・ローダー・ユーティリティを使用して、コンテンツ・サーバー・インスタンスで大量のファイルを同時に更新および挿入することを計画している場合は、バッチ・ロード・ファイルを作成する必要があります。バッチ・ロード・ファイルに含めることのできるオプション・パラメータの2つは、primaryOverrideFormatとalternateOverrideFormatです。ただし、これらのオプションは、IsOverrideFormat構成変数を有効にすると、バッチ・ロード・ファイルのパラメータとしてのみ動作します。この変数は、システム・プロパティ・ユーティリティを使用して設定できます。

4.2.2 マッピング・ファイル

マッピング・ファイルは、.hda拡張子を持つテキスト・ファイルで、コンテンツ・サーバー・インスタンスで使用されるデータ・ファイルのタイプで識別されます。

HDAファイル、LocalDataプロパティおよびResultSetsの詳細は、『Oracle WebCenter Contentでの開発』を参照してください。

4.2.2.1 マッピング・ファイルのフォーマット

次の2つのうちの1つのフォーマットで、メタデータ・マッピングを定義できます。

- LocalData定義での名前/値のペアの場合、マッピング・ファイルは次のようになります。

@Properties LocalData
dDocName=<$filename$>.<$extension$>
dInDate=<$filetimestamp$>
@end

- BatchBuilderMapping ResultSetの場合、マッピング・ファイルは次のようになります。

@ResultSet SpiderMapping
2
mapField
mapValue
dDocName
<$filename$>.<$extension$>
dInDate
<$filetimestamp$>
@end

4.2.2.2 マッピング・ファイルの値

マッピング・ファイルでは、次の値を使用できます。

値

説明

例

標準の文字列

すべてのファイルは、指定されたメタデータ値を持ちます。

dDocType=Document
すべてのファイルは、Documentコンテンツ・タイプになります。

Idocスクリプト

任意のサポート済のIdocスクリプト。詳細は、『Oracle WebCenter Contentでの開発』を参照してください。

xLanguage=<$if strEquals(dir2, "EN")$>English<$elseif strEquals(dir2, "SP")$>Spanish<$else$>French<$endif$>

<$dir1$>, <$dir2$>

ファイルのパス内の指定したレベルのディレクトリ名。<$dir1$>は「ディレクトリ」フィールドで指定したルート・ディレクトリを参照し、<$dir2$>はその次のレベルのディレクトリを参照します。

dDocType=<$dir1$>
dSecurityGroup=<$dir2$>
dDocAccount=<$dir3$>

ファイル・パスがf:/docs/public/sales/march.docで、「ディレクトリ」の値にf:/docsを指定した場合、値は次のようになります。

<$dir1$> = "docs"
<$dir2$> = "public"
<$dir3$> = "sales"

<$dUser$>

現在ログインしているユーザー。

dDocAuthor=<$dUser$>

administratorがログインしている場合、<$dUser$>はadministratorになります。

<$extension$>

ファイルのファイル拡張子。

dDocTitle=<$filename$>.<$extension$>

ファイル・パスがd:/salesdocs/sample.docの場合、<$extension$>はdocです。

<$filename$>

ファイルの名前。

dDocName=<$filename$>

ファイル・パスがd:/salesdocs/sample.docの場合、<$filename$>はsampleです。

<$filepath$>

ファイル名を含む、ファイルのディレクトリ・パス全体。

xPath=<$filepath$>

ファイル・パスがc:/docs/public/acct/sample.docの場合、<$filepath$>はc:/docs/public/acct/sample.docです。

<$filesize$>

ファイルのサイズ(バイト単位)。

xFileSize=<$filesize$>

42KBのファイルの場合、<$filesize$>は43008になります。

<$filetimestamp$>

ファイルが最後に変更された日時。

dInDate=<$filetimestamp$>

最終変更日が2001年9月13日午後4時3分の場合、<$filetimestamp$>は、米国英語のロケールでは9/13/01 4:03 PMになります。

<$URL$>

物理ファイル・ルートおよび相対Webルートの値に基づいた、ファイルのURL。

4.2.3 「バッチビルダー」ウィンドウからのバッチ・ロード・ファイルの作成

「バッチビルダー」ウィンドウからバッチ・ロード・ファイルを作成するには:

1. バッチ・ローダー・ユーティリティを起動します。

- Windows: 「スタート」、「プログラム」、「コンテンツ・サーバー」、instance_name、「ユーティリティ」、「バッチローダー」の順に選択します。

- UNIX: DomainHome/ucm/cs/bin/ディレクトリに移動し、シェル・ウィンドウで「./BatchLoader」と入力して、キーボードで[RETURN]キーを押します。

2. ログイン・ウィンドウで、コンテンツ・サーバー管理者のユーザー名およびパスワードを入力し、「OK」をクリックします。

3. 「バッチ・ローダー」ウィンドウで「オプション」を選択し、「バッチ・ファイルのビルド」をクリックします。

4. 「バッチビルダー」ウィンドウの「ディレクトリ」フィールドに、バッチ・ロード・ファイルに含めるファイルの場所を入力します。

5. 「バッチロード・ファイル」フィールドに、バッチ・ロード・ファイルのパスおよびファイル名を入力します。「参照」ボタンをクリックして、目的のディレクトリおよびファイルにナビゲートし、選択することができます。

6. マッピング・リストから、マッピング・ファイルを選択します。新規マッピング・ファイルの作成または既存のものの編集を行う場合は、第4.2.4項を参照してください。

7. オプション:「ファイル・フィルタ」フィールドに、特定のファイルをバッチ・ロード・ファイルに含めたり除外するフィルタ設定を入力します。

8. オプション: 読取り専用の外部コレクションをバッチ・ロードするには、「外部」を選択し、外部コレクションのオプションを選択します。

9. 「ビルド」をクリックします。

10. ビルド・プロセスが完了したら、「OK」をクリックします。

11. バッチ・ロード・ファイルをテキスト・エディタで開き、ファイル・レコードを再確認します。

12. 現在のバッチ・ロード・ファイルの設定をデフォルトとして保存するには、「オプション」、「構成の保存」の順に選択します。

4.2.4 マッピング・ファイルの作成

マッピング・ファイルを作成するには:

1. 「バッチビルダー」ウィンドウを開きます。

2. 「マッピング」フィールドの横にある「編集」をクリックします。

3. バッチビルダー・マッピング・リスト・ウィンドウで、「追加」をクリックします。

4. 「バッチビルダー・マッピングの追加」ウィンドウで、マッピング・ファイルの名前と説明を入力し、「OK」をクリックします。

5. 「バッチビルダー・マッピングの編集」ウィンドウで、「追加」をクリックします。

6. 「バッチビルダー・マッピング・フィールドの追加/編集」ウィンドウに、定義するメタデータ・フィールド名を入力します。たとえば、「コンテンツID」フィールドに「dDocName」と入力し、「コメント」フィールドに「xComments」と入力します。

7. メタデータ・フィールドの値を入力します。

- 任意の定数テキストおよびIdocスクリプトを「値」フィールドに直接入力します。たとえば、バッチ・ロード・ファイルのすべてのドキュメントのタイプに「Document」を設定するには、「フィールド」フィールドに「dDocType」と入力し、「値」フィールドに「Document」と入力します。詳細は、『Oracle WebCenter Contentでの開発』を参照してください。

- 事前定義済の変数を「値」フィールドに追加するには、右列で変数を選択し、「<<」ボタンをクリックします。たとえば、セキュリティ・グループに各ドキュメントの第2レベルのディレクトリを設定するには、「フィールド」フィールドに「dSecurityGroup」と入力し、「値」フィールドに<$dir1$>変数を挿入します。

注意:
事前定義済の変数を選択する際には注意してください。多くのメタデータ・フィールドには、長さの制限があり、空白や句読点などの特定の文字を含めることができません。『Oracle WebCenter Contentのマネージング』のコンテンツの管理に関する項を参照してください。

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

9. 定義するメタデータ・フィールドの数だけ、ステップ4から8までを繰り返します。

10. 「OK」をクリックして、変更を保存し、「バッチビルダー・マッピングの編集」ウィンドウを閉じます。
マッピング・ファイルは、MapFileName.hdaという名前でIntradocDir/search/external/mapping/ディレクトリに保存されます。

11. 「閉じる」をクリックして、バッチビルダー・マッピング・リスト・ウィンドウを閉じます。

4.2.5 コマンドラインからのバッチ・ロード・ファイルの作成

BatchBuilderパラメータを、「バッチビルダー」ウィンドウから入力するのではなく、コマンドラインから入力することで、バッチ・ロード・ファイルを作成できます。コマンドラインからバッチ・ロード・ファイルを作成するには:

1. DomainHome/ucm/cs/bin/intradoc.cfgファイルをテキスト・エディタで開き、コンテンツ・サーバー・システム管理者のユーザー名がsysadminであることを示す次の行を追加します。

BatchLoaderUserName=sysadmin

これは、管理権限を持つユーザーのみがバッチ・ローダーおよびバッチビルダー・ユーティリティを実行する権限を持っているため、システム管理者としてシステムにログインするために必要です。

2. ファイルを保存して閉じます。

3. コマンドライン・ウィンドウを開き、DomainHome/ucm/cs/bin/ディレクトリに変更します。

注意:
コンテンツ・サーバー・インスタンスを実行しているのと同じオペレーティング・システム・アカウントを使用して、バッチビルダーを実行します。そうでない場合、権限の問題が発生するため、ソフトウェアはデータを処理しません。

4. 次のコマンドを入力します。

- Windows:

BatchLoader.exe -spider -q -ddirectory -mmappingfile -nbatchloadfile

- UNIX:

BatchLoader -spider -q -ddirectory -mmappingfile -nbatchloadfile

次のフラグは、バッチビルダーをコマンドラインから実行するBatchLoaderコマンドで使用できます。

フラグ

必須?

説明

-spiderまたは/spider

あり

バッチビルダー・ユーティリティを実行します。

-qまたは/q

なし

バッチビルダーを、バックグラウンドで消音モードで実行します。(このフラグを使用せずにバッチビルダーをコマンドラインから実行すると、「バッチビルダー」ウィンドウが表示されます。)

-dまたは/d

あり

「ディレクトリ」フィールドの値。

-mまたは/m

あり

「マッピング」フィールドの値。

-nまたは/n

あり

「バッチロード・ファイル」フィールドの値。

-eまたは/e

なし

指定したファイルを除外します(「除外」チェック・ボックスを選択します)。

-iまたは/i

なし

指定したファイルを含めます(「除外」チェック・ボックスを選択解除します)。

4.2.5.1 Windowsの例

次の例は、バッチビルダーをWindowsのコマンドラインから実行する正しい構文を示しています。

- ディレクトリ = c:/myfiles

- マッピング・ファイル = MyMappingFile

- バッチ・ロード・ファイル = c:/batching/batchinsert.txt

- 除外するファイル = *.exeおよび*.zip

BatchLoader.exe -spider -q -dc:/myfiles -mMyMappingFile -nc:/batching/batchinsert.txt -eexe,zip

4.2.5.2 UNIXの例

次の例は、バッチビルダーをUNIXのコマンドラインから実行する正しい構文を示しています。

- ディレクトリ = /myfiles

- マッピング・ファイル = MyMappingFile

- バッチ・ロード・ファイル = /batching/batchinsert.txt

- 除外するファイル = index.htmおよびindex.html

BatchLoader -spider -q -d/myfiles -mMyMappingFile -n/batching/batchinsert.txt -eindex.htm,index.html

4.3 バッチ・ローダーの実行

この項の項目は次のとおりです。

- 第4.3.1項「バッチ・ローダーの実行について」

- 第4.3.2項「「バッチ・ローダー」ウィンドウからのバッチ・ロード」

- 第4.3.3項「コマンドラインからのバッチ・ロード」

- 第4.3.4項「IdcCommandユーティリティおよびリモート・アクセスの使用」

- 第4.3.5項「メタデータとしてのみのコンテンツのバッチ・ロード」

- 第4.3.6項「バッチ・ローダーの-consoleコマンドライン・スイッチ」

- 第4.3.7項「リダイレクトの追加」

- 第4.3.8項「バッチ・ロード・エラーの修正」

4.3.1 バッチ・ローダーの実行について

バッチ・ローダーでは、コンテンツ・サーバー・インスタンスで大量のファイルを同時にチェックイン(挿入)、削除または更新するために、バッチ・ロード・ファイルの情報が使用されます。

- バッチ・ローダーは、スタンドアロンのユーティリティ・インタフェースまたはコマンドラインから実行できます。

- バッチ・ローダーの実行後に、コンテンツ・サーバー・インスタンスは、他のコンテンツ・アイテムの場合と同様に、Inbound Refineryインスタンスおよびインデクサを通じてファイルを処理します。

4.3.2 「バッチ・ローダー」ウィンドウからのバッチ・ロード

「バッチ・ローダー」ウィンドウを使用してコンテンツをバッチ・ロードするには:

1. 「バッチ・ローダー」ウィンドウを開きます。

2. 「参照」をクリックして、バッチ・ロード・ファイルにナビゲートし、選択します。

3. バッチ・ローダーが処理を停止するまでに発生してもよいエラーの数を変更するには、「許容最大エラー数」フィールドに数字を入力します。

4. ファイルを正常にチェックインまたは更新した後でハード・ドライブからファイルを削除するには、「チェックインが成功した後でファイルをクリーン・アップします。」を選択します。

5. バッチ・ロード中に失敗したファイル・レコードを含むテキスト・ファイルを作成するには、「失敗したリビジョン・クラスに対してエラー・ファイルを有効にします。」を選択します。

6. 「バッチ・ファイルをロードします。」をクリックして、バッチ・ローダー・プロセスを開始します。
バッチ・ロード・プロセスが完了すると、「バッチ・ローダー」メッセージ・ウィンドウが開き、発生したエラー(ある場合)の数が示されます。

7. エラー・ファイルを有効化する場合、メッセージ・ボックスに表示されるファイル名を記録しておきます。

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

9. バッチ・ロードでの問題を修正します。

10. 現在のバッチ・ローダーの設定をデフォルトとして保存するには、「オプション」、「構成の保存」の順に選択します。

4.3.3 コマンドラインからのバッチ・ロード

バッチ・ローダー・パラメータを、「バッチ・ローダー」ウィンドウから入力するのではなく、コマンドラインから入力することで、コンテンツをバッチ・ロードできます。コマンドラインからバッチ・ローダーを実行するには:

1. DomainHome/ucm/cs/bin/intradoc.cfgファイルをテキスト・エディタで開き、コンテンツ・サーバー・システム管理者のユーザー名がsysadminであることを示す次の行を追加します。

BatchLoaderUserName=sysadmin

これは、管理権限を持つユーザーのみがバッチ・ローダー・ユーティリティを実行する権限を持っているため、システム管理者としてシステムにログインするために必要です。

2. ファイルを保存して閉じます。

3. コマンドライン・ウィンドウを開き、DomainHome/ucm/cs/bin/ディレクトリに移動します。

注意:
コンテンツ・サーバー・インスタンスを実行しているのと同じオペレーティング・システム・アカウントを使用して、バッチ・ローダーを実行します。そうでない場合、権限の問題が発生するため、ソフトウェアはファイルを処理しません。

4. 次のコマンドを入力します。

- Windows:

BatchLoader.exe -q -nbatchloadfile

- UNIX:

BatchLoader -q -nbatchloadfile

バッチ・ローダーはバッチ・ロード・ファイルを処理しますが、メッセージ・ボックスは表示されません。

5. バッチ・ロードでの問題を修正します。

次のフラグは、コマンドラインからBatchLoaderコマンドで使用できます。

フラグ

必須?

説明

-qまたは/q

なし

バッチ・ローダーを、バックグラウンドで消音モードで実行します。(このフラグを使用せずにバッチ・ローダーをコマンドラインから実行する場合、「バッチ・ローダー」ウィンドウが表示されます。)

-nまたは/n

あり

「バッチロード・ファイル」フィールドの値。

-console

なし

HTML Content Serverログおよびバッチ・ローダーを実行しているコンソール・ウィンドウに、すべてのアウトプットがエコーされます。詳細は、第4.3.6項を参照してください。

4.3.3.1 Windowsの例

次の例は、バッチ・ロード・ファイルがc:/batching/batchinsert.txtである場合の、バッチ・ローダーをWindowsのコマンドラインから実行する正しい構文を示しています。

BatchLoader.exe -q -nc:/batching/batchinsert.txt

4.3.3.2 UNIXの例

次の例は、バッチ・ロード・ファイルが/batching/batchinsert.txtである場合の、バッチ・ローダーをUNIXのコマンドラインから実行する正しい構文を示しています。

BatchLoader -q -n/batching/batchinsert.txt

4.3.4 IdcCommandユーティリティおよびリモート・アクセスの使用

コンテンツ・サーバー・インスタンスを管理する際に、リモート・アクセスを使用する必要がある場合があります。これは、必ずしもリモート・ターミナル・アクセスが必要であるということではありません。ただし、リモートの場所からサーバーにコマンドを発行できるようにする必要があります。

リモート・アクセスとIdcCommandユーティリティを組み合せると、強力なツールセットとなり、インスタンスに大量のファイルを簡単にチェックインできるようになります。この機能を利用するには、発行コマンドにワークステーションを正しく設定して、バッチ・ロード・コマンドライン・ファイルでIdcCommandユーティリティを使用できるようにする必要があります。

この項の内容は次のとおりです。

- 第4.3.4.1項「バッチ・ロード・コマンド・ファイル」

- 第4.3.4.2項「リモートのバッチ・ロードの準備」

4.3.4.1 バッチ・ロード・コマンド・ファイル

バッチ・ロード・コマンド・ファイルには、ロードされる各ファイルのコマンドのセットが含まれています。大量のファイルをロードする場合、コマンド・ファイルが何百行にもなる可能性があります。編集ツールを使用すると、必要な多くの行を作成するタスクを単純化できます。たとえば、「リモートのバッチ・ロードの準備」の手順では、Microsoft Officeの編集およびメール・マージ機能を使用してバッチ・ロード・コマンド・ファイルを準備する方法を示しています。

次に、バッチ・ロード・コマンド・ファイルの例を示します。

@Properties LocalData
IdcService=CHECKIN_UNIVERSAL
doFileCopy=1
dDocTitle=thisfile
dDocType=Native
dSecurityGroup=Internal
dDocAuthor=sysadmin
primaryFile=filename
primaryFile:Path=pathtothefile/primaryfilename
xComments=Initial Check In
@end
<<EOD>>@Properties LocalData
IdcService=CHECKIN_UNIVERSAL
doFileCopy=1
dDocTitle=99.tif
dDocType=Native
dSecurityGroup=Internal
dDocAuthor=sysadmin
primaryFile=350.afp
primaryFile:path=/lofs/invoices/350.afp
xComments=Initial Check In
@end
<<EOD>>

4.3.4.2 リモートのバッチ・ロードの準備

リモートの場所からバッチ・ロードを実行できます。次の手順はMicrosoft Windowsオペレーティング・システム用に記載されたもので、主なステージは次のとおりです。

- ローカル・コンピュータの構成

- リモート・ワークステーションの構成のテスト

- バッチ・ロード・コマンド・ファイルの作成

- アップロードの実行

4.3.4.2.1 ローカル・コンピュータの構成

ローカル・コンピュータを構成するには:

1. Windowsのエクスプローラを開きます。

2. 作業ディレクトリ(たとえばC:\working_dirなど)を作成します。

3. 作業ディレクトリには、アクセスしているコンテンツ・サーバー・インスタンスの1つ以上のディレクトリ(C:\working_dir\developmentおよびC:\working_dir\contributionなど)を作成します。これらのディレクトリは、DomainHomeNameと呼ばれます。

4. 各DonainHomeNameディレクトリに、cmdfilesサブディレクトリを作成します。

5. リモートのコンテンツ・サーバー・インスタンスで、MW_HOME\user_projects\domains\Domain_Name\ucm\csからそれぞれのDomainHomeName(この場合はC:\working_dir\development and C:\working_dir\contribution)に、次のディレクトリをコピーします。

- working_dir\DomainHomeName\ucm\cs\bin

- working_dir\DomainHomeName\ucm\cs\config

6. リモートのコンテンツ・サーバー・インスタンスから、次のディレクトリ(およびそのファイル)を作業ディレクトリにコピーします。

- working_dir\idc\bin

- working_dir\idc\components
(CSDmsおよびNativeOsUtilsコンポーネント・ファイルをコピーすれば十分です)

- working_dir\idc\config

- working_dir\idc\jlib

- working_dir\idc\resources\core\lang

- working_dir\idc\resources\core\table

- working_dir\idc\resources\core\config

7. テキスト・エディタを使用して、DomainHomeName\ucm\cs\bin\intradoc.cfgファイルをローカル・システム上で開き、ディレクトリ構造に合うようにIntradocDir構成変数を更新します。次に例を示します。

IntradocDir=working_dir\DomainHomeName\ucm\cs,
IdcHomeDir=working_dir\idc
WeblayoutDir=working_dir\DomainHomeName\ucm\cs\weblayout

8. テキスト・エディタを使用して、working_dir\DomainHomeName\ucm\cs\config\config.cfgファイルをローカル・システム上で開き、次の設定が正しいことを確認します。

IntradocServerPort=4444
IntradocServerHostName=HostMachineName

9. リモートのコンテンツ・サーバー・インスタンスで、システム・プロパティ・ユーティリティを使用して、ローカル・コンピュータのIPアドレスをセキュリティ・フィルタに追加します。

10. リモートのコンテンツ・サーバー・インスタンスを再起動します。

4.3.4.2.2 リモート・ワークステーションの構成のテスト

リモート・ワークステーションの構成をテストするには:

1. cmdfilesディレクトリで、pingservertest.hdaという名前のファイルを作成し、次の行を追加します。

@Properties LocalData
IdcService=PING_SERVER
@end

2. コマンド・プロンプトを開き、作業binディレクトリに変更します(たとえば、cd C:\working_dir\development\bin)。

3. 次のコマンドを発行します。

IdcCommand -f ..\cmdfiles\pingservertest.hda -u sysadmin -l ..\pingservertest.log -c server

4. 出力内容を確認します。成功した場合、サーバーから次のメッセージが表示されます。

3/24/04: Success executing service PING_SERVER.
You have completed your setup for remote commands.

4.3.4.2.3 バッチ・ロード・コマンド・ファイルの作成

この手順では、Microsoft Officeの編集およびメール・マージ機能を使用して、バッチ・ロード・コマンド・ファイルを作成します。バッチ・ロード・コマンド・ファイルを作成するには:

1. 次のように、ディレクトリの内容をリストするファイルを作成します。

1. コマンド・プロンプトを開き、ロードするファイルを表すルート・ディレクトリに変更します。

2. 出力内容をファイルにリダイレクトする次のコマンドを使用して、ファイル・リストを作成します。

dir /s /b > filelisting.txt

3. filelisting.txtファイルを確認します。それは次のようになります。

V:\policies\ADMIN\working_dir_Admin\AbbreviationList.doc
V:\policies\ADMIN\working_dir_Admin\Abbreviations.doc
V:\policies\ADMIN\working_dir_Admin\AbsencePres.doc
V:\policies\ADMIN\working_dir_Admin\AdmPatientCare.doc
V:\policies\ADMIN\working_dir_Admin\AdmRounds.doc
V:\policies\ADMIN\working_dir_Admin\AdverseEvents.doc
V:\policies\ADMIN\working_dir_Admin\ArchivesPermanent.doc
V:\policies\ADMIN\working_dir_Admin\ArchivesRetrieval.doc
V:\policies\ADMIN\working_dir_Admin\ArchivesStandardReq.doc

注意:
バッチ・ロードを処理する際、バッチ・ロード・コマンド・ファイル内のprimaryFile文によって示されるサーバー上に、ファイルが存在する必要がある点に注意することが重要です。ファイルのディレクトリをサーバーとローカル・システムにマップする場合は、同じ文字を使用することが最適です。または、ファイルのディレクトリをサーバーに一時的にコピーできます。

2. 次のように、ファイル・リストを編集して、ファイル名およびタイトル・データを作成します。

1. filelisting.txtファイルをExcelで開きます。

2. 「置換」を使用して、ファイル名のみ残っているすべてのディレクトリ情報を削除します。また、filelisting.txtの行を検索し、削除します。

3. 列A(ファイル名が格納されている)を列Bにコピーします。この例では、ファイル名はタイトルにも使用されており、列Bはタイトルになります。

4. 「置換」を使用して、列Bの名前からファイル拡張子を削除します。

5. 新しく1行目を挿入し、最初の列にfilename、2番目の列にtitleと入力します。

6. ファイルを保存します。

3. 次のように、メール・マージ機能を使用して、ファイル・リストから.hdaファイルを作成します。

1. Wordアプリケーションを開き、バッチ・ロード・コマンドのセットを使用して新規ドキュメントを作成します。次の例は、基本的なバッチ・ロード・コマンドを示しています。バッチ・ロード・コマンドを作成する際には、構成設定を一致させる必要があります。

@Properties LocalData
IdcService=CHECKIN_UNIVERSAL
doFileCopy=1
dDocTitle=
dDocType=Native
dSecurityGroup=Internal
dDocAccount=Policy/Admin
dDocAuthor=sysadmin
primaryFile=d:/temp/working_dir_Admin/
xComments=Initial Check In
@end
<<EOD>>

2. 「Tools」、「Letters and Mailing」、「Mail Merge Wizard」の順に選択し、ウィザードを進みます。filelisting.txtファイルをメール・マージへの入力として使用するものを次から選択します。

- レター・ドキュメント(ステップ1)

- 現在のドキュメント(ステップ2)

- 既存のリスト(ステップ3)、Excelスプレッドシートをデータ・ソースとして選択します。

- 追加の項目(ステップ4)、タイトルおよびファイル名のフィールドを、次のように表示されるよう、Wordドキュメントに配置します。

@Properties LocalData
IdcService=CHECKIN_UNIVERSAL
doFileCopy=1
dDocTitle="title"
dDocType=Native
dSecurityGroup=Internal
dDocAccount=Policy/Admin
dDocAuthor=sysadmin
primaryFile=d:/temp/working_dir_Admin/"filename"
xHistory=Initial Check In
@end
<<EOD>>

3. メール・マージを終了し(ステップ5および6)、ページ当たり1つのマージ・レコードを含む新規Wordドキュメントが作成されます。

4. 文字を編集し、すべてを選択し、置換機能を使用してすべてのセクション区切りを削除します。

5. ファイルを、拡張子がhdaのプレーン・テキスト・ファイルとして、/cmdfilesディレクトリに保存します(たとえばfilelisting.hda)

4.3.4.2.4 バッチ・ロードのアップロードの実行

アップロードを実行するには:

1. コマンド・プロンプトを開きます。

2. 作業binディレクトリにナビゲートします。

3. 次のコマンドを発行します。

IdcCommand -f ../cmdfiles/filelisting.hda -u sysadmin -l ../filelisting.log -c server

ファイルはコンテンツ・サーバー・リポジトリにチェックインされ、各ファイルがチェックインされる際に、コマンド・ウィンドウにメッセージが表示されます。

4.3.5 メタデータとしてのみのコンテンツのバッチ・ロード

バッチ・ローダーを使用して実行するアクションに応じて、特定のフィールドがバッチ・ロード・ファイルで必須になります。既存のコンテンツ・アイテムでメタデータのみを更新している場合、「プライマリ・ファイル」フィールドはバッチ・ロードで必須ではありません。詳細は、第4.1.5.1項を参照してください。

ただし、コンテンツをコンテンツ・サーバー・インスタンスにメタデータとしてのみロード(挿入アクション)する場合、「プライマリ・ファイル」フィールドはバッチ・ロード・ファイルで必須になります。このフィールドはインポートで無視されますが、バッチ・ローダーではこれを定義することが要求されます。「プライマリ・ファイル」フィールドが見つからない場合、次のような(または類似した)エラーが表示されます。

レコード番号<number>を確認してください。バッチローダー: 必須フィールドprimaryFileが存在しないので<record>をチェックインできません。

コンテンツをメタデータとしてのみバッチ・ロードするには、次の手順を実行します。

1. 次のように、コンテンツ・サーバー・インスタンスのconfig.cfgファイルを開きます。
IntradocDir/config/config.cfg

2. 次の構成変数を追加します。

createPrimaryMetaFile=true
AllowPrimaryMetaFile=true

3. config.cfgファイルを保存して閉じます。

4. バッチ・ロード・ファイルで、各レコードに対して次のフィールドを追加します。

primaryFile=
createPrimaryMetaFile=true

primaryFileフィールドが空白のままであることは許容されることに注意してください。このフィールドは無視されますが、含める必要があります。

5. バッチ・ローダーの手順またはコマンドラインの手順を使用して、コンテンツのバッチ・ロードを続行します。詳細は、第4.3.2項または第4.3.3項を参照してください。

4.3.6 バッチ・ローダーの-consoleコマンドライン・スイッチ

-consoleスイッチをバッチ・ローダー・コマンドラインに追加することによって、HTMLコンテンツ・サーバー・ログおよびバッチ・ローダーを実行しているコンソール・ウィンドウに、すべてのアウトプットがエコーされます。または、オペレーティング・システムのリダイレクトを使用して、出力を別のログ・ファイルに送信できます。

重要:
-consoleスイッチは、標準的なWindowsコマンドライン構文に従っていません(ただし、これは、以降のバージョンで修正される可能性があります)。/console構文ではなく、通常はUNIXに関連付けられている-console構文を使用する必要があります。他のほとんどのコマンドライン・ユーティリティについては、両方の構文が両方のプラットフォームで機能します。

コマンドラインの例

- Windowsのコマンドライン:

BatchLoader.exe -console -q -nc:/batching/batchinsert.txt

- UNIXのコマンドライン:

BatchLoader -console -q -n/u2/apps/batching/batchinsert.txt

サンプル出力

Processed 1 of 4 record.
Processed 2 of 4 records.
Processed 3 of 4 records.
Processed 4 of 4 records.
Done processing batch file 'c:/batching/batchinsert.txt'. Out of 4 records processed, 4 succeeded and 0 errors occurred.

4.3.7 リダイレクトの追加

コマンドラインでリダイレクト・シンボルを使用して、バッチ・ローダーの出力を別のログ・ファイルに送信できます。シンボルは、UNIXとWindowsの両方で機能します。デフォルトでは、-consoleスイッチは、バッチ・ローダーの出力をstderrに送信します。出力を別のファイルにリダイレクトするには、特別なリダイレクト・シンボル2>を使用します。

次の例では、各コマンドは、すべてを1行に入力する必要があります。

- Windowsのリダイレクトを含むコマンドライン:

BatchLoader.exe -console -q -nc:/batching/batchinsert.txt 2> batchlog.txt

- UNIXのリダイレクトを含むコマンドライン:

BatchLoader -console -q -n/u2/apps/batching/batchinsert.txt 2>
/logs/CSbatchload.log

4.3.8 バッチ・ロード・エラーの修正

バッチ・ロード中に発生したエラーを修正するには:

1. 「管理」、「ログ・ファイル」、「Content Serverログ」の順に選択します。

2. コンテンツ・サーバーのログ・ファイルで、Type列のErrorという語句を調べます。

3. 説明を読んで、問題を判別します。

4. 次のファイルのうちの1つで、エラーを修正します。

- バッチ・ロード・ファイル。

- 失敗したコンテンツのエラー・ファイル。(このオプションは、「バッチ・ローダー」ウィンドウでそれが有効になっている場合にのみ使用できます。)エラー・ファイルは、バッチ・ロード・ファイル名にいくつかの数字が追加された名前で、バッチ・ロード・ファイルと同じディレクトリにあります。

ヒント:
バッチ・ロード・ファイル全体が返される場合、すでにチェックインされたコンテンツ・アイテムは、通常は失敗します。これが発生するのは、既存のコンテンツ・アイテムのリリース日が挿入しようとするものと同じになるためです。

図4-4 コンテンツ・サーバーのログ・ファイルの例

4.4 バッチ・ローダーのパフォーマンスの最適化

この項では、バッチ・ローダーのパフォーマンスを向上するために使用できる基本的なガイドラインを示します。次の提案は、大量のコンテンツ・アイテムをチェックインする際に、バッチ・ロードのパフォーマンスの潜在的な低下を最小限にすることができます。多くの場合、バッチ・ロードの適切なチューニングにより、遅いサーバーを大幅に高速化できます。

バッチ・ロードの低速化を最小限にするには、次のバッチ・ローダー調整を実装してみます。

- Inbound Refineryの停止(『Oracle WebCenter Contentのマネージング』を参照)、およびRepository Managerの自動更新サイクル機能の一時停止など、他のアクティビティを一時的に無効化します。

- バッチ・ロード中のデータベース使用率を分析し、データベース問合せオプティマイザに役立てます。データベースには、データベース問合せをより効率的にするのに役立つ、組込みオプティマイザ・ユーティリティがあります。ただし、オプティマイザの効率を最大にするには、表とそれに関連する索引の物理特性に関する統計を、更新または再作成する必要があります。これらの特性には、レコード数、ページ数および平均レコード長などがあります。オプティマイザは、これらの統計を使用してデータにアクセスします。
各データベースには、統計の更新や再作成プロセスを呼び出すのに使用できる独自のコマンドがあります。次に例を示します。

- Oracleの場合、ANALYZE TABLE COMPUTE STATISTICSコマンドを使用します。

- SQL Serverの場合、CREATE STATISTICS文を使用します。

- DB2の場合、RUNSTATSコマンドを使用します。

4.5 ベスト・プラクティス事例

この事例では、非常に低速のロード・バッチのパフォーマンス、およびこの状況を診断および修正するために行った手順について説明します。この情報は、基礎となる問題を特定し、バッチ・ロードのパフォーマンスの問題を解決する際のモデルとしての役割を果たします。

- 第4.5.1項「背景情報」

- 第4.5.2項「事前トラブルシューティング」

- 第4.5.3項「解決策」

4.5.1 背景情報

ユーザーは、AIXサーバー上で実行しているコンテンツ・サーバー・インスタンスに27,000コンテンツ・アイテムをロードしようとしていました。DB2データベースは、別のAIXサーバー上で実行していました。コンテンツ・アイテムには、ネイティブ・ファイルとしてTIFファイル、およびWeb表示可能ファイルとして対応するPDFファイルが含まれていました。Inbound Refineryはネイティブ・ファイルからサムネイルを生成しました。

最初は、バッチ・ロード中のパフォーマンスは許容可能なもので、挿入時間が1秒以内でした。しかし、数千コンテンツ・アイテムをロードした後で、パフォーマンスが低下し始めました。コンテンツ・アイテムのロードに数秒かかるようになり、最終的には、コンテンツ・アイテム当たりのロード時間が10秒以上になりました。

4.5.2 事前トラブルシューティング

バッチ・ロード・の実行中、コンテンツ・サーバー・インスタンスには問題がないと思われました。十分なメモリーがあり、CPU使用率は低く(5%未満)、ディスクのボトルネックもありませんでした。Inbound Refineryサーバーはビジーでしたが、許容できる速度でサムネイルを処理していました。

データベース・サーバーに次の2つの問題が見つかりました。

- 2つのプロセスが交代でデータベースを更新していました。1つ目のプロセスの実行中、2つ目のプロセスは、1つ目のプロセスのデータベース・ロックが解除されるのを待機していました。1つ目のプロセスが完了すると、2つ目のプロセスが実行され、その間、1つ目のプロセスは待機していました。この実行/待機のサイクルのプロセスは、次のとおりです。

- コンテンツ・アイテムの挿入後にデータベース表を更新している実際のバッチ・ロード・プロセス。

- コンテンツ・サーバー・インスタンスはデータベース表を更新しており、サムネイルが完了したという通知を受信した後で、ステータスがGENWWWからDONEに変更されます。

この2つのプロセスは、同じコンテンツ・アイテムを更新していないため、互いに競合する必要がありません。DB2がロック・エスカレーションを実行し、単一の行ではなくデータベース・ページ全体をロックするようになっているため、2つのプロセスがお互いをロックしていたと思われます。

- 両方のプロセスによって、大量の表領域スキャンが実行されていました。

4.5.3 解決策

次の2ステップの解決策を使用しました。

1. Inbound Refineryを停止し、ステータス更新プロセスによって、バッチ・ロード・プロセスとの競合が発生しないようにしました。完了したサムネイルからのコンテンツ・アイテムのバックログが2000件増加されたため、パフォーマンスが向上しました。

2. すべてのコンテンツ・サーバー・データベース表に、RUNSTATSコマンドを発行し、表統計を更新しました。これにより、バッチ・ロードのパフォーマンスが大幅に向上しました。挿入時間は1秒以内に戻り、バッチ・ロードが短時間で完了しました。最初の22,000コンテンツ・アイテムの挿入には21時間かかりました。表統計の更新後は、残りの5000コンテンツ・アイテムは13分で挿入されました。

第III部

Oracle WebCenter Content Serverの監視

この部では、Oracle Enterprise Manager Fusion MiddlewareコンソールおよびWebCenter Contentアプリケーションを使用して、コンテンツ・サーバーおよびInbound Refineryを監視する方法について説明します。

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

- 第5章「コンテンツ・サーバーのステータスの監視」

- 第6章「コンテンツ・サーバーのログ・ファイルの監視」

- 第7章「Fusion Middleware Controlを使用したコンテンツ・サーバーおよびInbound Refineryの監視」

5 コンテンツ・サーバーのステータスの監視

この章では、各種のOracle WebCenter Content Server内部・リソースを使用して、コンテンツ・サーバー・インスタンスのステータスを監視する方法について説明します。

この章の内容は次のとおりです。

- コンテンツ・サーバーのステータスの表示

- コンテンツ・サーバーのコンソール出力の表示

- システム構成情報の表示

- システム監査情報の表示

- サーバー出力の表示

- イベント出力の表示

- スキーマ・キャッシュの確認

- ローカライズ監査情報の表示

- スケジュールされたジョブのモニタリング

5.1 コンテンツ・サーバーのステータスの表示

コンテンツ・サーバー・インスタンスの現在のステータス(実行中、停止など)を表示できます。

Fusion Middleware Controlを使用してコンテンツ・サーバーの現在のステータスを表示するには、次の手順を実行します。

1. ナビゲーション・ツリーで、適切なドメイン名(Content_base_domainなど)を開きます。

2. 「WebCenter」、「コンテンツ」、「コンテンツ・サーバー」の順に展開します。

3. コンテンツ・サーバー・インスタンス名(Oracle WebCenter Content - Content Server (UCM_server1)など)を選択します。

4. コンテンツ・サーバーのホームページに、コンテンツ・サーバー・インスタンスの現在のステータスが表示されます。

5.2 コンテンツ・サーバーのコンソール出力の表示

コンテンツ・サーバー・インスタンスのコンソール出力を表示できます。これは、DomainHome/ucm/cs/data/trace/classname.logファイルにある情報と同じです。

1. 「管理」、「システム監査情報」の順に選択します。

2. 「サーバー出力の表示」をクリックします。

3. 出力メッセージをリフレッシュするには、「ページのリフレッシュ」をクリックします。出力メッセージをクリアするには、「クリア」をクリックします。

5.3 システム構成情報の表示

Oracle WebCenter Contentでは、コンテンツ・サーバー・インスタンスのシステム構成情報を表示する「構成情報」ページが提供されており、問題のトラブルシューティングやOracleサポート組織で作業する際に役に立ちます。

構成情報ページにアクセスするには:

1. 「管理」→「インスタンスの構成」を選択します。

2. 詳細を表示するには、各構成情報のタイプのリンクをクリックします。
提供される構成情報は次のとおりです。

- サーバー名

- バージョン

- クラス・ローダー

- インスタンス・ディレクトリ

- データベース・タイプ

- データベースのバージョン

- HTTPサーバー・アドレス

- メール・サーバー

- 検索エンジン名

- 索引エンジン名

- アクティブな索引

- インストール済の機能の数

- 有効なコンポーネントの数

- 無効なコンポーネントの数

- 自動採番接頭辞

- アカウントを使用

- NTLMセキュリティは有効です

- 読取り特権を持つユーザーである場合にコピーを許可する

- 元のコントリビュータにのみチェックアウトを許可する

- Javaバージョン

注意:
オプションには、ソフトウェアのインストール中に指定されるものもありますが、「システム・プロパティ」ユーティリティを使用して設定されるオプションもあります。

5.4 システム監査情報の表示

Oracle WebCenter Contentでは、コンテンツ・サーバー・インスタンスの「システム監査情報」ページが提供されており、問題のトラブルシューティングやコンテンツ・サーバーのパフォーマンスの調整の際に役立ちます。

「システム監査情報」ページには、いくつかの情報のタイプがあります。

- 第5.4.1項「システム監査の一般的な情報」

- 第5.4.2項「システム監査のローカライズ情報」

- 第5.4.3項「システム監査のトレース・セクション情報」

- 第5.4.4項「システム監査のキャッシュ情報」

- 第5.4.5項「システム監査の構成エントリ情報」

- 第5.4.6項「システム監査のコンポーネント・レポート情報」

5.4.1 システム監査の一般的な情報

「システム監査情報」ページの「一般的な情報」セクションに、一般的なシステム監査の数と詳細を表示できます。

「システム監査情報」ページにアクセスするには、「管理」→「システム監査情報」を選択します。

- コンテンツ・サーバー・インスタンスが起動して稼働した期間。

- 処理されたサービス・リクエスト数、およびシステムがサービス・リクエストを正常に処理したかどうか。システムが受信するリクエストの数が多すぎる場合、ロード・パフォーマンスに関する電子メールがシステム管理者に送信されます。

- JVMメモリー容量の合計、および使用可能なJVMメモリーの合計。また、システムのメモリー使用に関する情報。メモリー不足に関するエラーのトラブルシューティングに役立つ場合があります。ユーザー数とデータ量が多いコンテンツ・サーバー・インスタンスを実行しているときにも重要となる場合がある情報です。

- スレッドの合計数、および現在実行中のJavaスレッドに関する情報。この情報はエラーの原因を特定する場合に有用な場合があります。

- アクティブなデータベース接続の合計数、およびデータベース・アクティビティに関する情報。

- 監査メッセージの合計数。

詳細を表示するには、構成情報のタイプのページでリンクをクリックします。

5.4.2 システム監査のローカライズ情報

「システム監査情報」ページの「ローカライズ情報」セクションに、コンテンツ・サーバー・インスタンスのローカライズに関する数を表示できます。

「システム監査情報」ページにアクセスするには、「管理」→「システム監査情報」を選択します。

- 文字列キー・カウント

- ローカライズ・システムが文字列索引を使用しているかどうか

- ローカライズ・テスト実行時間

- ローカライズ・テスト1秒当たりの参照

5.4.3 システム監査のトレース・セクション情報

「システム監査情報」ページの「トレース・セクション情報」セクションに、トレースの詳細を表示できます。このセクションでは、コンテンツ・サーバー・インスタンス内のトレースを有効にし、セクションごとにアクティブ化できます。アクティブ・セクションのトレースを有効にするには、「システム監査情報」ページで「サーバー出力の表示」をクリックします。セクション・トレースは、コンテンツ・サーバーのどのセクションが問題の原因となっているかを特定する場合、または特定のセクションの詳細を表示するときに役立つ場合があります。

「システム監査情報」ページにアクセスするには、「管理」→「システム監査情報」を選択します。

- トレースに使用できるセクションのリストを簡単な説明とともに表示するには、「トレース・セクション情報」見出しの横にある「情報」アイコンをクリックします。

- 詳細出力をサポートするアクティブなセクションについて詳細なトレースを確認するには、「完全な詳細トレース」を選択します。詳細は、第D.2.1項を参照してください。

- トレース情報を保存する場合は、「保存」を選択します。

- トレースする追加のセクションを指定するには、セクション名のカンマ区切りリストを入力するか、または「アクティブなセクション」フィールドの横にあるメニューからセクションを選択します。ワイルドカード文字*がサポートされているため、たとえばschema*と指定すると、接頭辞schemaで始まるすべてのセクションをトレースできます。セクションを指定したら、「更新」をクリックします。

- トレースする追加のサービスを指定するには、「アクティブ・サービス」フィールドにサービス名のカンマ区切りリストを入力して、「更新」をクリックします。

- トレースする追加のスレッドを指定するには、「アクティブ・スレッド」フィールドにスレッド名のカンマ区切りリストを入力して、「更新」をクリックします。

- トレースで捕捉するテキストを指定するには、「イベント捕捉テキスト」フィールドにテキストを入力して、「更新」をクリックします。イベント捕捉の使用の詳細は、ブログ記事「Caught in the Act!」を参照してください。

- スレッド・ダンプをトレースに追加するには、「スレッド・ダンプの追加」を選択して、「更新」をクリックします。

- 変更したフィールドを以前の設定に戻すには、「リセット」をクリックします。

重要:
「トレース・セクション情報」で設定するすべてのオプションは、「保存」を有効にして「更新」をクリックしていない場合は、コンテンツ・サーバー・インスタンスを再起動する際に失われます。

5.4.4 システム監査のキャッシュ情報

コンテンツ・サーバー・インスタンスは、簡単にアクセスするために様々なアイテムをキャッシュします。「システム監査情報」ページの「キャッシュ情報」セクションに、3つのキャッシュの現在の詳細を表示できます。

「システム監査情報」ページにアクセスするには、「管理」→「システム監査情報」を選択します。

- キャッシュの検索: 永続的にロードされたページ数およびリソース・ファイル数。キャッシュが一時的に制限される数。一時アイテムがロードされるかどうか。実行する個別検索問合せの合計数。実行する個別検索問合せの合計数。これらの詳細は、検索関連の問題のトラブルシューティングの際に役立ちます。

- スキーマ・キャッシュ: スキーマ・キャッシュに格納されているアイテムの合計数。許可されたバイト数から使用されたバイト数。現在キャッシュにあるスキーマ・オブジェクトの追加詳細。

- バッファ・プール・キャッシュ: キャッシュ内のオブジェクトおよび各オブジェクトが使用しているメモリーの容量に関する情報で、「システム監査の一般的な情報」セクションのメモリー情報に反映されます。この情報は、メモリー・リークやその他のメモリーの問題の原因となるオブジェクトを特定する際に役立ちます。(トラブルシューティングの情報は、付録Dを参照してください。)

詳細を表示するには、このページでキャッシュ情報のタイプのリンクをクリックします。

5.4.5 システム監査の構成エントリ情報

「システム監査情報」ページの「構成エントリ情報」セクションに、数と詳細を表示できます。

「システム監査情報」ページにアクセスするには、「管理」→「システム監査情報」を選択します。

- 環境キーの数

- 上書きされた構成値の数

- 無視された設定の数

- 削除された設定の数

アイテムごとの詳細を表示するには、このページで構成エントリ情報のタイプのリンクをクリックします。

5.4.6 システム監査のコンポーネント・レポート情報

「システム監査情報」ページの「コンポーネント・レポート」セクションに、コンポーネントに関する情報を表示できます。このページには、コンテンツ・サーバー・コンポーネントが名前のアルファベット順で表示されます。コンポーネントに関する詳細を表示するには、リストでコンポーネント名をクリックします。コンポーネントの詳細が表示されます。

「システム監査情報」ページにアクセスするには、「管理」→「システム監査情報」を選択します。

- 場所: インスタンス内のコンポーネントのパス名

- バージョン: 日付、ビルドおよびリビジョン

- ステータス: コンポーネントの現在のステータス(「ロードされました」または「スキップ済」)

- 理由: コンポーネント・ステータスの説明

5.5 サーバー出力の表示

コンテンツ・サーバー・インスタンスのコンソール出力であるサーバー出力を表示できます。これは、DomainHome/ucm/cs/data/trace/classname.logファイルにある情報と同じです。

1. 「管理」、「システム監査情報」の順に選択します。

2. 「サーバー出力の表示」をクリックします。

5.6 イベント出力の表示

サーバーのイベント出力を表示できます。

1. 「管理」、「システム監査情報」の順に選択します。

2. 「イベント出力の表示」をクリックします。

3. 現在の出力以外の出力を表示するには、メニューから該当する以前のタイムスタンプを選択します。

4. 現在の表示を更新するには、「ページのリフレッシュ」をクリックします。

5.7 スキーマ・キャッシュの確認

サーバーの最新のスキーマ・キャッシュ情報を表示できます。

1. 「管理」、「システム監査情報」の順に選択します。

2. 「スキーマ・キャッシュのチェック」をクリックします。
「システム監査情報」ページが開き、「キャッシュ情報」セクションに、スキーマ・キャッシュでの「ビュー名」および「使用されるバイト」についての追加の列が表示されます。

3. 特定のスキーマ・キャッシュ・ビューの詳細を確認するには、「ビュー名」列で名前を選択します。

5.8 ローカライズ監査情報の表示

「監査のローカライズ」ページのコンテンツ・サーバーのユーザー・インタフェースで、ローカライズされた変数の可用性に関する情報を表示できます。この情報は、カスタム・メタデータ・フィールド・ラベルまたは他のカスタマイズ・コンテンツ・サーバー・テキストでローカライズが必要かどうかを判別するのに役に立ちます。監査のローカライズは永続的ではないため、使用する際に開始または停止する必要があります。

1. 「管理」、「システム監査情報」の順に選択します。

2. 「監査のローカライズ」をクリックします。

3. 監査のローカライズを開始するには、「監査の開始」をクリックします。

4. 監査のローカライズを停止するには、「監査の終了」をクリックします。

5. 生成されたJavaの例外を表示するには、「スタック・トレース」列で「表示」をクリックします。

5.9 スケジュールされたジョブの監視

スケジュールされたジョブは、システム・コンポーネントでスケジュールされたイベントの一部として実行されます。「スケジュールされたジョブの管理」インタフェースを使用して、コンテンツ・サーバー・インスタンスでスケジュールされたジョブに関する情報を監視し、場合によってはスケジュールされたジョブを編集できます。

- 第5.9.1項「アクティブなスケジュールされたジョブの表示」

- 第5.9.2項「スケジュールされたジョブの履歴の表示」

- 第5.9.3項「スケジュールされたジョブの変更」

- 第5.9.4項「スケジュールされたジョブの取消しまたは削除」

5.9.1 アクティブなスケジュールされたジョブの表示

アクティブなスケジュールされたジョブを表示するには:

1. 「管理」→「スケジュールされたジョブの管理」→「アクティブなスケジュールされたジョブ」を選択します。
「スケジュールされたジョブのリスト」ページに、スケジュールされた各ジョブのジョブ名、ジョブの説明、処理日と処理時刻、現在のステータスおよび使用可能なアクションが表示されます。ステータス・アイコンは、「優先度」、「非アクティブ」または「処理済」、「1回のみ」または「繰返し」および「短い」または「長い」を表します。

2. 「アクション」をクリックして、スケジュールされたジョブの次のアクションのいずれかを選択します。

- 「情報」: 「スケジュールされたジョブの情報」ページを表示します。

- 編集: スケジュールされたジョブを編集します。

- 取消: スケジュールされたジョブを取り消します。

- 削除: スケジュールされたジョブを削除します。

3. 「情報」をクリックします。
「スケジュールされたジョブの情報」ページが開きます。

5.9.2 スケジュールされたジョブの履歴の表示

スケジュールされたジョブの履歴を表示するには、次の手順を実行します。

1. 「管理」→「スケジュールされたジョブの管理」→「スケジュールされたジョブの履歴」を選択します。
「スケジュールされたジョブ履歴のリスト」ページが開き、スケジュールされた各ジョブのジョブ名、ジョブの説明、最終処理日、最終ステータスおよびアクションが表示されます。

2. 特定のジョブの「スケジュールされたジョブの情報」ページを表示するには、「アクション」列の「情報」アイコンをクリックします。

5.9.3 スケジュールされたジョブの変更

スケジュールされたジョブを変更するには、次の手順を実行します。

1. 「管理」→「スケジュールされたジョブの管理」→「アクティブなスケジュールされたジョブ」を選択します。

2. 「スケジュールされたジョブのリスト」ページのリストにある特定のジョブに対して、「アクション」アイコン、「編集」の順にクリックします。
ジョブ名、説明、カテゴリ、例外の親ジョブ、初期ユーザー、キュー・タイプ、スケジュール・タイプ、現在の状態、優先度、間隔、開始トークン、進行状況ステータス、作成日、更新日、プロセス日付、最終処理日および最終処理ステータスが表示されます。

3. 該当するフィールドを編集します(すべてのフィールドが変更できるわけではありません)。

4. 「更新」をクリックします。変更を削除する場合は、「リセット」をクリックします。

5.9.4 スケジュールされたジョブの取消しまたは削除

スケジュールされたジョブを取り消すかまたは削除するには、次の手順を実行します。

1. 「管理」→「スケジュールされたジョブの管理」→「アクティブなスケジュールされたジョブ」を選択します。

2. 「スケジュールされたジョブのリスト」ページのリストにある特定のジョブを取り消すには、そのジョブで「アクション」アイコンをクリックして、「取消」を選択します。

3. 「スケジュールされたジョブのリスト」ページのリストにある特定のジョブを削除するには、そのジョブで「アクション」アイコンをクリックして、「削除」を選択します。

6 コンテンツ・サーバーのログ・ファイルの監視

この章では、コンテンツ・サーバーのステータス情報およびエラーをログ・ファイルで確認し、使用する方法を説明します。

この章の内容は次のとおりです。

- コンテンツ・サーバーのログ・ファイルの管理の概要

- コンテンツ・サーバーのログ・ファイルの特性について

- コンテンツ・サーバーのログへのアクセス

- アーカイバのログへのアクセス

- Inbound Refineryのログへのアクセス

6.1 コンテンツ・サーバーのログ・ファイルの管理の概要

Oracle WebCenter Contentでは、ログ・ファイルにステータス情報およびエラーが格納されます。ログ・ファイルは、システム・イベントをその発生日時とともに登録するために使用されます。これは、詳細ロギングがオンになっている場合は特に、トラブルシューティングの際に有益なツールとなります。ログは、特定のイベントが発生したことを示すだけではなく、エラーや問題を引き起こすイベントの連鎖に関する重要な手がかりも提供します。

注意:
トレース・ログ出力に適用する場合、詳細ロギングによって、ログ・ファイルのサイズがすぐに大きくなり、コンテンツ・サーバー・インスタンスが遅くなる可能性があります。トレース・ログでは、特定の問題のトラブルシューティングの場合のみ、詳細ロギングを使用することをお薦めします。システム・イベントに関するコンテンツ・サーバー・ログでは、詳細ロギングに関してこのような問題はありません。
トラブルシューティングの情報は、付録Dを参照してください。システム監査情報の表示の情報は、第5章を参照してください。

OracleログAPIを使用して、Oracle Fusion Middleware ControlおよびOracle WebLogic Server管理コンソールによって制御されたログにも、情報が取得されます。WebCenter Contentインタフェースを使用して、これらのログにアクセスできます。Fusion Middleware Controlを使用してログを監視する方法の詳細は、第7.1項を参照してください。

6.2 コンテンツ・サーバーのログ・ファイルの特性について

コンテンツ・サーバー・インスタンス関連のログ・ファイルには、次の特性があります。

- 最初のステータス、エラーまたはリカバリ不能なエラーが発生した際に、1日に1回のみ作成されます。

- 空のログ・ファイルは生成されません。

各ログ・ファイルには、次の列があります。

- タイプ: ログ・エントリを求められるインシデントの種類(情報、エラーまたは致命的)を指定します。

- 時間: ログ・エントリが発生した日時を示します。

- 説明: 発生したインシデントを説明します。

ログ・ファイルは標準的なHTMLページで、コンテンツ・サーバー・インスタンスごとに保持されます。ログは、回転するファイル名形式で、最大30ファイルまで保持されます。31番目のファイルが作成されると、最も古いものが削除されます。そのため、コンテンツ・サーバーのログ・ファイル名は、生成された日付と関係がありません。ログ・ファイルで特定の日付を検索するには、ブラウザで索引ファイルを表示し、その日付のリンクを選択します。ファイル名は、ブラウザのステータス・バー(有効な場合)に表示されます。

ヒント:
ログ・ファイル・ページをブックマークします。これを行うと、コンテンツ・サーバー・インスタンスが使用できない場合でも、問題のトラブルシューティングに役立ちます。また、コンテンツ・サーバー・インスタンスが使用できない場合に見つけられるように、構成ファイルがある場所を理解しておいてください。

6.3 コンテンツ・サーバー・ログへのアクセス

コンテンツ・サーバー・ログは、日時別にリストされます。1日に1ファイルが生成されます。エントリは、イベントの発生に従って終日にわたりファイルに追加されます。

次のサーバー・ログ・エントリのタイプが生成されます。

- 情報: 基本的なステータス情報を表示します。たとえば、サーバーが準備完了して待機中である場合、ステータス情報が記録されます。

- エラー: 発生してもソフトウェアの機能が停止しないエラーを表示します。たとえば、ユーザーが、アクセスが許可されていないセキュリティ保護された情報をリクエストすると、エラーが記録されます。

- 致命的: 発生するとソフトウェアの機能が停止するエラーを表示します。たとえば、コンテンツ・サーバー・インスタンスがデータベースにアクセスできない場合、致命的エラーが記録されます。

コンテンツ・サーバー・ログにアクセスするには:

1. コンテンツ・サーバー・インスタンスに管理者としてログインします。

2. 「管理」→「ログ・ファイル」を選択します。

3. 「Content Serverログ」を選択します。

4. 「Content Serverログ」ページで、表示するログの日時に対応するリンクを選択します。

注意:
ログ・ファイルを表示できるように、コンテンツ・サーバー・インスタンスに管理者としてログインする必要があります。

なんらかの理由で「管理」トレイまたはメニューからログ・ファイルを表示できない場合でも、コンテンツ・サーバー・インスタンスのファイル・システム上でそれにアクセスすることもできます。ログ・ファイルは次の場所にあります。

ログ・ファイル

場所

コンテンツ・サーバー

IntradocDir/weblayout/groups/secure/logs

コンソール出力ログ

IntradocDir/bin/classname.log

リファイナリ

IntradocDir/weblayout/groups/secure/logs/refinery

アーカイバ

IntradocDir/weblayout/groups/secure/logs/archiver

6.4 アーカイバ・ログへのアクセス

コンテンツ・サーバー・アーカイバ・ログには、インポート、エクスポートおよびレプリケーションに関する情報が表示されます。アーカイバ・ログは、日時別にリストされます。最初の「アーカイバ」情報ステータス、致命的エラーまたはエラーが発生した際に、1日に1回生成されます。

次のタイプのアーカイバ・ログ・エントリが生成されます。

- 情報: 基本的なステータス情報を表示します。たとえば、エクスポートおよびインポートが開始および終了する際に、ステータス情報が記録されます。

- エラー: 発生してもソフトウェアの機能が停止しないユーザー/管理エラーを表示します。たとえば、エクスポートしようとするコンテンツ・アイテムのファイル情報がない場合、エラーが記録されます。

- 致命的: 発生するとソフトウェアの機能が停止するエラーを表示します。たとえば、コンテンツ・サーバー・インスタンスがデータベースにアクセスできない場合、致命的エラーが記録されます。接続文字列、ユーザー名およびパスワードを確認します。

アーカイバ・ログにアクセスするには:

1. コンテンツ・サーバー・インスタンスに管理者としてログインします。

2. 「管理」→「ログ・ファイル」→「アーカイバ・ログ」を選択します。または、「管理」ページの「アーカイバ・ログ」リンクをクリックします。

3. 「アーカイバ・ログ」ページで、ログの日時に対応するリンクを選択します。
各アクションのタイプ、日時および説明を示している表が開きます。表には、アーカイブを作成したコンテンツ・サーバー・インスタンスの名前も含まれます。

6.5 Inbound Refineryログへのアクセス

Oracle WebCenter Content: Inbound Refineryのログはすべて、Inbound Refineryインタフェースからアクセスします。ログ・ファイルによってリファイナリ・ステータスをモニタリングする方法の詳細は、『Oracle WebCenter Contentのマネージング』を参照してください。

7 Fusion Middleware Controlを使用したコンテンツ・サーバーおよびInbound Refineryの監視

この章では、Oracle Enterprise Manager Fusion Middleware Controlを使用して、Oracle WebCenter Content ServerおよびInbound Refineryのログ、パフォーマンス情報、およびMBean情報を監視する方法について説明します。

この章の内容は次のとおりです。

- Fusion Middleware Controlを使用したログ情報の管理

- Fusion Middleware Controlを使用したパフォーマンス情報の表示

- Fusion Middleware Controlを使用したMBean情報の表示

7.1 Fusion Middleware Controlを使用したログ情報の管理

Fusion Middleware Controlインタフェースを使用して、コンテンツ・サーバー・インスタンスまたはInBound Refineryインスタンスのログ・メッセージの表示およびログ構成の管理を実行できます。

- 第7.1.1項「Fusion Middleware Controlを使用したログ情報の表示」

- 第7.1.2項「Fusion Middleware Controlを使用したログ情報の変更」

7.1.1 Fusion Middleware Controlを使用したログ情報の表示

1. Fusion Middleware Controlにログインします。

2. ナビゲーション・ツリーで、適切なドメイン名(Farm_base_domainなど)、「WebCenter」、「コンテンツ」の順に展開します。

- コンテンツ・サーバー・インスタンスに対して、「コンテンツ・サーバー」を展開し、コンテンツ・サーバー・インスタンス名(Oracle WebCenter Content - Content Server (UCM_server1)など)を選択します。

- Inbound Refineryインスタンスに対して、「Oracle Inbound Refinery」を展開し、Inbound Refineryインスタンス名(IBR (IBR_server1)など)を選択します。

3. インスタンスのホームページで、「コンテンツ・サーバー」または「IBR」メニューから、「ログ」→「ログ・メッセージの表示」を選択します。
「ログ・メッセージ」ページには、入手可能なすべてのログ・ファイルの内容に関する情報が含まれています。このページでは、次のことができます。

- 過去n時間に記録されたログ・メッセージの検索。

- 2つの時間間隔の間に記録されたログ・メッセージの検索。

- メッセージ・タイプに基づくログ・メッセージのフィルタリング。

7.1.2 Fusion Middleware Controlを使用したログ情報の変更

1. Fusion Middleware Controlにログインします。

2. ナビゲーション・ツリーで、適切なドメイン名(Farm_base_domainなど)、「WebCenter」、「コンテンツ」の順に展開します。

- コンテンツ・サーバー・インスタンスに対して、「コンテンツ・サーバー」を展開し、コンテンツ・サーバー・インスタンス名(Oracle WebCenter Content - Content Server (UCM_server1)など)を選択します。

- Inbound Refineryインスタンスに対して、「Oracle Inbound Refinery」を展開し、Inbound Refineryインスタンス名(IBR (IBR_server1)など)を選択します。

3. インスタンスのホームページで、「コンテンツ・サーバー」または「IBR」メニューから、「ログ」→「ログ構成」を選択します。

4. 「ログ構成」ページを使用して、次のログ・レベルとログ・ファイルの基本および詳細のログ構成設定を構成します。次の操作を実行できます。

- 永続ロガー(ロギング構成ファイルで定義されたロガー)のログ・レベルの変更。

- ランタイム・ロガーのログ・レベルの変更。

- 現在、永続でもランタイムでもないロガーの指定。

- ログ・ファイル・パスおよびログ・ローテーション・ポリシーなどのログ・ファイル構成パラメータの指定。

- 新規ログ・ファイル構成の作成。

- 既存のログ・ファイル構成を使用している新規ログ・ファイル構成の作成。

- ログ・ファイル構成パラメータの表示。

- 1つ以上のロガーのログ・ファイル構成との関連付け。

詳細は、『Oracle WebLogic Server Administration Consoleオンラインヘルプ』を参照してください。

注意:
IBM Websphereでロギングする方法の詳細は、Oracle Fusion Middlewareサード・パーティ・アプリケーション・サーバー・ガイドのIBM WebsphereでのOracle Fusion Middlewareのロギングの構成に関する項を参照してください。

7.2 Fusion Middleware Controlを使用したパフォーマンス情報の表示

コンテンツ・サーバー・インスタンスまたはInbound Refineryインスタンスのパフォーマンス情報を監視することにより、システムのパフォーマンスを即座に評価できます。情報には、主要なメトリックと値のグラフおよび最近のサービス・リクエストのリストが含まれています。

パフォーマンス情報を表示するには、次の手順を実行します。

1. Fusion Middleware Controlにログインします。

2. ナビゲーション・ツリーで、適切なドメイン名(Farm_base_domainなど)、「WebCenter」、「コンテンツ」の順に展開します。

- コンテンツ・サーバー・インスタンスに対して、「コンテンツ・サーバー」を展開し、コンテンツ・サーバー・インスタンス名(Oracle WebCenter Content - Content Server (UCM_server1)など)を選択します。

- Inbound Refineryインスタンスに対して、「Oracle Inbound Refinery」を展開し、Inbound Refineryインスタンス名(IBR (IBR_server1)など)を選択します。

3. インスタンスのホームページで、「コンテンツ・サーバー」または「IBR」メニューから、「監視」→「パフォーマンス・サマリー」を選択します。「パフォーマンス・サマリー」ページが表示されます。
デフォルトでは、「パフォーマンス・サマリー」ページには、最近の15分間のパフォーマンス・メトリックが表示されます。「スライダ」または「時間の入力」アイコンを使用して、メトリックの表示期間を変更できます。

「パフォーマンス・サマリー」ページに、グラフ形式で情報が表示されます。メトリックを表形式で表示するには、「表ビュー」を選択します。

デフォルトで表示される主要なInbound Refineryメトリックは変換のレートで、1分当たりのドキュメント数で測定されます。表7-1に、主要なコンテンツ・サーバー・メトリックを示します。

表7-1 主要なコンテンツ・サーバー・メトリック

要素

説明

アクティブ・スレッド

コンテンツ・サーバー・インスタンスのアクティブ・スレッドの数。

アクティブなデータベース接続

コンテンツ・サーバー・インスタンスによって作成されたアクティブなデータベース接続の数。

監査メッセージ

監査メッセージの合計数。

読取りアクション

処理された読取りサービス・リクエスト数、およびシステムがリクエストを正常に処理したかどうか。

書込みアクション

処理された書込みサービス・リクエスト数、およびシステムがリクエストを正常に処理したかどうか。

キャッシュ済検索問合せ数

キャッシュされている検索問合せの数(行)。

ヒットとミスの割合

実行された検索問合せの数のヒットとミスの割合。

GenWWW状態のドキュメント

GenWWW状態でInbound Refineryを待機しているドキュメントの数。

終了状態の索引作成待ちドキュメント

終了状態で索引作成を待機しているドキュメントの数。

ワークフローのドキュメント

現在ワークフロー内にあるドキュメントの数。

平均リクエスト/秒

リクエストされた平均サービス数/秒。

4. 「メトリック・パレットの表示」をクリックすると、チャート内に表示できるすべてのメトリックが表示されます。「メトリック・パレット」には、グラフで表示するメトリックに使用できるオプションが一覧表示されます。
「メトリック・パレットの非表示」をクリックしてメトリック・パレットをたたむと、メトリック・チャートを表示する領域が広がります。

5. 「メトリック・パレット」を開いた状態で、表示する各メトリックのチェック・ボックスを選択します。
表7-2にメトリック・パレット・コンテンツ・サーバー・メトリックを示します。

表7-3にメトリック・パレットIBRメトリックを示します。

表7-2 コンテンツ・サーバー・メトリック・パレット

要素

説明

キャッシュ情報

- 一時的にロードされたアイテム: 一時的なアイテムがロードされたかどうかを示します。

- 完全にロードされたページ: 永続的にロードされたページの数。

- 完全にロードされたリソース・ファイル: 永続的にロードされたリソース・ファイルの数。

- 一時キャッシュの上限: キャッシュが一時的に制限される数。

- 一時アイテム消費: キャッシュ内にあるアイテムの合計数。

接続

- アクティブなデータベース接続: WebCenter Content Serverインスタンスによって作成されたアクティブなデータベース接続の合計数。

- アクティブ・スレッド: アクティブ・スレッドの合計数。

- 監査メッセージ: 監査メッセージの合計数。

- 読取りアクション: 処理された読取りサービス・リクエスト数、およびシステムがリクエストを正常に処理したかどうか。

- 書込みアクション: 処理された書込みサービス・リクエスト数、およびシステムがリクエストを正常に処理したかどうか。

Inbound Refineryのキュー

- GenWWW状態のドキュメント: GenWWW状態でInbound Refineryを待機しているドキュメントの数。

- 終了状態の索引作成待ちドキュメント: 終了状態で索引作成を待機しているドキュメントの数。

ローカライズ情報

- ローカライズ・テスト参照数/秒: 1秒当たりのローカライズ・テスト参照数。

- 文字列キー数: 文字列キー・カウント数。

メモリーの詳細

処理された書込みサービス・リクエスト数、およびシステムがリクエストを正常に処理したかどうか。

- 使用可能なプロセッサ: WebCenter Content Serverインスタンスに使用可能なプロセッサの数。

- 空きメモリー(バイト): WebCenter Content ServerインスタンスのJVMで使用可能な合計空きメモリー容量。

- 最大メモリー(バイト): WebCenter Content Serverインスタンスの最大JVMメモリー容量。

- 合計メモリー(バイト): WebCenter Content Serverインスタンスの合計JVMメモリー容量。

レスポンス

ステータス: WebCenter Content Serverインスタンスが稼働中であるか停止中であるか。値は1または0であり、1は稼働中であること、0は停止中であることを示します。

スキーマ・キャッシュの詳細

保存されたアイテムの数: キャッシュ内にあるアイテムの合計数。

SearchCache

- ヒットとミスの割合: 実行された検索問合せの数のヒットとミスの割合。

- キャッシュ済検索問合せ数: キャッシュされている検索問合せの数(行)。

サーバーの状態

状態: WebCenter Content Serverの現在の状態。

サービス・リクエスト

平均リクエスト/秒: 1秒当たりにリクエストされた平均サービス数。

ワークフロー

ワークフローのドキュメント: 現在ワークフロー内にあるドキュメントの数。

表7-3 Inbound Refineryメトリック・パレット

要素

説明

サイズ別ジョブ

ファイル・サイズ当たりのジョブ数。

タイプ別ジョブ

変換タイプ当たりのジョブ数。

ジョブ・サマリー

- アクティブなジョブ: 現在変換されているジョブの数。

- 「変換率」: 起動時以降ドキュメントが変換されたレートで、1分当たりのドキュメント数で測定されます。

- 失敗したジョブ: 正常に変換されなかったドキュメントの数。

- 成功したジョブ: 正常に変換されたドキュメントの数。

- ジョブの合計: Inbound Refineryによって処理されたすべてのドキュメント数。成功したジョブと失敗したジョブの両方を含みます。

PreconversionQueueMetrics

現在変換を待機中のジョブ数。

PostconversionQueueMetrics

変換されて、コンテンツ・サーバーに取得されるのを待機中のジョブ数。

レスポンス

ステータス: Inbound Refineryインスタンスが稼働中であるか停止中であるか。値は1または0であり、1は稼働中であること、0は停止中であることを示します。

Fusion Middlewareパフォーマンスの詳細は、『Oracle WebLogic Server Administration Consoleオンラインヘルプ』を参照してください。

IBM WebSphereのサーバーを監視する方法の詳細は、Oracle Fusion Middlewareサード・パーティ・アプリケーション・サーバー・ガイドのIBM WebSphereでのOracle Fusion Middlewareの管理に関する項を参照してください。

7.3 Fusion Middleware Controlを使用したMBean情報の表示

MBeanブラウザを使用して、コンテンツ・サーバー・インスタンスまたはInbound Refineryインスタンスに関するMBean属性情報を表示できます。

MBean情報を表示するには、次の手順を実行します。

1. Fusion Middleware Controlにログインします。

2. ナビゲーション・ツリーで、適切なドメイン名(Farm_base_domainなど)、「WebCenter」、「コンテンツ」の順に展開します。

- コンテンツ・サーバー・インスタンスに対して、「コンテンツ・サーバー」を展開し、コンテンツ・サーバー・インスタンス名(Oracle WebCenter Content - Content Server (UCM_server1)など)を選択します。

- Inbound Refineryインスタンスに対して、「Oracle Inbound Refinery」を展開し、Inbound Refineryインスタンス名(IBR (IBR_server1)など)を選択します。

3. インスタンスのホームページで、「コンテンツ・サーバー」または「IBR」メニューから、「システムMBeanブラウザ」を選択します。
「システムMBeanブラウザ」ページには、インスタンス名がハイライトされたナビゲーション・ペインと、インスタンスの構成MBeanアプリケーションのデプロイメント情報が表示されます。

4. 「属性」タブには、個別の属性名、説明、アクセスのタイプおよび値が表示されます。属性値を変更する場合は、「適用」をクリックします。

5. 「操作」タブでは、個別のMBean操作を表示および起動できます。

- いずれかのMBeanを選択すると、詳細が表示されます。

- MBean操作を適用するには、「起動」を選択します。

- 操作を前の設定にリセットするには、「回復」をクリックします。

- 「操作」タブに戻るには、「戻る」をクリックします。

詳細は、『Oracle WebLogic Server JMXによるカスタム管理ユーティリティの開発』のWebLogic Server MBeanに関する項を参照してください。

第IV部

システム構成の管理

この部では、システム設定、コンポーネント、検索索引、ファイル・ストア・システム、プロバイダ、URLのマッピングなど、Oracle WebCenter Contentシステム構成の管理について説明します。

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

- 第8章「システム・プロパティの構成」

- 第9章「コンポーネントの管理」

- 第10章「検索機能の管理」

- 第11章「検索索引の構成」

- 第12章「ファイル・ストア・システムの管理」

- 第13章「プロバイダの構成」

- 第14章「URLのマッピング」

8 システム・プロパティの構成

この章では、Oracle Enterprise Manager Fusion Middleware Control、コンテンツ・サーバー管理インタフェースおよびコンテンツ・サーバー・システム・プロパティ・ユーティリティを使用して、Oracle WebCenter Content Serverシステム・プロパティを構成する方法について説明します。

この章の内容は次のとおりです。

- システム・プロパティ

- Fusion Middleware Controlを使用したシステム・プロパティの構成

- 一般オプションの構成

- コンテンツ・セキュリティの構成

- コンテンツ・サーバーを使用したインターネット情報の構成

- システム・データベース・プロパティの構成

- ドキュメント・クラウド・サービス統合の設定の構成

- サーバー・プロパティの構成

- ローカライゼーション・プロパティの構成

- パス・プロパティの構成

8.1 システム・プロパティについて

システム・プロパティはシステム全体にわたる設定で、コンテンツ・サーバー・インスタンスを特定の要件に合うように調整できます。システム・プロパティは、インストール時に設定され、ユーザーおよびコンテンツのメンテナンスのためにより定期的に使用される他の管理ツールとは異なり、通常、ときどきまたは必要に応じて更新されます。

重要:
システム・プロパティをどの方法で変更したかに関係なく、構成の変更内容を反映するには、コンテンツ・サーバー・インスタンスを再起動する必要があります。

システム・プロパティの変更は、次のツールを使用して行います。

- Enterprise Manager Fusion Middleware Controlインタフェースは、コンテンツ・サーバー・インスタンスのサーバー、インターネット、電子メールおよびコンポーネント構成を表示および変更するために使用します。Fusion Middleware Controlへのアクセスの詳細は、第3.1項を参照してください。

- コンテンツ・サーバーの管理インタフェースは、コンテンツ・サーバー・インスタンスのサーバー、インターネット、電子メールおよびコンポーネント構成を表示および変更するために使用します。管理インタフェースは、Oracle Documents Cloud ServiceをContent Serverに統合するための設定の構成にも使用されます。この章では、これらの構成オプションへのアクセスに関する情報について説明します。

- システム・プロパティ・ユーティリティはコンテンツ・サーバーの管理アプリケーションで、コンテンツ・サーバー・インスタンスがインストールされているシステムからシステム全体の設定を構成するために使用します。このユーティリティは、スタンドアロン・アプリケーションとして実行されます。システム・プロパティ・ユーティリティの実行の詳細は、第3.5.2項を参照してください。

注意:
システム・プロパティ・ユーティリティは、WebCenter Contentドメインでコンテンツ・サーバー・インスタンス用のスタンドアロン・アプリケーションとして実行されるため、追加の構成が必要です。

- 大部分のシステム・プロパティ設定は、次の構成ファイルのいずれかにある構成変数に対応しています。

- IntradocDir/config/config.cfg

- DomainHome/ucm/cs/bin/intradoc.cfg

- IntradocDir/search/search.cfg

これらのファイルに変更を加える場合は、管理インタフェースまたはシステム・プロパティ・ユーティリティを使用して、設定が正しく入力されていることを確認することをお薦めします。テキスト・エディタを使用してこれらのファイルを直接編集することもできますが、誤りが生じる可能性があります。構成変数の詳細は、『Oracle WebCenter Content構成リファレンス』を参照してください。

ヒント:
コンテンツ・サーバー・インスタンスのパフォーマンスを最適化するには、いろいろな方法があります。あるタイプのチューニングでは、核となるコンテンツ・サーバーのパフォーマンスに影響を与えるデフォルトのパラメータやソフトウェア設定に変更が必要になります。システムの最適化やパフォーマンス・チューニングは、多くの場合、システム設定や構成変数の調整、あるいはデータベースや索引などのリソースのチューニングによって行われます。
たとえば、コンテンツ・サーバー・インスタンス内のコンテンツが増えるにつれて、使用可能な領域が不足する可能性があります。この場合、ボールト、Webレイアウトおよび検索索引ディレクトリをもっと領域のある別のドライブに移動すると、不足の問題を軽減できます。これらのディレクトリを移動するには、DomainHome/ucm/cs/bin/intradoc.cfgファイルにエントリを追加する必要があります。

8.2 Fusion Middleware Controlを使用したシステム・プロパティの構成

この項では、Oracle Enterprise Manager Fusion Middleware Controlインタフェースを使用して、特定のコンテンツ・サーバー・システム・プロパティを構成する方法を説明します。

この項の内容は次のとおりです。

- 第8.2.1項「Fusion Middleware Controlを使用したコンテンツ・セキュリティ構成の変更」

- 第8.2.2項「Fusion Middleware Controlを使用した一般構成の変更」

- 第8.2.3項「Fusion Middleware Controlを使用したインターネット構成の変更」

- 第8.2.4項「Fusion Middleware Controlを使用した電子メール構成の変更」

注意:
Fusion Middleware Controlを使用したコンテンツ・サーバー・コンポーネント管理の詳細は、第9.3項を参照してください。
レコード管理構成オプションの詳細は、『Oracle WebCenter Contentのマネージング』の保存の定義とオプションの構成に関する項を参照してください。

8.2.1 Fusion Middleware Controlを使用したコンテンツ・セキュリティ構成の変更

WebCenter Content Serverセキュリティ構成では、ユーザーのWebCenter Content Serverコンテンツ・アイテムへのアクセスを制御するために使用される設定を指定します。

WebCenter Content Serverのコンテンツ・セキュリティ構成を変更するには、次の手順を実行します。

1. Enterprise Manager Fusion Middleware Controlにログインしたら、ナビゲーション・ツリーで、適切なドメイン名(Content_base_domainなど)を展開します。

2. 「WebCenter」、「コンテンツ」、「コンテンツ・サーバー」の順に展開します。

3. Webcenter Content Serverインスタンス名(Oracle Webcenter Content - Content Server (UCM_server1)など)を選択します。WebCenter Content Serverインスタンスのホーム・ページが表示されます。

4. Webcenter Content Serverホームページで、「コンテンツ・サーバー」メニューから、「構成ページ」、「一般構成」の順に選択します。

5. 「一般構成」ページの「コンテンツ・セキュリティ」セクションで、設定を変更できます。表8-1では、この設定について説明しています。

6. 「適用」をクリックします。
変更を適用しない場合、「元に戻す」をクリックして前の構成設定に戻します。

表8-1 「一般構成」: 「コンテンツ・セキュリティ」

要素

説明

読取り特権を持つユーザーである場合にコピーを許可する

コンテンツ・アイテムの読取り特権を持つユーザーがコンテンツ・アイテムのコピーを取得することを許可します。有効にするには、チェック・ボックスを選択します。

作成者にリビジョンの削除を許可する

作成者または所有者が読取り特権を持っていれば、コンテンツ・アイテムの作成者がアイテムのリビジョンを削除することを許可します(読取り特権を持っていない場合は、コンテンツ・アイテムのセキュリティ・グループの削除特権が必要です)。有効にするには、チェック・ボックスを選択します。

注意: サイトでコントリビューション・フォルダを使用している場合は、この設定により、作成者または所有者がコンテンツ・アイテムのセキュリティ・グループの削除特権を持っていない場合でも、コンテンツ・アイテムを削除できます。

元のコントリビュータにのみチェックアウトを許可する

コンテンツ・アイテムの元のコントリビュータのみにそのアイテムをチェックアウトすることを許可します。有効にするには、チェック・ボックスを選択します。

既知のアカウントのみを表示する

ユーザーの既知のアカウントのみを表示します。既知のアカウントとは、ユーザーが許可されているアカウントのことです。有効にするには、チェック・ボックスを選択します。

8.2.2 Fusion Middleware Controlを使用した一般構成の変更

一般構成では、WebCenter Content Serverを構成するために使用される様々な設定(アカウントの有効化、独自のデプロイメントに固有の構成変数の追加など)を指定します。

WebCenter Content Serverの一般構成を変更するには、次の手順を実行します。

1. ナビゲーション・ツリーで、適切なドメイン名(Farm_base_domainなど)を開きます。

2. 「WebCenter」、「コンテンツ」、「コンテンツ・サーバー」の順に展開します。

3. Webcenter Content Serverインスタンス名(Oracle Webcenter Content - Content Server (UCM_server1)など)を選択します。
WebCenter Content Serverインスタンスのホーム・ページが表示されます。

4. Webcenter Content Serverホームページで、「コンテンツ・サーバー」メニューから、「構成ページ」、「一般構成」の順に選択します。

5. 「一般構成」ページの「管理サーバーの一般構成」セクションで、設定を変更できます。表8-2では、この設定について説明しています。

6. 「適用」をクリックします。
変更を適用しない場合、「元に戻す」をクリックして前の構成設定に戻します。

表8-2 「一般構成」: 「管理サーバーの一般構成」

要素

説明

チェックイン時にフォーマットのオーバーライドを許可

リポジトリへのチェックイン時に、コンテンツ・アイテムのフォーマットをオーバーライドすることを許可します。有効にするには、チェック・ボックスを選択します。

ダウンロード・アプレットを有効にする

ダウンロード・アプレットが、チェックアウトまたはダウンロードする複数のファイルを同時にダウンロードできるようにします。有効にするには、チェック・ボックスを選択します。

アップロード・アプレットを有効にする

アプレットがWebCenter Content Serverからアップロードされることを許可します。有効にするには、チェック・ボックスを選択します。

アカウントの有効化

WebCenter Content Serverでアカウントが使用できるようにします。有効にするには、チェック・ボックスを選択します。

詳細は、第19章「アカウントの管理」を参照してください。

Java Server Page (JSP)の有効化

有効にするには、チェック・ボックスを選択します。

チェックイン時にコンテンツIDを自動割当てする

リポジトリへのチェックイン時に、コンテンツ・アイテムにコンテンツIDを自動的に割り当てます。有効にするには、チェック・ボックスを選択します。

メジャー・リビジョンのラベル・シーケンス

システム構成のメジャー・リビジョンのラベル・シーケンスを表示します。

マイナー・リビジョンのラベル・シーケンス

システム構成のマイナー・リビジョンのラベル・シーケンスを表示します。

JSPを有効にするグループ

システム構成のJSPを有効にするセキュリティ・グループを表示します。

自動採番接頭辞

システム構成の自動採番接頭辞を表示します。

追加の構成変数

システム構成の追加の一般構成変数を表示します。このフィールドに構成変数を追加できます。

変数の詳細は、『Oracle WebCenter Content構成リファレンス』を参照してください。

8.2.3 Fusion Middleware Controlを使用したインターネット構成の変更

WebCenter Content Server構成設定では、コンテンツ・サーバーのデプロイメント・シナリオを識別するために使用する情報を指定します。

サーバーのインターネット構成を変更するには、次の手順を実行します。

1. ナビゲーション・ツリーで、適切なドメイン名(Farm_base_domainなど)を開きます。

2. 「WebCenter」、「コンテンツ」、「コンテンツ・サーバー」の順に展開します。

3. コンテンツ・サーバー・インスタンス名(Oracle WebCenter Content - Content Server (UCM_server1)など)を選択します。
コンテンツ・サーバー・インスタンスのホーム・ページが表示されます。

4. コンテンツ・サーバー・ホームページで、「コンテンツ・サーバー」メニューから、「構成ページ」、「インターネットの構成」の順に選択します。

5. 「インターネットの構成」ページの「サーバーの構成」セクションで、一部の設定を変更できます。一部の設定は読取り専用で、変更できません。表8-3では、この設定について説明しています。

6. 「適用」をクリックします。
変更を適用しない場合、「元に戻す」をクリックして前の構成設定に戻します。

表8-3 「Oracle WebCenter Content」 - 「インターネットの構成」

要素

説明

HTTPアドレス

Content ServerインスタンスのHTTP Webサーバーの名前。セキュリティ上の理由で、このフィールドはインタフェースからは変更できません。このフィールドは、Oracle WebCenter Contentスタンドアロン・アプリケーションを使用して変更する必要があります。

サーバー・アドレスは、コンテンツ・サーバーのユーザー・インタフェースでの完全URLを形成するために使用されます。これにより、ページ上のリンクが相対リンクである場合はサーバーの入力に使用するドメイン名が変更されないため、ユーザーは再度ログインするよう求められません。例: pc.idc.example.com。

IPアドレス・フィルタ

コンテンツ・サーバー・インスタンスへのアクセスに使用できるIPアドレスのリスト。このフィールドは必須です。

IPアドレスのリストは、Intradocサーバー・ポート経由でコンテンツ・サーバー・インスタンスへの通信が許可されています。このフィールドは、アドレス間のセパレータにパイプを使用して、IPアドレスとIPv6アドレスの両方を受け入れます。これは信頼できる接続であるため、このリストは正確に定義されている必要があります。例: 10.131.123.*。

Intradocサーバー・ポート

コンテンツ・サーバー・インスタンスのサーバー・ポート番号。

Intradocサーバー・ポートは、コンテンツ・サーバー・インスタンスによってリスニングされるポート番号です。これは、認証にユーザーIDのみを必要とする、信頼できる接続です。例: 4056。

SSLの使用

Secure Sockets Layer (SSL)対応のWebサーバーを使用するかどうかを指定します。セキュリティ上の理由で、このフィールドはインタフェースからは変更できません。このフィールドは、Oracle WebCenter Contentスタンドアロン・アプリケーションを使用して変更する必要があります。

SSLはHTTPサーバー・アドレスに関連し、完全URLが保護されたHTTP命名を使用していることを意味します。たとえば、http://HttpServerAddress/...ではなくhttps://HttpServerAddress/...でアドレスを生成します。

8.2.4 Fusion Middleware Controlを使用した電子メール構成の変更

WebCenter Content Server電子メール構成設定では、コンテンツ・サーバーのデプロイメント・シナリオを識別するために使用する情報を指定します。

電子メール構成を変更するには:

1. ナビゲーション・ツリーで、適切なドメイン名(Farm_base_domainなど)を開きます。

2. 「WebCenter」、「コンテンツ」、「コンテンツ・サーバー」の順に展開します。

3. コンテンツ・サーバー・インスタンス名(Oracle WebCenter Content - Content Server (UCM_server1)など)を選択します。

4. コンテンツ・サーバー・ホームページで、「コンテンツ・サーバー」メニューから、「構成ページ」、「インターネットの構成」の順に選択します。

5. 「インターネットの構成」ページの「電子メールの構成」セクションで、一部の設定を変更できます。一部の設定は読取り専用で、変更できません。表8-4では、この設定について説明しています。

6. 「適用」をクリックします。
変更を適用しない場合、「元に戻す」をクリックして前の構成設定に戻します。

表8-4 「Oracle WebCenter Content」 - 「電子メールの構成」

要素

説明

メール・サーバー

コンテンツ・サーバー・インスタンスから電子メール通知を送信するために使用するメール・サーバーの名前。例: mailserver.example.com。

SMTPポート

SMTP通信に使用するポート番号。例: 25。

セキュリティ上の理由で、このフィールドはインタフェースからは変更できません。このフィールドは、Oracle WebCenter Contentスタンドアロン・アプリケーションを使用して変更する必要があります。

管理メール・アドレス

コンテンツ・サーバー・インスタンスの管理者用の電子メール・アドレス。

エラー・メッセージを受け取る管理者の電子メール・アドレスです。このようなメッセージは通常、記録されますが、これは付加的な通知方法です。例: mymail@example.com。

8.3 一般オプションの構成

WebCenter Contentおよびコンテンツ・サーバー・インスタンスをデプロイし、初期構成を指定した後は、システム・プロパティ・ユーティリティの「オプション」タブまたは管理インタフェースからアクセスする「一般構成」ページを使用して、コンテンツ・サーバーの一般機能オプションを設定または変更できます。

- システム・プロパティの「オプション」タブにアクセスする方法は、第3.5.2項を参照してください。

- 「一般構成」ページにアクセスするには、「管理」→「管理サーバー」→「一般構成」を選択します。

一般的な機能のオプションを使用して、次のことができます。

- ユーザーがチェックイン時にドキュメントのフォーマットを選択できるようにします

- ユーザーが同時に複数のファイルを選択してチェックアウトまたはダウンロードできるようにします

- ユーザーが単一のZipファイルとして複数のファイルにチェックインできるようにします

- アカウントを使用できるようにします

- 返されるPDF、HTMLおよびテキスト・ドキュメントですべてのフルテキスト検索用語がハイライトされます。

- Enterprise Searchを使用する構成になっている場合に、Enterprise Searchフィールドが検索ページに表示されるようにします

- コンテンツIDが6桁のシーケンス番号として自動的に生成されるようにします

- 自動コンテンツID生成が有効になっている場合は、このフィールドで指定した文字列が6桁のシーケンス番号に接頭辞として追加されます

- リビジョン番号の省略可能な2つ目の文字または数値の増分方法を指定します

構成の変更内容を反映するには、コンテンツ・サーバー・インスタンスを再起動する必要があります。

8.3.1 リビジョンのラベル・シーケンス

設定できる一般構成オプションには、リビジョンのラベル・シーケンスが含まれます。「リビジョン」というメタデータ・フィールドには、1、2、3、4、5などのデフォルトのリビジョン番号シーケンスが入っています。この番号は、ドキュメントが改訂されるごとに自動的に増えます。

「リビジョン」のデフォルト値は、そのリビジョンのラベルの定義を変更することでオーバーライドできます。リビジョンのラベルは、メジャー・リビジョンのシーケンスとマイナーリビジョンのシーケンスという2つの部分で構成されます。メジャー・リビジョンのラベル・シーケンス(MajorRevSeq)は最初の数字または文字で、その後にマイナー・リビジョンのラベル・シーケンス(MinorRevSeq)が続きます。たとえば、1a、1b、1c、2a、2b、2c、3a、3b、3cなどのリビジョン・シーケンスでは、数字1、2、3がメジャー・リビジョン・シーケンスで、a、b、cがマイナー・リビジョン・シーケンスです。

8.3.1.1 リビジョンのラベルの範囲

メジャーおよびマイナーのリビジョン・シーケンスは、どちらも数字または文字の範囲として定義されます。メジャー・シーケンスには複数の範囲を定義できるのに対し、マイナー・シーケンスでは1つの範囲のみです。

範囲の定義には次の制限があります。

- 数字または文字を使用できますが、両方を使用することはできません。たとえば、1から10は有効な範囲ですが、Aから10は無効な範囲です。

- 文字の範囲で定義できるのは1文字のみです。たとえば、AからZは有効な範囲ですが、AAからZZは無効な範囲です。

- メジャー・リビジョンのシーケンスで文字の範囲が使用されている場合は、マイナー・リビジョンのシーケンスは数字の範囲または未使用にする必要があります。メジャー・リビジョンのシーケンスで数字の範囲が使用されている場合は、マイナー・リビジョンのシーケンスは文字の範囲または未使用にする必要があります。

8.3.1.2 リビジョンの例

次に示すのは、異なるリビジョン・シーケンスの例と、config.cfgファイルでのメジャーおよびマイナーのリビジョン・エントリの定義方法です。

例1

MajorRevSeq=A-D,1-99

リビジョン・シーケンスは、A、B、C、D、1、2、3、4などです。

例2

MajorRevSeq=1-99

MinorRevSeq=a-c

リビジョン・シーケンスは、1a、1b、1c、2a、2b、2c、3a、3b、3cなどです。

8.3.1.3 リビジョン構成設定

IntradocDir/config/config.cfgファイルでデフォルトのリビジョン・シーケンスを手動で変更するには、次の名前/値のペアを入力します。

- MajorRevSeq=range1,range2,range3...

- MinorRevSeq=range

range1,range2,range3...およびrangeは、定義された範囲のシーケンスです。

8.3.2 チャンク化機能

コンテンツ・サーバーのチャンク化機能は、データを複数のチャンクに分割し、一度に1チャンクずつ転送することにより、大量のデータ転送の失敗を防ぎます。転送に失敗した場合、失敗前にコンテンツ・サーバー・インスタンスに転送されたチャンクはすべて保存され、転送は失敗した時点から再開できます。

注意:
チャンク化機能を使用するクライアント・セッションが、タイムアウトまたはクライアント・ブラウザを閉じることで終了した場合、転送は失敗します。

チャンク化機能は、アップロード・アプレットで使用できます。

チャンク化機能を有効にするには、次のようにします。

1. アップロード・アプレットまたはHTTPプロバイダを有効にします。第8.3項を参照してください。

- アップロード・アプレットを有効化する方法の情報は、第8.3項を参照してください。

- HTTPプロバイダを作成する方法の情報は、第21章を参照してください。

2. 「一般構成」ページの「追加の構成変数」フィールドで、次の構成設定を設定します。

DisableHttpUploadChunking=false
AppletChunkThreshold=size in bytes
AppletChunkSize=size in bytes

AppletChunkSize設定は、個々のチャンクのサイズを設定します。AppletChunkThreshold設定は、チャンク化機能を使用する最小ファイル・サイズを設定します。これらの値はどちらもデフォルトでは1Mです。

3. チャンク化機能をデバッグするには、ChunkedRequestTrace=trueを設定します。この設定により、チャンク化されたリクエストを「サーバー出力」ページで表示できます。

4. 変更を保存します。

5. コンテンツ・サーバー・インスタンスを再起動します。

8.4 コンテンツ・セキュリティの構成

WebCenter Contentおよびコンテンツ・サーバー・インスタンスをデプロイし、初期構成を指定した後は、システム・プロパティ・ユーティリティの「コンテンツ・セキュリティ」タブまたは管理インタフェースからアクセスする「コンテンツ・セキュリティ」ページを使用して、コンテンツ・サーバーのコンテンツ・セキュリティ・オプションを設定または変更できます。

- システム・プロパティの「コンテンツ・セキュリティ」タブにアクセスする方法は、第3.5.2項を参照してください。

- 「コンテンツ・セキュリティ」ページにアクセスするには、「管理」→「管理サーバー」→「コンテンツ・セキュリティ」を選択します。

- Fusion Middleware Controlを使用してセキュリティ・オプションを構成するには、第8.2.1項を参照してください。

コンテンツ・セキュリティのオプションを使用して、次のことができます。

- コンテンツ・アイテムのセキュリティ・グループに対して読取り権限のみを持つユーザーが、ネイティブ・ファイルのコピーを取得できるようにします。

- 作成者またはコンテンツ・アイテムのセキュリティ・グループに対して管理権限を持つユーザーのみが、コンテンツ・アイテムをチェックアウトできるようにします。

- コンテンツ・アイテムの作成者が、読取り権限を持っていれば、自分が作成したコンテンツ・アイテムのセキュリティ・グループに対して削除権限を持っていない場合でも、コンテンツ・アイテムを削除できるようにします。

注意:
サイトでコントリビューション・フォルダを使用している場合は、この設定により、作成者がコンテンツ・アイテムのセキュリティ・グループの削除特権を持っていない場合でも、コンテンツ・アイテムを削除できます。

- チェックイン・ページの「アカウント」リストに、グローバルに事前定義されているアカウントのみが表示されるようにします。

構成の変更内容を反映するには、コンテンツ・サーバー・インスタンスを再起動する必要があります。

8.5 コンテンツ・サーバーを使用したインターネット情報の構成

WebCenter Contentドメインおよびコンテンツ・サーバーをデプロイし、初期構成を指定した後は、システム・プロパティ・ユーティリティの「インターネット」タブまたは管理インタフェースからアクセスする「インターネットの構成」ページを使用して、コンテンツ・サーバーのインターネット・オプションを表示または変更できます。通常、インターネット・オプションはOracle WebCenter Contentのインストール中および初期構成中に指定されます。

- システム・プロパティの「インターネット」タブにアクセスする方法は、第3.5.2項を参照してください。システム・プロパティ・ユーティリティでのみ変更可能なフィールドもあります。

- 「インターネットの構成」ページにアクセスするには、「管理」→「管理サーバー」→「インターネット」を選択します。

インターネット構成オプションを使用して、次のことができます。

- コンテンツ・サーバー・インスタンスのHTTPサーバー・アドレスを表示します。セキュリティ上の理由で、このフィールドはインタフェースからは変更できません。このフィールドは、Oracle WebCenter Contentスタンドアロン・アプリケーションを使用して変更する必要があります。

- コンテンツ・サーバー・インスタンスへのアクセスに使用できるIPアドレスをリストするIPアドレス・フィルタを表示および変更します。

- コンテンツ・サーバー・インスタンスのサーバー・ポート番号である、Intradocサーバー・ポートを表示および変更します。

- Secure Sockets Layer (SSL)対応のWebサーバーが使用されるかどうかを表示します。セキュリティ上の理由で、このフィールドはインタフェースからは変更できません。このフィールドは、Oracle WebCenter Contentスタンドアロン・アプリケーションを使用して変更する必要があります。

- コンテンツ・サーバー・インスタンスから電子メール通知を送信するために使用する電子メール・サーバーを表示および変更します。

- SMTP通信に使用するポートを表示します。セキュリティ上の理由で、このフィールドはインタフェースからは変更できません。このフィールドは、Oracle WebCenter Contentスタンドアロン・アプリケーションを使用して変更する必要があります。

- コンテンツ・サーバー・インスタンスが電子メール通知を送信するために使用する管理者電子メール・アドレスを表示および変更します。

構成の変更内容を反映するには、コンテンツ・サーバー・インスタンスを再起動する必要があります。

8.6 システム・データベース・プロパティの構成

WebCenter ContentおよびWebCenter Content Serverインスタンスをデプロイし、初期構成を指定した後は、コンテンツ・サーバーのシステム・データベース・プロパティを設定または変更できます。システム・データベースには、Oracle Database 11g、Microsoft SQL Server、IBM DB2、またはその他のデータベースを使用できます。

サポートされているデータベースの詳細は、Oracle Technology Networkの次の場所にある「Oracle Fusion Middlewareのサポートされるシステム構成」ページで、お使いの製品の「システム要件およびサポートされるプラットフォーム」ドキュメントを参照してください:

http://www.oracle.com/technetwork/middleware/ias/downloads/fusion-certification-100350.html

初期デプロイメントおよび構成の詳細は、『Oracle WebCenter Contentのインストールと構成』を参照してください。

注意:
セキュリティ上の理由で、コンテンツ・サーバー管理インタフェースを使用して、これらのオプションを構成することはできません。コンテンツ・サーバー・インスタンスがインストールされているコンピュータから、スタンドアロン・アプリケーションとしてシステム・プロパティ・ユーティリティを起動する必要があります。このプログラムを起動するのに必要な方法は、WindowsインストールとUNIXインストールとで若干異なります。詳細は、第3.5.2項を参照してください。

システム・データベースのオプションを使用して、次のことができます。

- JDBCが有効かどうかを変更し、ドライバ・オプションを選択します。

- データベースで大文字と小文字が区別されるかどうかを変更します(OracleやInformixなど)。

- データベース接続をサポートするために、「データベース・ドライバ・クラスパス」フィールドにデータベース・ドライバ・クラスパスを指定する必要があるかどうかを変更します。

- データベース・ドライバのクラスパスを指定します。

- JDBCドライバの名前を指定します。

- JDBCドライバの接続文字列を指定します。

- データベース内部に表を所有するユーザー名を指定します。

- データベース内部に表を所有するユーザー名のパスワードを指定します。

構成の変更内容を反映するには、コンテンツ・サーバー・インスタンスを再起動する必要があります。

8.6.1 コンテンツ・サーバーのシステム・データベースについて

コンテンツ・サーバーでは、Oracle WebLogic Serverデータ・ソースを使用して、メタデータおよびその他の情報が格納されているシステム・リレーショナル・データベースと通信します。システム・リレーショナル・データベースのデータベース接続情報の管理には、Oracle WebLogic Server管理コンソールを使用する必要があるため、JDBCユーザー名およびパスワード情報は、IntradocDir/config/config.cfgファイルには格納されず、システム・プロパティ・ユーティリティでは管理されません。

注意:
Oracle WebLogic Serverドメインのデータベース接続情報をシステム・プロパティ・ユーティリティを使用して設定する場合、JDBCユーザー名およびパスワードは暗号化されて不特定の場所に格納されます。

コンテンツ・サーバーでは、Oracle Real Application Cluster (RAC)用のOracle Databaseリレーショナル・データベースへの接続で、GridLinkデータ・ソースをサポートします。詳細は、『Oracle Fusion Middleware Oracle WebLogic Server JDBCデータ・ソースの構成と管理』および『Oracle Fusion Middleware管理者ガイド』を参照してください。

スタンドアロン・モードでアプリケーションを実行するコンテンツ・サーバー・インスタンスへのデータベース接続の構成の詳細は、次の項を参照してください。

- 第3.5.2.3項「スタンドアロン・モード用のシステム・データベース・プロバイダの構成」

- 第3.5.2.4項「スタンドアロン・モード用のJDBCデータベース・ドライバの構成」

- 第3.5.2.5項「スタンドアロン・モード用の外部データベース・プロバイダの構成」

8.6.2 IBM DB2データベース検索のためのコンテンツ・サーバーの構成

IBM DB2データベースでは、検索問合せにおいてキーワードCONTAINSがサポートされていません。コンテンツ・サーバー・インスタンスをIBM DB2検索問合せ用に正しく構成するには、フラグSSUseContains=false変数を追加する必要があります。コンテンツ・サーバー・インスタンスを構成するには、次の手順を実行します。

1. 新規のブラウザ・ウィンドウを開き、システム管理者としてコンテンツ・サーバー・インスタンスにログインします。

2. 「管理」→「管理サーバー」→「一般構成」を選択します。

3. 「一般構成」ページの「追加の構成変数」領域で、次の行を追加します。

SSUseContains=false

4. config.cfgファイルで、変数DatabasePreserveCaseがtrue (または1)に設定されていることを確認します。変数がtrueに設定されていない場合は、「一般構成」ページの「追加の構成変数」領域に、DatabasePreserveCase=trueを追加します。

5. 「Save」をクリックします。

6. コンテンツ・サーバー・インスタンスを再起動します。

8.7 ドキュメント・クラウド・サービス統合の設定の構成

Oracle Documents Cloud ServiceをContent Serverに統合すると、Oracle WebCenter Contentユーザーは、Oracle Documents Cloudにドキュメントを格納したり、格納されているドキュメントを取得したりすることができます。また、Content Serverに格納されているコンテンツをOracle Documents Cloudにコピーすることもできます。

Oracle Documents Cloud Serviceに統合するようにContent Serverを構成する手順:

1. コンポーネント・マネージャを使用して、OracleDocumentsFoldersコンポーネントを有効にします。詳細は、第9.2.2項「コンポーネント・マネージャを使用したコンポーネントの有効化または無効化」を参照してください。

注意:
OracleDocumentsFoldersコンポーネントを有効にする前に、FrameworkFoldersコンポーネントが有効になっていることを確認してください。

2. 「Oracle Documents Cloud Service統合の設定」ページでDocuments Cloud Service (DCS)接続情報を構成します。

1. 新規のブラウザ・ウィンドウを開き、システム管理者としてコンテンツ・サーバー・インスタンスにログインします。

2. 「管理」、「Oracle Documents Cloud Service」の順に選択します。「Oracle Documents Cloud Service統合の設定」ページが開きます。

3. Oracle Documents CloudサーバーのURL、テナント・ユーザー名およびパスワードを入力します。

4. 「Save」をクリックします。
「テスト」ボタンをクリックして、Oracle Documents Cloudサーバー接続の設定をテストできます。

3. Oracle WebLogic Server管理コンソールを使用してコンテンツ・サーバーでワイルドカードのホスト名ベリファイアを構成します。

1. 管理コンソールのホームページの「ドメイン構成」領域で、「環境」→「サーバー」を選択します。

2. 「サーバーのサマリー」ページの「構成」タブで、コンテンツ・サーバー・インスタンスのWebCenter Content Serverの名前を選択します。

3. 「SSL」 サブタブをクリックし、「詳細」を展開します。

4. 「ホスト名の検証」フィールドで、「カスタム・ホスト名の検証」を選択します。

5. 「カスタム・ホスト名の検証」フィールドに、weblogic.security.utils.SSWLSWildcardHostnameVerifierと入力します。

6. JSEE SSLを使用するチェック・ボックスを選択します。

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

構成の変更内容を反映するには、コンテンツ・サーバー・インスタンスを再起動する必要があります。

8.8 サーバー・プロパティの構成

WebCenter Contentおよびコンテンツ・サーバー・インスタンスをデプロイし、初期構成を指定した後は、システム・プロパティ・ユーティリティの「サーバー」タブを使用して、コンテンツ・サーバーのオプションを設定または変更できます。

注意:
セキュリティ上の理由で、コンテンツ・サーバー管理インタフェースを使用して、これらのオプションを構成することはできません。コンテンツ・サーバー・インスタンスがインストールされているコンピュータから、スタンドアロン・アプリケーションとしてシステム・プロパティ・ユーティリティを起動する必要があります。このプログラムを起動するのに必要な方法は、WindowsインストールとUNIXインストールとで若干異なります。詳細は、第3.5.2項を参照してください。

サーバーのオプションを使用して、次のことができます。

- ユーザー・インタフェースの言語、ステミング・ルール、ソート順序、日付/時間書式など、いくつかの言語固有の問題をコンテンツ・サーバー・インスタンスが処理する方法を指定します。

- コンテンツ・サーバー・インスタンスが配置されているタイムゾーンを選択します。

- Windowsの「スタート」メニューに表示されるインスタンス名を指定します。

- コンテンツ・サーバー・インスタンスへのアクセスを、指定したIPアドレスを持つコンピュータに制限します。

- プロキシのパスワードを指定します。

- コンテンツ・サーバー・インスタンスで内部JSPサポートが有効かどうかを指定します。

- 内部JSPサポートに対して有効にするセキュリティ・グループを指定します。

構成の変更内容を反映するには、コンテンツ・サーバー・インスタンスを再起動する必要があります。

注意:
ホスト名フィルタ、IPアドレス・フィルタまたはその他のネットワークベースのセキュリティを使用しないと、コンテンツ・サーバー・インスタンスにセキュリティ・ホールが生じます。たとえば、システムについての深い知識を持つユーザーならば、ログインしなくても、他のユーザーをシステム管理者のアクセス権限を持つように作成または変更することができます。

ホスト名フィルタまたはIPアドレス・フィルタの値は、次のような状況でコンテンツ・サーバー・インスタンスと通信できるように設定する必要があります。

- Inbound RefineryおよびPDF Converterの実行時(コンテンツ・サーバー・インスタンスと同じ物理コンピュータ上の場合でも)。

- コンピュータ間でのコンテンツ・サーバー・アーカイブの転送時。

- Webサーバーとコンテンツ・サーバー・インスタンスが異なるシステムにある場合の構成。

- EJB拡張機能の操作。

- コンテンツ・サーバー・インスタンスとは別のシステムでIdcCommandまたはIdcCommandXユーティリティの使用時。(デフォルト値を変更し、WebサーバーのIPアドレスを指定する必要があります。)

8.9 ローカライゼーション・プロパティの構成

WebCenter Contentおよびコンテンツ・サーバー・インスタンスをデプロイし、初期構成を指定した後は、システム・プロパティ・ユーティリティの「ローカライズ」タブを使用して、日付/時間のフォーマット、デフォルトのタイムゾーン、ソート・ゾーン、有効になっているインタフェース言語などの言語特有のアイテムを変更できます。

「ローカライズ」ページを使用すると、ユーザーが各自の「ユーザー・プロファイル」で選択するロケールを有効化または無効化できます。

- システム・プロパティの「ローカライズ」タブにアクセスする方法は、第3.5.2項を参照してください。

- 「ローカライズ」ページにアクセスするには、コンテンツ・サーバー・ポータルで、「管理」→「ローカライズ」を選択します。

8.9.1 日付書式の構成

デフォルトのEnglish-USロケールでは、年は2桁(yy)で表現され、1969年から2068年の間のものとして解釈されます。つまり、65は1965年ではなく、2065年とみなされます。English-USロケールで1969年より前の年が正しく解釈されるようにするには、そのロケールのデフォルトの日付フォーマットを、年が4桁(yyyy)で表されるように変更する必要があります。

この問題は、すでに年の表現に4桁を使用しているEnglish-UKロケールには当てはまりません。

デフォルトのEnglish-USデータ・フォーマットを変更するには、次のようにします。

1. システム・プロパティ・アプレットを起動します。

- Windows: 「スタート」→「プログラム」→「コンテンツ・サーバー」→「instance_name」→「ユーティリティ」→「システム・プロパティ」を選択します。

- UNIX: コンテンツ・サーバー・インストール・ディレクトリの/binサブディレクトリにあるシステム・プロパティ・ユーティリティを実行します。

./SystemProperties

2. 「ローカライズ」タブを選択します。

3. ロケールのリストで「English-US」エントリを選択し、「編集」をクリックします。

4. 「ロケールの構成」ダイアログで、日付フォーマットを2桁(yy)ではなく4桁(yyyy)を使用して年を表すように修正します。

5. 編集が終了したら、「OK」をクリックして「ロケールの構成」ダイアログを閉じます。

6. 「OK」をクリックして変更を適用し、「システム・プロパティ」を終了します。

7. コンテンツ・サーバー・インスタンスを再起動して、構成の変更内容を有効にします。

8.9.2 インタフェース言語の構成

コンテンツ・サーバー・インスタンスのインタフェース言語を追加、編集、削除、有効化または無効化するには、次のようにします。

1. 第8.9.1項で説明されているのと同じ基本手順で、システム・プロパティ・ユーティリティの「ローカライズ」タブでロケールを選択します。

2. インタフェース言語を変更し、「OK」をクリックします。「ローカライズ」タブでロケールを有効化すると、管理ローカライゼーション・ページでもそのロケールが有効になります。

管理者は複数のロケールを有効化して、ユーザーが各自の「ユーザー・プロファイル」から、自分のユーザー・インタフェース言語に使用するロケールを、有効化されたロケールの中から選択できるようにすることができます。ユーザーが選択できるように有効にするロケールを指定するには、次のようにします。

1. コンテンツ・サーバーのメイン・ページで、「管理」→「ローカライズ」を選択します。

2. 「有効なロケール」リストからチェック・ボックスを選択して言語を指定します。

3. 「更新」をクリックします。

8.10 パス・プロパティの構成

WebCenter Contentおよびコンテンツ・サーバー・インスタンスをデプロイし、初期構成を指定した後は、システム・プロパティ・ユーティリティの「パス」タブを使用して、次のことをできます。

- スタンドアロンの管理ユーティリティおよびアプリケーションからオンライン・ヘルプを表示するために使用されるブラウザ実行可能ファイルの場所を変更します。

- Javaクラス・ファイルへのパスを変更します。

- 共有ディレクトリへのパスを変更します。

構成の変更内容を反映するために、コンテンツ・サーバー・インスタンスを再起動する必要があります。

注意:
セキュリティ上の理由で、コンテンツ・サーバー管理インタフェースを使用して、これらのオプションを構成することはできません。コンテンツ・サーバー・インスタンスがインストールされているコンピュータから、スタンドアロン・アプリケーションとしてシステム・プロパティ・ユーティリティを起動する必要があります。このプログラムを起動するのに必要な方法は、WindowsインストールとUNIXインストールとで若干異なります。詳細は、第3.5.2項を参照してください。

9 コンポーネントの管理

この章では、Oracle WebCenter Contentコンポーネント・マネージャ、Fusion Middleware Control、およびComponent Toolを使用して、システムおよびカスタムのコンテンツ・サーバー・コンポーネントを有効化、無効化、およびアップロードする方法について説明します。また、コンポーネント・ウィザードを使用して、新しいコンテンツ・サーバー・コンポーネントを作成する方法についても説明します。

この章の内容は次のとおりです。

- コンポーネントについて

- コンポーネント・マネージャの使用

- Fusion Middleware Controlを使用したコンポーネントの管理

- コマンドラインを使用したコンポーネントの管理

- コンポーネント構成の更新

- コンポーネント・ウィザードを使用したコンポーネントの作成

9.1 コンポーネントについて

コンポーネントとは、追加の機能を提供したり既存の機能を変更するために、コンテンツ・サーバーにプラグインできる機能単位です。コンポーネントの主な用途は、既存のページのユーザー・インタフェースを変更し、既存のサービスの動作を変更することです。コンテンツ・サーバーには標準コンポーネントとシステム・コンポーネントが付属しており、さらにOracle Technology Networkから追加のコンポーネントを入手できます。管理者および開発者は、各自のサイト用に独自のカスタム・コンポーネントを作成できます。

注意:
コンポーネントの構造およびカスタマイズ方法の詳細は、『Oracle WebCenter Contentでの開発』を参照してください。

表9-1に、最も標準的なコンテンツ・サーバーのシステム・コンポーネントの一覧とその簡単な説明を示します。すべてのコンポーネントがデフォルトで有効化されているわけではありません。大部分のコンポーネントの詳細情報は、WebCenter Contentドキュメント・セットで見つかります。

表9-1 コンテンツ・サーバー・コンポーネント

コンポーネント

説明

ActiveDirectoryLdapComponent

コンテンツ・サーバー・インスタンスがLDAPを使用してActive Directoryサーバーに対してユーザーを認証できるようにします。また、プロバイダはすべてのグループ・メンバーシップと指定されたユーザー・メタデータをActive Directoryから取得します。

AppAdapterCore

Oracleビジネス・アプリケーションの添付ファイル・フレームワークのコア機能を提供します。これにより、ビジネス・アプリケーションのユーザーは、コンテンツ・サーバー・リポジトリで管理されているアプリケーション・ビジネス・エンティティの添付ドキュメントを保存および取得できるようになります。このコンポーネントが正しく機能するためには、アプリケーション固有のコンテンツ・サーバー統合コンポーネントも有効にする必要があります。このコンポーネントは、E-Business Suite Adapter for Oracle WebCenter Content(管理対象添付ファイル・ソリューション)およびPeopleSoft Adapter for Oracle WebCenter Content(管理対象添付ファイル・ソリューション)の必須要素です。

AppAdapterEBS

E-Business Suite統合検索結果表示ページを作成し、E-Business Suite管理対象添付ファイル・ソリューションを有効にするために必要なカスタマイズ・テンプレートを作成します。このコンポーネントが正しく機能するためには、AppAdapterCoreコンポーネントも有効にする必要があります。このコンポーネントは、E-Business Suite Adapter for Oracle WebCenter Content(管理対象添付ファイル・ソリューション)の必須要素です。

AppAdapterPSFT

PeopleSoft統合検索結果表示ページを作成し、PeopleSoft管理対象添付ファイル・ソリューションを有効にするために必要なカスタマイズ・テンプレートを作成します。このコンポーネントが正しく機能するためには、AppAdapterCoreコンポーネントも有効にする必要があります。このコンポーネントは、PeopleSoft Adapter for Oracle WebCenter Content(管理対象添付ファイル・ソリューション)の必須要素です。

AppAdapterUniversal

このコンポーネントは、エンタープライズ・アプリケーション・アダプタ・フレームワーク・ソリューションを任意のビジネス・アプリケーションとともに使用する際の必須要素です。これには、カスタマイズ可能なUIレイアウト、ドキュメント・プロファイルおよびアプリケーション・フィールド定義が含まれており、このコンポーネントが正しく機能するためには、AppAdapterCoreコンポーネントも有効にする必要があります。注意: Oracle WebCenter Content用のエンタープライズ・アプリケーション・アダプタには、コンテンツ・サーバー以外にも、サーバーにインストールする必要がある必須コンポーネントがあります。

ArchiveReplicationExceptions

失敗したインポートを取得して例外アーカイブに挿入し、インポートが失敗したことを示す電子メールを管理者に送信することにより、管理者はインポートが失敗してもレプリケーションが停止しないようにすることができます。

AutoSuggestConfig

WebCenter Contentユーザー・インタフェースをサポートしています(ネイティブ11gインタフェースと比較した場合)。

BpelIntegration

コンテンツ・サーバー・ワークフロー内からBusiness Process Execution Language (BPEL)プロセス・マネージャと対話する機能を追加します。管理者は、BPELサーバー上にデプロイされたプロセスを開始するようにコンテンツ・サーバー・ワークフローを構成できます。

BrowserUrlPath

コンテンツ・サーバーの変数HttpBrowserFullCgiPathおよび関数proxiedBrowserFullCgiWebUrl()の計算を変更して、特定のプロトコルに固定されないようにします。リクエストがポート443 (SSLポート)に着信すると、変数または関数はHTTPSをプロトコルとして使用して結果を返します。それ以外の場合、変数または関数はHTTPをプロトコルとして使用して結果を返します。

CheckoutAndOpenInNative

ユーザーは、コンテンツ・サーバー・インスタンスから、WebDAV準拠アプリケーションで直接コンテンツ・アイテムをチェックアウトして開くことができます。チェックアウトして開く機能が正しく機能するためには、CoreWebdavコンポーネントがインストールされて有効化されている必要があります。

CheckSCSHealth

検索エンジン、プロバイダおよびファイル・システムのヘルス状態をチェックするために使用するサービスを追加します。これらのサービスは、主に、コンテンツ・サーバーとサード・パーティの監視ユーティリティを統合する場合に役立ちます。

ClassifiedEnhancements

DoD分類済レコード要件を許可します。

CommonUtils

すべてのレコード管理機能レベルで使用されます。

ConfigMigrationUtility

コンテンツ・サーバー・インスタンスの要素を選択して、別のコンテンツ・サーバー・インスタンスに移行するために使用します。

ContentAccess-system

コンテンツ・サーバー・インスタンスに対して、標準のイン・プレース変換およびフィルタリングを実行します。ネイティブ・コンテンツのHTMLレンダリングの作成、フルテキスト索引用のテキストの抽出、およびリンク参照管理用のリンクの抽出に使用します。特定のコンポーネント名は、コンテンツ・サーバーがインストールされているシステムのタイプによって異なります。

ContentBasket

ユーザーが、コンテンツ・アイテムのレンダリングを選択し、その内容をコンテンツ・バスケットと呼ばれる個人の記憶域に格納できます。このコンポーネントが別個にインストールされている場合、「検索結果」ページまたは「コンテンツ情報」ページの「アクション」メニューからレンディションを選択して、コンテンツ・バスケットに格納できます。ユーザーはネイティブ・ファイルまたはWeb表示可能レンディションを選択できます。イメージ・マネージャまたはビデオ・マネージャを使用している場合、「レンディション情報」ページの「アクション」オプションを使用して、コンテンツ・バスケットに追加のレンディション・タイプを選択できます。

注意: コンテンツ・バスケット・コンポーネントは、イメージ・マネージャまたはビデオ・マネージャを使用する場合に必要です。

ContentCategorizer

コンテンツ・サーバー・インスタンスにチェックインされているドキュメントのメタデータ値を示し、すでに存在するドキュメントのメタデータを再カテゴリ化するために使用できます。メタデータ値は、管理者により指定された検索ルールに従って決定されます。

ContentFolios

コンテンツ・サーバー・インスタンスの安全な環境内から、複数のコンテンツ・アイテムの論理グループの結集、追跡およびアクセスを迅速かつ効率的に行う方法を提供します。たとえば、このコンポーネントを使用して、コンテンツ・アイテムがチェックインされると、すべての関連コンテンツ・アイテムが特定階層にまとめられ、階層の特定領域へのアクセスが制限される仮想空間が必要な、新規プロジェクトを作成できます。

ContentPortletSuiteBundle

コンテンツの作成および配布プロセスの管理に使用するポートレットを提供します。ポートレットは、BEA WebLogic、IBM WebSphere、PlumtreeおよびSun ONEのポータル・サーバーでサポートされています。

ContentTracker

コンテンツ・サーバー・インスタンスのアクティビティを監視し、それらのアクティビティについて、選択した詳細を記録します。その後、システムが使用されている方法を管理者が把握するのに役立つレポートを生成します。

ContentTrackerReports

Content Trackerコンポーネントにより生成されたデータをレポートします。

CoreWebdav

WebDAVプロトコルをサポートするクライアントを使用して、コンテンツ・サーバー・リポジトリでコンテンツをリモートで作成および管理する手段を提供します。

DAMConverterSupport

Inbound Refineryで、チェックイン済グラフィック・ファイルの複数のパッケージ化された(圧縮済)レンディションを作成できるようにします。ZipRenditionManagementシステム・コンポーネントを使用して、リファイナリで作成されたレンディションにアクセスできます。

DBSearchContainsOpSupport

hasAsWord(Contains)演算子のサポートを、SQL Server、OracleおよびDB2データベースのDATABASEおよびDATABASEFULLTEXTに追加します。

DesktopIntegrationSuite

デスクトップ操作をコンテンツ・サーバーとシームレスに統合する際に役立つ、一連の埋込みアプリケーションを提供します。Microsoft Windowsエクスプローラ、Microsoft WordやExcelなどのデスクトップ・アプリケーション、Microsoft OutlookやLotus Notesなどの電子メール・クライアントから、コンテンツ・サーバーに簡単にアクセスできるようになります。

DesktopTag

一連のカスタム・プロパティをドキュメントに保持することで、CleanContentコンポーネントでサポートされているドキュメントを変更します。これらのプロパティは、コンテンツ・サーバーでファイルを使用するために、Desktop Integration SuiteのMicrosoft Office統合で使用されます。

DigitalAssetManager

ダウンロード用に指定されたフォーマットとサイズで、イメージとビデオを定義して提供できるようにします。このコンポーネントにより、イメージまたはビデオがコンテンツ・サーバーにチェックインされるときに、複数のフォーマットのデジタル・アセットが自動的に作成され、1つのコンテンツIDの下にフォーマットが表示されます。

DodConfig

DoD要件を構成するための機能を提供します。

DynamicConverter

ドキュメントの作成に使用したアプリケーションを使用しなくてもすべての人がドキュメントを参照できるよう、ドキュメントをWebページに変換します。

ElectronicSignatures

管理対象コンテンツ・オブジェクトの電子署名の作成および管理をサポートします。このコンポーネントはOracle WebCenter Contentワークフローと緩やかに統合されています。

EmailMetadata

Microsoft Outlookメッセージ(MSG)とInternet Mailメッセージ(EML)から情報を抽出して、コンテンツ・サーバーの電子メール用のフィールドに入力します。このプロセスは、Microsoft Outlook、Lotus NotesまたはWindowsエクスプローラでコンテンツ・サーバーのコントリビューション・フォルダ機能を使用してファイルをチェックインするときに行われます。Webブラウザ・インタフェースを使用してMSGまたはEMLファイルをチェックインするときにも行われます。

ExtendedUserAttributes

管理者は、拡張セキュリティ属性をコンテンツ・サーバー・ユーザーに追加できます。拡張セキュリティ属性は既存のユーザー属性とマージされ、ユーザーの管理に柔軟性を追加できます。

ExtranetLook

匿名ユーザーに対するOracle WebCenter Contentのデフォルト動作をカスタマイズできます。匿名ユーザーは重要ページへのアクセスが制限されるため、それらのページを表示したときに利用できる機能が少なくなります。

FileStoreProvider

コンテンツ・サーバーで、ファイルの格納方法を詳細に制御できるようにします。ファイルは、データベース内またはファイル・システム上に格納できます。このコンポーネントには、他のタイプの記憶域リポジトリにファイルを格納するコンポーネントを記述できる拡張オプションがあります。ファイルをファイル・システム上に格納する場合、このコンポーネントによりパス計算を柔軟に行うことができます。Web表示可能パスは、使用できるパスのタイプが制限されています。

Folders_g

コンテンツ・サーバー内のコンテンツに対して階層フォルダ・インタフェースを提供します。

FoldersStructureArchive

コントリビューション・フォルダ構造および関連付けられているコンテンツをアーカイブするように、管理者がコンテンツ・サーバー・アーカイブを構成できるようにします。コントリビューション・フォルダの構造は、データベース表のレプリケーションを使用してアーカイブされます。

FormEditor

hcswファイルをhcsfファイルに処理するシステム機能を提供します。

FrameworkFolders

従来のファイル・システムと同様に、コンテンツ・サーバー・リポジトリ内の一部またはすべてのコンテンツを編成および検索するための階層フォルダ・インタフェースを提供します。

InboundRefinerySupport

コンテンツ・サーバーで、ファイルの変換にInbound Refineryを使用できるようにします。このコンポーネントがなければ、コンテンツ・サーバーでInbound Refineryを使用できません。

iTextComponent

コンポーネントによるPDFドキュメントの作成および操作を可能にするiTextライブラリを提供します。

JpsUserProvider

Oracle Java Platform Security (JPS)フレームワークとの統合が可能となります。

LinkManager

索引付けされたドキュメントのURLリンクを抽出し、パターン・エンジンに従ってURLを評価、フィルタリングおよび解析した後、結果をデータベース表に格納します。リンクの抽出は索引付けサイクル中に行われるため、リリースされたドキュメントのリンクのみが管理されます。

Localization

コンテンツ・サーバー、Inbound Refinery、Recordsおよびその他多数のコンポーネントのローカライゼーションが含まれています。管理者は、コンテンツ・サーバーで有効になっているロケールを制御できます。

MetadataSet

追加カスタム・メタデータを作成し、DocMeta表の外部にある追加補助情報を保存できる機能を提供します。通常、補助メタデータは、イメージのサイズ、ビデオ・ファイルの長さ、ドキュメントの文字エンコーディングなど、そのメタデータが表すアイテムに固有の様々なプロパティに関連付けられています。保存カテゴリ、保存フォルダおよび物理コンテンツのカスタム・フィールドの作成、編集、削除にも、同じ補助メタデータ・セットUIが使用されます。

MSOfficeHtmlConverterSupport

コンテンツ・サーバーとInbound Refineryが、ネイティブ・アプリケーションを使用して、選択したMicrosoft OfficeフォーマットをHTMLに変換できるようにします。

NativeOsUtils

(必須)コンテンツ・サーバー・インスタンスで必要なネイティブJNIコールを提供します。このコンポーネントが有効化されていなくてもコンテンツ・サーバーを実行できますが、一部の機能が失われます。失われる主要な2つの機能を、次に示します。

- スキーマのパブリッシュにおいて、コンテンツが変更されていない場合に、ハード・リンクを使用して新規ファイルを既存のファイルに再びリンクするかわりに、すべてのファイルが書き直されます。

- ネイティブの実行可能ファイルを持つコンポーネントがインストールされると、ファイルの実行可能ビットが正しく切替えられません。このことは、ContentAccessなどのコンポーネントに影響を与える可能性があります。

OCM

コンテンツ・サーバー・インスタンスで有効化および無効化されているコンポーネントのリストを収集し、構成マネージャにデータを提供します。

OracleAdvancedSecurityConfig

すべてのセキュリティ構成を処理します。このコンポーネントは、他のセキュリティ機能とともに、デフォルトで有効になっています。また、データベース表をスキーマに追加して、セキュリティ構成フラグの状態を維持します。

OpssPolicyStore

コンテンツ・サーバーとOPSSポリシー・ストアを統合します。

OracleCleanContent

クリーン・コンテンツ・ライブラリが含まれ、DesktopTagコンポーネントで使用されるドキュメントの説明が生成されます。

OracleDocumentsFolders

Oracle Documents Cloudとシームレスに統合するようにContent Serverを有効にします。ユーザーは、ドキュメントをOracle Documents Cloudに格納したり、格納されているドキュメントを取得したりすることができます。また、Content Serverに格納されているコンテンツをOracle Documents Cloudにコピーすることもできます。

注意: このコンポーネントを有効にする前に、FrameworkFoldersコンポーネントが有効になっていることを確認してください。

OracleLocalization

コンテンツ・サーバーで、日付、数値および小数値をローカルに適した方法で解析、ソートおよびフォーマットできます。

OracleQueryOptimizer

最良の実行計画が使用されるように問合せのヒントを追加可能にすることで、Oracle Databaseに対する問合せの調整に役立ちます。

PDFWatermark

Inbound Refinery PDFConverterコンポーネントで生成されたPDFファイルにウォーターマークを適用して、コンテンツ・サーバーに戻すことができるようにします。コンテンツ・サーバーにすでに存在するPDFファイルにも、ウォーターマークを適用できます。動的なウォーターマークが迅速に生成され、変数情報を含めることができます。

PopUpCalendar

コンテンツ・サーバーのチェックイン・ページおよび更新ページにあるすべての日付フィールドの右側に、カレンダ・アイコンが表示されるようになります。アイコンをクリックすると、カレンダ・ウィンドウがポップアップ表示され、ユーザーはこのウィンドウで日付をクリックして選択できます。カレンダにより、選択された日付が親ページの関連する入力フィールドにロードされます。ウィンドウを開くことなく、JavaScriptを使用したダイアログを開くように構成することもできます。

ProxyConnections

HTTPまたはHTTPSを介してコンテンツ・アイテムのアーカイブ・レプリケーションを実行する機能を提供します。対象となるマスター・サーバーへのプロキシ接続に対して名前付きパスワードを使用することにより、コンテンツ・サーバー・インスタンスへのアクセス制限を強化できます。コンテンツ・サーバー・インスタンスへのパスワードで保護された接続の確立や、資格証明マップの作成のためのユーザー・インタフェースを提供します。

RecordsManagement

コア・レコード管理機能を提供します。

RelatedContent

ドキュメントをリンク付けしたり関連付ける様々な方法を提供します。たとえば、ドキュメントをピアツーピア(レンディション)、連鎖リスト(差替え)、親子(サポート・コンテンツ)、相互参照リンク(相互参照)として関連付けることができます。

ReportPublisher

Oracle BI Publisherを使用してレポートを生成します。

RetentionManager

Oracle Content Serverでのレコード管理用の構成が含まれます。

RmaEmail

電子メール・レコードを管理する機能を提供します。

RMFeatureConfig

様々なレコード管理機能レベルを選択するために使用します。

RoleEntityACL

コンテンツ・サーバーとOPSSアクセス制御リストの権限を統合します。

SecurityProviders

コンテンツ・サーバーの送受信ソケット・プロバイダのSecure Sockets Layer (SSL)暗号化および認証を提供します。

SESCrawlerExport

Oracle Secure Enterprise Searchを使用してコンテンツ・サーバーを検索できる機能を追加します。このサービスでは、現在コンテンツ・サーバー上にあるコンテンツのスナップショットを生成して、Oracle SES Crawlerに提供します。

SiebelECMIntegration

Siebel Adapter for Oracle WebCenter Contentの一部で、Siebel CRMユーザーが、コンテンツ・サーバー・リポジトリに保存された添付ファイルを保存および取得できるようにします。

SiebelFilter

Siebel Adapter for Enterprise Content Managementのオプション部分。これにより、ドキュメント・タイプ、作成者、セキュリティ・グループなどのメタデータに基づいて、添付ファイル・リストをフィルタリングできます。

SiebelIntegrationSearchDisplay

Oracle WebCenter Contentドキュメントを管理対象添付ファイルとして、Siebelアプリケーション内のiFrameのSiebelエンティティに表示します。

SiebelSearchExtensions

まだリリースされていないドキュメントをSiebel添付ファイル・リストに表示するかどうかを決定します。有効にすると、索引付けを待機しているドキュメント、Inbound Refinery変換プロセス内のドキュメント、ワークフロー内のドキュメントなど、システム内のすべてのドキュメントが表示されます。有効にしない場合は、リリースされたドキュメントのみがSiebel添付ファイル・リストに表示されます。このコンポーネントは、Siebel Adapter for Oracle WebCenter Contentのオプション部分です。注意: この機能を使用できるのは、メタデータのみの検索がコンテンツ・サーバー・インスタンスに構成されているときのみです。

SiebelSearchExtraParams

追加のSiebelメタデータ値をコンテンツ・サーバーのSiebel Adapterコンポーネントに渡せるようにします。有効にすると、構成された追加のSiebelパラメータが、新規またはスキャンの添付フォームのメタデータ設定として追加されます。このコンポーネントは、Siebel Adapter for Oracle WebCenter Contentのオプション部分です。

SiteStudio

企業規模のWebサイトを設計、構築およびメンテナンスする包括的なアプローチを提供する強力で柔軟なWeb開発アプリケーション・パッケージ。Webサイトの作成とコンテンツ管理の両方を行うことができます。

SiteStudioExternalApplications

アプリケーション・サーバーまたはWebサイトがコンテンツ・サーバー・インスタンスから切断されているWebサイト環境で、Site Studio機能を拡張します。VCRサービスのサポートを介して他のアプリケーション環境でSiteStudioファイルを再利用する機能も提供します。

SiteStudioPublisher

Site Studio Webサイトの静的コピーを作成し、ライブの場所にデプロイする機能を提供します。

TaskPanel

管理者とユーザーが、アクションや情報に迅速かつ効率的に1箇所からアクセスできるように、タスクや情報を1箇所に整理するために使用するダッシュボード。

ThreadedDiscussions

別のドキュメントに関するディスカッション・ドキュメントを作成できるようにします。任意のコンテンツ・アイテムを取得し、そのドキュメントIDに_dを追加して、元のドキュメントに関するディスカッションにフォーカスした新しいHCSP形式のドキュメントを作成します。

TiffConverterSupport

コンテンツ・サーバーとInbound Refineryで、tiffファイルを検索可能なPDFファイルに変換できるようにします。

UIEnhancements

レコード管理コンポーネントに必要なユーティリティ・コンポーネント。

UrmAgent

Oracle WebCenter Content: Recordsとコンテンツ・サーバー・リポジトリの間の通信手段です。コンテンツはアダプタ・サーバーのコンテンツ・ボールトに保存され、同時にOracle WebCenter Content: Recordsサーバーは、保存されたコンテンツに、企業の保存ポリシー、処理プロセスおよび法定保留を適用します。

UserProfileSchemaLoader

ユーザー・プロファイルをスキーマ・ビューとしてロードします。

WebCenterConfigure

必要な構成パラメータを設定し、WebCenterで必要なコンポーネントを有効にすることにより、コンテンツ・サーバー・インスタンスを構成するために使用します。

WebUrlMapPlugin

マッピング用の単純な置換スクリプトを使用して、コンテンツ・サーバー内のURLを他のURLにマップできます。

WsdlGenerator

コンテンツ・サーバーの機能にアクセスするWebサービス統合テクノロジを提供します。

XMLConverterSupport

コンテンツ・サーバーとInbound Refineryで、プライマリWebレンディションまたは追加のレンディションとして、様々なフォーマットをFlexionDocまたはSearchMLに変換できるようにします。コンテンツ・サーバーとInbound Refineryで、XSLT変換を実行することもできます。

YahooUserInterfaceLibrary

(必須) BSDライセンスで使用可能なYahoo! User Interface Library (YUI)のラッパーを提供します。コンテンツ・サーバーでは、フォルダ移動操作(フォルダ間でアイテムを移動)を実装する機能およびアクセシビリティのサポート(特にキーボード操作)のため、ユーザー・インタフェースの実装にYUIライブラリを採用しています。YUIライブラリは、カレンダ・コントロールおよびType-Ahead(先行入力)フィールドでのポップアップ選択のサポートにも使用されます。

9.2 コンポーネント・マネージャの使用

この項では、コンテンツ・サーバーとカスタム・コンポーネントを管理するために、コンポーネント・マネージャで実行できるタスクについて説明します。

- 第9.2.1項「コンポーネント・マネージャを使用したコンポーネントに関する情報の表示」

- 第9.2.2項「コンポーネント・マネージャを使用したコンポーネントの有効化または無効化」

- 第9.2.3項「コンポーネント・マネージャを使用したコンポーネントのインストール」

- 第9.2.4項「コンポーネント・マネージャを使用したコンポーネントのアンインストール」

- 第9.2.5項「コンポーネント・マネージャを使用したコンポーネントのダウンロード」

- 第9.2.6項「コンポーネント・マネージャを使用したコンポーネント構成の変更」

9.2.1 コンポーネント・マネージャを使用したコンポーネントに関する情報の表示

コンポーネントの基本説明を表示するには:

1. コンテンツ・サーバー・ポータルで、「管理」→「管理サーバー」→「コンポーネント・マネージャ」の順に選択します。
「コンポーネント・マネージャ」ページが開き、コンポーネント・カテゴリのリストとコンポーネント名のリストが表示されます。

2. 「すべてのコンポーネント」というカテゴリを選択します。

3. 「コンポーネント・マネージャ」ページで、コンポーネントのリストでコンポーネント名の上にカーソルを置きます。
コンポーネントが選択されているかどうかを示す説明が画面に表示されます。

コンポーネントの詳細情報を表示するには:

1. コンテンツ・サーバー・ポータルで、「管理」、「管理サーバー」、「コンポーネント・マネージャ」の順に選択します。
「コンポーネント・マネージャ」ページが開き、コンポーネント・カテゴリのリストおよびコンポーネント名のリストが簡単な説明とともに表示されます。

2. 「コンポーネント・マネージャ」ページの最初の段落で、下線付きのテキスト「拡張コンポーネント・マネージャ」をクリックします。

3. 「拡張コンポーネント・マネージャ」ページで、「有効なコンポーネント」のリストまたは「無効なコンポーネント」のリストで、コンポーネント名を選択します。
コンポーネント名、説明、タグ、場所、機能拡張など、コンポーネントに関する情報がリストの隣のペインに表示されます。

9.2.2 コンポーネント・マネージャを使用したコンポーネントの有効化または無効化

コンポーネントを有効化または無効化するには:

1. コンテンツ・サーバー・ポータルで、「管理」、「管理サーバー」、「コンポーネント・マネージャ」の順に選択します。

2. 「コンポーネント・マネージャ」ページで、「すべてのコンポーネント」を選択します。
ドキュメント管理、フォルダ、Inbound Refinery、統合およびWebコンテンツ管理のカテゴリのすべてのコンポーネントが表示されます。

3. 有効化するコンポーネントのチェック・ボックスを選択します。
無効化するコンポーネントのチェック・ボックスの選択を解除します。

コンポーネントが表示されていない場合、適切なフィルタのチェック・ボックスが選択されていることを確認し、コンポーネントが表示されるようにしてください。選択内容に変更を加えない場合は、「リセット」をクリックします。

4. 「更新」をクリックします。

5. コンテンツ・サーバー・インスタンスを再起動します。これは、変更を有効にするために必要なステップです。インスタンスを再起動する手順は、第3.2.3項を参照してください。
コンテンツ・サーバー・インスタンスが再起動され、コンポーネントが有効または無効になります。

注意:
コンテンツ・サーバー・インスタンスを起動すると、有効化されたコンポーネントがコンポーネント・リストに表示されている順序でロードされます。

6. コンポーネントの影響を受けるページに移動して、カスタマイズの追加または削除が予想どおりに機能していることを確認します。

注意:
コンポーネントの有効化または無効化は、「拡張コンポーネント・マネージャ」ページを使用して行うこともできます。

9.2.3 コンポーネント・マネージャを使用したコンポーネントのインストール

コンポーネントをインストールするには:

ヒント:
コンポーネントは、コンポーネント・ウィザードを使用してパッケージを展開することもできます。詳細は、第9.6項を参照してください。

1. コンテンツ・サーバー・ポータルで、「管理」、「管理サーバー」、「コンポーネント・マネージャ」の順に選択します。

2. 「コンポーネント・マネージャ」ページで、「拡張コンポーネント・マネージャ」をクリックします。

3. 「拡張コンポーネント・マネージャ」ページで、「新規コンポーネントのインストール」フィールドの横にある「参照」ボタンをクリックします。

4. コンポーネントzipファイルに移動して選択します。

5. 「開く」をクリックします。
「新規コンポーネントのインストール」フィールドに、パスおよびファイル名が表示されます。

6. 「インストール」をクリックします。
コンテンツ・サーバー・インスタンスでコンポーネント・ファイルのパッケージが展開され、コンポーネントの名前が「無効なコンポーネント」リストに表示されます。

注意:
コンポーネントをインストールしても、有効にはなりません。コンポーネントを有効化する必要があります。詳細は、第9.2.2項を参照してください。

7. コンポーネントをアップロードするのが困難な場合は、「管理」、「システム監査情報」の順に選択して、コンテンツ・サーバーの出力メッセージを確認します。「サーバー出力の表示」をクリックして、最近のサーバー・アクションを表示します。

9.2.4 コンポーネント・マネージャを使用したコンポーネントのアンインストール

コンポーネントをアンインストールするには:

ヒント:
コンポーネントは、コンポーネント・ウィザードを使用してアップロード(パッケージを展開)することもできます。詳細は、第9.6項を参照してください。

1. コンテンツ・サーバー・ポータルで、「管理」、「管理サーバー」、「コンポーネント・マネージャ」の順に選択します。

2. 「コンポーネント・マネージャ」ページで、「拡張コンポーネント・マネージャ」をクリックします。

3. 「拡張コンポーネント・マネージャ」ページで、「コンポーネントのアンインストール」フィールド・メニューからコンポーネントを選択します。

4. 「コンポーネントのアンインストール」フィールドにアンインストールするコンポーネント名が表示された状態で、「アンインストール」をクリックします。

9.2.5 コンポーネント・マネージャを使用したコンポーネントのダウンロード

次の要件を満たさないかぎり、コンポーネントをダウンロードできません。

- コンポーネントはMW_HOME/WC_CONTENT_ORACLE_HOME/ucm/idc/system/ディレクトリの外に存在する必要があります。これにより、コンポーネントにパッチがアップロードされている場合を除き、提供されているすべてのコンポーネントが除外されます。コンポーネントに適切な名前のzipファイルがあり、それがコンポーネント・ディレクトリの内側に存在する必要があります。一般に、これはコンポーネントが手動でアップロードまたはインストールされた場合にのみ発生します。

コンポーネントをダウンロードする手順は次のとおりです。

1. WebCenter Contentポータルで、「管理」、「管理サーバー」、「コンポーネント・マネージャ」の順に選択します。

2. 「コンポーネント・マネージャ」ページで、「拡張コンポーネント・マネージャ」をクリックします。

3. 「拡張コンポーネント・マネージャ」ページで、「コンポーネントのダウンロード」フィールド・メニューからパッケージ化するコンポーネントを選択します。

4. 「ダウンロード」をクリックします。

5. 「ファイルのダウンロード」ウィンドウで、「このファイルをディスクに保存」オプションを選択して「OK」をクリックします。

6. 「別名保存」ウィンドウで、コンポーネントzipファイルを保存するディレクトリに移動します。

7. 必要に応じて、コンポーネントzipファイルの名前を変更します。

8. 「Save」をクリックします。
コンポーネントがコンポーネントzipファイルとして保存されます。

9.2.6 コンポーネント・マネージャを使用したコンポーネント構成の変更

インストール後には、複数の方法を使用してコンポーネントの構成を変更または更新できます。

注意:
すべてのコンポーネントの構成を変更できるわけではありません。

コンポーネント・マネージャを使用してコンポーネントを変更するには、次の手順を実行します。

1. 「管理」、「管理サーバー」、「コンポーネント・マネージャ」の順に選択します。

2. 「コンポーネント・マネージャ」ページで、「拡張コンポーネント・マネージャ」をクリックします。

3. 「拡張コンポーネント・マネージャ」ページで、「コンポーネント構成の更新」フィールド・メニューからコンポーネント名を選択し、「更新」をクリックします。
コンポーネントの「コンポーネント構成の更新」ウィンドウが開きます。リストされるコンポーネント・パラメータは、コンポーネントのインストール後に編集可能として定義されたパラメータです。

4. コンポーネント構成の変更が終了したら、「更新」をクリックします。コンテンツ・サーバー・インスタンスを再起動する必要はありません。

インスタンスの構成ページを使用してコンポーネントを変更するには:

1. 「管理」→「インスタンスの構成」を選択します。

2. 「有効なコンポーネントの詳細」をクリックします。

3. 構成するコンポーネント名の横にある「構成」をクリックします。

- コンポーネントを構成できる場合は、コンポーネントの「コンポーネント構成の更新」ウィンドウが開きます。

- コンポーネントを構成できない場合は、メッセージが開きます。

4. コンポーネント構成の変更が終了したら、「更新」をクリックします。コンテンツ・サーバー・インスタンスを再起動する必要はありません。

9.3 Fusion Middleware Controlを使用したコンポーネントの管理

この項では、Enterprise Manager Fusion Middleware Controlインタフェースを使用して、WebCenter Content Serverのシステムおよびカスタムのコンポーネントを管理するために、コンポーネント・マネージャと拡張コンポーネント・マネージャで実行できるタスクについて説明します。

- 第9.3.1項「コンポーネント・マネージャの使用」

- 第9.3.2項「拡張コンポーネント・マネージャの使用」

9.3.1 コンポーネント・マネージャの使用

Fusion Middleware Controlを使用すると、WebCenter Content Serverコンポーネント・マネージャで、コンポーネントを表示して有効化または無効化できます。

- 第9.3.1.1項「Fusion Middleware Controlを使用したコンポーネント情報の表示」

- 第9.3.1.2項「Fusion Middleware Controlを使用したコンポーネントの有効化または無効化」

9.3.1.1 Fusion Middleware Controlを使用したコンポーネント情報の表示

コンポーネントの基本説明を表示するには:

1. Enterprise Manager Fusion Middleware Controlにログインしたら、ナビゲーション・ツリーで、適切なドメイン名(Content_base_domainなど)を展開します。

2. 「WebCenter」、「コンテンツ」、「コンテンツ・サーバー」の順に展開します。

3. Webcenter Content Serverインスタンス名(Oracle Webcenter Content - Content Server (UCM_server1)など)を選択します。
WebCenter Content Serverインスタンスのホーム・ページが表示されます。

4. WebCenter Content Serverホームページで、「コンテンツ・サーバー」メニューから、「構成ページ」→「コンポーネント・マネージャ」の順に選択します。
「コンポーネント・マネージャ」ページが開き、コンポーネント・カテゴリのリストおよびコンポーネント名のリストが表示されます。

5. 「コンポーネント・マネージャ」ページで、カテゴリ「すべてのコンポーネント」を選択します。

6. 「コンポーネント・マネージャ」ページで、コンポーネントのリストでコンポーネント名の上にカーソルを置きます。
コンポーネントが選択されているかどうかを示す説明が画面に表示されます。

コンポーネントの詳細情報を表示するには:

1. Enterprise Manager Fusion Middleware Controlにログインしたら、ナビゲーション・ツリーで、適切なドメイン名(Content_base_domainなど)を展開します。

2. 「WebCenter」、「コンテンツ」、「コンテンツ・サーバー」の順に展開します。

3. Webcenter Content Serverインスタンス名(Oracle Webcenter Content - Content Server (UCM_server1)など)を選択します。
WebCenter Content Serverインスタンスのホーム・ページが表示されます。

4. Webcenter Content Serverホームページで、「コンテンツ・サーバー」メニューから、「構成ページ」、「拡張コンポーネント・マネージャ」の順に選択します。

5. 「拡張コンポーネント・マネージャ」ページで、「有効なコンポーネント」または「無効なコンポーネント」のいずれかのリストで、コンポーネント名を選択します。
コンポーネント名、説明、タグ、場所、機能拡張など、コンポーネントに関する情報がリストの隣のペインに表示されます。

9.3.1.2 Fusion Middleware Controlを使用したコンポーネントの有効化または無効化

コンポーネントを有効化または無効化するには:

1. Enterprise Manager Fusion Middleware Controlにログインしたら、ナビゲーション・ツリーで、適切なドメイン名(Content_base_domainなど)を展開します。

2. 「WebCenter」、「コンテンツ」、「コンテンツ・サーバー」の順に展開します。

3. Webcenter Content Serverインスタンス名(Oracle Webcenter Content - Content Server (UCM_server1)など)を選択します。
WebCenter Content Serverインスタンスのホーム・ページが表示されます。

4. Webcenter Content Serverホームページで、「コンテンツ・サーバー」メニューから、「構成ページ」、「コンポーネント・マネージャ」の順に選択します。

5. 「コンポーネント・マネージャ」ページで、「すべてのコンポーネント」を選択します。
ドキュメント管理、フォルダ、Inbound Refinery、統合およびWebコンテンツ管理のカテゴリのすべてのコンポーネントが表示されます。

6. 有効化するコンポーネントのチェック・ボックスを選択します。
無効化するコンポーネントのチェック・ボックスの選択を解除します。

コンポーネントが表示されていない場合、適切なフィルタのチェック・ボックスが選択されていることを確認し、コンポーネントが表示されるようにしてください。選択した変更を行わない場合は、「元に戻す」をクリックします。

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

8. WebCenter Content Serverインスタンスを再起動します。これは、変更を有効にするために必要なステップです。インスタンスを再起動する手順は、第3.2.3項を参照してください。

注意:
Webcenter Content Serverインスタンスが開始され、コンポーネント・リストに示された順序に従って、有効化されたコンポーネントがロードされます。

9. コンポーネントの影響を受けるページに移動して、コンポーネントの追加または削除が予想どおりに機能していることを確認します。

注意:
コンポーネントの有効化または無効化は、「拡張コンポーネント・マネージャ」ページを使用して行うこともできます。

9.3.2 拡張コンポーネント・マネージャの使用

Fusion Middleware Controlを使用すると、WebCenter Content Serverコンポーネント・マネージャで、システムおよびカスタムのコンポーネントの有効化または無効化、インストールまたはアンインストール、ダウンロード、および変更を実行できます。

- 第9.3.2.1項「Fusion Middleware Controlを使用したコンポーネントの有効化または無効化」

- 第9.3.2.2項「Fusion Middleware Controlを使用したコンポーネントのインストール」

- 第9.3.2.3項「Fusion Middleware Controlを使用したコンポーネントのアンインストール」

- 第9.3.2.4項「Fusion Middleware Controlを使用したコンポーネントのダウンロード」

- 第9.3.2.5項「Fusion Middleware Controlを使用したコンポーネント構成の変更」

9.3.2.1 Fusion Middleware Controlを使用したコンポーネントの有効化または無効化

コンポーネントを有効化または無効化するには:

1. Enterprise Manager Fusion Middleware Controlにログインしたら、ナビゲーション・ツリーで、適切なドメイン名(Content_base_domainなど)を展開します。

2. 「WebCenter」、「コンテンツ」、「コンテンツ・サーバー」の順に展開します。

3. Webcenter Content Serverインスタンス名(Oracle Webcenter Content - Content Server (UCM_server1)など)を選択します。
WebCenter Content Serverインスタンスのホーム・ページが表示されます。

4. Webcenter Content Serverホームページで、「コンテンツ・サーバー」メニューから、「構成ページ」、「拡張コンポーネント・マネージャ」の順に選択します。

5. 「カテゴリ・フィルタ」を選択して、関連コンポーネント(標準、カスタムおよびシステム)を表示します。

6. 「その他のフィルタリング」で、「すべてのコンポーネント」を選択します。
ドキュメント管理、フォルダ、Inbound Refinery、統合およびWebコンテンツ管理のカテゴリのすべてのコンポーネントが表示されます。

7. 有効化したコンポーネントに関する情報を表示するには、「有効なコンポーネント」リストでコンポーネント名を選択します。

8. 有効化したコンポーネントを無効にするには、「有効なコンポーネント」リストでコンポーネント名を選択してから、「無効化」をクリックします。

9. 無効化したコンポーネントに関する情報を表示するには、「無効なコンポーネント」リストでコンポーネント名を選択します。

10. 無効化したコンポーネントを有効にするには、「無効なコンポーネント」リストでコンポーネント名を選択してから、「有効化」をクリックします。

11. WebCenter Content Serverインスタンスを再起動します。これは、変更を有効にするために必要なステップです。インスタンスを再起動する手順は、第3.2.3項を参照してください。

注意:
Webcenter Content Serverインスタンスが開始され、コンポーネント・リストに示された順序に従って、有効化されたコンポーネントがロードされます。

12. コンポーネントの影響を受けるページに移動して、コンポーネントの追加または削除が予想どおりに機能していることを確認します。

9.3.2.2 Fusion Middleware Controlを使用したコンポーネントのインストール

コンポーネントをインストールするには:

1. Enterprise Manager Fusion Middleware Controlにログインしたら、ナビゲーション・ツリーで、適切なドメイン名(Content_base_domainなど)を展開します。

2. 「WebCenter」、「コンテンツ」、「コンテンツ・サーバー」の順に展開します。

3. Webcenter Content Serverインスタンス名(Oracle Webcenter Content - Content Server (UCM_server1)など)を選択します。
WebCenter Content Serverインスタンスのホーム・ページが表示されます。

4. Webcenter Content Serverホームページで、「コンテンツ・サーバー」メニューから、「構成ページ」、「拡張コンポーネント・マネージャ」の順に選択します。

5. 「拡張コンポーネント・マネージャ」ページで、「コンポーネントのインストール」フィールドの横にある「参照」ボタンをクリックします。

6. コンポーネントzipファイルに移動して選択します。

7. 「開く」をクリックします。
「コンポーネントのインストール」フィールドに、パスおよびファイル名が表示されます。

8. 「インストール」をクリックします。
WebCenter Content Serverインスタンスでコンポーネント・ファイルのパッケージが展開され、コンポーネントの名前が「無効なコンポーネント」リストに表示されます。

9. WebCenter Content Serverインスタンスを再起動します。これは、変更を有効にするために必要なステップです。インスタンスを再起動する手順は、第3.2.3項を参照してください。

10. コンポーネントをインストールするのが困難な場合は、メニューの「管理出力の表示」リンクをクリックして、WebCenter Content Serverの出力メッセージを確認します。
サーバー出力ページが開き、最近のアクションを確認できます。

9.3.2.3 Fusion Middleware Controlを使用したコンポーネントのアンインストール

コンポーネントをアンインストールするには:

1. Enterprise Manager Fusion Middleware Controlにログインしたら、ナビゲーション・ツリーで、適切なドメイン名(Content_base_domainなど)を展開します。

2. 「WebCenter」、「コンテンツ」、「コンテンツ・サーバー」の順に展開します。

3. Webcenter Content Serverインスタンス名(Oracle Webcenter Content - Content Server (UCM_server1)など)を選択します。WebCenter Content Serverインスタンスのホーム・ページが表示されます。

4. Webcenter Content Serverホームページで、「コンテンツ・サーバー」メニューから、「構成ページ」、「拡張コンポーネント・マネージャ」の順に選択します。

5. 「拡張コンポーネント・マネージャ」ページで、「コンポーネントのアンインストール」フィールド・メニューからコンポーネントを選択します。

6. 「コンポーネントのアンインストール」フィールドにアンインストールするコンポーネント名が表示された状態で、「アンインストール」をクリックします。

7. WebCenter Content Serverインスタンスを再起動します。これは、変更を有効にするために必要なステップです。インスタンスを再起動する手順は、第3.2.3項を参照してください。

9.3.2.4 Fusion Middleware Controlを使用したコンポーネントのダウンロード

次の要件を満たさないかぎり、コンポーネントをダウンロードできません。

- コンポーネントはMW_HOME/WC_CONTENT_ORACLE_HOME/ucm/idc/system/ディレクトリの外に存在する必要があります。これにより、コンポーネントにパッチがアップロードされている場合を除き、提供されているすべてのコンポーネントが除外されます。コンポーネントに適切な名前のzipファイルがあり、それがコンポーネント・ディレクトリの内側に存在する必要があります。一般に、これはコンポーネントが手動でアップロードまたはインストールされた場合にのみ発生します。

コンポーネントをダウンロードする手順は次のとおりです。

1. Enterprise Manager Fusion Middleware Controlにログインしたら、ナビゲーション・ツリーで、適切なドメイン名(Content_base_domainなど)を展開します。

2. 「WebCenter」、「コンテンツ」、「コンテンツ・サーバー」の順に展開します。

3. Webcenter Content Serverインスタンス名(Oracle Webcenter Content - Content Server (UCM_server1)など)を選択します。
WebCenter Content Serverインスタンスのホーム・ページが表示されます。

4. Webcenter Content Serverホームページで、「コンテンツ・サーバー」メニューから、「構成ページ」、「拡張コンポーネント・マネージャ」の順に選択します。

5. 「拡張コンポーネント・マネージャ」ページで、「コンポーネントのダウンロード」フィールド・メニューからパッケージ化するコンポーネントを選択します。

6. 「ダウンロード」をクリックします。

7. 「ファイルのダウンロード」ウィンドウで、「このファイルをディスクに保存」オプションを選択して「OK」をクリックします。

8. 「別名保存」ウィンドウで、コンポーネントzipファイルを保存するディレクトリに移動します。

9. 必要に応じて、コンポーネントzipファイルの名前を変更します。

10. 「Save」をクリックします。
コンポーネントがコンポーネントzipファイルとして保存されます。

9.3.2.5 Fusion Middleware Controlを使用したコンポーネント構成の変更

インストール後にコンポーネントの構成を変更または更新するには:

注意:
すべてのコンポーネントの構成を変更できるわけではありません。

1. Enterprise Manager Fusion Middleware Controlにログインしたら、ナビゲーション・ツリーで、適切なドメイン名(Content_base_domainなど)を展開します。

2. 「WebCenter」、「コンテンツ」、「コンテンツ・サーバー」の順に展開します。

3. Webcenter Content Serverインスタンス名(Oracle Webcenter Content - Content Server (UCM_server1)など)を選択します。
WebCenter Content Serverインスタンスのホーム・ページが表示されます。

4. Webcenter Content Serverホームページで、「コンテンツ・サーバー」メニューから、「構成ページ」、「拡張コンポーネント・マネージャ」の順に選択します。

5. 「拡張コンポーネント・マネージャ」ページで、「コンポーネント構成の更新」フィールド・メニューからコンポーネント名を選択し、「更新」をクリックします。
コンポーネントの「コンポーネント構成の更新」ウィンドウが開き、コンポーネント固有の各種構成が表示されます。リストされるコンポーネント・パラメータは、コンポーネントのインストール後に編集可能として定義されたパラメータです。

6. コンポーネント構成の変更が終了したら、「OK」をクリックします。Webcenter Content Serverインスタンスを再起動する必要はありません。
コンポーネント構成を更新しない場合は、「取消」をクリックします。

9.4 コマンドラインを使用したコンポーネントの管理

ComponentToolコンポーネントにより、管理者はコマンドラインを使用してコンテンツ・サーバー・インスタンスへのコンポーネントのインストール、有効化および無効化を行うことができます。ComponentToolは、コンテンツ・サーバー・インスタンスとともにインストールされて有効化されます。

コンテンツ・サーバーがデプロイされると、デフォルトでUNIXおよびWindows用のComponentToolランチャがインストールされます。実行可能ファイルは、DomainHome/ucm/cs/bin/ディレクトリにあります。

Windows

ComponentTool.exe

UNIX

ComponentTool

Component Toolは、表9-2に表示されているコマンドをサポートしています。

表9-2 Component Toolのコマンド

タスク

コマンド

コンポーネントのインストール(およびコンポーネントを自動的に有効化)

ComponentTool --install path/component_name

コンポーネントの有効化

ComponentTool --enable component_name

コンポーネントの有効化

ComponentTool --disable component_name

有効化されたコンポーネントの表示

ComponentTool --list-enabled

無効化されたコンポーネントの表示

ComponentTool --list-disabled

すべてのコンポーネントの表示

ComponentTool --list

ComponentToolヘルプへのアクセス

ComponentTool --help

9.5 コンポーネント構成の更新

コンテンツ・サーバーのいくつかのコンポーネントが有効であっても無効であっても、拡張コンポーネント・マネージャまたは「インスタンスの構成」画面を使用して、更新または変更できます。拡張コンポーネント・マネージャには、「コンポーネント構成の更新」フィールドで構成を変更できるコンポーネントのリストが表示されます。インスタンスの構成画面から、選択したコンポーネントの「コンポーネント構成の更新」を開きます。

すべてのコンポーネントで構成設定を変更できるわけではありません。「コンポーネント構成の更新」ページを使用した構成設定の変更がコンポーネントでサポートされていない場合は、メッセージが表示されます。

コンテンツ・サーバーには、次のコンポーネントに対する「コンポーネント構成の更新」ページがあります。

- 第9.5.1項「ContentTrackerコンポーネント構成の更新」

- 第9.5.2項「ContentTrackerReportsコンポーネント構成の更新」

- 第9.5.3項「DesktopIntegrationSuiteコンポーネント構成の更新」

- 第9.5.4項「EmailMetadataコンポーネント構成の更新」

- 第9.5.5項「Folders_gコンポーネント構成の更新」

- 第9.5.6項「OCMコンポーネント構成の更新」

- 第9.5.7項「PDFWatermarkコンポーネント構成の更新」

- 第9.5.8項「SiteStudioコンポーネント構成の更新」

9.5.1 ContentTrackerコンポーネント構成の更新

Content Trackerコンポーネントの構成設定は、コンポーネントが有効化されているか無効化されているかに関係なく、拡張コンポーネント・マネージャまたはインスタンスの構成画面で更新できます。

拡張コンポーネント・マネージャを使用して構成を更新するには:

1. 「コンテンツ・サーバー」トレイまたはメニューから「管理」を選択して、「管理サーバー」→「コンポーネント・マネージャ」の順に選択します。

2. 「コンポーネント・マネージャ」ページで、「拡張コンポーネント・マネージャ」クリックして、「コンポーネント構成の更新」リストから「ContentTracker」を選択します。

3. 「更新」をクリックします。
「コンポーネント構成の更新」ページが表示されます。

4. コンポーネントが有効化されていない場合は、構成するコンポーネントの名前を「無効なコンポーネント」リストから探して、そのコンポーネントの名前を選択してから「有効化」をクリックします。

5. 構成を変更して、「更新」をクリックします。
変更を取り消す場合は、「リセット」をクリックします。

設定内容を元の構成に変更する場合は、「インストール設定に戻る」をクリックします。

6. コンテンツ・サーバー・インスタンスを再起動します。詳細は、3.2.3項を参照してください。

注意:
コンポーネント構成を変更した後は、コンテンツ・サーバー・インスタンスを再起動する必要があります。

要素

説明

コンテンツ・アクセスのみ追跡

選択すると、コンテンツ・アクセスのみの追跡が指定されます。デフォルトでは、チェック・ボックスは選択されています。

アクセス・ログ列を移入しない

移入しないアクセス・ログ列を指定します。

ユーザー・エージェント文字列の簡素化

選択すると、ユーザー・エージェント文字列が簡素化されます。デフォルトでは、チェック・ボックスは選択されています。

データを保持する最大日数

データを保持する最大日数を指定します。デフォルト設定は60です。

期限切れデータをアーカイブしない

選択すると、期限切れデータをアーカイブしないように指定されます。デフォルトでは、チェック・ボックスは選択されています。

URLの最大長を入力してください

URLの最大長(文字数)を入力します。デフォルト設定は3000です。

プロキシ名の最大長を入力してください

プロキシ名の最大長(文字数)を入力します。デフォルト設定は50です。

削減後実行可能ファイル

削減後実行可能ファイルを指定します。デフォルトはありません。

WebビーコンIDリスト

WebビーコンIDのリストを指定します。

9.5.2 ContentTrackerReportsコンポーネント構成の更新

Content Tracker Reportsコンポーネントの構成設定は、コンポーネントが有効化されているか無効化されているかに関係なく、拡張コンポーネント・マネージャまたはインスタンスの構成画面で更新できます。

「拡張コンポーネント・マネージャ」ページを使用して構成設定を変更するには:

1. 「コンテンツ・サーバー」トレイまたはメニューから「管理」を選択して、「管理サーバー」→「コンポーネント・マネージャ」の順に選択します。

2. 「コンポーネント・マネージャ」ページで、「拡張コンポーネント・マネージャ」クリックして、「コンポーネント構成の更新」リストから「ContentTrackerReports」を選択します。

3. 「更新」をクリックします。
「コンポーネント構成の更新」ページが表示されます。

4. コンポーネントが有効化されていない場合は、構成するコンポーネントの名前を「無効なコンポーネント」リストから探して、そのコンポーネントの名前を選択してから「有効化」をクリックします。

5. 構成を変更して、「更新」をクリックします。
変更を取り消す場合は、「リセット」をクリックします。

設定内容を元の構成に変更する場合は、「インストール設定に戻る」をクリックします。

6. コンテンツ・サーバー・インスタンスを再起動します。詳細は、3.2.3項を参照してください。

注意:
コンポーネント構成を変更した後は、コンテンツ・サーバー・インスタンスを再起動する必要があります。

要素

説明

問合せのセキュリティ・チェックの有効化

選択すると、Content Trackerレポートの問合せのセキュリティ・チェックが有効になります。デフォルトでは、このチェック・ボックスは選択されていません。

9.5.3 DesktopIntegrationSuiteコンポーネント構成の更新

DesktopIntegrationSuiteコンポーネントの構成設定は、コンポーネントが有効化されているか無効化されているかに関係なく、拡張コンポーネント・マネージャまたはインスタンスの構成画面で更新できます。DesktopIntegrationSuiteは、コンテンツ管理統合の中心的な機能をサーバーで処理します。

拡張コンポーネント・マネージャを使用して構成設定を更新するには:

1. 「コンテンツ・サーバー」トレイまたはメニューから「管理」を選択して、「管理サーバー」→「コンポーネント・マネージャ」の順に選択します。

2. 「コンポーネント・マネージャ」ページで、「拡張コンポーネント・マネージャ」クリックして、「コンポーネント構成の更新」リストから「DesktopIntegrationSuite」を選択します。

3. 「更新」をクリックします。
「コンポーネント構成の更新」ページが表示されます。

4. コンポーネントが有効化されていない場合は、構成するコンポーネントの名前を「無効なコンポーネント」リストから探して、そのコンポーネントの名前を選択してから「有効化」をクリックします。

5. 構成を変更して、「更新」をクリックします。
変更を取り消す場合は、「リセット」をクリックします。

設定内容を元の構成に変更する場合は、「インストール設定に戻る」をクリックします。

6. コンテンツ・サーバー・インスタンスを再起動します。詳細は、3.2.3項を参照してください。

注意:
コンポーネント構成を変更した後は、コンテンツ・サーバー・インスタンスを再起動する必要があります。

要素

説明

Webブラウザ検索プラグインを有効にする

選択すると、ユーザーはコンテンツ・サーバー・インスタンスのWebブラウザ検索プロバイダを追加できるようになります。これにより、コンテンツ・サーバーWebインタフェースを実行せずに、ブラウザでサーバーの迅速な検索を実行できます。

Webブラウザ検索プラグイン・タイトル

クライアントWebブラウザに表示されるこのコンテンツ・サーバー・インスタンスの検索エンジン名。この名前が企業内で一意であることを確認してください。

チェックイン・ダイアログのコメント・メタデータ・フィールド名

このコンテンツ・サーバー・インスタンスのコメント・メタデータ・フィールドの名前。デフォルトはxCommentsです。

チェックイン・ダイアログのデフォルト・コメント

Microsoft Officeアプリケーションのチェックイン・コメントと「閉じる」ダイアログ・ボックスに表示されるデフォルトのコメント。

チェックイン・ダイアログのコメント・サービス

コンテンツ・サーバーからチェックアウトされるときに、Microsoft Officeドキュメントのデフォルトのチェックイン・コメントを取得するために呼び出すサービス。このフィールドを空にした場合、サービスは呼び出されず、上で指定したデフォルトのコメントが使用されます。前のリビジョンのxComment値をデフォルトのチェックイン・コメントとして使用するにはDOC_INFOと入力します。

チェックイン・ダイアログの最大コメント長

クライアント・コンピュータ上のMicrosoft Officeアプリケーションのチェックイン・ダイアログに表示されるコメントの最大文字数。このフィールドを空白のままにした場合は、メタデータ・フィールドの最大テキスト長によって制限が設定されます。

9.5.4 EmailMetadataコンポーネント構成の更新

EmailMetadataコンポーネントの構成は、コンポーネントが有効化されているか無効化されているかに関係なく、拡張コンポーネント・マネージャまたはインスタンスの構成画面で更新できます。EmailMetadataコンポーネントは、電子メール・メッセージのフィールドを電子メール・メタデータのフィールドにマップします。このコンポーネントは、Microsoft OutlookおよびLotus Notesのコンテンツ・フォルダに電子メールをドラッグ・アンド・ドロップする場合にも必要になります。

たとえば、常にタイトルが件名行になり、ファイル名がメッセージIDまたはUUIDになるようにするには、まず、次の設定を選択解除(falseに設定)します。

- 電子メールの件名行にコンテンツ・アイテム・タイトルを常に設定

- 電子メールの件名行にコンテンツ・アイテム・ファイル名を常に設定

- タイトルがファイル名と同じ場合はファイル名を電子メールの件名行に設定します

その後で、オプションの「タイトルがファイル名と同じ場合はタイトルを電子メールの件名行に設定します」を選択(trueに設定)します。

タイトルとファイル名の両方がメッセージIDまたはUUIDになるようにする場合は、すべてのチェック・ボックスを選択解除(falseに設定)します。

拡張コンポーネント・マネージャを使用して構成を更新するには:

1. 「コンテンツ・サーバー」トレイまたはメニューから「管理」を選択して、「管理サーバー」→「コンポーネント・マネージャ」の順に選択します。

2. 「コンポーネント・マネージャ」ページで、「拡張コンポーネント・マネージャ」クリックして、「コンポーネント構成の更新」リストから「EmailMetadata」を選択します。

3. 「更新」をクリックします。
「コンポーネント構成の更新」ページが表示されます。

4. コンポーネントが有効化されていない場合は、構成するコンポーネントの名前を「無効なコンポーネント」リストから探して、そのコンポーネントの名前を選択してから「有効化」をクリックします。

5. 構成を変更して、「更新」をクリックします。
変更を取り消す場合は、「リセット」をクリックします。

設定内容を元の構成に変更する場合は、「インストール設定に戻る」をクリックします。

6. コンテンツ・サーバー・インスタンスを再起動します。詳細は、3.2.3項を参照してください。

注意:
コンポーネント構成を変更した後は、コンテンツ・サーバー・インスタンスを再起動する必要があります。

要素

説明

電子メール・メタデータ・マッピング・メニューの表示

選択すると、「電子メール・メタデータの構成」メニュー・オプションをコンテンツ・サーバーの管理トレイまたはメニューに表示します。

電子メールの件名行にコンテンツ・アイテム・タイトルを常に設定

選択すると、チェックインしたコンテンツ・アイテムのタイトルが電子メール・メッセージの件名行になります。それ以外の場合、次の構成設定に基づいて件名行が変更されないかぎり、タイトルは電子メール・メッセージID (受信メッセージの場合、ヘッダーから取得)またはUUID (ドラフトまたは送信メッセージの場合)になります。

タイトルがファイル名と同じ場合はタイトルを電子メールの件名行に設定します

選択すると、タイトルがファイル名(ファイル拡張子なし)と同じ場合にタイトルを電子メールの件名行に設定します。それ以外の場合、タイトルは変更されません。

電子メールの件名行にコンテンツ・アイテム・ファイル名を常に設定

選択すると、チェックインしたコンテンツ・アイテムのファイル名が常に電子メール・メッセージの件名行になります。それ以外の場合、次の構成設定に基づいて件名行が変更されないかぎり、ファイル名は電子メール・メッセージID (受信メッセージの場合、ヘッダーから取得)またはUUID (ドラフトまたは送信メッセージの場合)になります。

タイトルがファイル名と同じ場合はファイル名を電子メールの件名行に設定します

選択すると、タイトルがファイル名(ファイル拡張子なし)と同じ場合にファイル名を電子メールの件名行に設定します。それ以外の場合、ファイル名は変更されません。

電子メール・アドレス・セパレータ

複数の受信者に送信されるメッセージ内の電子メール・アドレスを区切る文字。デフォルトはセミコロンです。

Unicode以外の電子メール・メッセージのエンコーディング

Unicode以外の電子メール・メッセージのエンコーディング。デフォルトは、このコンテンツ・サーバー・インスタンスを実行しているシステムのJava Virtual Machineのデフォルトです(ロケールに依存します)。Java仕様の定義に従って、別のエンコーディングを指定することもできます(通常は、US-ASCII、ISO-8859-1またはUTF-8)。

Unicodeの電子メール・メッセージのエンコーディング

Unicodeの電子メール・メッセージのエンコーディング。デフォルトはUTF-16LEです。

9.5.5 Folders_gコンポーネント構成の更新

Folders_gコンポーネントの構成設定は、コンポーネントが有効化されているか無効化されているかに関係なく、拡張コンポーネント・マネージャまたはインスタンスの構成画面で更新できます。ビジネスにおいて設定を変更する必要がないかぎり、デフォルト設定を維持することをお薦めします。

拡張コンポーネント・マネージャを使用して構成を更新するには:

1. 「コンテンツ・サーバー」トレイまたはメニューから「管理」を選択して、「管理サーバー」→「コンポーネント・マネージャ」の順に選択します。

2. 「コンポーネント・マネージャ」ページで、「拡張コンポーネント・マネージャ」クリックして、「コンポーネント構成の更新」リストから「Folders_g」を選択します。

3. 「更新」をクリックします。
「コンポーネント構成の更新」ページが表示されます。

4. コンポーネントが有効化されていない場合は、構成するコンポーネントの名前を「無効なコンポーネント」リストから探して、そのコンポーネントの名前を選択してから「有効化」をクリックします。

注意:
FrameworkFoldersコンポーネントが有効化されている場合は、通常、Folders_gを有効化する必要はありません。詳細は、『Oracle WebCenter Contentのインストールと構成』を参照してください。

5. 構成を変更して、「更新」をクリックします。
変更を取り消す場合は、「リセット」をクリックします。

設定内容を元の構成に変更する場合は、「インストール設定に戻る」をクリックします。

6. コンテンツ・サーバー・インスタンスを再起動します。詳細は、3.2.3項を参照してください。

注意:
コンポーネント構成を変更した後は、コンテンツ・サーバー・インスタンスを再起動する必要があります。

要素

説明

ユーザーが、読取り権限のみを所有するコンテンツ・アイテムのコピーをダウンロードできるようにしますか。

選択すると、GetCopyAccess環境変数が設定されます。デフォルトでは、チェック・ボックスは選択されています。

仮想フォルダまたはコンテンツ・アイテムの表示/非表示をユーザーが指定できるようにする場合は、仮想フォルダまたはコンテンツ・アイテムを表示するか非表示にするかを指定するための情報フィールドの名前を入力します。

CollectionHiddenMeta環境変数を設定します。デフォルト設定はxHiddenです。

仮想フォルダおよびそのコンテンツを読取り専用にするかどうかをユーザーが指定できるようにする場合は、仮想フォルダおよびそのコンテンツが読取り専用であるかどうかを指定するための情報フィールドの名前を入力します。

CollectionReadOnlyMeta環境変数を設定します。デフォルト設定はxReadOnlyです。

ユーザーがフォルダおよびコンテンツ・アイテムを他のフォルダに移動できるようにしますか。

選択すると、CollectionMoveEnabled環境変数が設定されます。デフォルトでは、チェック・ボックスは選択されています。

ユーザーがフォルダおよびコンテンツ・アイテムを削除できるようにしますか。

選択すると、CollectionDeleteEnabled環境変数が設定されます。デフォルトでは、チェック・ボックスは選択されています。

メタデータ伝播関数の禁止フィールドの名前を入力してください

CollectionInhibitUpdateMeta環境変数を設定します。デフォルト設定はxInhibitUpdateです。

フォルダ・コンテンツに対するフォルダ・セキュリティの適用をフォルダ所有者に許可しますか。

選択すると、CollectionForceFolderSecurityEnabled環境変数が設定されます。デフォルトでは、チェック・ボックスは選択されています。

フォルダ・セキュリティの適用を有効化するメタデータ・フィールドの名前を入力します

CollectionForceFolderSecurityMeta環境変数を設定します。デフォルト設定はxForceFolderSecurityです。

オプションのごみ箱設定を設定しますか。

選択すると、SetupTrashBinSettings環境変数が設定されます。デフォルトでは、このチェック・ボックスは選択されていません。詳細は、『Oracle WebCenter Contentのマネージング』を参照してください。

なりすましや再生攻撃を回避するためにWebDAV Cookieの暗号化に使用するキーを指定します。

WebDAVSecretKey環境変数を設定します。デフォルト設定はfoldersWDAVKeyです。WebDAV Cookieを保護するには、デフォルト設定を一意の値に変更する必要があります。このフィールドを変更しないと、なりすましや再生攻撃を受けるリスクがあります。

仮想フォルダ当たりの最大フォルダ数を入力します

環境変数MaxFoldersを設定します。最大許容値は1000です。デフォルト設定は1000です。

仮想フォルダ当たりの最大コンテンツ・アイテム数を入力します

環境変数MaxContentを設定します。最大許容値は1000です。デフォルト設定は1000です。

このサーバーの初期フォルダの識別子を入力します:(百万単位)

InitialFolderID環境変数を設定します。デフォルト設定は空白です。
このフィールドを空白にすると、初期フォルダIDはランダムに選択されます。このフィールドは設定しないことをお薦めします。

9.5.6 OCMコンポーネント構成の更新

OCMコンポーネントの構成設定は、コンポーネントが有効化されているか無効化されているかに関係なく、拡張コンポーネント・マネージャまたはインスタンスの構成画面で更新できます。OCMコンポーネントは、コンテンツ・サーバー・インスタンスで有効化および無効化されているコンポーネントのリストを収集し、構成マネージャにデータを提供します。

拡張コンポーネント・マネージャを使用して構成を更新するには:

1. 「コンテンツ・サーバー」トレイまたはメニューから「管理」を選択して、「管理サーバー」→「コンポーネント・マネージャ」の順に選択します。

2. 「コンポーネント・マネージャ」ページで、「拡張コンポーネント・マネージャ」クリックして、「コンポーネント構成の更新」リストから「OCM」を選択します。

3. 「更新」をクリックします。
「コンポーネント構成の更新」ページが表示されます。

4. コンポーネントが有効化されていない場合は、構成するコンポーネントの名前を「無効なコンポーネント」リストから探して、そのコンポーネントの名前を選択してから「有効化」をクリックします。

5. 構成を変更して、「更新」をクリックします。
変更を取り消す場合は、「リセット」をクリックします。

設定内容を元の構成に変更する場合は、「インストール設定に戻る」をクリックします。

6. コンテンツ・サーバー・インスタンスを再起動します。詳細は、3.2.3項を参照してください。

注意:
コンポーネント構成を変更した後は、コンテンツ・サーバー・インスタンスを再起動する必要があります。

要素

説明

管理者のユーザーID

コンポーネント構成の抽出時に、OCMで使用する管理ユーザーのID。これは、ローカルのコンテンツ・サーバー管理ユーザーにする必要があります。デフォルト: sysadmin

9.5.7 PDFWatermarkコンポーネント構成の更新

PDFWatermarkコンポーネントの構成設定は、コンポーネントが有効化されているか無効化されているかに関係なく、拡張コンポーネント・マネージャまたはインスタンスの構成画面で更新できます。PDFWatermark

拡張コンポーネント・マネージャを使用して構成を更新するには:

1. 「コンテンツ・サーバー」トレイまたはメニューから「管理」を選択して、「管理サーバー」→「コンポーネント・マネージャ」の順に選択します。

2. 「コンポーネント・マネージャ」ページで、「拡張コンポーネント・マネージャ」クリックして、「コンポーネント構成の更新」リストから「PDFWatermark」を選択します。

3. 「更新」をクリックします。
「コンポーネント構成の更新」ページが表示されます。

4. コンポーネントが有効化されていない場合は、構成するコンポーネントの名前を「無効なコンポーネント」リストから探して、そのコンポーネントの名前を選択してから「有効化」をクリックします。

5. 構成を変更して、「更新」をクリックします。
変更を取り消す場合は、「リセット」をクリックします。

設定内容を元の構成に変更する場合は、「インストール設定に戻る」をクリックします。

6. コンテンツ・サーバー・インスタンスを再起動します。詳細は、3.2.3項を参照してください。

注意:
コンポーネント構成を変更した後は、コンテンツ・サーバー・インスタンスを再起動する必要があります。

要素

説明

PDFオプティマイザの使用

選択すると、PDFオプティマイザを使用を指定します。デフォルトでは、このチェック・ボックスは選択されていません。

オプティマイザ・コマンド・ライン・テンプレート

オプティマイザ・コマンド・ライン・テンプレート。

9.5.8 SiteStudioコンポーネント構成の更新

Site Studioコンポーネントの構成設定は、コンポーネントが有効化されているか無効化されているかに関係なく、拡張コンポーネント・マネージャまたはインスタンスの構成画面で更新できます。

拡張コンポーネント・マネージャを使用して構成を更新するには:

1. 「コンテンツ・サーバー」トレイまたはメニューから「管理」を選択して、「管理サーバー」→「コンポーネント・マネージャ」の順に選択します。

2. 「コンポーネント・マネージャ」ページで、「拡張コンポーネント・マネージャ」クリックして、「コンポーネント構成の更新」リストから「SiteStudio」を選択します。

3. 「更新」をクリックします。
「コンポーネント構成の更新」ページが表示されます。

4. コンポーネントが有効化されていない場合は、構成するコンポーネントの名前を「無効なコンポーネント」リストから探して、そのコンポーネントの名前を選択してから「有効化」をクリックします。

5. 構成を変更して、「更新」をクリックします。
変更を取り消す場合は、「リセット」をクリックします。

設定内容を元の構成に変更する場合は、「インストール設定に戻る」をクリックします。

6. コンテンツ・サーバー・インスタンスを再起動します。詳細は、3.2.3項を参照してください。

注意:
コンポーネント構成を変更した後は、コンテンツ・サーバー・インスタンスを再起動する必要があります。

要素

説明

フラグメント・ライブラリ・コンテンツ・タイプ

フラグメント・ライブラリのチェックインに使用するコンテンツ・タイプ。

カスタム要素フォーム・コンテンツ・タイプ

カスタム要素フォームのチェックインに使用するコンテンツ・タイプ。

検証スクリプト・コンテンツ・タイプ

検証スクリプトのチェックインに使用するコンテンツ・タイプ。

Webサイト・オブジェクト・コンテンツ・タイプ

サンプルWebサイト・オブジェクトのチェックインに使用するコンテンツ・タイプ。

カスタム構成スクリプト・コンテンツ・タイプ

カスタム構成スクリプトのチェックインに使用するコンテンツ・タイプ。

初期セクションID

Webサイト・セクションに名前を付けるために使用される初期値。

9.6 コンポーネント・ウィザードを使用したコンポーネントの作成

ここでは、コンポーネント・ウィザードを使用してコンポーネントを作成する方法について説明します。この章の内容は次のとおりです。

- 第9.6.1項「コンポーネント・ウィザードの概要」

- 第9.6.2項「Javaコードの使用」

- 第9.6.3項「Readmeファイルの編集」

- 第9.6.4項「コンポーネント・ウィザードを使用したコンポーネントの作成」

- 第9.6.5項「コンポーネント・ウィザードの追加タスク」

注意:
Red Hat Linux ES 3でコンポーネント・ウィザードを使用している場合、DomainHome/ucm/cs/bin/intradoc.cfgファイルでUseCustomModaling=FALSEを設定してください。この変数により、モーダル・ダイアログで、すべてのフレームではなく1つのフレームのみをロックできます。この変数をintradoc.cfgファイルで設定することで、他のアプレットがこのアクションの影響を受けることがなくなります。使用方法の詳細は、『Oracle WebCenter Content構成リファレンス』を参照してください。

9.6.1 コンポーネント・ウィザードの概要

次の手順は、コンポーネント・ウィザードを使用してカスタム・コンポーネントを作成する方法の概要を示しています。

1. 次のようにコンポーネント・ウィザードを起動します。

- (Windows)「スタート」メニューから、「プログラム」→「コンテンツ・サーバー」→instance_name→「ツール」→「コンポーネント・ウィザード」を選択します。

- (UNIX) DomainHome/ucm/cs/bin/ディレクトリに移動して、コンポーネント・ウィザード・プログラムの./ComponentWizardを実行します。

2. すでに別のコンポーネントが選択可能な場合は、「コンポーネント・リスト」ウィンドウが開きます。「追加」を選択します。

図9-1 コンポーネント・リスト

別のコンポーネントが選択できない場合は、コンポーネント・ウィザードのメイン・ウィンドウが開きます。「オプション」を選択して、「追加」をクリックします。

図9-2 コンポーネント・ウィザード

3. 「コンポーネントの追加」ウィンドウで、「新規コンポーネントの作成」オプションが選択されていることを確認し、新規コンポーネントの名前を入力します。

図9-3 コンポーネントの追加

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

5. 確認ウィンドウで、「OK」をクリックします。
新規コンポーネントがコンポーネント・ウィザードのウィンドウに表示されます(「場所」フィールドに、コンポーネントの名前が示されます)。

9.6.2 Javaコードの使用

新規コンポーネントにJavaコードが含まれる場合、「コンポーネント・ウィザード」の「Javaコード」タブを使用してClassAliases表とFilters表のコンテンツを表示できます。

コンポーネントglueファイルからクラスとフィルタを削除することもできます。ただし、クラスまたはフィルタに関連付けられているファイルは、システムから削除されません。クラスまたはフィルタを選択し、それに関連付けられた「アンインストール」ボタンをクリックしてリストから削除します。

9.6.3 Readmeファイルの編集

コンポーネント・ウィザードには、カスタム・コンポーネントのReadmeファイルを作成する便利な方法が用意されています。

Readmeファイルを編集するには、次の手順を実行します。

1. コンポーネント・ウィザードでコンポーネントを開きます。

2. 「オプション」→「Readmeファイルの編集」を選択します。
テキスト・エディタに、最初の行にコンポーネント名が入力されたreadme.txtファイルが開きます。

3. コンポーネントを説明するテキストを入力します。

4. ファイルを保存して閉じます。
readme.txtファイルは、コンポーネント定義ファイルと同じディレクトリに保存されます。また、コンポーネント・ウィザードを使用してコンポーネントのzipファイルを作成すると、このファイルはComponentExtraエントリとして含められます。

9.6.4 コンポーネント・ウィザードを使用したコンポーネントの作成

コンポーネント・ウィザードを使用してコンポーネントを作成するには、次の手順を実行します。

1. コンポーネント・ウィザードを起動します。

- (Windows)「スタート」メニューから、「プログラム」→「コンテンツ・サーバー」→instance_name→「ツール」→「コンポーネント・ウィザード」を選択します。

- (UNIX) DomainHome/ucm/cs/bin/ディレクトリに移動して、コンポーネント・ウィザード・プログラムの./ComponentWizardを実行します。

詳細は、第3.5.2項を参照してください。

2. コンポーネント・ウィザードのメイン・ウィンドウが開くか、または他のコンポーネントがすでに使用可能である場合は「コンポーネント・リスト」ウィンドウが開きます。「コンポーネント・リスト」ウィンドウには、インストールされているコンポーネントとそのステータス(有効または無効)が示されます。

注意:
インストールされているコンポーネントがない場合、「コンポーネント・リスト」ウィンドウは表示されません。

3. 「コンポーネント・リスト」ウィンドウが開いたら、「追加」を選択します。
コンポーネント・ウィザードのメイン・ウィンドウが開いたら、「オプション」→「追加」を選択します。

4. 「コンポーネントの追加」ウィンドウの「名前」フィールドに、新規コンポーネントの名前を入力します。

5. デフォルト・ディレクトリ(custom/)をそのまま使用するか、コンポーネントの新しい場所を入力します。絶対パス、またはコンテンツ・サーバーのインストール・ディレクトリへの相対パスを指定できます。一般的に、カスタム・コンポーネントはカスタム・ディレクトリに保存されます。

6. 既存のコンポーネント定義ファイルを基にして新規コンポーネントを作成するには、「既存のものをコピー」を選択し、「参照」をクリックして、既存の定義(glue)ファイル(component_name.hda)に移動して選択します。
新しいコンポーネントは、すべてのリソースと他のコンポーネント・ファイルを含め、既存のコンポーネントのコピーとなります。新しいコンポーネントは一意の名前である必要があります。

「既存のものをコピー」を選択しない場合、新しいコンポーネントは、リソース・ファイルが1つも含まれないまま作成されます。

7. 「OK」をクリックします。
新規コンポーネント定義(glue)ファイルが作成されます。既存のコンポーネントをコピーした場合、リソース・ファイルの名前が新規コンポーネント名に変更され、新規コンポーネントに直接コピーされます。

8. 必要に応じて、次の項の説明に従って、カスタム・リソースおよび他のファイルを追加および編集します。

- 第9.6.4.1項「新規コンポーネントの環境リソースの作成」

- 第9.6.4.2項「テンプレート・リソースの作成」

- 第9.6.4.3項「問合せリソースの作成」

- 第9.6.4.4項「サービス・リソースの作成」

- 第9.6.4.5項「HTMLインクルードの作成」

- 第9.6.4.6項「文字列リソースの作成」

- 第9.6.4.7項「動的表リソースの作成」

- 第9.6.4.8項「静的表リソースの作成」

9.6.4.1 新規コンポーネントの環境リソースの作成

環境リソースは、新規変数を作成するか既存の変数の値を置換して、構成変数を定義します。

環境リソースを作成するには、次の手順を実行します。

1. コンポーネント・ウィザードのメイン・ウィンドウで、「リソースの定義」タブが選択されていることを確認し、「追加」をクリックします。

2. 「リソースを追加します。」ウィンドウで、追加するリソースのタイプの「環境」オプションを選択します。

3. リソース・ファイルのファイル名を入力します。デフォルトのファイル名は、componentname_templates.hdaです。

- リソース・ファイルが作成されている場合、ファイル名を選択してファイルに追加できます。ロード順に変更を加えた場合は、リソース・ファイル全体に適用されます。

- 別のファイル名で新規リソース・ファイルを作成するには、ファイル名を入力します。

4. 新規リソース・ファイルを特定の順序でロードする場合は、「ロード順」フィールドに数値を入力します。

注意:
リソース・ファイルを他のリソースの後にロードする特別な理由がある場合を除き、ロード順は1に設定されたままにしてください。

5. 「終了」をクリックします。
テキスト・エディタを起動して編集を続行するかどうかを尋ねるプロンプトが表示されます。

6. 「Yes」をクリックして、リソース・ファイルをテキスト・エディタで開きます(または、「いいえ」をクリックして、コンポーネント・ウィザードに戻ります)。
ファイルが「カスタム・リソース定義」リストに表示されます。

注意:
HTMLエディタが定義されていない場合、コンポーネント・ウィザードで「オプション」→「構成」を選択して必要なエディタのパスとファイル名を入力するか、「参照」をクリックして必要なエディタの実行可能ファイルに移動します。詳細は、第9.6.5.6項を参照してください。

7. テキスト・エディタでファイルを保存します。
コンポーネント・ウィザード・ウィンドウに、新しい環境リソースが表示されます。

9.6.4.2 テンプレート・リソースの作成

テンプレート・リソース・ファイルは、コンポーネント用にロードされるカスタム・テンプレートの名前、タイプおよび場所を定義します。テンプレート・ページを追加するには、次の手順を実行します。

1. コンポーネント・ウィザードのメイン・ウィンドウで、「リソースの定義」タブが選択されていることを確認し、「追加」をクリックします。

2. 「リソースを追加します。」ウィンドウで、「テンプレート」オプションを選択します。

3. 「リソースを追加します。」ウィンドウで、リソース・ファイルのファイル名を入力します。デフォルトのファイル名は、componentname_templates.hdaです。

- ファイル名の前にtemplates/を入力すると、コンポーネント・ディレクトリに新規のtemplatesディレクトリを作成できます。

- テンプレート・リソース・ファイルが作成されている場合、ファイル名を選択して、既存のファイルに新規テンプレート表を追加できます。ロード順に変更を加えた場合は、リソース・ファイル全体に適用されます。

- 別のファイル名で新規リソース・ファイルを作成するには、ファイル名を入力します。

4. 新規リソース・ファイルを特定の順序でロードする場合は、「ロード順」フィールドに数値を入力します。

注意:
リソース・ファイルを他のリソースの後にロードする特別な理由がある場合を除き、ロード順は1に設定されたままにしてください。

5. 「次へ」をクリックします。

6. 「テンプレート表情報を追加します。」ウィンドウで、コンポーネントで使用されるテンプレート用に、アクセスする表の名前を入力します。

- コンポーネント名を接頭辞として残すことをお薦めします。

- テンプレート表が別のリソース・ファイルにある場合であっても、コンポーネントの各テンプレート表には、一意の名前を付ける必要があります。

7. 新規テンプレート表のマージ先の標準表を選択します。

- IntradocTemplates

- SearchResultTemplates

8. 「次へ」をクリックします。

9. 「Intradocテンプレートの追加/編集」ウィンドウで、既存のテンプレート定義を使用する手順は次のとおりです。

1. 「選択」をクリックします。
「リソース選択ダイアログ」ウィンドウが開き、定義済のテンプレートが表示されます。

2. 事前定義テンプレートのリスト全体を表示するには、「すべて表示」を選択します。

3. リストからテンプレートを選択します。
新規のテンプレート・リソースは、既存のテンプレートがコピーされたものになります。

4. 「OK」をクリックします。
テンプレート・パラメータが入力されます。

注意:
既存のカスタム・テンプレート・ファイルを基にして作成することもできます。「コピー元」を選択し、「参照」をクリックして、テンプレート・ファイルに移動して選択します。テンプレート・パラメータは自動的に入力されませんが、テンプレート・ファイルを選択する前に、フィールドに入力する標準テンプレートを選択できます。

10. 必要に応じて、テンプレート・パラメータを編集します。

注意:
テンプレートの名前を変更しない場合、このコンポーネントを最後にロードすると、カスタム・テンプレートにより標準テンプレートおよび同じ名前の他のカスタム・テンプレートがオーバーライドされます。

11. 「終了」をクリックします。
テキスト・エディタを起動して編集を続行するかどうかを尋ねるプロンプトが表示されます。

12. 「Yes」をクリックして、リソース・ファイルをテキスト・エディタで開きます(または、「いいえ」をクリックして、コンポーネント・ウィザードに戻ります)。
ファイルが「カスタム・リソース定義」リストに表示され、テンプレート表が右ペインの「表名」リストに表示されます。

注意:
リソースの最低限の指定が定義されていない場合、この機能は使用できません。

9.6.4.3 問合せリソースの作成

問合せリソースは、データベース内の情報を管理するSQL問合せを定義します。問合せをサービスで使用して、データベースに対するデータの追加、削除または取得などのタスクを実行します。

問合せを追加するには、次の手順を実行します。

1. コンポーネント・ウィザードのメイン・ページで、「リソース定義の追加」ペインをクリックします。

2. 「リソースを追加します。」ウィンドウで、「問合せ」オプションを選択します。

3. リソース・ファイルのファイル名を入力します。デフォルトのファイル名は、resources/componentname_query.htmです。

- 問合せリソース・ファイルがデフォルトのファイル名で作成されている場合、新規のデフォルト・ファイル名に数値(1、2など)が追加されます。リソース・ファイルを手動で編集する場合を除き、問合せ表を既存のデフォルト・ファイルに追加することはできません。

- 問合せリソース・ファイルがデフォルト以外のファイル名で作成されている場合、新規の問合せ表を既存のファイルに追加できます。

- 別のファイル名で新規リソース・ファイルを作成するには、ファイル名を入力します。

4. 新規リソース・ファイルを特定の順序でロードする場合は、「ロード順」フィールドに数値を入力します。

注意:
リソース・ファイルを他のリソースの後にロードする特別な理由がある場合を除き、ロード順は1に設定されたままにしてください。

5. 「次へ」をクリックします。

6. 「問合せ表情報の追加」ウィンドウで、問合せ表の名前を入力します。コンポーネント名を接頭辞として残すことをお薦めします。デフォルトでは、コンポーネント、アンダースコア、文字列Queriesがこの順に連結された値となります。
既存の問合せリソース・ファイルに追加する場合、新しい表名を入力する必要があります。リソース・ファイルを手動で編集する場合を除き、問合せ定義を既存の表に追加することはできません。

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

8. 「問合せの追加/編集」ウィンドウで、既存の問合せ定義を使用する手順は次のとおりです。

1. 「選択」をクリックします。
リソース選択ダイアログが開き、定義済の問合せが表示されます。

2. リストから問合せを選択します。

3. 「OK」をクリックします。
SQL問合せ式とパラメータが表示され、「名前」フィールドに入力されます。

注意:
問合せの名前を変更しない場合、このコンポーネントを最後にロードすると、カスタム問合せにより標準問合せおよび同じ名前の他のカスタム問合せがオーバーライドされます。

9. 必要に応じて、問合せ式とパラメータを編集します。

- パラメータは、問合せ式に表示される順序で「パラメータ」リストに表示される必要があります。「上へ」および「下へ」ボタンを使用して、選択したパラメータを移動します。

- パラメータを追加する場合は、「追加」をクリックします。パラメータ名を入力し、パラメータ・タイプを選択して、「OK」をクリックします。

- パラメータ・タイプを編集する場合は、パラメータを選択して「編集」をクリックします。パラメータ・タイプを選択して、「OK」をクリックします。

- パラメータを削除する場合は、パラメータを選択して「削除」をクリックします。

10. 「終了」をクリックします。
テキスト・エディタを起動して編集を続行するかどうかを尋ねるプロンプトが表示されます。

注意:
リソースの最低限の指定が定義されていない場合、この機能は使用できません。

11. 「Yes」をクリックして、リソース・ファイルをテキスト・エディタで開きます(または、「いいえ」をクリックして、コンポーネント・ウィザードに戻ります)。
問合せリソース・ファイルが「カスタム・リソース定義」リストに表示され、問合せ表が右ペインの「表名」リストに表示されます。

9.6.4.4 サービス・リソースの作成

サービス・リソースは、コンテンツ・サーバー・インスタンスで実行される関数またはプロシージャを定義します。コンポーネント・ウィザードを使用してサービス・リソースを作成するには、次の手順を実行します。

1. コンポーネント・ウィザードで、リソースを作成するコンポーネントを開きます。

2. 「リソースの定義」タブで、「追加」をクリックします。

3. 「リソースを追加します。」ウィンドウで、「サービス」オプションを選択します。

4. リソース・ファイルのファイル名を入力します。デフォルトのファイル名は、resources/componentname_service.htmです。

- サービスにリソース・ファイルが作成されている場合、ファイル名を選択して、新規のサービス表を既存のファイルに追加できます。ロード順に変更を加えた場合は、リソース・ファイル全体に適用されます。

- 別のファイル名で新規リソース・ファイルを作成するには、ファイル名を入力します。

5. 新規リソース・ファイルを特定の順序でロードする場合は、「ロード順」フィールドに数値を入力します。

注意:
リソース・ファイルを他のリソースの後にロードする特別な理由がある場合を除き、ロード順は1に設定されたままにしてください。

6. 「次へ」をクリックします。

7. 「サービス表情報の追加」ウィンドウで、新規リソース用に作成されるサービス表の名前を入力します。

- コンポーネント名を接頭辞として残すことをお薦めします。

- デフォルトでは、コンポーネント名、アンダースコア、文字列Servicesがこの順に連結された値となります。

- サービス表が別のリソース・ファイルにある場合であっても、コンポーネントの各サービス表には、一意の名前を付ける必要があります。

8. 「次へ」をクリックします。

9. 「サービスの追加」ウィンドウで、既存のサービス定義を使用する手順は次のとおりです。

1. 「選択」をクリックします。
「リソース選択」ウィンドウが開き、一般的に使用される定義済のサービスが表示されます。

2. 事前定義サービスのリスト全体を表示するには、「すべて表示」を選択します。

3. リストからサービスを選択します。

4. サービスの詳細を表示するには、「プレビュー」をクリックします。
サービスの情報をプレビュー・ウィンドウで、サービスおよびサービスのアクションに関する情報を確認します。

5. 「OK」をクリックします。
サービスの属性とアクションが入力されます。

注意:
サービスの名前を変更しない場合、このコンポーネントを最後にロードすると、カスタム・サービスにより標準サービスおよび同じ名前の他のカスタム・サービスがオーバーライドされます。

10. 必要に応じて、サービスの属性とアクションを編集します。
属性には、サービス・クラス、テンプレート、サービス・タイプ、アクセス・レベル、通知サブジェクト、エラー・メッセージなどが含まれます。

アクションは、SQL文の実行、問合せの実行、コードの実行、問合せの結果のキャッシュまたはオプション・リストのロードを行うために使用されます。

- アクションは、実行順に「アクション」リストに表示される必要があります。「上へ」および「下へ」ボタンを使用して、選択したアクションを移動します。

- アクションを追加する場合は、「追加」をクリックします。「アクションの追加」ウィンドウが開きます。アクション定義を入力して、「OK」をクリックします。

- アクションを編集する場合は、アクションを選択して「編集」をクリックします。アクション定義を変更して、「OK」をクリックします。

- アクションを削除する場合は、アクションを選択して「削除」をクリックします。

11. 「終了」をクリックします。
テキスト・エディタを起動して編集を続行するかどうかを尋ねるプロンプトが表示されます。

注意:
リソースの最低限の指定が定義されていない場合、この機能は使用できません。

12. 「Yes」をクリックして、リソース・ファイルをテキスト・エディタで開きます(または、「いいえ」をクリックして、コンポーネント・ウィザードに戻ります)。
サービス・リソース・ファイルが「カスタム・リソース定義」リストに表示され、サービス表が右ペインの「表名」リストに表示されます。

9.6.4.5 HTMLインクルードの作成

HTMLインクルードは、他のファイルのプレースホルダまたは同一ファイル内の他の場所から参照されている、再利用可能なコードです。インクルード・リソースは、コンテンツ・サーバーWebページの作成に使用されるコードを定義します。インクルードは、Webページが収集されるたびにコンテンツ・サーバー・インスタンスによって解決されます。このため、インクルードは動的コンテンツ・リソースとも呼ばれます。

HTMLインクルード・リソースを追加するには、次の手順を実行します。

1. コンポーネント・ウィザードのメイン・ウィンドウの「リソースの定義」タブで、「追加」をクリックします。

2. 「リソースを追加します。」ウィンドウで、「リソース - HTMLインクルード/文字列」オプションを選択します。

3. リソース・ファイルのファイル名を入力します。デフォルト名は、componentname_resource.htmです。

- インクルード、文字列または静的表、またはその両方にリソース・ファイルが作成されている場合、ファイル名を選択して、インクルードを既存のファイルに追加できます。ロード順に変更を加えた場合は、リソース・ファイル全体に適用されます。

- 別のファイル名で新規リソース・ファイルを作成するには、ファイル名を入力します。

4. 新規リソース・ファイルを特定の順序でロードする場合は、「ロード順」フィールドに数値を入力します。

注意:
リソース・ファイルを他のリソースの後にロードする特別な理由がある場合を除き、ロード順は1に設定されたままにしてください。

5. 「次へ」をクリックします。

6. 「HTMLリソース・インクルード/文字列の追加」ウィンドウで、カスタマイズしたHTMLリソースまたはカスタマイズした文字列リソースをコンポーネントに指定するには、「インクルード」オプションを選択します。

7. 既存のHTMLインクルードからコードを開始する手順:

1. 「選択」をクリックします。
「リソース選択」ウィンドウが開き、一般的に使用される定義済のインクルードが表示されます。

2. 事前定義インクルードのリスト全体を表示するには、「すべて表示」を選択します。

3. リストからインクルードを選択します。

4. 「OK」をクリックします。
インクルード・コードが表示され、「名前」フィールドに入力されます。

注意:
インクルードの名前を変更しない場合、このコンポーネントを最後にロードすると、カスタム・インクルードにより標準インクルードおよび同じ名前の他のカスタム・インクルードがオーバーライドされます。

8. 必要に応じて、インクルード・コードを編集します。

9. 「終了」をクリックします。
テキスト・エディタを起動して編集を続行するかどうかを尋ねるプロンプトが表示されます。

10. 「Yes」をクリックして、リソース・ファイルをテキスト・エディタで開きます(または、「いいえ」をクリックして、コンポーネント・ウィザードに戻ります)。
リソース・ファイルが「カスタム・リソース定義」リストに表示され、インクルードが「カスタムHTMLインクルード」リストに表示されます。

9.6.4.6 文字列リソースの作成

文字列リソースは、エラー・メッセージおよびコンテンツ・サーバーWebページとアプレットで使用される、ロケールに依存するテキスト文字列を定義します。コンポーネント・ウィザードを使用して文字列リソースを作成するには、次の手順を実行します。

1. コンポーネント・ウィザードで、リソースを作成するコンポーネントを開きます。

2. 「リソースの定義」タブで、「追加」をクリックします。

3. 「リソースを追加します。」ウィンドウで、「リソース - HTMLインクルード/文字列」オプションを選択します。

4. リソース・ファイルのファイル名を入力します。デフォルト名は、componentname_resource.htmです。

- インクルード、文字列または静的表、またはその両方にリソース・ファイルが作成されている場合、ファイル名を選択して、インクルードを既存のファイルに追加できます。ロード順に変更を加えた場合は、リソース・ファイル全体に適用されます。

- 別のファイル名で新規リソース・ファイルを作成するには、ファイル名を入力します。

5. 新規リソース・ファイルを特定の順序でロードする場合は、「ロード順」フィールドに数値を入力します。

注意:
リソース・ファイルを他のリソースの後にロードする特別な理由がある場合を除き、ロード順は1に設定されたままにしてください。

6. 「次へ」をクリックします。

7. 「HTMLリソース・インクルード/文字列の追加」ウィンドウで、カスタマイズしたHTMLリソースまたはカスタマイズした文字列リソースをコンポーネントに指定するには、「文字列」オプションを選択します。

8. 「名前」フィールドに文字列の名前を入力します(myStringなど)。

注意:
既存の文字列の名前を入力する場合、このコンポーネントを最後にロードすると、カスタム文字列により標準文字列および同じ名前の他のカスタム文字列がオーバーライドされます。

9. 必要に応じて文字列コードを編集します(This is my string textなど)。

10. 「終了」をクリックします。
テキスト・エディタを起動して編集を続行するかどうかを尋ねるプロンプトが表示されます。

11. 「Yes」をクリックして、リソース・ファイルをテキスト・エディタで開きます(または、「いいえ」をクリックして、コンポーネント・ウィザードに戻ります)。
リソース・ファイルが「カスタム・リソース定義」リストに表示され、文字列が「カスタム文字列」リストに表示されます。

9.6.4.7 動的表リソースの作成

動的表は、コンテンツ・サーバー・インスタンスに動的な(頻繁に変更される)コンテンツを表形式で提供します。

コンポーネント・ウィザードを使用して動的表リソースを作成するには、次の手順を実行します。

1. コンポーネント・ウィザードで、リソースを作成するコンポーネントを開きます。

2. 「リソースの定義」タブで、「追加」をクリックします。

3. 「リソースを追加します。」ウィンドウで、「リソース - 動的表 (Hdaフォーマット)」オプションを選択します。

4. リソース・ファイルのファイル名を入力します。デフォルトのパスおよびファイル名はresources/componentname_resource.hdaです。

- 動的表にリソース・ファイルが作成されている場合、ファイル名を選択して、新規の表コードを既存のファイルに追加できます。ロード順に変更を加えた場合は、リソース・ファイル全体に適用されます。

- 別のファイル名で新規リソース・ファイルを作成するには、ファイル名を入力します。

5. 新規リソース・ファイルを特定の順序でロードする場合は、「ロード順」フィールドに数値を入力します。

注意:
リソース・ファイルを他のリソースの後にロードする特別な理由がある場合を除き、ロード順は1に設定されたままにしてください。

6. 「次へ」をクリックします。

7. 「動的リソース情報表の追加」で、動的表の名前を入力します。コンポーネント名を接頭辞として残すことをお薦めします。

8. 新規の表を既存の表とマージする場合は、「マージ先」を選択し、リストからターゲットの表を選択するか、カスタム表の名前を入力します。

9. 「終了」をクリックします。

- マージ先の表を選択した場合、テキスト・エディタを起動して編集を続行するかどうか尋ねるプロンプトが表示されます。

- マージ先の表を選択しなかった場合は、「列情報」ウィンドウが開きます。

1. 「列名」フィールドに列名を入力します。

2. 「挿入」をクリックします。すべての表の列が入力されるまで、この手順を繰り返します。

3. 「OK」をクリックします。
テキスト・エディタを起動して編集を続行するかどうかを尋ねるプロンプトが表示されます。

4. 「Yes」をクリックして、リソース・ファイルをテキスト・エディタで開きます(または、「いいえ」をクリックして、コンポーネント・ウィザードに戻ります)。
リソース・ファイルが「カスタム・リソース定義」リストに表示され、表が「リソースの定義」タブの右ペインに表示されます。

9.6.4.8 静的表リソースの作成

コンポーネント・ウィザードを使用して静的表リソースを作成するには、次の手順を実行します。

1. コンポーネント・ウィザードで、リソースを作成するコンポーネントを開きます。

2. 「リソースの定義」タブで、「追加」をクリックします。

3. 「リソースを追加します。」ウィンドウで、「リソース - 静的表 (HTMLフォーマット)」オプションを選択します。

4. リソース・ファイルのファイル名を入力します。デフォルト名は、componentname_resource.htmです。

- 静的表、インクルードまたは文字列またはその両方にリソース・ファイルが作成されている場合、ファイル名を選択して、静的表コードを既存のファイルに追加できます。ロード順に変更を加えた場合は、リソース・ファイル全体に適用されます。

- 別のファイル名で新規リソース・ファイルを作成するには、ファイル名を入力します。

5. 新規リソース・ファイルを特定の順序でロードする場合は、「ロード順」フィールドに数値を入力します。

注意:
リソース・ファイルを他のリソースの後にロードする特別な理由がある場合を除き、ロード順は1に設定されたままにしてください。

6. 「次へ」をクリックします。

7. 「静的リソース表情報の追加」ウィンドウで、静的表の名前を入力します。コンポーネント名を接頭辞として残すことをお薦めします。

8. 新規の表を既存の表とマージする場合は、「マージ先」を選択し、リストから表を選択します。

9. 「終了」をクリックします。

- マージ先の表を選択した場合、テキスト・エディタを起動して編集を続行するかどうか尋ねるダイアログ・ボックスが表示されます。

- マージ先の表を選択しなかった場合は、「列情報」ウィンドウが開きます。

1. 「列名」フィールドに列名を入力します。

2. 「挿入」をクリックします。

3. すべての表の列が入力されるまで、手順aとbを繰り返します。

4. 「OK」をクリックします。
テキスト・エディタを起動して編集を続行するかどうかを尋ねるプロンプトが表示されます。

5. 「Yes」をクリックして、リソース・ファイルをテキスト・エディタで開きます(または、「いいえ」をクリックして、コンポーネント・ウィザードに戻ります)。
リソース・ファイルが「カスタム・リソース定義」リストに表示され、表が「リソース表」リストに表示されます。

9.6.4.9 コンポーネントの有効化

コンポーネントを作成したら、有効化してテストする必要があります。

1. コンポーネント・ウィザードのメイン・ウィンドウで、「オプション」→「有効化」を選択します。

2. コンテンツ・サーバー・インスタンスを再起動します。

3. 新しく作成したコンポーネントをテストします。

9.6.5 コンポーネント・ウィザードの追加タスク

カスタム・コンポーネントの作成のほかに、コンポーネント・ウィザードを使用してコンポーネントのzipファイルをビルドし、カスタム・インストール・パラメータを作成できます。

- 第9.6.5.1項「コンポーネントZipファイルのビルド」

- 第9.6.5.2項「インストール・パラメータの使用」

- 第9.6.5.3項「コンポーネントの有効化と無効化」

- 第9.6.5.4項「コンポーネントの削除」

- 第9.6.5.5項「コンポーネントを開く」

- 第9.6.5.6項「デフォルトHTMLエディタの構成」

- 第9.6.5.7項「コンポーネントのパッケージの展開」

- 第9.6.5.8項「パッケージ展開済のコンポーネントの追加」

9.6.5.1 コンポーネントZipファイルのビルド

コンポーネント・ウィザードのビルド機能により、コンポーネントzipファイルをビルド(またはパッケージ)し、バックアップとして保存またはパッケージを展開して、コンポーネントを他のコンテンツ・サーバー・インスタンスにデプロイできます。

コンポーネントzipファイルを作成するには、次の手順を実行します。

1. コンポーネント・ウィザードでコンポーネントを開きます。

2. 「ビルド」メニューから、「ビルドの設定」を選択します。
定義(glue)ファイル用のComponentエントリとreadme.txtファイル用のComponentExtraエントリが自動的に作成されます。glueファイル・エントリは削除できませんが、readme.txtエントリは削除できます。

3. 「ビルドの設定」ウィンドウで、「追加」をクリックします。

4. 「追加」ウィンドウで、エントリ・タイプを選択します。

5. 「サブディレクトリまたはファイル」フィールドに、選択したエントリ・タイプのファイルの場所を入力します。

- 「コンポーネント」エントリ・タイプの場合、この設定はglueファイルのファイル名です。

- 他のエントリ・タイプの場合、パスを入力して特定ディレクトリのすべてのファイルを選択するか、パスとファイル名を入力して個別ファイルを選択します。

- 場所は、DomainHome/custom/ディレクトリからの相対パスを指定する必要があります。絶対パス(C:/DomainHome/custom/my_component/など)も使用できますが、その場合、コンポーネントは同じインストール・ディレクトリ・パスのコンテンツ・サーバー・インスタンス上にしかインストールできません。

注意:
パスでは、必ずスラッシュを使用してください。

6. コンポーネントのすべてのファイルを含めるまで、エントリ・タイプの追加、およびサブディレクトリの指定を続けます。

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

8. 「ビルド」メニューから、「ビルド」を選択します。

9. メインの「ビルド」ウィンドウで、「OK」をクリックします。
コンポーネント・ウィザードにより、DomainHome/custom/component_nameディレクトリにコンポーネントzipファイルがビルドされます。

9.6.5.2 インストール・パラメータの使用

「インストール/アンインストール設定」タブは、プリファレンス・データ・パラメータを含めることができる、カスタマイズ・インストール・コンポーネントを作成するために使用します。これらのパラメータは、ユーザー・プロンプトおよびユーザー・メッセージにすることができます。どのように定義されているかによって、インストール・プロセス時に表示されるプロンプトやメッセージは異なります。これらのカスタム・インストール・パラメータにより、コンポーネント作成者はコンポーネントをインストールする前に、ユーザーに情報を尋ねることができます。

コンポーネントのカスタム・インストール・パラメータを定義する手順:

1. 「コンポーネント・リスト」ウィンドウで、カスタム・インストール・パラメータを定義するコンポーネントを選択します。

2. 「開く」をクリックします。

3. 「プリファレンスの追加」ウィンドウで、「インストール/アンインストール設定」タブを選択して、該当するチェック・ボックスを選択します。

- インストール/アンインストール・フィルタの保持

- インストール文字列の保持

一般に、両方のオプションを使用して、必要なインストール・パラメータを作成します。

4. インストール/アンインストール・フィルタ・オプションの「エディタの起動」をクリックして、Javaコード・テンプレート・ファイルを開きます。既存のコードを編集して、フィルタの作成手順に必要な追加のJavaコードをテンプレートに含めます。
コンポーネントのインストールまたはアンインストール手順で、各フィルタ手順が1回実行されます。ユーザー・レスポンスの値が、インストール構成(install.cfgおよびconfig.cfg)ファイルに保存されます。詳細は、『Oracle WebLogic Server WebLogic Webサービスの保護』を参照してください。

5. インストール/アンインストール・フィルタJavaコード・ファイルを保存して閉じます。

6. 「プリファレンス・データ設定」ペインで、「追加」ボタンをクリックして、「プリファレンスの追加」ウィンドウを開きます。

7. インストール文字列オプションの「エディタの起動」をクリックして、Javaコード・テンプレート・ファイルを開きます。既存のコードを編集して、設定プロンプトまたはメッセージの定義に必要な追加のJavaコードをテンプレートに含めます。
「プリファレンスの追加」ウィンドウとインストール文字列HTMLテンプレートの両方を開いたままにして、同時に使用します。必要に応じて、「プリファレンスの追加」ウィンドウのフィールドに値を入力します。実際のメッセージまたはプロンプト・テキストを、インストール文字列HTMLに追加します。

8. インストール文字列Javaコード・ファイルを保存して閉じます。

9. 「ビルド」メニューから「ビルドの設定」を選択して、「ビルドの設定」ウィンドウを開きます。

10. 必要に応じて、「ビルドの設定」ウィンドウのフィールドに値を入力します。

11. コンポーネントをコンポーネントzipファイルに含めるように指定されている場合、「追加」ウィンドウでコンポーネントの追加として追加する必要があります。「追加」ボタンをクリックして、「追加」ウィンドウを開きます。
各コンポーネントを個別に追加します。

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

13. 必要に応じて、さらにコンポーネントをコンポーネントの追加としてzipファイルに追加します。

14. 「ビルドの設定」ウィンドウで、「OK」をクリックしてコンポーネントzipファイルを作成します。

zipファイルはクライアントに送信したり、コンテンツ・サーバー・インスタンス内でコンポーネント・ウィザードまたはコンポーネント・マネージャを使用してインストールできます。

9.6.5.3 コンポーネントの有効化と無効化

コンポーネント・ウィザードからコンポーネントを有効化または無効化するには、次のいずれかの手順を実行します。

ヒント:
コンポーネント・マネージャを使用してコンポーネントを有効化および無効化することもできます。

9.6.5.3.1 オプション1

1. コンポーネント・ウィザードでコンポーネントを開きます。

2. コンポーネント・ウィザードのメイン・ウィンドウで、「オプション」→「有効化」を選択します。

3. コンテンツ・サーバー・インスタンスを再起動します。
コンポーネントが有効化または無効化されます。

4. コンポーネントの影響を受けるページに移動して、カスタマイズの追加または削除が予想どおりに機能していることを確認します。

9.6.5.3.2 オプション2

1. 次のいずれかの方法で、「コンポーネント・リスト」ウィンドウを表示します。

- コンポーネント・ウィザードを起動します。

- コンポーネント・ウィザードのメイン・ウィンドウで、「オプション」→「開く」を選択します。

2. 有効化または無効化するコンポーネントを選択します。

3. コンポーネントを設定する条件に対して「有効化」または「無効化」を選択します。

4. コンテンツ・サーバー・インスタンスを再起動します。
コンポーネントが有効化または無効化されます。

5. コンポーネントの影響を受けるページに移動して、カスタマイズの追加または削除が予想どおりに機能していることを確認します。

9.6.5.4 コンポーネントの削除

コンポーネントをコンテンツ・サーバー・インスタンスから削除するには:

注意:
コンポーネントを削除すると、コンテンツ・サーバー・インスタンスはそのコンポーネントを認識しなくなりますが、コンポーネント・ファイルはファイル・システム上から削除されません。

1. 削除するコンポーネントを無効化します。
削除するコンポーネントがコンポーネント・ウィザードで開かれている場合、別のコンポーネントを開くか、コンポーネント・ウィザードを閉じて再起動します。(コンポーネントが開かれている場合、そのコンポーネントは削除できません。)

2. 「コンポーネント・リスト」ウィンドウを表示するには:

- コンポーネント・ウィザードを起動します。

- コンポーネント・ウィザードのメイン・ウィンドウで、「オプション」→「開く」を選択します。

3. 「コンポーネント・リスト」ウィンドウから、削除するコンポーネントを選択します。

4. 「アンインストール」をクリックします。

5. 「はい」をクリックします。
コンポーネントが「コンポーネント・リスト」に表示されなくなります。

9.6.5.5 コンポーネントを開く

コンテンツ・サーバー・インスタンスにすでに追加されているコンポーネントを開くには:

1. 「コンポーネント・リスト」ウィンドウを表示するには:

- コンポーネント・ウィザードを起動します。

- コンポーネント・ウィザードのメイン・ウィンドウで、「オプション」→「開く」を選択します。

2. 「コンポーネント・リスト」ウィンドウから、開くコンポーネントを選択します。

3. 「開く」をクリックします。
コンポーネント・リソースが、コンポーネント・ウィザードのメイン・メニューの「カスタム・リソース定義」リストに表示されます。

9.6.5.6 デフォルトHTMLエディタの構成

HTMLエディタを起動して、テキストベースのコンポーネント・ファイルをコンポーネント・ウィザードから直接編集できます。

- (Windows) Microsoft WordPad (wordpad.exe)がデフォルトのエディタです。

- (UNIX) viがデフォルトのエディタです。

重要:
グラフィカルなHTMLエディタではなく、ワードパッドなどのテキスト・エディタを指定します。グラフィカル・エディタではHTMLタグの挿入または変更が可能であるため、Idocスクリプト・タグがコンテンツ・サーバー・インスタンスで認識されない文字列に変換される可能性があります。

デフォルトのHTMLエディタを定義するには:

1. コンポーネント・ウィザードのメイン・ウィンドウを表示します。

2. 「オプション」→「構成」を選択します。

3. 「コンポーネントの構成」ウィンドウで、「参照」をクリックします。

4. 使用するHTMLエディタの実行可能ファイルに移動して選択します。

5. 「開く」をクリックします。

6. 「OK」をクリックします。
コンポーネント・ウィザードで任意の「エディタの起動」ボタンをクリックすると、選択したプログラムでファイルが開かれます。

9.6.5.7 コンポーネントのパッケージの展開

コンポーネントzipファイルを展開するには:

注意:
コンテンツ・サーバー・インスタンスの既存のコンポーネントと同じ名前でコンポーネントのパッケージを展開すると、backupで始まりタイム・スタンプで終わるファイル名(backup1008968718221.zipなど)で古いコンポーネントが圧縮されて、DomainHome/ucm/cs/bin/ディレクトリにコピーされます。

1. 次のいずれかの方法で、「インストール」ウィンドウを表示します。

- コンポーネント・ウィザードのメイン・ウィンドウで、「オプション」→「インストール」を選択します。

- 「コンポーネント・リスト」ウィンドウから、「インストール」をクリックします。

2. 「選択」をクリックします。

3. 「Zipファイル・パス」ウィンドウで、コンポーネントzipファイルに移動して、選択します。

4. 「開く」をクリックします。
コンポーネントzipファイルの内容が、「パッケージの展開」ウィンドウに一覧表示されます。

5. 「OK」をクリックします。
コンポーネント・ファイルが正しい場所(ファイルが解凍されるまでに多少の遅れが生じることがあります)にコピーされ、「パッケージの展開」ウィンドウが閉じて、コンポーネント・リソースがコンポーネント・ウィザードのメイン・ウィンドウの「カスタム・リソース定義」リストに表示されます。コンポーネントはコンポーネント・リストにも追加されます。

注意:
コンポーネントのパッケージを展開しても、コンポーネントは有効化されません。詳細は、第9.6.5.3項を参照してください。

9.6.5.8 パッケージ展開済のコンポーネントの追加

既存のパッケージ展開済のコンポーネントをコンテンツ・サーバー・インスタンスに追加するには:

1. 次のいずれかの方法で、「コンポーネントの追加」ウィンドウを表示します。

- コンポーネント・ウィザードのメイン・ウィンドウで、「オプション」メニューから「追加」をクリックします。

- 「コンポーネント・リスト」ウィンドウから、「追加」をクリックします。

2. 「既存のコンポーネントを使用」オプションを選択します。

3. 「参照」をクリックします。

4. コンポーネント定義(hda)ファイル(components.hda)に移動して選択します。

5. 「開く」をクリックします。
パスとファイル名が「FilePath」フィールドに表示されます。

6. 「OK」をクリックします。
コンポーネント・リソースが、コンポーネント・ウィザードのメイン・ウィンドウの「カスタム・リソース定義」リストに表示されます。コンポーネントはコンポーネント・リストにも追加されます。

注意:
既存のコンポーネントを追加しても、そのコンポーネントは有効化されません。

10 検索機能の管理

この章では、Oracle Text 11gをOracle WebCenter Contentのプライマリ・フルテキスト検索エンジンとして使用するようにOracleTextSearch機能を構成する方法、Oracle Search Enterprise Search (SES)を使用するようにコンテンツ・サーバーを構成する方法、およびフルテキスト・データベース検索を構成する方法について説明します。

この章の内容は、次のとおりです。

- OracleTextSearchの管理

- Oracle Secure Enterprise Searchの管理

- フルテキスト・データベース検索索引の構成

10.1 OracleTextSearchの管理

OracleTextSearch機能をOracle Database 11gで使用するライセンスを持っている場合は、WebCenter Contentのプライマリ・フルテキスト検索エンジンとしてOracle Text 11g製品を使用するようにOracleTextSearchを構成できます。Oracle Text 11gには、最新の索引付け機能があり、Oracle Secure Enterprise Search (Oracle SES)の基礎となる検索機能を提供しています。ただし、Oracle Text 11gには独自の問合せ構文があり、一般的なエンド・ユーザーではなくアプリケーションまたは情報の専門家による使用を対象としています。

OracleTextSearchにより、管理者は、特定のメタデータ・フィールドを検索索引用に最適化するように指定したり、追加のフィールドをカスタマイズできます。また、この機能を使用すると、索引再構築と索引の最適化を迅速に実行することもできます。

この項の内容は次のとおりです。

- 第10.1.1項「OracleTextSearchを使用する上での考慮事項」

- 10.1.2項「Oracle Text 11gの機能と利点」

- 第10.1.3項「コンテンツ・サーバー用のOracleTextSearchの構成」

- 第10.1.4項「OracleTextSearchの管理」

- 第10.1.5項「OracleTextSearchによる検索」

- 第10.1.6項「メタデータ・ワイルドカードの使用」

- 第10.1.7項「インターネット・スタイルの検索構文の使用」

- 第10.1.8項「OracleTextSearch結果のスコアの調整」

- 第10.1.9項「OracleTextSearchの検索結果のカスタマイズ」

10.1.1 OracleTextSearchを使用する上での考慮事項

OracleTextSearch機能の使用を検討する上で重要な事項を、次に示します。

- WebCenter Contentバージョン11g リリース(11.1.1)は、Oracle Text 11gでサポートされているすべての言語をサポートします。OracleTextSearchは、様々な言語の様々なドキュメント・フォーマットのコンテンツをフィルタリングおよび抽出できます。Microsoft Officeファイル形式、Adobe PDF、HTML、XMLなど、多数のドキュメント・フォーマットがサポートされています。検索結果は、未フォーマットのテキスト、検索語を強調表示するHTML、元のドキュメント・フォーマットなど、様々なフォーマットでレンダリングできます。

- Oracle Text 11gはOracle Database 11g上で動作します。コンテンツ・サーバーのデータベースには、Oracle Database 11g、Microsoft SQL Server、またはOracle WebCenter Content 11gリリース1 (11.1.1)の動作保証マトリックスに記載されているその他のデータベースを使用できます。ただし、システム・データベースがOracle Database 11gでない場合、OracleTextSearchの外部プロバイダを構成する必要があります。外部プロバイダの詳細は、第10.1.3項を参照してください。

- OracleTextSearchを使用する場合は、Oracle Databaseバージョン11.1.0.7.0以上が必要です。

- OracleTextSearchで最適化されたフィールドはSDATAフィールドとして作成され、最大249文字に制限されます。この制限はOracle Databaseによって適用され、OracleTextSearchコンポーネントによりコンテンツ・サーバーに反映されます。デフォルトのSDATAフィールドには、dDocName、dDocTitle、dDocTypeおよびdSecurityGroupがあります。SDATAフィールドの合計数は、32フィールドに制限されます。Folders_gコンポーネントが有効化されていない場合、dDocTitleフィールドはデフォルトで80文字に制限されます。

- WebCenter Contentには各種データベース(Oracle、Microsoft SQL Server、IBM DB2)を使用する多数の検索オプションが備わっていますが、デフォルトでは、検索索引として機能するデータベースはWebCenter Contentでメタデータやその他の構成情報(ユーザー、セキュリティ・グループなど)の管理に使用されるのと同じシステム・データベースです。OracleTextSearch機能により、Oracle Text 11gがOracle Database 11g上でWebCenter Content用の別の検索コレクション・インスタンスとして有効になり、これにより、検索コレクションを別のコンピュータに置いて、プロセッサやメモリーに関してWebCenter Contentと競合しないようにできます。その結果、索引付けおよび検索のレスポンス時間を短縮できます。

- OracleTextSearchコレクション・インスタンスは、WebCenter Contentインストールとは異なるプラットフォームにインストールできます。

- 管理者またはコンポーネントによってOracleTextSearch機能が構成および実行され、メタデータ・フィールドがコンテンツ・サーバー・インスタンスにプッシュされる場合(コンテンツ・サーバー・インスタンスの再起動が必要です)、新規メタデータ・フィールドを使用してコンテンツをコンテンツ・サーバー・インスタンスにチェックインする前に、OracleTextSearch索引を再構築する必要があります。

10.1.2 Oracle Text 11gの機能と利点

この項の内容は次のとおりです。

- 第10.1.2.1項「索引付けおよび問合せの速度と方法」

- 10.1.2.2項「高速再構築」

- 10.1.2.3項「問合せ構文」

- 第10.1.2.4項「OracleTextSearchの演算子」

- 第10.1.2.5項「大/小文字の区別およびステミングのルール」

- 第10.1.2.6項「検索結果データのクラスタリング」

- 第10.1.2.7項「スニペット」

- 第10.1.2.8項「その他の変更」

10.1.2.1 索引付けおよび問合せの速度と方法

Oracle Text 11gを使用すると、WebCenter Contentの索引付けの速度が大幅に高まります。Oracle Textの索引付けは、トランザクションです。コンテンツ・サーバーは、ドキュメントのバッチをOracle Textに送信し、バッチをコミットしてから、Oracle Textインデクサを起動します。コンテンツ・サーバーには、索引付けに失敗したドキュメントが通知され、それらのドキュメントのみが索引付けのために再送信されます。追加の機能には、コンテンツ・サーバー・インスタンスに5,000ドキュメントが追加されるたびに実行される自動の高速最適化と、50,000ドキュメントごとにまたはリポジトリが20%増加するたびに実行される完全最適化があります。コンテンツ・サーバーのメタデータのみの検索問合せにOracle Textを使用すると、パフォーマンスが下がる場合があります。

WebCenter Contentでは、Oracle Text 11gの最新機能の一部を使用します。たとえば、コンテンツ・サーバーでは、検索速度を上げるために、テキスト情報フィールドごとに新しい検索索引ゾーンが自動的に作成されます。情報ゾーンを使用すると、コンテンツ・サーバーでデータがフルテキスト・データであるかのようにデータを問い合せることができます。テキストベースの情報フィールド(テキスト、ロング・テキストおよびメモ)すべてが、別々のゾーンとして自動的に追加されます。テキスト情報フィールド用に作成されるゾーンに加えて、コンテンツ・サーバーにはIdcContentという追加ゾーンも用意されており、これにより、カスタム・コンポーネント、Oracle WebCenter Content: Inbound Refineryのコンポーネント、アプリケーションまたはユーザーは、フルテキスト・メタデータ・フィールドとして索引付けされるタグ付きXMLコンテンツを作成できます。

WebCenter Contentでは、Oracle Text 11gのSDATAセクション機能を使用して、重要なテキスト、日付および整数の各フィールドに索引を設定し、これらのフィールドを最適化フィールドとして定義します。SDATAセクションはOracle Textエンジンが管理する独立したXML構造で、この構造によって、エンジンはデータと整数の範囲が含まれているリクエストに対して迅速に応答できます。コンテンツ・サーバーでは最大で32の最適化フィールドを保持でき、これらの最適化フィールドには、データ、整数、Content Serverの標準フィールド(dInDate、dOutDate、最適化対象として選択したフィールドなど)が格納されます。最適化されたすべてのフィールドはSDATAフィールドで、デフォルトではdDocName、dDocTitle、dDocTypeおよびdSecurityGroupが含まれます。

注意:
Oracle Text 11gで定義された一連の最適化フィールドを変更する場合、定義可能な最適化フィールドの最大数は32です。

索引付けのエラーを防ぐために、存在しないメタデータ・フィールドを構成マネージャのDrillDownFieldsパラメータに追加しないでください。また、SDATAセクションまたはDrillDownFieldsパラメータにメモ・フィールドを追加しないでください。構成マネージャの詳細は、『Oracle WebCenter Contentのマネージング』を参照してください。

10.1.2.2 高速再構築

OracleTextSearchでは、リポジトリ・マネージャ・アプリケーションの「インデクサ」タブで「コレクション再構築サイクル」ウィンドウを使用する際、「インデクサの再構築」ウィンドウが用意されています。高速再構築機能により、検索エンジンは、コレクション全体を再構築することなく、検索コレクションに新しい情報を追加できます。高速再構築は次の場合に必要です。

- 情報フィールドの追加または削除

- 任意の最適化フィールドの変更

- 情報フィールドの最適化フィールドへの変更

高速再構築により、すべての情報(メタデータとフルテキスト)に索引が付け直されるわけではありません。コレクション全体に変更を追加し、更新します。高速再構築サイクル中にコンテンツ・サーバーの検索機能に対する影響はありません。

高速再構築の実行に関する情報は、第10.1.4.3項を参照してください。

10.1.2.3 問合せ構文

Universal Query Syntaxで定義されている問合せがサポートされており、通常変更は不要です。これには、ユーザーが保存した問合せ、カスタム・コンポーネントで定義された問合せ、Site Studioのページで定義された問合せが含まれます。

10.1.2.4 OracleTextSearchの演算子

Oracle Textでは、次のデフォルトがサポートされています。

- CONTAINS

- MATCHES

- Has Word Prefix

- 日付および整数の範囲検索

Oracle Text 11gエンジンでは、デフォルトではユーザー・インタフェースに表示されないが、演算子定義HDA表に追加するカスタマイズにより表示できる、その他の検索演算子および関数がサポートされています。これらの演算子の詳細および例は、『Oracle Textリファレンス』を参照してください。

10.1.2.4.1 検索シソーラス

stemやRelated Termなどの特定の問合せは、Oracle Textシソーラスを使用すると、効果が上がる場合があります。Oracle Textを使用すると、語や句のシノニムや階層上の関係を定義する、大/小文字の区別ありまたは大/小文字の区別なしのシソーラスを作成できます。その結果、問合せを拡張してシソーラスに定義されている類義語または関連語を含めることで、関連テキストを含むドキュメントを検索し、取得できます。たとえば、特定の製品名、関連モデル、関連機能などをシソーラスに入れることができます。

- デフォルトのシソーラス: 問合せでシソーラスの名前を指定しないと、デフォルトでは、シソーラスの演算子はDEFAULTというシソーラスを使用します。ただし、Oracle TextにはDEFAULTシソーラスは用意されていません。
その結果、シソーラス演算子にデフォルトのシソーラスを使用する場合は、DEFAULTという名前のシソーラスを作成する必要があります。このシソーラスの作成には、Oracle Textがサポートしている次のシソーラス作成方法を使用できます。

- CTX_THES.CREATE_THESAURUS (PL/SQL)

- ctxloadユーティリティ

- 提供されるシソーラス: Oracle Textではデフォルトのシソーラスはありませんが、ctxloadによりロードするファイル形式のシソーラスが提供されており、汎用の英語シソーラスの作成に使用できます。
シソーラス・ロード・ファイルは、Oracle Text用のデフォルト・シソーラスの作成に使用でき、また特定のサブジェクトや、サブジェクトの範囲にあわせたシソーラスの作成の基礎として使用することもできます。

注意:
ctxloadおよびCTX_THESパッケージの使用方法の詳細は、『Oracle Textリファレンス』および『Oracle Textアプリケーション開発者ガイド』の「Oracle Textでのシソーラスの使用」を参照してください。

10.1.2.5 大/小文字の区別およびステミングのルール

コンテンツ・サーバーでは、問合せは自動的に大文字と小文字を区別しないものとして実行されます。デフォルトでは、フルテキストおよびテキスト・フィールド検索の問合せは、すべて大文字と小文字の区別はありません。コンテンツ・サーバーでは、最適化フィールドとして格納されている情報に対する大文字と小文字を区別しない検索問合せも処理します。

ステミングはOracle Textの機能で、stem ($)演算子を使用して、問合せ語句と同じ言語学上の語根を持つ語句を検索します(構文は$term)。たとえば、$singと入力すると、sang sung singを含むように検索が拡張されます。ステミング・ルールは、複数形、動詞などの検索アカウントを設定するときに使用できます。コンテンツ・サーバーは、デフォルトではOracle Text 11gにステミング・ルールを適用しませんが、stem ($)演算子を使用することで、ステミング・ルールのセットを作成できます。ステミング・ルールを実装する方法には他に、searchindexerrules構成ファイル(カスタム・コンポーネントが必要)での標準問合せ定義の変更や、Oracle Textエンジン(Oracle Database)での構成の変更があります。

注意:
詳細は、『Oracle Textリファレンス』のOracle Text CONTAINS問合せ演算子に関する章を参照してください。

コンテンツ・サーバーでは、Oracle TextエンジンでWORLD_LEXER機能を使用することで、英語以外の言語のコンテンツを処理します。これにより、Oracle Textは自動的に言語を識別し、適切なトークン化ルールを適用できます。

10.1.2.6 検索結果データのクラスタリング

コンテンツ・サーバーでは、Oracle Text検索機能を使用して、検索結果リストについての追加情報を取得し、「検索結果」ページの新しいメニュー・バーに表示しますこの情報には、特定の情報フィールドの特定の値にどれだけのドキュメントが添付されているかが要約されています。コンテンツ・サーバーでは、最大4つの情報フィールドのクラスタリングがサポートされています(デフォルトのフィールドは、「セキュリティ・グループ」と「ドキュメント・タイプ」)。

これは、多くのアイテムを返す問合せの場合に役に立ちます。たとえば、結果セットに、「Public」セキュリティ・グループに属する100のドキュメント、「Sales」グループに属する75のドキュメント、および「Marketing」グループに属する25のドキュメントを含む、200のコンテンツ・アイテムが含まれているとします。「セキュリティ・グループ」のメニュー・オプションには、値リストと、各値に属するドキュメント数が表示されます。メニューから値(「Public」、「Sales」、「Marketing」)の1つを選択すると、その値に属するドキュメントのみが結果セットのリストに示されます。

10.1.2.7 スニペット

コンテンツ・サーバーでは、使用される文脈での検索語の出現を示すために、検索結果の一部としてドキュメントのスニペットを取得できます。この機能はデフォルトで無効です。この機能を有効にするには、config.cfgファイルで次の構成エントリを設定します。ただし、検索問合せのパフォーマンスに影響することがあります。

OracleTextDisableSearchSnippet=false

10.1.2.8 その他の変更

Oracle Text 11gを使用するためのその他の変更は、次のとおりです。

- XMLコンテンツには、自動的に索引が付けられます。

- 「検索」ユーザー・インタフェースには、検索演算子オプションとして「Substring」が削除されている以外に目に見える変更はありません。デフォルトの検索演算子は、CONTAINS、MATCHESおよびHAS WORD PREFIXです。部分文字列ベースの問合せはそのまま機能します。

- MATCHES演算子を非最適化フィールドで使用する問合せは、CONTAINS問合せと同じ動作をします。たとえば、xDepartmentが最適化されていない場合、問合せxDepartment MATCHES 'Marketing'はxDepartment CONTAINS 'Marketing'と同じ動作をし、コンテンツ・アイテムで'Marketing Services'または'Product Marketing'のxDepartment値を持つヒットを返します。

- 関連性のランキングは、DEFINESCOREという演算子の使用により、Oracle Text 11gで変更される可能性があります。この演算子は、SearchQueryDefinition表(Oracle Textのsearchindexerrules構成ファイル内)のOracleTextSearchのWhereClause値にコンポーネントを使用して追加できます。この演算子の詳細は、『Oracle Textリファレンス』を参照してください。

- 以前はフルテキスト検索ボックスに入力していたような複雑な問合せを、現在は「クエリー・ビルダー・フォーム」の詳細オプションに入力します。「クエリー・ビルダー・フォーム」の詳細は、『Oracle WebCenter Contentの使用』を参照してください。

- エスケープ文字を指定する必要がある場合は、構成変数AdditionalEscapeChars=を使用します。デフォルト設定は次のとおりです。

AdditionalEscapeChars=_:#,-:#

デフォルトでは、アンダースコア(_)とハイフン(-)がエスケープ文字として設定されます。

- PDFの強調表示機能は無効になりました。

- スペル・チェック機能は有効にできますが、Autonomy VDKの場合と同様に、カスタム・コンポーネントが必要です。

10.1.3 コンテンツ・サーバー用のOracleTextSearchの構成

コンテンツ・サーバーを最初にインストールするときにOracleTextSearchを指定しなかった場合、この機能を構成するには、次の手順を実行します。

1. コンテンツ・サーバー・インスタンスのconfig.cfgファイルをテキスト・エディタで開きます。たとえば、MW_HOME/user_projects/domain/servers/ucm/config/config.cfgを開きます。

2. 次のプロパティ値を設定します。

SearchIndexerEngineName=OracleTextSearch

注意:
ACLを使用しており、UseEntitySecurity=trueがOracleTextSearchに検索エンジンとして設定されている場合、コンテンツ・サーバー・インスタンスのconfig.cfgファイルで次のコードも設定する必要があります。

ZonedSecurityFields=xClbraUserList,xClbraAliasList

3. システム・データベースではなく外部データ・ソースを使用する場合は、次のプロパティ設定の値SystemDatabaseを外部データベース・プロバイダ名に変更します。

IndexerDatabaseProviderName=SystemDatabase

注意:
IndexerDatabaseProviderNameの値として、SystemDatabaseではなく、別のOracle Databaseを指定できます。
OracleTextSearchで使用するコンテンツ・サーバー・データベースがOracle Database 11gでない場合は、OracleTextSearchの外部プロバイダを構成する必要があります。ドライバおよびfmwgenerictoken.jarをMW_HOME/oracle_common/modules/oracle.jdbc_11.1.1/ojdbc6dms.jarから取得します。

4. ファイルを保存します。

5. コンテンツ・サーバー・インスタンスを再起動します。詳細は、3.2.3項を参照してください。

最初にコンテンツ・サーバーでOracleTextSearchを使用した外部プロバイダを使用するよう構成したものの、SystemDatabaseの使用に切り替える必要がある場合は、システム・データベース・スキーマに対してcontentprocedures.sqlスクリプトを手動で実行する必要があります。このスクリプト・ファイルはWC_CONTENT_ORACLE_HOME/ucm/idc/database/oracle/admin/ディレクトリにあります。

10.1.4 OracleTextSearchの管理

この項の内容は次のとおりです。

- 第10.1.4.1項「最適化するフィールドの決定」

- 第10.1.4.2項「最適化フィールドの割当て/編集」

- 第10.1.4.3項「高速再構築の実行」

- 第10.1.4.4項「検索結果で表示されるフィールドの変更」

10.1.4.1 最適化するフィールドの決定

最適化するフィールドを決定するときには、次のことを考慮します。

- 問合せで完全一致検索を行うか。

- 検索で照合を高速化するか。

- 検索結果をフィールド別にソートするか。

デフォルトでは、OracleTextSearch機能で、「コンテンツID」および「ドキュメント・タイトル」メタデータ・フィールドが最適化されます。

最大32フィールドを、Oracle Text Search機能で最適化フィールドとして定義できます。コンテンツ・サーバー・インスタンスでは最大で32の最適化フィールドを保持でき、これらの最適化フィールドには、データ、整数、コンテンツ・サーバーの標準フィールド(dInDate、dOutDate、最適化対象として選択したフィールドなど)が格納されます。最適化されたすべてのフィールドはSDATAフィールドで、デフォルトではdDocName、dDocTitle、dDocTypeおよびdSecurityGroupが含まれます。

整数フィールドの表示は動的で、コンテンツ・サーバー構成に依存します。

10.1.4.2 最適化フィールドの割当て/編集

メタデータの非最適化フィールドを選択し、検索のための最適化フィールドに割り当てたり、最適化フィールドを編集して非最適化にすることができます。

最適化フィールドの割当てまたは編集を行う手順:

1. 「管理」→「管理アプレット」を選択します。

2. 「構成マネージャ」→「情報フィールド」タブ→「拡張検索のデザイン」を選択します。構成マネージャ・アプレットの詳細は、『Oracle WebCenter Contentのマネージング』を参照してください。

3. メタデータ・フィールドを最適化するには、「フィールドの編集」をクリックします。「metadata_fieldの詳細なオプション」ウィンドウで、「最適化されています」を選択します。

4. 最適化フィールドを編集して非最適化にするには、「フィールドの編集」をクリックします。「metadata_fieldの詳細なオプション」ウィンドウで、「最適化されています」の選択を解除します。

5. フィールドの移動が完了したら、リポジトリ・マネージャで「索引の高速再構築」を使用し、検索コレクションを更新して新規および変更したフィールドを使用します。

注意:
高速再構築は、検索コレクションの再構築が進行中の場合は機能しません。

10.1.4.3 高速再構築の実行

高速再構築機能により、検索エンジンは、コレクション全体を再構築することなく、検索コレクションに新しい情報を追加できます。高速再構築は次の場合に必要です。

- 情報フィールドの追加または削除

- 任意の最適化フィールドの変更

- 情報フィールドの最適化フィールドへの変更

高速再構築を行うには、次の手順を実行します。

1. 「管理」→「管理アプレット」を選択します。

2. 「リポジトリ・マネージャ」→「インデクサ」タブを選択します。

3. リポジトリ・マネージャ・アプリケーションの「インデクサ」タブの「コレクション再構築サイクル」部分で、「開始」をクリックします。
「インデクサの再構築」ウィンドウが、検索索引の再構築には時間がかかることを示す警告とともに開きます。今すぐに再構築を開始しない場合は「取消」をクリックし、それ以外の場合はこの手順を続行します。

4. 「インデクサの再構築」ウィンドウで、「OK」をクリックします。
検索コレクションの高速再構築が実行されます。

注意:
検索コレクションの再構築が進行中の場合、高速再構築は実行されません。

注意:
高速再構築プロセスでは、「全文」、「メタデータのみ」、「削除」のインデクサ・カウンタ値は作成されません。インデクサ・カウントの統計値を取得するには、コレクション全体の再構築を実行する必要があります。

10.1.4.4 検索結果で表示されるフィールドの変更

OracleTextSearch機能には、「検索結果」ページにデフォルトのメニュー・オプションが用意されています(Oracle Database構成スクリプトで設定)。

DrillDownFields=dDocType, dSecurityGroup

管理者は、最適化フィールドのリストからもう1つオプションを追加し、検索結果をさらにカスタマイズできます。構成を編集して、DrillDownFieldsのリストにオプションを追加します。(この機能では、複数値オプションのリストはサポートされません。)

DrillDownfields設定に変更を加えた後には、高速再構築を実行する必要があります。

10.1.5 OracleTextSearchによる検索

OracleTextSearchによる検索の実行は、検索演算子オプションとして「Substring」が削除されている以外に「検索: 拡張フォーム」に目に見える変更がない点を除き、一般に同じです。デフォルトの検索演算子はCONTAINSです。部分文字列ベースの問合せはそのまま機能します。

検索の実行の詳細は、『Oracle WebCenter Contentの使用』を参照してください。

次の表で、デフォルトの検索演算子について説明します。

演算子

説明

例

CONTAINS

指定した語全体または句全体がメタデータ・フィールドに含まれるコンテンツ・アイテムを検索します。
これはOracleTextSearch、またはオプションのDBSearchContainsOpSupportコンポーネントが有効化されているOracle DatabaseおよびMicrosoft SQL Serverデータベースでのみ使用できます。

「タイトル」フィールドにformと入力した場合、タイトルにformという語を持つアイテムは返されますが、performanceまたはreformという語を持つアイテムは返されません。

MATCHES

指定した値と完全に一致する値がメタデータ・フィールドに含まれるアイテムを検索します。

「タイトル」フィールドにaddress change formと入力した場合、address change formと完全に一致するタイトルのアイテムが返されます。
非最適化フィールドに対してMATCHES演算子を使用する問合せは、CONTAINS演算子を使用する問合せと同様に動作します。

たとえば、xDepartmentが最適化されていない場合、問合せxDepartment MATCHES 'Marketing'はxDepartment CONTAINS 'Marketing'と同じ動作をし、ドキュメントで'Marketing Services'または'Product Marketing'のxDepartment値を持つヒットを返します。

HAS WORD PREFIX

指定した語がメタデータ・フィールドの先頭に含まれるコンテンツ・アイテムをすべて検索します。指定する値の前後にワイルドカード文字を配置しません。

「タイトル」フィールドにformと入力した場合、タイトルの頭の部分にformという語を持つすべてのアイテムは返されますが、タイトルがperformanceまたはreformという語で始まるアイテムは返されません。

10.1.6 メタデータ・ワイルドカードの使用

「クイック検索」フィールドを使用している場合であっても、次のワイルドカードをメタデータ検索フィールドで使用できます。

- アスタリスク(*)は、ゼロまたは多数の英数字を示します。次に例を示します。

- form*は、formやformulaと一致します。

- *ormは、formやreformと一致します。

- *form*は、form、formula、reform、performanceと一致します。

- 疑問符(?)は、1つの英数字を示します。次に例を示します。

- form?は、formsやform1と一致しますが、formやformalとは一致しません。

- ??formは、reformと一致しますが、performとは一致しません。

注意:
アスタリスク(*)または疑問符(?)をワイルドカードとして扱わずに検索する場合は、"here*"のように、検索語を引用符で囲む必要があります。

10.1.7 インターネット・スタイルの検索構文の使用

通常のインターネット検索エンジンで一般的な検索手法はコンテンツ・サーバーでもサポートされています。たとえば、「クイック検索」フィールドにnew productと入力すると、new <AND> productが検索され、new, productと入力すると、new <OR> productが検索されます。

この検索のスタイルを有効にするには、変数をDoMetaInternetSearch=Trueのように設定します。この検索のスタイルを無効にするには、変数をDoMetaInternetSearch=Falseのように設定します。これがデフォルトです。詳細は、『Oracle WebCenter Content構成リファレンス』を参照してください。

次の表に、一般的な文字がコンテンツ・サーバーでどのように解釈されるかを示します。

文字

解釈方法

スペース( )

AND

カンマ(,)

OR

マイナス(-)

NOT

二重引用符で囲まれた句("任意の句")

入力した句と正確に一致する句

次の表に、フルテキスト検索でインターネット・スタイルの構文がどのように解釈されるかの例を示します。

問合せ

解釈方法

new product

new <AND> product

(new, product) images

(new <OR> product) <AND> images

new product -images

(new <AND> product) <AND> <NOT> images

"new product", "new images"

"new product" <OR> "new images"

次の表に、substring演算子を使用してタイトル・メタデータを検索する場合にインターネット・スタイルの構文がどのように解釈されるかの例を示します。

問合せ

解釈方法

new product

dDocTitle <substring> 'new' <AND> dDocTitle <substring> 'product'

new, product

dDocTitle <substring> 'new' <OR> dDocTitle <substring> 'product'

new -product

dDocTitle <substring> 'new' <AND> <NOT> 'product'

"new product"

dDocTitle <substring> 'new product'

10.1.8 OracleTextSearch結果のスコアの調整

Oracle TextをWebCenter Contentでの検索エンジンとしてOracleTextSearchを使用する場合、スコアによる検索結果は、ドキュメントの関連性に基づきソートされます。理論上は、検索語のドキュメントに対する関連性が高ければ高いほど、受け取るスコアは高くなるはずです。実際には、検索語に基づき、あるドキュメントの重要性の、それ以外に対する関連性スコアのランク付け方法は、完全に明らかではありません。ある語がドキュメント内に特定の回数出現すると、スコアは最大値の100に到達し、上位の結果を相互に区別することは難しい場合があります。

たとえば、「vacation」という語をドキュメントのセットで検索し、7つの結果のうち6つのスコアが"100"であると、これらは基本的に同じランクです。多数のドキュメントのランクが同じだと、スコアによるソートはまったく意味がなくなります。

関連性によるソートに加えて、発生回数によるソートをOracle Textに伝えることもできます。発生回数によるソートは、ドキュメントのランク付けでより予測可能な結果をもたらし、多くの場合、関連性よりも意味のあるソート結果を得ることができます。

Oracle Textに発生回数によるソートを伝えるには、SearchOperatorMapリソースに対しコンポーネントを多少変更する必要があります。デフォルトでは、フルテキスト検索に使用される問合せは次のようなコードになります。

&lt;td&gt;(ORACLETEXTSEARCH)fullText&lt;/td&gt;
&lt;td&gt;DEFINESCORE((%V), <strong>RELEVANCE * .1</strong>)&lt;/td&gt;
&lt;td&gt;text&lt;/td&gt;

このリソースを上書きして、RELEVANCEのかわりにOCCURRENCEを使用するように変更します。この変更により、リソースは強制的に発生回数を使用するようになります(.1から.01へのスケールの変更にも注意してください)。

&lt;td&gt;(ORACLETEXTSEARCH)fullText&lt;/td&gt;
&lt;td&gt;DEFINESCORE((%V),<strong> OCCURRENCE * .01</strong>)&lt;/td&gt;
&lt;td&gt;text&lt;/td&gt;

前述の例と同じ検索とソート・オプションを実行すると、結果は違うものとなり、7つのドキュメントそれぞれが一意のスコアを持ちます。これにより、アイテムのランクをより明確に理解できるようになります。一般的に、あるドキュメントで検索語が他のドキュメントよりも3回多く出現すると、ユーザーが調査しようと思うドキュメントとなる可能性が高まります。

注意:
発生回数のランクでも最大回数は100なので、ドキュメントでの検索語の発生がこの回数を超えても、スコア結果は100のままです。

サイトによっては、関連性ランクの使用が発生回数ランクよりも有用な場合もありますが、このオプションは結果に対してより適切に動作する可能性のある代替方法を提供します。

10.1.9 OracleTextSearchの検索結果のカスタマイズ

「検索: 拡張フォーム」を使用して検索を実行すると、「検索結果」ページには、検索結果を選択的に表示できるオプションを含む追加のメニュー・バーが表示されますこれらのオプションは、検索結果をフィルタ処理するために使用されるカテゴリを表しています。このオプションは状況依存であるため、1つのオプションに対して1つしかコンテンツ・アイテムが返されなかった場合、メニュー自体に表示される結果は、図10-1に示すように1つのみです。オプションのデフォルト・セットには、Content Type、Security GroupおよびAccountが含まれます。

注意:
「検索結果」のOracleTextSearchメニューの2つのデフォルト・メニュー・オプションを、カスタマイズ・メニュー・オプションSecurity GroupおよびDocument Typeに置き換えることができます。

図10-1 検索結果とOracleTextSearchのデフォルト・メニュー

1つのオプションに対して複数のコンテンツ・アイテムが検索された場合、オプション名の横に矢印が表示されます。オプション名の上にカーソルを移動すると、そのオプションの検索結果に含まれるカテゴリのリストと各カテゴリのコンテンツ・アイテム数を示すメニューが表示されます。メニューで任意のカテゴリ名をクリックして、「検索結果」ページにそのカテゴリに一致するアイテムのみを表示するように変更できます。

図10-2は、Security Groupのカテゴリのリストと各カテゴリで検索されたアイテム数を示しています。

図10-2 スニペット付きの検索結果の表示と開かれたOracleTextSearchメニュー

要素

説明

Filter by Category

検索結果のフィルタ処理に使用されるカテゴリ(「Content Type」、「Security Group」、「Account」など)を表示します。

コンテンツ・タイプ

(デフォルト)タイプのリスト、および検索結果におけるタイプ別のコンテンツ・アイテム数が表示されます。
コンテンツ・タイプ名の1つをクリックすると、そのコンテンツ・タイプに一致するアイテムのみを表示するように検索結果が変更されます。

セキュリティ・グループ

(デフォルト)セキュリティ・グループのリスト、および検索結果におけるグループ別のコンテンツ・アイテム数が表示されます。セキュリティ・グループには、「Administration」、「Public」および「Secure」があります。
セキュリティ・グループ名の1つをクリックすると、そのセキュリティ・グループに一致するアイテムのみを表示するように検索結果が変更されます。

Account

(デフォルト)アカウント・タイプのリスト、および検索結果におけるアカウント別のアイテム数が表示されます。
アカウント・タイプの1つをクリックすると、そのアカウントに一致するコンテンツ・アイテムのみを表示するように検索結果が変更されます。

10.2 Oracle Secure Enterprise Searchの管理

Oracle Secure Enterprise Search (Oracle SES) 11gにより、企業のすべての情報資産に対する安全、高品質かつ容易な検索が可能になります。Oracle SES 11gを使用するためのライセンスがある場合は、Oracle SESを使用するようにWebCenter Contentを構成できます。

- OracleTextSearch機能により、Oracle SESをWebCenter Contentの外部フルテキスト検索エンジンとして使用できるようにする。Oracle SESの構成の詳細は、第10.2.1項を参照してください。

- SESCrawlerExportコンポーネントにより、プライマリ検索エンジンとしてでなくとも、Oracle SESがコンテンツ・サーバー・インスタンスのコンテンツを検索できるようにする。SESCrawlerExportの構成の詳細は、第10.2.2項を参照してください。

詳細は、クックブック: SESとUCMの設定ブログを参照してください。Oracle SESの詳細は、『Oracle Secure Enterprise Search管理者ガイド』を参照してください。

10.2.1 Oracle SESを外部フルテキスト検索エンジンとして使用

Oracle Secure Enterprise Search (Oracle SES) 11gをバックエンド検索エンジンとして使用するように、WebCenter ContentをOracleTextSearch機能で構成できます。この構成により、ユーザーは1つのファイルに対して複数のコンテンツ・サーバー・インスタンスを検索できます。

- 第10.2.1.1項「OracleTextSearchとともに使用するようにOracle SESを構成」

- 第10.2.1.2項「Oracle SESをOracleTextSearchとともに使用するように検索エンジンを再構成」

10.2.1.1 OracleTextSearchとともに使用するようにOracle SESを構成

OracleTextSearchオプションとともに使用するようにOracle SESを構成するには:

注意:
WebCenter ContentでOracle SES以外の検索エンジンをすでに使用していて(コンテンツ・サーバーの「構成後処理」ページで設定されたエンジンなど)、その検索エンジンをOracle SESに変更する場合、新規データベース・プロバイダを作成し、そのプロバイダを使用するようOracle SESを構成する必要があります。詳細は、第10.2.1.2項を参照してください。

1. Oracle SESのインストール後、ファイルORACLE_HOME/network/admin/sqlnet.oraを編集して、次の2行をコメント・アウトします。

tcp.invited_nodes
tcp.validate_checking

2. Oracle SESが実行中の場合、シャットダウンします(中間層およびデータベース)。

ORACLE_HOME/bin/searchctl stopall

3. データベースを起動します。

ORACLE_HOME/bin/searchctl start_backend

4. 後で使用するために、次のファイルでデータベース接続情報を見つけます。

ORACLE_HOME/search/webapp/config/search.properties

5. Oracle SESに対してリポジトリ作成ユーティリティ(RCU)を実行して、OCSEARCHスキーマを作成します。OCSEARCHでは、Oracle SESでRCUによってすでに設定されているデータベースの検索部分のみが設定されます。
このスキーマを作成するには、RCUの「コンポーネントの選択」ウィンドウで「コンテンツ・サーバー11g - 検索のみ」を選択します。RCU実行の詳細は、『Oracle WebCenter Contentのインストールと構成』を参照してください。

6. WebCenter Contentの標準インストールおよびコンテンツ・サーバーのインストールを実行します。手順については、『Oracle WebCenter Contentのインストールと構成』を参照してください。

注意:
コンテンツ・サーバーの「構成後処理」ページでは、通常のデータベース構成が設定されるため、この手順は行わないでください。

7. Oracle WebLogic ServerインスタンスでOracle SESに接続する新規データ・ソース(WLS DataSource)を作成します。

1. Oracle WebLogic Server管理コンソールで、「サービス」メニューを使用して「JDBC」、「データ・ソース」の順に選択します。
JDBCデータ・ソースのサマリーを示すウィンドウが開きます。

2. 「新規」をクリックして、「新しいデータ・ソースの作成」ウィンドウで次のアイテムの値を入力します。
名前: 新しいデータ・ソース名を入力します。

JNDI名: 新しい名前を再入力します。

データベース・タイプ: Oracleと入力します。

データベース・ドライバ: 「*Oracleのインスタンス接続用ドライバ(Thin XA)」をクリックします。

3. 「次」をクリックして、「トランザクション・オプション」を表示します。

4. 「次」をクリックして、データベース・パラメータを入力します。手順4で説明したように、search.propertiesファイルでデータベース接続情報を見つけることができます。
データベース名: sesなど、接続するデータベースの名前を入力します。

ホスト名: データベース・サーバーのIPアドレスを入力します。

ポート: データベース接続用のデータベース・サーバーのポート番号を入力します。

データベース・ユーザー名: データベース・アカウントのユーザー名を入力します。これは、RCU作成プロセスで指定したSchemaOwner名です。

パスワード: データベース接続の作成に使用するデータベース・アカウントのパスワードを入力します。これは、RCU作成プロセスで指定したパスワードです。

パスワードの確認: データベース・アカウントのパスワードを再入力します。

5. 「次へ」をクリックします。

6. 「構成のテスト」をクリックします。ページ上部にメッセージ"Connection test succeeded"が表示されたことを確認して、「次」をクリックします。

7. 使用可能なターゲット・サーバーのリストから、新しいJDBCデータ・ソースをデプロイするターゲットContent Serverのチェック・ボックスを選択します。たとえば、ターゲットContent ServerにはUCM_server1という名前が付けられています。

8. 「終了」をクリックします。

8. コンテンツ・サーバーの「構成後処理」ページで、「外部フルテキスト検索オプションの選択」をクリックして、データ・ソース名を入力します。

9. コンテンツ・サーバー・インスタンスを再起動します。詳細は、3.2.3項を参照してください。

10.2.1.2 Oracle SESをOracleTextSearchとともに使用するように検索エンジンを再構成

WebCenter ContentでOracle SES以外の検索エンジンをすでに使用していて(コンテンツ・サーバーの「構成後処理」ページで設定されたエンジンなど)、その検索エンジンをOracle SESに変更する場合、新規データベース・プロバイダを作成し、そのプロバイダを使用するようにコンテンツ・サーバーのOracle SESを構成する必要があります。

1. Oracle SESのインストール後、ファイルORACLE_HOME/network/admin/sqlnet.oraを編集して、次の2行をコメント・アウトします。

tcp.invited_nodes
tcp.validate_checking

2. Oracle SESが実行中の場合、シャットダウンします(中間層およびデータベース)。

ORACLE_HOME/bin/searchctl stopall

3. データベースを起動します。

ORACLE_HOME/bin/searchctl start_backend

4. 後で使用するために、次のファイルでデータベース接続情報を見つけます。

ORACLE_HOME/search/webapp/config/search.properties

5. Oracle SESに対してOracleリポジトリ作成ユーティリティ(RCU)を実行して、OCSEARCHスキーマを作成します。OCSEARCHでは、Oracle SESでRCUによってすでに設定されているデータベースの検索部分のみが設定されます。
このスキーマを作成するには、RCUの「コンポーネントの選択」ウィンドウで「コンテンツ・サーバー11g - 検索のみ」を選択します。

RCU実行の詳細は、『Oracle WebCenter Contentのインストールと構成』のリポジトリ作成ユーティリティによるOracle WebCenter Contentスキーマの作成に関する項を参照してください。

6. コンテンツ・サーバー・インスタンスでOracle SESに接続する新規データ・ソース(WLS DataSource)を作成します。

1. Oracle WebLogic Server管理コンソールで、「サービス」メニューを使用して「JDBC」、「データ・ソース」の順に選択します。
JDBCデータ・ソースのサマリーを示すウィンドウが開きます。

2. 「新規」をクリックして、「新しいデータ・ソースの作成」ウィンドウで次のアイテムの値を入力します。
名前: 新しいデータ・ソース名ExternalSearchProviderを入力します

JNDI名: 新しい名前を再入力します。

データベース・タイプ: Oracleと入力します。

データベース・ドライバ: 「*Oracleのインスタンス接続用ドライバ(Thin XA)」をクリックします。

3. 「次」をクリックして、「トランザクション・オプション」を表示します。

4. 「次」をクリックして、データベース・パラメータを入力します。手順4で説明したように、search.propertiesファイルでデータベース接続情報を見つけることができます。
データベース名: SESなど、接続するデータベースの名前を入力します。

ホスト名: データベース・サーバーのIPアドレスを入力します。

ポート: データベース接続用のデータベース・サーバーのポート番号を入力します。

データベース・ユーザー名: データベース・アカウントのユーザー名を入力します。これは、RCU作成プロセスで指定したSchemaOwner名です。

パスワード: データベース接続の作成に使用するデータベース・アカウントのパスワードを入力します。これは、RCU作成プロセスで指定したパスワードです。

パスワードの確認: データベース・アカウントのパスワードを再入力します。

5. 「次へ」をクリックします。

6. 「構成のテスト」をクリックします。ページ上部にメッセージ"Connection test succeeded"が表示されたことを確認して、「次」をクリックします。

7. 使用可能なターゲット・サーバーのリストから、新しいJDBCデータ・ソースをデプロイするターゲットContent Serverのチェック・ボックスを選択します。たとえば、ターゲットのコンテンツ・サーバー・インスタンスをUCM_server1などの名前にします。

8. 「終了」をクリックします。

注意:
Oracle WebLogic Serverインスタンスを再起動する必要はありません。

7. コンテンツ・サーバーで、次の手順に従って検索(データベース)プロバイダを変更します。

1. 「管理」→「プロバイダ」を選択します。

2. 新規データベース・プロバイダを作成する行で、「追加」をクリックします。

3. 新しいデータベース・プロバイダの設定を入力または確認します。
プロバイダ名: ExternalSearchProvider。

プロバイダの説明: External Database Provider。

プロバイダ・クラス: intradoc.jdbc.JdbcWorkspace。

接続クラス: intradoc.jdbc.JdbcConnection。

データベース・タイプ: ORACLEを選択します。

データ・ソースの使用: このボックスを選択します。

データ・ソース: SESなど、データ・ソースの名前を入力します。

問合せのテスト: select * from SES.IDCTEXTなど、問合せのテストを入力します。

接続の数: デフォルトでは、5に設定されています。

追加のストレージ・キー: デフォルトでは、systemに設定されています。

4. 「追加」をクリックします。

5. コンテンツ・サーバー・インスタンスを再起動します。詳細は、3.2.3項を参照してください。
新規データベース・プロバイダ名が、「プロバイダ」ページのリストに表示されているはずです。

8. 「管理」→「管理サーバー」→「一般構成」を選択します。

9. 「一般構成」の「追加の構成変数」セクションで、次の設定を入力または確認します。
SearchIndexerEngineName=OracleTextSearch

IndexerDatabaseProviderName=ExternalSearchProvider

10. コンテンツ・サーバー・インスタンスを再起動します。詳細は、3.2.3項を参照してください。

11. リポジトリ・マネージャ・アプレットを使用して、検索索引を再構築します。
リポジトリ・マネージャの詳細は、『Oracle WebCenter Contentのマネージング』を参照してください。

10.2.2 Oracle SESでSESCrawlerExportを使用してコンテンツ・サーバーのコンテンツを検索

SESCrawlerExportコンポーネントにより、RSSフィード・ジェネレータとしての機能がコンテンツ・サーバー・インスタンスに追加され、Oracle Secure Enterprise Search (Oracle SES)による検索が可能になりました。このコンポーネントは、コンテンツ・サーバー・インスタンスの現在のコンテンツのスナップショットを生成して、Oracle SES Crawlerに提供します。

SESCrawlerExportコンポーネントは、インデクサ・アクティビティに基づいて、内部インデクサからRSSフィードをXMLファイルとして生成します。このコンポーネントは、元のWebCenter Contentコンテンツ(Microsoft Wordドキュメントなど)、Web表示可能レンディション、および各ドキュメントの関連付けられているすべてのメタデータにアクセスできます。このコンポーネントには、インデクサからメタデータ値を適用してXMLドキュメントを生成するIdocスクリプトを含むテンプレートもあります。

SESCrawlerExportは、すべてのドキュメントの初期クロール用のRSSフィードを生成するほかに、更新および削除されたドキュメントの増分クロール用のフィードを生成します。各ドキュメントは、フィード内のアイテム、そのアイテムの操作(挿入、削除、更新など)、そのメタデータ(作成者、サマリーなど)、URLリンクなどになることができます。インデクサは定期的(約30秒)にウェイクアップし、変更されたドキュメントのデータ・フィードを作成します。

Oracle SES用コンテンツ・サーバー・コネクタは、クローリング・スケジュールに従って、SESCrawlerExportにより提供されるフィードを読み取ります。Oracle SESは汎用RSSクローラ・フレームワークを使用して、メタデータ情報を解析および抽出し、ドキュメントのコンテンツを取得します。

SESCrawlerExportコンポーネントは、コンテンツ・サーバー・インスタンスで使用される検索エンジンの影響を受けません。SESCrawlerExportは、Oracle SESによる検索の実行方法に影響を与えません。

注意:
コンテンツ・サーバー・インスタンスで、YahooUserInterfaceLibraryコンポーネントが有効になっている必要があります。このコンポーネントには、SESCrawlerExportが初期クロール時にフィード生成ステータスをレポートするために使用するJavaScriptライブラリがあります。

注意:
デフォルトで、SESCrawlerExportはDigitalMediaドキュメント・タイプのスナップショットをサポートしていないため、このタイプのドキュメントはSES検索で検出されません。SESExportCrawler管理ページにあるsceCoreFilter構成パラメータは、ソース格納場所スクリプトの事前フィルタとして機能し、DigitalMediaコンテンツがsceSourceLocationスクリプトに送られる前にフィルタ処理で除外します。sceCoreFilterのデフォルトのパラメータ設定は次のとおりです。

<$if dDocType and dDocType like 'DigitalMedia'$>#none<$else$>#customScript#<$endif$>

コア・フィルタリングをsceSourceLocationScriptに従うようにすることによりDigitalMediaドキュメント・タイプを許可するには、デフォルトのsceCoreFilter構成パラメータを#customScript#に変更します。

この項の内容は次のとおりです。

- 第10.2.2.1項「SESCrawlerExportコンポーネントへのアクセス」

- 第10.2.2.2項「コンテンツのスナップショットの取得」

- 第10.2.2.3項「SESCrawlerExportパラメータの構成」

- 第10.2.2.4項「コンテンツ・サーバーのソース格納場所スクリプトの構成」

10.2.2.1 SESCrawlerExportコンポーネントへのアクセス

SESCrawlerExportコンポーネントにアクセスする手順:

1. 「管理」、「管理サーバー」、「コンポーネント・マネージャ」の順に選択します。

2. 「コンポーネント・マネージャ」ページで、統合コンポーネントのリストから、「SESCrawlerExport」を選択します。

3. 「更新」をクリックします。
SESCrawlerExportコンポーネントが有効化されます。

4. 「管理」→「SESCrawlerExport」を選択して、「SESCrawlerExport管理」ページを開きます。このページを使用して、コンテンツのスナップショットを取得してRSSフィードを生成し、「SESCrawlerExportの構成」ページにアクセスします。

10.2.2.2 コンテンツのスナップショットの取得

コンテンツ・サーバー・インスタンスのコンテンツのスナップショットを取得すると、Oracle SES Crawlerに提供するフィードが生成されます。スナップショットにより、SESCrawlerExportコンポーネントのFeedLocパラメータで指定された場所で、configFile.xmlが生成されます。XMLフィードは、wikisなどのソース名でサブディレクトリに作成されます。コンテンツ・サーバー・インスタンスに格納されているアイテム数および生成しているソース数によっては、スナップショットの実行に多少時間がかかることがあります。

スナップショットを取得する手順:

1. 「管理」→「SESCrawlerExport」を選択します。

2. 「SESCrawlerExport管理」ページで、使用可能なメニュー・オプションから、スナップショットを取得するソースを選択します。
コンテンツ・ソースのリストから「すべてのソース」を選択すると、SESCrawlerExportで、定義されているすべてのソースに対してRSSフィードが生成されます。個別のソースを選択したり、ソースのサブセットを選択して、それらのソースのスナップショットのみを取得することもできます。configFile.xmlドキュメントの更新により再索引付けが行われる場合、同じ場所にフィードも生成されます。

3. 「スナップショットの取得」をクリックします。

注意:
configFile.xmlファイルは、初期スナップショットまたは任意のドキュメントの最初の更新のどちらか最初に行われた方の、同じ構成に対して1度生成されます。

10.2.2.3 SESCrawlerExportパラメータの構成

SESCrawlerExportコンポーネントには、データ・フィードのソース、コンテンツ、メタデータ、データ・フィードごとのアイテム数などを指定するために構成できる、複数のパラメータがあります。パラメータに対する変更はただちに有効になりますが、変更内容を伝播するには、スナップショットを新たに再取得する必要があります。

これらのパラメータを構成する手順:

1. 「管理」→「SESCrawlerExport」を選択します。

2. 「SESCrawlerExport管理」ページで、「SESCrawlerExportの構成」をクリックします。

3. 次のSESCrawlerExportパラメータ・フィールドに値を入力するか、値を確認します。

要素

説明

ホスト名
(sceHostname)

エクスポートされるコンテンツをホスティングする、コンテンツ・サーバー・インスタンスのホスト名の文字列。値が空白の場合、ホスト名はOracle SESエクスポートを実行するホストに設定されます。このフィールドはIdoc対応です。

フィード・ロケーション
(sceFeedLoc)

構成ファイルとデータ・フィードが書き込まれるディレクトリ。configFile.xmlファイルはこの場所で生成されます。データ・フィードとコンテンツは、この場所のソース名を持つサブディレクトリで生成されます。

メタデータ・リスト
(sceMetadataList)

Oracle SESにエクスポートされるメタデータ値のカンマで区切られたリスト。この値が空白の場合、メタデータ値のリストは次のフィールドから構成されます。

- dID

- dDocName

- dRevLabel

- dDocType

- dDocAccount

- dSecurityGroup

- dOriginalName

- dReleaseDate

- dOutDate

- dDocCreator

- dDocLastModifier

- dDocCreatedDate

- dDocFunction

- fParentGUID

- fApplicationGUID

- すべてのカスタム・メタデータ・フィールド(文字"x"から始まるもの)

このリストに一連のメタデータ・フィールドが入力されている場合、それらのフィールドのみがOracle SESにエクスポートされます。これらのフィールドには、標準またはカスタム・メタデータ・フィールドを指定できます。

管理者の電子メール
(sceAdminEmail)

クローリング・エラーの発生時に電子メールで通知される、電子メール・アドレス、ユーザー名、ユーザー・エイリアスのカンマで区切られたリスト。

カスタム・メタデータ・ブラックリスト
(sceCustomMetadataBlacklist)

Oracle SESにエクスポートされない、メタデータ値のカンマで区切られたリスト。これらのフィールドには、標準またはカスタム・メタデータ・フィールドを指定できます。

SESによるソースごとの保留消費量の最大フィード(sceMaxFeedsPerSource)

SESによる保留中の消費量であるソースごとのデータフィードが指定された値を超えた場合に、新規データフィードの作成を制限する数。
フィードを制限するには、この数が0または正の値に設定されている必要があります。この数が負の値に設定されている場合、生成されるフィードは制限されません。

データフィード当たりの最大アイテム数
(sceMaxItemsPerFeed)

各データ・フィードのコンテンツ・アイテムの最大数。(フィード内のコンテンツ・アイテムは操作です。例: ドキュメントの挿入、更新または削除。)

コア・フィルタ
(sceCoreFilter)

コンテンツに対して事前フィルタ処理を実行して、Oracle SESへのエクスポート対象から削除します。この値はデフォルト設定のままにすることをお薦めします。

クローラ・ロール
(sceCrawlerRole)

Oracle SESがコンテンツ・サーバー・インスタンスのクロールに使用するアカウントで必要なコンテンツ・サーバーのロール。デフォルトでは、コンテンツ・サーバーのadminロールは必須です。
注意: Oracle SESからのクロールに、デフォルトのOracle WebLogic Server管理者アカウントは使用しないでください。かわりに、外部ソース(LDAPプロバイダなど)の管理者アカウントまたはローカルのコンテンツ・サーバー・アカウントを使用します。必要に応じて、このSESCrawlerExportフィールドを使用して、必須ロールadminを他のロールに変更できます。次に例を示します。

1. コンテンツ・サーバー・インスタンスで、scecrawlerroleという新規ロールを作成します。

2. 新規ローカル・ユーザー・アカウントsescrawlerを作成して、ロールscecrawlerroleをこのユーザー・アカウントに割り当てます。

3. Oracle SESで、sescrawlerアカウントを使用してコンテンツ・サーバー・インスタンスをクロールするように、ソース定義を変更します。

4. コンテンツ・サーバー・インスタンスで、config.cfgファイルにsceCrawlerRole=sescrawlerroleを追加します。

ソース名
(sceSourceName)

Webcenter Content Serveインスタンスで作成されたすべてのコンテンツ・ソースの、カンマで区切られたリスト。リストされた各ソースは、まったく同じです(ミラー化)。複数のソースを持つことで、このインスタンスのコンテンツを、複数のOracle SESサーバーが別々に消費できます。
これらのソース名がフィード・ロケーション・ディレクトリのサブディレクトリ名として使用されて、データ・フィードとコンテンツが保持されます。

注意: 名前「ssSource」は予約されたソース名で、このフィールドでは使用できません。

Secure APIの無効化
(sceDisableSecureAPIs)

SESCrawlerExportコンポーネントで提供されるサービスのセキュリティが内部的に実行されるか(false)、またはコンテンツ・サーバーによってネイティブに実行されるか(true)を判断する、ブール・フラグ。シングル・サインオンの詳細は、第10.2.2.3.2項を参照してください。

10.2.2.3.1 Oracle SESでのコンテンツ・サーバー・ソースの構成

コンテンツ・サーバー・コネクタにより、Oracle SESはWebCenter Contentでコンテンツ・サーバー・インスタンスを検索できるようになります。コネクタは、クローリング・スケジュールに従って、コンテンツ・サーバー・インスタンスにより提供されるフィードを読み取ります。Oracle SESからデータをクロールするには、タイプContent Serverのソースを作成する必要があります。コネクタ・パッチをインストールしてコンテンツ・サーバー・ソースを作成する方法は、Oracle Secure Enterprise Search管理者ガイドを参照してください。

コンテンツ・サーバー・ソースの設定には、次のパラメータを使用します。

- 構成URL:

http://host_name/instance_name/idcplg?IdcService=SES_CRAWLER_DOWNLOAD_CONFIG&source=source_name

source_nameで表されるパラメータは、SESCrawlerExportコンポーネントのソース名(sceSourceName)パラメータで使用される文字列の1つと同じである必要があります。このパラメータは、コンテンツ・サーバー・インスタンスのコンテンツ・ソースの1つを指しています。次に例を示します。

http://stahz16/ucm/idcplg?IdcService=SES_CRAWLER_DOWNLOAD_CONFIG&source=cs

- 認証および認可用HTTPエンドポイント: Oracle WebCenter Contentアイデンティティ・プラグインのアクティブ化および認可マネージャの構成時に、HTTPエンドポイントの値を求められます。一般に、2つの値は、同一のコンテンツ・サーバー・インスタンスでは同じで、形式はhttp://host_name/instance_name/idcplgです。たとえば、http://host.example.com/ucm/idcplgとなります。この値は、コンテンツ・サーバー・インスタンスに対するすべてのサービス・コールのエンドポイントとして使用されます。この値は、「管理」、「管理サーバー」、「インターネットの構成」の順に選択して検索することもできます。現在のURL (URLパラメータなし)をHTTPエンドポイントとして使用します。

10.2.2.3.2 コンテンツ・サーバー・ソースをOracle Single Sign-Onで構成

コンテンツ・サーバー・インスタンスがOracle Single Sign-On (OSSO)で保護されている場合、Oracle SESがSESCrawlerExportによって提供されるサービスにアクセスできるように、SESCrawlerExportコンポーネントの構成を変更する必要があります。「SESCrawlerExportの構成」ページに移動し、「Secure APIの無効化」パラメータをtrueに設定して、内部セキュリティ・メカニズムを無効にします。

10.2.2.3.3 Oracle Access Managerでのコンテンツ・サーバー・ソースの構成

コンテンツ・サーバー・インスタンスがOracle Access Manager (OAM)で保護されている場合、Oracle SESがSESCrawlerExportコンポーネントによって提供されるサービスにアクセスできるように、なんらかの変更を加える必要があります。

1. コンテンツ・サーバー・インスタンスのconfig.cfgファイルをテキスト・エディタで開きます。例: DomainHomeName/ucm/cs/config/config.cfg。

2. 次のプロパティ値を設定します。

HttpServerAddress=<OHSHost>:7778

ここで、OHSHostはOracle HTTP Server (OHS)ホスト名で、7778はOHSポートです。

3. コンテンツ・サーバー・インスタンスを再起動します。詳細は、3.2.3項を参照してください。

4. 「管理」→「SESCrawlerExport」を選択します。

5. 「SESCrawlerExport管理」ページで、「SESCrawlerExportの構成」をクリックします。

6. 「SESCrawlerExportの構成」ページで、「ホスト名」をクリックしてホスト名を<OHSHost>に設定します。

7. OAMで保護されたContent ServerインスタンスにアクセスするようにOracle SESを構成します。詳細は、『Oracle Secure Enterprise Search管理者ガイド』を参照してください。

10.2.2.3.4 コンテンツ・サーバー・ソースを他のシングル・サインオンで構成

コンテンツ・サーバー・インスタンスがOracle Single Sign-On (OSSO)以外のシングル・サインオン・ソリューションで保護されている場合、Oracle SESがSESCrawlerExportコンポーネントによって提供されるサービスにアクセスできるように、なんらかの変更を加える必要があります。

- 構成: Oracle Single Sign-On以外のシングル・サインオン・ソリューションを使用している場合、SESCrawlerExportコンポーネントによって提供されるサービスのセキュリティは、コンポーネント自体によって提供されます。「SESCrawlerExportの構成」ページに移動し、「Secure APIの無効化」パラメータをfalseに設定して、内部SESCrawlerExportセキュリティ・メカニズムを有効にします。

- Webサーバー: Oracle SESはシングル・サインオン・ソリューションと互換性がないため、SESCrawlerExportコンポーネントによって提供されるサービスへのアクセスは、シングル・サインオンをバイパスする必要があります。選択したシングル・サインオン・ソリューションによっては、バイパスを作成することが、サービスのサブセットへのアクセスを許可するようにWebサーバーを構成することと同じくらい簡単な場合もあります。
コンテンツ・サーバー・インスタンスで追加のWebサーバーを設定する場合、そのWebサーバーは標準のコンテンツ・サーバー・ポートとは別のポート(ポート80以外のポート)で実行される必要があります。シングル・サインオン保護をまったく設定せずに、この追加のWebサーバーを構成します。また、このWebサーバーへのOracle SESのアクセスのみを許可するように、アクセス制御リストを設定します。Oracle SESの構成では、コンテンツ・サーバー・ソースの構成URLで、この追加のWebサーバー・ポートを使用します。

10.2.2.4 コンテンツ・サーバー・ソース格納場所スクリプトの構成

コンテンツ・サーバー・ソース格納場所スクリプトは完全にカスタマイズ可能なIdocスクリプトで、コンテンツ・アイテムのメタデータを評価して、このコンテンツ・アイテムを設定するソースを返します。

ソース格納場所スクリプトを作成または更新するページにアクセスする手順:

1. 「管理」→「SESCrawlerExport」を選択します。

2. 「SESCrawlerExport管理」ページで、「SESCrawlerExportの構成」をクリックします。

3. 「SESCrawlerExportの構成」ページで、「ソース格納場所の構成スクリプト」をクリックします。

4. 表示された領域にIdocスクリプトを入力します。
デフォルトでは、ソース格納場所スクリプトは#allに設定され、Latest Releasedとフラグが付けられたすべてのコンテンツ・アイテムをコンテンツ・サーバー・インスタンスで構成されたすべてのソース(「ソース名」パラメータを参照)に送信します。#allソース名は、すべてのソースがコンテンツ・アイテムを受信することを示す予約キーワードです。

同様に、#noneソース名も予約キーワードですが、これはコンテンツ・アイテムをソースに送信しないことを示します(基本的に、コンテンツ・アイテムはOracle SESにエクスポートされない)。

5. 「更新」をクリックします。
ソース格納場所スクリプトを削除するには、「リセット」をクリックします。

6. ソース格納場所スクリプトをテストするには、コンテンツ・アイテムのドキュメント名(dDocName)を表示されたフィールドに入力して、「テスト」をクリックします。
スクリプトに構文エラーがある場合、構文エラーのタイプに応じて、エラーはページまたはサーバー出力に表示されます。論理エラーは、「SESCrawlerExportソース格納場所スクリプト」ページで修正して、ただちにテストを再実行できます。

スクリプトが存在しないソース名を返した場合、サーバー出力でエラーが生成されます。無効なソース名が削除され、アイテムの処理は続行されますが、ログに記録されます。この問題は、ソース名をスクリプトから削除するか、コンテンツ・サーバー・インスタンスに新しい「ソース名」パラメータ値を追加することで訂正できます。

スクリプトでは、複数のソース名をカンマで区切って返すことができます。

例

次の例では、ソース格納場所スクリプトを設定して、ドキュメント・タイプ(dDocType)がADACCTのすべてのコンテンツ・アイテムがaccountingという名前のソースに送信され、その他はすべてdefaultという名前のソースに含まれています。accountingおよびdefaultソースは、「SESCrawlerExportの構成」ページでそれぞれの名前を「ソース名」パラメータに追加することで、別個に設定する必要があります。

<$if dDocType like "ADACCT" $>
accounting
<$else$>
default
<$endif$>

10.3 フルテキスト・データベース検索索引の構成

フルテキスト・データベース検索およびSQL Serverやその他のデータベースの索引付けを設定して使用するには:

1. WebCenter Contentをコンテンツ・サーバー・インスタンスとともにインストールし、データベースを使用できるように構成します。

2. 次のエントリをDomainHomeName\ucm\cs\config\config.cfgファイルに追加して、ファイルを保存します。

SearchIndexerEngineName=DATABASE.FULLTEXT

3. コンテンツ・サーバー・インスタンスを再起動します。詳細は、3.2.3項を参照してください。

4. リポジトリ・マネージャを使用して、検索索引を再構築します。
リポジトリ・マネージャの詳細は、『Oracle WebCenter Contentのマネージング』を参照してください。

注意:
OCSスキーマのインポート後、フルテキスト・データベース検索索引の再構築に問題があると、「Oracleテキスト・コレクション'IdcText1'を作成できません。」というメッセージが表示されることがあります。この場合の解決策は、(コンテンツ・サーバーの)データベース管理者としてログインして、表IdcText1と表IdcText2を削除することです。
詳細は、『管理者ガイド』のOracle WebCenter Contentのバックアップおよびリカバリの推奨事項に関する項を参照してください。

11 検索索引の構成

この章では、Oracle WebCenter Content Serverの検索索引を構成する方法について説明します。コンテンツ・サーバーは、商用検索エンジンやデータベースなどの検索付けツールと接続して一緒に機能します。

この章の内容は次のとおりです。

- 多様な索引付けツールおよび方法

- データベースの検索索引の構成

- 検索索引の使用

- ゾーン・テキスト・フィールドの管理

- Oracle Query Optimizerを使用したコンテンツの検索

- 検索パフォーマンスの向上

11.1 多様な索引付けツールおよび方法

コンテンツ・サーバーは、商用検索エンジンやデータベースなどの検索付けツールと接続して一緒に機能します。使用する検索付けツールは、コンテンツ・サーバー・インスタンスが機能する目的や環境に基づいて、インストール前に選択されます。

各索引付けツールには、フルテキストの索引付けとメタデータのみの索引付け機能があります。フルテキストの索引付けでは、ファイル内のメタデータのみでなく、すべての語に索引が付けられます。フルテキストの索引付けは、メタデータの索引付けより時間がかかりますが、より包括的な結果セットが得られます。メタデータのみの索引付けでは、格納されたコンテンツ情報のすべての語に索引が付けられます。メタデータのみの索引付けは、フルテキストの索引付けよりも高速です。デフォルトでは、コンテンツ・サーバー・インスタンスは、メタデータのみの索引付けを使用するように構成されます。

11.2 データベースの検索索引の構成

システムが、データベースによる索引付けおよび検索機能を使用できるように設定されているとすれば、担当のシステム・インテグレータがIntradocDir/config/config.cfgファイルに次のいずれかの行を追加しているものと考えられます。

- メタデータ検索のみ:

SearchIndexerEngineName=DATABASE.METADATA

Oracle Fusion Middleware 11g リリース1 (11.1.1)でサポートされているすべてのデータベースで、DATABASE.METADATAがサポートされます。

- フルテキスト検索:

SearchIndexerEngineName=ORACLETEXTSEARCH

Oracle Databaseリリース11.1.0.7以上では、ORACLETEXTSEARCHがサポートされます。

- フルテキスト検索:

SearchIndexerEngineName=DATABASE.FULLTEXT

SQL ServerおよびOracle Database(サポートされている全リリース)で、DATABASE.FULLTEXTがサポートされます。

サポートされているデータベースに適したdbfulltextsearchスクリプトが実行されます。

- デフォルトでは、フルテキスト索引付けは、変換されたすべてのファイルに適用されます。

- デフォルトでは、次のいずれかのフォーマットを経た、またはそのフォーマットに変換されたファイルに、コンテンツ・サーバーはフルテキスト索引を付けます。
Oracleでサポートされているフォーマット

- pdf

- html

- htm

- xls

- hcsp

- text

- txt

- doc

- rtf

- ppt

MS SQLでサポートされているフォーマット

- text

- txt

- htm

- html

- doc

- msword

- ms-word

- ms-powerpoint

- ppt

- ms-excel

- xls

たとえば、Microsoft Word(.doc)ファイルをPDFのかわりにテキスト・ファイルに変換する場合、構成マネージャでこれを指定できます。つまり、「ファイル・フォーマット」オプションを使用して、.docファイル拡張子をテキスト・フォーマットにマップすると、これによってそのファイルがどのようにWeb表示可能フォーマットに変換されるかが定義されます。この場合、テキスト・ファイルは、Webサイトに渡される前に完全に索引付けされます。

構成マネージャの「ファイル形式」オプションの詳細は、『Oracle WebCenter Contentのマネージング』を参照してください。

- 「システム・プロパティ」ユーティリティでフォーマット・オーバーライド機能を有効にすれば、コントリビュータがファイルのフルテキスト索引付けをするかどうかを指定できます。詳細は、第8.3項を参照してください。
たとえば、構成マネージャの「ファイル形式」オプションを使用して、Corel WordPerfect (.wpd)ファイルをtextフォーマットが使用できるようにマップしている場合、コントリビュータがチェックイン・ページの「フォーマット」フィールドで「デフォルトの使用」オプションを選択すると、ファイルはテキストに変換され、フルテキスト索引が付けられます。コントリビュータが「Corel WordPerfectドキュメント」を選択した場合、ファイルはネイティブ・フォーマットで渡され、フルテキスト索引付けは行われません。

構成マネージャの「ファイル形式」オプションの詳細は、『Oracle WebCenter Contentのマネージング』を参照してください。

- フルテキスト検索を使用する場合、メタデータ検索では大文字と小文字が区別され、フルテキスト検索では区別されません。ただし、コンテンツIDの場合、小文字が大文字に変換されるため、小文字では検索できません。

注意:
索引付けのエラーを防ぐために、存在しないメタデータ・フィールドを構成マネージャのDrillDownFieldsパラメータに追加しないでください。また、SDATAセクションまたはDrillDownFieldsパラメータにメモ・フィールドを追加しないでください。詳細は、『Oracle Fusion Middleware Oracle WebCenter Contentのマネージング』を参照してください。

次の項では、その他の検索索引構成の手順を示します。

- 第11.2.1項「すべてのデータベースのメタデータ検索の構成」

- 第11.2.2項「SQL Serverの全文検索の構成」

- 第11.2.3項「OracleTextSearchの全文検索の構成」

- 第11.2.4項「全文検索の最適化」

- 第11.2.5項「データベースでサポートされるファイル形式の構成」

- 第11.2.6項「デフォルトの索引付けの変更」

11.2.1 すべてのデータベースのメタデータ検索の構成

すべてのデータベースでメタデータのみの検索および索引付けを設定および使用する手順は、次のとおりです。

1. Content Serverがインストールされており、データベースとともに使用するように構成されていることを確認してください。

2. 次のエントリをDomainHomeName/ucm/cs/config/config.cfgファイルに追加し、ファイルを保存します。

SearchIndexerEngineName=DATABASE.METADATA

3. コンテンツ・サーバー・インスタンスを再起動します。

4. リポジトリ・マネージャを使用して、検索索引を再構築します。

- リポジトリ・マネージャにアクセスするには、「管理」→「管理アプレット」→「リポジトリ・マネージャ」を選択します。

- 「インデクサ」タブの「コレクション再構築サイクル」部分で「開始」をクリックします。検索索引が完全に再構築され、再構築が完了すると古い索引コレクションは新しい索引コレクションに置き換えられます。

11.2.2 SQL Serverのフルテキスト検索の構成

SQL ServerおよびOracle Database(サポートされているすべてのバージョン)におけるフルテキストのデータベース検索および索引付けを設定して使用する手順は、次のとおりです。

1. Content Serverがインストールされており、データベースとともに使用するように構成されていることを確認してください。

2. 次のエントリをDomainHomeName/ucm/cs/config/config.cfgファイルに追加し、ファイルを保存します。

SearchIndexerEngineName=DATABASE.FULLTEXT

3. コンテンツ・サーバー・インスタンスを再起動します。

4. リポジトリ・マネージャを使用して、検索索引を再構築します。

- リポジトリ・マネージャにアクセスするには、「管理」→「管理アプレット」→「リポジトリ・マネージャ」を選択します。

- 「インデクサ」タブの「コレクション再構築サイクル」部分で「開始」をクリックします。検索索引が完全に再構築され、再構築が完了すると古い索引コレクションは新しい索引コレクションに置き換えられます。

11.2.3 OracleTextSearchのフルテキスト検索の構成

OracleTextSearch (Oracle Databaseバージョン11.1.0.7以降でサポートされています)によるフルテキストの検索および索引付けを設定して使用する手順は、次のとおりです。

1. Content Serverがインストールされており、データベースとともに使用するように構成されていることを確認してください。

2. 次のエントリをDomainHomeName/ucm/cs/config/config.cfgファイルに追加し、ファイルを保存します。

SearchIndexerEngineName=DATABASE.ORACLETEXTSEARCH

3. コンテンツ・サーバー・インスタンスを再起動します。

4. リポジトリ・マネージャを使用して、検索索引を再構築します。

- リポジトリ・マネージャにアクセスするには、「管理」→「管理アプレット」→「リポジトリ・マネージャ」を選択します。

- 「インデクサ」タブの「コレクション再構築サイクル」部分で「開始」をクリックします。検索索引が完全に再構築され、再構築が完了すると古い索引コレクションは新しい索引コレクションに置き換えられます。

OracleTextSearchの詳細は、第10.1項を参照してください。

11.2.4 全文検索の最適化

次の2つの設定のどちらかを使用してWebCenter Contentで全文検索を使用する場合、データベースではOracle Text索引を使用して検索のためのデータを管理します。

SearchIndexerEngineName=OracleTextSearch
SearchIndexerEngineName=DATABASE.FULLTEXT

Oracle Text検索を使用する際は、ディスクが断片化されないようにするためにデータベース上の索引を維持する必要があります。断片化を防ぐには、optimize_indexプロシージャを毎週実行する必要があります。このプロシージャは、WebCenter Contentのデータベース管理者がスケジュールする必要があります。

アクティブな索引の判別

WebCenter Contentシステムでどれがアクティブな索引であるかを判別するには、WebCenter Contentシステムにログインして、「管理」を選択し、「インスタンスの構成」を選択します。「構成」ページで、Oracle Text Searchに対して次のような情報が表示されます。

Search Engine::ORACLETEXTSEARCH
Index Engine Name:ORACLETEXTSEARCH
Active Index:ots2

全文検索データベースに対して次のような情報が表示されます。

Search Engine::DATABASE.FULLTEXT
Index Engine Name:DATABASE.FULLTEXT
Active index:IdcColl1

「アクティブな索引」の値は、データベース内でアクティブな表と索引を示します。

SearchIndexerEngineName

アクティブな表

データベース表

データベース索引

OracleTextSearch

ots1

IDCTEXT1

FT_IDCTEXT1

OracleTextSearch

ots2

IDCTEXT2

FT_IDCTEXT2

DATABASE.FULLTEXT

IdcColl1

IDCCOLL1

FT_IDCCOLL1

DATABASE.FULLTEXT

IdcColl2

IDCCOLL2

FT_IDCCOLL2

Oracle Text索引に最適化が必要かどうかの決定

Oracle Text索引が断片化されており最適化の必要があるかどうかを決定するために、CTX_REPORTパッケージのINDEX_STATSというレポートに、Oracle Text検索に使用されるWebCenter Content索引がわかりやすく表示されます。CTX_REPORTパッケージの詳細は、Oracle Textリファレンス・ガイドを参照してください。

optimize_indexプロシージャの実装

データベース管理者がデータベース上でoptimize_indexプロシージャを毎週(通常週末または使用量が少ないとき)またはデータベース管理者の推奨に従って必要に応じて実行するスケジュールを作成するようリクエストします。パラメータはプロシージャへのコール内で調整できますが、デフォルトの実行では次の例に示すパラメータが使用されます。

begin
ctx_dll.optimize_index('FT_IDCTEXT1','FULL',parallel_degree=>'1');
end;

初めてoptimize_indexプロシージャを実行すると、データベースに大量のログが作成される場合があります。optimize_indexが完了できないか、データベース上のログ・ファイルがいっぱいになっている場合は、データベースをNOARCHIVELOGモードで再起動してから、optimize_indexプロシージャを実行してください。最適化プロシージャが完了したら、データベースをARCHIVELOGモードで再起動します。

11.2.5 データベースでサポートされるファイル形式の構成

ファイル形式をネイティブ・フォーマットでPASSTHRUに定義し、そのフォーマット名に前述のリストにあるタイプの1つが含まれている場合(application/ms-excel.nativeなど)、通過するネイティブ・ファイルにはデフォルトでフルテキスト索引が作成されます。

または、構成変数を使用して、ドキュメントにフルテキスト索引を作成するかどうかを制御することもできます。特定のドキュメント・フォーマット・タイプのフルテキスト索引および検索を管理するには、IntradocDir/config/config.cfgに該当するエントリを追加し、ファイルを保存します。フルテキスト索引付け構成変数には、次のものがあります。

- FormatMap

- ExceptionFormatMap

11.2.5.1 FormatMap

FormatMap構成変数は、フルテキスト検索索引に特定のフォーマットを含めるべきかどうかを制御します。これは、フルテキスト索引付けの対象となるすべてのフォーマットのカンマ区切りのリストです。ファイルに割り当てられたMIMEタイプを取得し、MIMEタイプをスラッシュ(/)またはピリオド(.)で分割し、その値がFormatMapリストにあるかどうかを調べることで決定します。

たとえば、application/vnd.mswordは、次の3項目のリストになります。

- application

- vnd

- msword

FormatMapのリストにmswordがある場合、インデクサ・エンジンではファイルにフルテキスト索引付けが試みられ、比較テストでは大文字と小文字は区別されません。

11.2.5.2 ExceptionFormatMap

ExceptionFormatMap構成変数は、FormatMapテストからドキュメント・フォーマットを除外するために使用されます。ExceptionFormatMapテストに適合するフォーマットは、フルテキスト索引の対照にはなりません。このテストは、MIMEフォーマットをピリオド(.)ではなく、スラッシュ(/)で分割してから実行されます。たとえば、例外リストにmswordが含まれている場合、MIMEフォーマットapplication/mswordは除外されますが、application/vnd.msswordは除外されません。

11.2.6 デフォルトの索引付けの変更

使用されている検索エンジンにより、Content Serverはメタデータのみか、またはメタデータとコンテンツ・アイテムのフルテキストの両方を索引付けします。デフォルトでは、コンテンツ・アイテムのファイル形式およびいくつかのそれ以外のファイル関係の考慮事項に基づいて、フルテキストの索引付けが実行されます。

コンテンツ・アイテムが検索索引に転送される前に、Content Serverはstd_indexable_format_scriptリソースを実行します。デフォルトの索引付け条件を変更するには、カスタム・コンポーネントを作成して、std_indexable_format_scriptリソースを変更します。たとえば、MIMEタイプに基づき、またはカスタム・メタデータ・フィールドを含むメタデータ・フィールドの値に基づき、コンテンツ・アイテムのフルテキストの索引付けを選択的に含めるまたは除外することができます。

この項の内容は次のとおりです。

- 第11.2.6.1項「リソースの索引付けのデフォルト」

- 第11.2.6.2項「リソース・インクルードの索引付けの例」

カスタム・コンポーネントの作成の詳細は、『Oracle WebCenter Contentでの開発』を参照してください。

11.2.6.1 リソースの索引付けのデフォルト

std_indexable_format_scriptリソースのデフォルト・スクリプトは次のとおりです。

<@dynamichtml std_indexable_format_script@>

<$loop DocIndexableFormats$>
<$if DocIndexableFormats.fileSize <= MaxIndexableFileSize and
DocIndexableFormats.fileSize >= MinIndexableFileSize$>
<$indexableFilePath = DocIndexableFormats.filePath$>
<$indexableFileSize = DocIndexableFormats.fileSize$>
<$indexableFileURL = DocIndexableFormats.url$>
<$if isFalse(DocIndexableFormats.allowDirectIndex) and
isTrue(DocIndexableFormats.allowConversion)$>
<$indexerConversionHandler = DocIndexableFormats.conversionHandler$>
<$endif$>
<$if isTrue(DocIndexableFormats.useMap)$>
<$indexerUseMap = "1"$>
<$indexerMapExtension = DocIndexableFormats.mapExtension$>
<$endif$>
<$break$>
<$endif$>
<$endloop$>

<@end@>

このスクリプトはコンテンツ・アイテムと索引付け可能形式のリストを比較します。一致を検出すると、ファイルが確立されたサイズ範囲内であるかどうかを判断し、コンテンツ・アイテムに索引関係値の数を設定します。

11.2.6.2 リソース・インクルードの索引付けの例

シナリオ1:

ユーザーが特定のドキュメント・タイプにチェックインするときに、コンテンツ・アイテムの索引付けに、メタデータのみを使用するか、またはメタデータとフルテキストの両方を使用するかのいずれかを選択できます。

方法1:

ドキュメントの索引付けに、メタデータのみを使用するか、またはメタデータとフルテキストの両方を使用するかをユーザーが指定できるようにするには、次の2つの値を含むリストを使用してカスタム・メタデータ・フィールド(xIsFullTextSearchableなど)を作成します: YesおよびNo (Yesがデフォルト)。そのため、ユーザーがアカウンティング・データを含むドキュメントにチェックインすると、フルテキストを使用して索引付けできず、xIsFullTextSearchableの値はNoに設定されます。

この方法を実装するには、カスタム・フィールドの値をチェックする新しいIF文にデフォルトのリソース・コードを含むカスタム・コンポーネントを作成します。

<@dynamichtml std_indexable_format_script@>

<$if strEquals(xIsFullTextSearchable, "Yes")$>

<$loop DocIndexableFormats$>
.
.
.
<$endloop$>

<$endif$>
<@end@>

シナリオ2:

それ自体が索引付けされたコンテンツ・アイテムのWeb表示可能レンディションに対し、フルテキスト索引を実行しないでください。

方法2:

この方法を実装するには、FormatTypeの値をチェックして、アイテムがネイティブ・ファイル(FormatType="vault")またはWeb表示可能レンディション(FormatType="webviewable")であるかを判断する新しいIF文にデフォルトのリソース・コードを含むカスタム・コンポーネントを作成します。

<@dynamichtml std_indexable_format_script@>

<$if strEquals(FormatType, "vault")$>

<$loop DocIndexableFormats$>
.
.
.
<$endloop$>

<$endif$>
<@end@>

11.3 検索索引の使用

この項の項目は次のとおりです。

- 第11.3.1項「検索索引」

- 第11.3.2項「検索索引の更新」

- 第11.3.3項「コレクションの再構築」

- 第11.3.4項「検索索引の更新またはコレクションの再構築の構成」

- 第11.3.5項「フルテキストの索引付け」

- 第11.3.6項「フルテキストの索引付けの無効化」

- 第11.3.7項「デフォルトでのネイティブ・ファイルの索引付け」

- 第11.3.8項「電子メールおよび添付ファイルの索引付け」

11.3.1 検索索引

リポジトリ・マネージャ・ユーティリティには、管理者が検索索引に対してアクションを実行するために使用できる「インデクサ」タブがあります。

リポジトリ・マネージャにアクセスするには、「管理」→「管理アプレット」→「リポジトリ・マネージャ」を選択します。リポジトリ・マネージャには、スタンドアロン・アプリケーションとしてアクセスすることもできます。詳細は、第3.5.2項を参照してください。

リポジトリ・マネージャ・ウィンドウの「インデクサ」タブでは、管理者が次のアクションを実行できます。

- 検索索引の更新: 索引データベースを追加的に更新します。索引はサーバーにより約5分ごとに自動的に更新されるため、これは通常必要ありません。

- コレクションの再構築: 検索索引が完全に再構築され、古い索引コレクションは新しい索引コレクションに置き換えられます。

- 更新または再構築の一時停止: 更新または再構築を一時的に停止します。適切な「開始」ボタンをクリックすることで、プロセスを再開できます。

- 検索更新の取消し: 索引の更新プロセスが終了し、その時点までに処理されたファイルのみが検索エンジンでアクセス可能になります。

- コレクション再構築の取消し: 索引再構築プロセスが終了し、前の索引データベースが引き続き検索エンジンによって使用されます。

リポジトリの管理方法の詳細は、『Oracle WebCenter Contentのマネージング』を参照してください。

11.3.2 検索索引の更新

1. 「リポジトリ・マネージャ」ウィンドウで、「インデクサ」タブを選択します。

2. 「自動更新サイクル」領域で「開始」をクリックします。

11.3.3 コレクションの再構築

1. 「リポジトリ・マネージャ」ウィンドウで、「インデクサ」タブを選択します。

2. 「コレクション再構築サイクル」領域で「開始」をクリックします。

注意:
OracleTextSearchには高速再構築機能があり、サイトでOracleTextSearch機能を使用する場合、リポジトリ・マネージャのインデクサ機能から使用できます。詳細は、第10.1.2.2項を参照してください。

11.3.4 検索索引の更新またはコレクションの再構築の構成

検索索引の更新またはコレクションの再構築のためのパラメータを設定するには、次のようにします。

1. 「リポジトリ・マネージャ」ウィンドウで、「インデクサ」タブを選択します。

2. 画面の「自動更新サイクル」領域または「コレクション再構築サイクル」領域のいずれかで、「構成」をクリックします。「自動更新サイクル」ウィンドウまたは「コレクション再構築サイクル」ウィンドウが表示されます。

3. インデクサ・バッチ当たりのコンテンツ・アイテム(ファイル)数を指定します。これは、検索索引で同時に処理されるファイルの最大数です。
デフォルトは25です。たとえば、25ファイルがまとめて索引付けされた後、次の25ファイルが索引付けされます。ただし、1つのアイテムが失敗すると、バッチが再び処理されます。

4. チェックポイント当たりのコンテンツ・アイテム(ファイル)数を指定します。これは、関連するすべての索引付け状態を一度に通過するファイルの数です。チェックポイントごとに、複数のファイル・バッチを索引付けできます。

5. インデクサのデバッグ・レベルを指定します。これは、サーバー・ウィンドウで表示する各ファイルの関連情報の量です。サーバー・ウィンドウ内にリストされたデバッグ情報が多いほど、索引付けの速度は下がります。レベルには、次のものがあります。

- なし: 各ファイル・アクセスの情報は表示されず、ログは生成されません。

- 詳細: アクセスされた各ファイルの情報が表示されます。「索引付け」、「無視」または「失敗」が示され、完全なレポートが生成されます。

- デバッグ: 中間レベルの情報、特に機能的なものが表示されます。

- トレース: 実行された各アクティビティの最低レベルの情報が表示されます。

- すべて: 最高レベルのデバッグ情報が表示されます。

6. 「自動更新サイクル」を選択した場合は、「インデクサの自動更新」チェック・ボックスが利用可能になります。選択すると、索引データベースは自動的に更新されます。

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

11.3.5 フルテキストの索引付け

索引付けエンジンとしてDATABASE.FULLTEXTまたはORACLETEXTSEARCHを使用するようにコンテンツ・サーバー・インスタンスを構成した場合、コンテンツ・サーバーでは、Outside Inコンテンツ・アクセス・モジュールを使用して、チェックイン時にコンテンツをテキスト・ファイルにエクスポートします。その後、テキスト・ファイルは、フルテキスト索引付けのためにフルテキスト・インデクサに渡されます。

注意:
Outside Inコンテンツ・アクセス・モジュールでPostScriptファイルを変換する際、変換プロセスで余分な文字を含むテキストが生成されます。残念ながらこれにより、フルテキスト索引付けされてもフルテキスト検索ができないファイルが作成されます。

DATABASE.FULLTEXTを使用する場合、フルテキスト検索は、大きなドキュメントでは問題になる可能性があります。デフォルトでは、索引付けされる最大のドキュメント・サイズは10MBです。これは、コンテンツ・サーバー・リポジトリでMaxIndexableFileSize構成変数を設定すれば変更できます。デフォルトは、MaxIndexableFileSize=10485760です。それより大きなドキュメントでフルテキスト索引付けが必要な場合は、MaxIndexableFileSizeの値を増やす必要があります。

Oracleデータベースでフルテキスト検索を使用している場合(OracleTextSearch方式およびDATABASE.FULLTEXT検索方式の両方に適用される)に検索コレクションを最適化する方法の詳細は、第11.2.4項およびhttps://blogs.oracle.com/kyle/entry/full_text_indexing_you_mustを参照してください。

11.3.6 フルテキストの索引付けの無効化

たとえば、ファイル・スペースを節約したり、特定のコンテンツ・タイプにフルテキスト検索が不要な場合などには、フルテキスト索引付けを無効にできます。フルテキスト索引付けを無効にしても、メタデータには索引が付けられます。

特定のファイルに対してフルテキスト索引付けを無効にするには、次のようにします。

1. 構成マネージャ画面で、「アプリケーション/索引なし」というフォーマットを定義します。

2. 「チェックイン時にフォーマットのオーバーライドを許可」設定を有効にします。詳細は、第8.3項を参照してください。

3. ユーザーは、索引付けが不要なファイルをチェックインする際、「アプリケーション/索引なし」フォーマットを選択する必要があります。標準ファイル、バッチ・ロードおよびアーカイブされたリビジョンがこれに当てはまります。

11.3.7 デフォルトでのネイティブ・ファイルの索引付け

検索索引では、索引付けにデフォルトでWebレイアウト・ファイルを使用します。状況によっては、Webレイアウト・ファイルのかわりに、デフォルトでネイティブ・ファイルに索引を付ける方が便利な場合があります。たとえば、処理上の問題のために、変換されたPDFファイルを抽出して索引付けできない場合、ネイティブのWordドキュメントまたはかわりのタイプのドキュメントを抽出して、索引を付けることができます。あるいは、プライマリ・ファイルが.exeファイルであるために索引付けできなくても、かわりの.txtファイルがある場合、そのファイルに索引付けができます。

検索索引で、ネイティブ・ファイルをデフォルトで索引付けに使用できるようにするには、コンテンツ・サーバー・インスタンスで次のパラメータを設定します。

UseNativeFormatInIndex=true

11.3.8 電子メールおよび添付ファイルの索引付け

コンテンツ・サーバーでは、電子メールおよび添付ファイル(元のファイルやzipファイルなど)の索引付けがサポートされています。電子メールのメッセージはデフォルトで索引付けされ、メッセージに添付ファイルが含まれる場合は、それも抽出され、全文として検索付けされます。検索結果で返されるものには変わりはなく、検索によりドキュメント内に情報が見つかった場合、そのドキュメントのメタデータが返されます。Outside Inテクノロジでサポートされている電子メールの添付ファイルはすべて、検索索引でサポートされます。

11.4 ゾーン・テキスト・フィールドの管理

この項で説明する機能は、データベース検索の「次を含む」演算子機能をインストールし、有効にしてある場合にのみ使用可能です。

注意:
この機能は、OracleTextSearchコンポーネントでは必要ありません。

この項の項目は次のとおりです。

- 第11.4.1項「ゾーン・テキスト・フィールド」

- 第11.4.2項「ゾーン・テキスト・フィールドの有効化および無効化」

- 第11.4.3項「テキスト・フィールドの最小限の長さの変更」

- 第11.4.4項「データベース検索の「次を含む」演算子の無効化」

11.4.1 ゾーン・テキスト・フィールド

データベース検索の「次を含む」演算子を使用すると、SQLサーバーおよびOracleでデータベースおよびデータベース・フルテキスト検索を実行する際、テキスト・フィールドの検索に「次を含む」検索演算子を使用できます。まず、「次を含む」検索演算子を使用して問合せができるテキスト・フィールドを有効にする必要があります。これらのテキスト・フィールドは、ゾーン・テキスト・フィールドと呼ばれます。

テキスト・フィールドがゾーン・テキスト・フィールドとして追加されると、そのフィールド内のテキストは解析され、データベースにフィールドのフルテキスト索引が作成されます。データベースにより索引作成の全作業が実行され、そのテキスト・フィールドがゾーン・テキスト・フィールドとして無効になると、索引はデータベースから削除されます。したがって、テキスト・フィールドをゾーン・テキスト・フィールドとして有効または無効にした後で、コレクションを再構築する必要はありません。

重要:
テキスト・フィールドをゾーン・テキスト・フィールドに変更すると、非常に時間がかかる場合があります。この処理で、テキストを解析し、フルテキスト索引を作成するのに要する時間は、コンテンツ・サーバー・リポジトリにあるコンテンツ・アイテムの数と、テキスト・フィールドに格納されているテキストの量によって異なります。ただし、テキスト・フィールドに索引が付いていると、コンテンツ・アイテムの更新および追加時に、パフォーマンスが大幅に低下することはありません。

テキスト・フィールドがゾーン・テキスト・フィールドとして有効になっていると、「拡張検索」ページでそのテキスト・フィールドに対してCONTAINS検索演算子を使用できます。それは、そのテキスト・フィールドの隣のリストに、「語を含む」オプションとして表示されます。

図11-1 「語を含む」オプション

11.4.2 ゾーン・テキスト・フィールドの有効化および無効化

注意:
ここで説明する機能は、データベース検索の「次を含む」演算子機能をインストールし、有効にしてある場合にのみ使用可能です。ゾーン・テキスト・フィールド機能は、OracleTextSearchコンポーネントでは必要ありません。

ゾーン・テキスト・フィールドを有効または無効にする際、次のことを考慮してください。

- カスタム・テキスト・フィールド(「コメント」テキスト・フィールドおよびカスタマ作成のテキスト・フィールド)がデータベースとデータベース検索エンジンとの間で共有されるため、一方の検索エンジンでこれらのテキスト・フィールドのステータスを変更すると、その変更がもう一方の検索エンジンにも適用されます。

- 標準テキスト・フィールド(「作成者」、「コンテンツID」、「コンテンツ・タイプ」、「タイトル」など)は、検索エンジンごとに有効化または無効化できます。

- データベースにより索引作成の全作業が実行され、そのテキスト・フィールドがゾーン・テキスト・フィールドとして無効になると、索引はデータベースから削除されます。したがって、テキスト・フィールドをゾーン・テキスト・フィールドとして有効または無効にした後で、コレクションを再構築する必要はありません。

- ゾーン・テキスト・フィールドは、無効にしなければ、構成マネージャを使用してコンテンツ・サーバー・インスタンスから削除できません。有効なテキスト・フィールドを構成マネージャを使用して削除し、「データベース設計の更新」をクリックすると、エラーが発生します。
ゾーン・テキスト・フィールドを無効にすることで、そのフィールドの索引がデータベースから削除され、フィールドをデータベースから削除できます。ゾーン・テキスト・フィールドを無効にするかわりに、データベースにログインし、フィールドの索引を削除するコマンドを発行して、フィールドを削除することもできます。

- すべてのゾーン・テキスト・フィールドを無効する場合は、機能をアンインストールする前に行います。そうしないと、手動でゾーン・テキスト・フィールドを無効にするか、またはゾーン・テキスト・フィールドの索引をデータベースから削除する機能を再インストールしないかぎり、ゾーン・テキスト・フィールドをコンテンツ・サーバー・インスタンスから削除することはできません。

ゾーン・テキスト・フィールドを有効および無効にする手順は次のとおりです。

1. 「管理」→「ゾーン・フィールドの構成」を選択します。

図11-2 ゾーン・フィールドの構成

注意:
カスタム・テキスト・フィールド(「コメント」テキスト・フィールドおよびカスタマ作成のテキスト・フィールド)は、Database検索エンジンとDatabaseFullText検索エンジンとの間で共有されます。したがって、一方の検索エンジンでこれらのテキスト・フィールドのステータスを変更すると、その変更がもう一方の検索エンジンにも適用されます。標準テキスト・フィールド(「作成者」、「コンテンツID」、「コンテンツ・タイプ」、「タイトル」など)は、検索エンジンごとに有効化または無効化できます。

2. 「ゾーン・フィールドの構成」ウィンドウで、ゾーン・テキスト・フィールドの検索に使用する検索エンジン(DatabaseまたはDatabaseFullTextのどちらか)を選択します。

3. テキスト・フィールドをゾーン・テキスト・フィールドとして有効にする手順は次のとおりです。

1. 「テキスト・フィールド」リストで、(選択した検索エンジンの)テキスト・フィールドを選択します。[Ctrl]キーおよび[Shift]キーを押して、複数のフィールドを選択できます。
デフォルトでは、フィールド長が20文字以下のテキスト・フィールドは「テキスト・フィールド」リストに掲載されません。この設定を変更するには、MinFullTextFieldLength構成変数を変更します。詳細は、第11.4.3項を参照してください。

2. 左矢印ボタンをクリックして、テキスト・フィールドを「ゾーン・テキスト・フィールド」リストに移動します。

3. 「更新」をクリックします。このアクションは、「ゾーン・テキスト・フィールド」リストのテキスト・フィールドをゾーン・テキスト・フィールドとして有効化し、「テキスト・フィールド」リストのテキスト・フィールドを無効化します。また、すべてのゾーン・テキスト・フィールド内のテキストを解析し、Contains検索演算子を使用して問い合せることができるフルテキスト索引を作成します。

重要:
テキスト・フィールドをゾーン・テキスト・フィールドに変更すると、非常に時間がかかる場合があります。この処理で、テキストを解析し、フルテキスト索引を作成するのに要する時間は、コンテンツ・サーバー・リポジトリにあるコンテンツ・アイテムの数と、テキスト・フィールドに格納されているテキストの量によって異なります。ただし、テキスト・フィールドに索引が付けられている場合は、コンテンツ・アイテムを更新および追加するとき、パフォーマンスが大幅に低下することはありません。

4. ゾーン・テキスト・フィールドを無効にする手順は次のとおりです。

1. 「ゾーン・テキスト・フィールド」リストでゾーン・テキスト・フィールドを選択します。[Ctrl]キーおよび[Shift]キーを押して、複数のフィールドを選択できます。

2. 右矢印ボタンをクリックして、テキスト・フィールドを「テキスト・フィールド」リストに移動します。

3. 「更新」をクリックします。

5. リストの変更開始後に、最後に保存したリストに戻る場合は、「リセット」をクリックします。

11.4.3 テキスト・フィールドの最小限の長さの変更

注意:
ここで説明する機能は、データベース検索の「次を含む」演算子機能をインストールし、有効にしてある場合にのみ使用可能です。ゾーン・テキスト・フィールド機能は、OracleTextSearchコンポーネントでは必要ありません。

デフォルトでは、フィールド長が20文字以下のテキスト・フィールドは「テキスト・フィールド」リストに掲載されません。この設定を変更するには、MinFullTextFieldLength構成変数を変更します。この変数を変更する手順は次のとおりです。

1. テキスト・エディタを使用して、IntradocDir/config/ディレクトリにあるconfig.cfgファイルを開きます。

2. MinFullTextFieldLength構成変数を追加し、その値を設定します(デフォルト値は21です)。次に例を示します。

MinFullTextFieldLength=16

3. config.cfgファイルへの変更を保存します。

4. コンテンツ・サーバー・インスタンスを再起動します。

11.4.4 データベース検索の「次を含む」演算子の無効化

注意:
ここで説明する機能は、データベース検索の「次を含む」演算子機能をインストールし、有効にしてある場合にのみ使用可能です。ゾーン・テキスト・フィールド機能は、OracleTextSearchコンポーネントでは必要ありません。

データベース検索の「次を含む」演算子を無効にする前に、すべてのゾーン・テキスト・フィールドを無効にできます。データベースには、有効なゾーン・テキスト・フィールドごとに索引が保存されています(索引は、ゾーン・テキスト・フィールドが無効になると削除されます)。データベースにフィールドの索引が保存されている場合、構成マネージャを使用してそのフィールドをコンテンツ・サーバー・インスタンスから削除することはできません。詳細は、第11.4.2項を参照してください。

機能を無効にした後で、ゾーン・テキスト・フィールドとして有効なフィールドを削除する場合は、次のいずれかの方法があります。

- 機能を再インストールし、ゾーン・テキスト・フィールドを無効にして、構成マネージャでフィールドを削除してから、機能をアンインストールします。

- データベースにログインし、フィールドの索引を削除するコマンドを発行してから、構成マネージャを使用してフィールドを削除します。

11.5 Oracle Query Optimizerを使用したコンテンツの検索

OracleQueryOptimizerコンポーネントは、デフォルトではコンテンツ・サーバー・インスタンスによりインストール(有効化)されます。この機能は、Oracleデータベースでのみ機能します。

この項の項目は次のとおりです。

- 第11.5.1項「Oracle Query Optimizerについて」

- 第11.5.2項「問合せの最適化プロセス」

- 11.5.3「問合せの再フォーマットによる検索の最適化」

- 11.5.4「認識されるヒントのタイプ」

- 11.5.5「問合せヒントの構文」

- 11.5.6「サポートされているその他のソート構造体」

- 第11.5.7項「ヒント・ルール表」

- 第11.5.8項「ヒント・ルール・フォームの編集」

- 第11.5.9項「ヒント・キャッシュ」

- 第11.5.10項「ヒント・ルールの使用」

- 11.5.11「問合せコンバータの使用」

- 第11.5.12項「ヒント・キャッシュの更新」

11.5.1 Oracle Query Optimizerについて

Oracleデータベースでは、一部のタイプのユーザー問合せに対して、最良の実行計画が自動的に選択されません。これに対処するため、Oracle Query Optimizerにより、Oracleデータベースで検索がより効率的に実行されるようにするヒントを問合せに追加します。

ヒントは、コンテンツ・サーバーの表データ配布およびその索引選択性の本質的な知識に基づいています。この知識を利用するために、Oracle Query Optimizerでは、事前定義のヒント・ルール表を使用して、データベース問合せを分析し、その問合せに適切なヒントを追加します。その結果、追加されたヒントにより、Oracleの検索効率が改善されます。

Oracle Query Optimizerでは、Content Serverのデータベース表でのデータ配布と、その索引選択プリファレンスを利用します。これらの特性に基づき、Oracle Query Optimizer付属のヒント・ルール表には、事前定義のルールが含まれています。この機能では、これらのルールを使用してデータベース問合せを分析し、検索効率を最適化するための1つ以上の適切なヒントを追加します。

数百万のコンテンツ・アイテムを含む非常に大きなコレクションでは、通常、コンテンツ・サーバー・ソフトウェアは、簡単な問合せを解決する場合でも、適切な最適化戦略をなかなか選択できません。この問題に対処するために、Oracle Query Optimizerでは、発行された問合せを検査し、その分析に基づいて、検索プロセスを最適化する適切なヒントを追加することで、問合せを再フォーマットします。この機能では、ヒントを追加するために、コンテンツ・サーバーのヒント、ヒント・ルール表およびヒント・キャッシュが使用されます。

11.5.2 問合せ最適化プロセス

最適化プロセスのステージは、次の順序で完了します。

1. 発行された問合せは、1つ以上のヒントが含まれているかどうかを確認し、含まれる場合は、ヒントのタイプ判断するために分析されます。詳細は、第11.5.2.1項を参照してください。

2. 問合せのWHERE句にヒントが含まれていない場合、最適化機能によりWHERE句を解析する必要があります。詳細は、第11.5.2.2項を参照してください。

3. 解析後、問合せのWHERE句の各条件が、ヒント・ルール表に照合して評価され、条件の修飾および正規化が試みられます。詳細は、第11.5.2.3項を参照してください。

4. WHERE句の条件が修飾され、問合せが正規化されると、ヒントが選択されるか、ヒント・キャッシュから取得されます。詳細は、第11.5.2.4項を参照してください。

5. 問合せは選択したヒントを使用して再フォーマットされます。詳細は、第11.5.2.5項を参照してください。

図11-3 最適化プロセスの順序

11.5.2.1 ステージ1: 問合せ分析

このステージでは、Oracle(ネイティブ)とコンテンツ・サーバーの両方のヒントがないか、問合せをチェックします。これは、ヒント構文に基づいて判断されます。「問合せヒント構文」を参照してください。Oracleヒントが含まれる問合せは通過します。コンテンツ・サーバーのヒントが含まれる問合せは、ステージ2: 解析およびステージ3: 正規化を迂回して先に進みます。問合せに複数のコンテンツ・サーバーのヒントが含まれる場合、最良のヒントが選択されます。ヒントが含まれていない問合せは、解析と正規化化が必要です。

11.5.2.2 ステージ2: 解析

このステージでは、ヒントが含まれていない問合せが問合せパーサーを通して送られ、WHERE句が解析されます。WHERE句は、ANDまたはORのいずれかの接続詞で接続された1つ以上の条件で構成されています。条件ごとに、フィールド名、演算子およびフィールド値が抽出されます。句のANDまたはOR接続詞は残されますが、カッコは削除されます。条件には次のフォーマットを使用する必要があります。

fieldname operator value

たとえば、正しいフォーマットの条件はdID = 3となります。3 = dIDは間違った条件です。

11.5.2.3 ステージ3: 正規化

このステージでは、正規化により条件を単純化し、問合せ演算子を確定して、追加の手順のためにWHERE句の表示を安定させます。正規化プロセスの結果は、キャッシュ・キーと、ヒント検索に使用するフィールドのリストを生成するための基礎となります。

注意:
どのデータベース表や列に索引を付けるかを設定するために、ヒント・ルール表がコンテンツ・サーバー・リソースおよび実行中のシステムで定義されます。

- WHERE句の条件の修飾:
WHERE句内の各条件は、ヒント・ルール表に照合してチェックされます。条件のフィールド名がヒント・ルール表に含まれている場合、それが修飾され、正規のものとみなされます。条件には、その表の名前とエイリアスが含まれます。次に、正規化された条件は、同じセットの条件が常に一貫してリストに表示されるようにソートされます。

- 正規化時のWHERE句条件の破棄:
正規化時に、次の条件は不適切とみなされて、その後の処理から除外されます。

- 結合条件。

- 副問合せを含む条件。

- フィールド名にヒント・ルール表内のエントリが含まれておらず、修飾できない条件。

- 複数のフィールドを含むOR条件。次に例を示します。

(dSecurityGroup = 'Secure' or dDocAccount LIKE 'prj%')

- 値がワイルドカードで始まるLIKE演算子を含む条件。

- WHERE句条件の再フォーマット:
正規化の手順で、問合せ条件は、複雑な問合せ条件をまとめるために書き換えられます。OR条件は、次のように再評価されます。

- すべてのフィールドが同じで、すべての演算子が等しい(またはすべての演算子がLIKEで、ワイルドカードで始まる値がない)場合、条件は結合され、1つのIN問合せに変更されます。

- フィールドは同じでも、演算子が異なる場合、条件は結合され、汎用演算子が割り当てられます。

- フィールドが異なる場合、条件は削除されます。

たとえば、正規化中に、次の条件は再フォーマットされます。

(dReleaseState = 'Y' OR dReleaseState = 'O")

これは次のように再フォーマットされます。

dReleaseState IN ('Y', 'O')

- 使用可能な範囲問合せの確認:
解析した問合せは、使用可能な範囲問合せがないか分析され、それらは正規化のプロセスでまとめられます。たとえば、条件dIndate > date1およびdInDate < date2は、range演算子を使用して1つの条件にまとめられます。

11.5.2.4 ステージ4: ヒントの選択

このステージでは、正規化された条件が、ヒント・キャッシュに照合してチェックされます。1つ以上の条件で、キャッシュ内に適用可能なヒントが見つかった場合、それらは含まれます。キャッシュで適用可能なヒントが見つからない場合、条件は分析され、考えられる最良のヒントを決めるために、優先順位が比較されます。

11.5.2.5 ステージ5: 問合せの再フォーマット

このステージでは、選択したヒントを付け加えることで、問合せが再フォーマットされます。検索の最適化に役立つヒントで問合せを再フォーマットする方法の詳細と、再フォーマットされた問合せのいくつかの例は、第11.5.3項「再フォーマットされた問合せによる検索の最適化」を参照してください。

11.5.3 再フォーマットされた問合せによる検索の最適化

コンテンツ・サーバー・インスタンス内の大部分の問合せは、対象となるコンテンツ・アイテム・セットが小さいか、返す行が最大でも100行です。コンテンツ・サーバー・ソフトウェアは、簡単に数百万のコンテンツ・アイテムに対応できます。ただし、1000万のコンテンツ・アイテムを含むコレクションを持つOracleデータベースでテストを行うと、Oracleで選択される実行計画が最も効率のよいものではないことがわかります。Oracleでは通常、多数の問合せを、一部取るに足りないものがあっても、解決するのに最良の最適化戦略が選択されません。次の例は、この問題を説明しています。

- 例1: 1つのヒントの追加による問合せの再フォーマット

- 例2: 複数のヒントの追加による問合せの再フォーマット

11.5.3.1 例1: 1つのヒントの追加による問合せの再フォーマット

前述の環境では、Oracleにより次の問合せができるだけ効率的に解決されることはありません。

SELECT *
FROM Revisions, Documents, DocMeta
WHERE Revisions.dID = Documents.dID
AND Revisions.dID = DocMeta.dID
AND Revisions.dRevClassID = 333
Order By Revisions.dID

かなり選択性の高い索引が使用可能であるため(Revisions.dRevClassID用のdRevClassID_2)、この問合せはdRevClassID_2にアクセスし、dRevClassIDに一致する行に対してソートを実行する必要があります。ただし、この問合せの例では、OracleはRevisions.dID索引の使用を選択します。

この選択では、全索引スキャンを実行し、行ごとにdRevClassIDを取得しに表にアクセスするため、実際にはRevisions表で全表スキャンを実行するより効率が悪くなります。コンテンツ・アイテムが1000万を超えるコンテンツ・サーバー・リポジトリの場合、この実行計画を使用して問合せを解決しようとしてもうまくいかないのは明らかです。この場合、結果を返すのに約500秒かかります。

しかし、次のようなヒントを1つ追加して問合せを変更すると、パフォーマンスは劇的に向上します。

SELECT /*+ INDEX(Revisions dRevClassID_2)*/ *
FROM Revisions, Documents, DocMeta
WHERE Revisions.dID = Documents.dID
AND Revisions.dID = DocMeta.dID
AND Revisions.dRevClassID = 333
Order By Revisions.dID

問合せは、SELECT句に次のヒントを加えて変更されています。

/*+ INDEX(Revisions dRevClassID_2)*/

これにより、Oracleデータベースでは、Revisions.dID用の索引ではなく、dRevClassID_2索引が強制的に選択されます。この例では、dRevClassIDを共有するコンテンツ・アイテムがわずかなので、変更された問合せは即時に結果を返します。

11.5.3.2 例2: 複数のヒントの追加による問合せの再フォーマット

標準的なコンテンツ・サーバー・インスタンスでは、大部分のドキュメントは、現在の日付より前のdInDateで、dReleaseStateのステータスが「Y」(リリース済)になっています。ただし、わずかながら、dReleaseStateのステータスが「N」(新規、また索引なし)のドキュメントがあります。次の問合せでは、まだリリースされていないコンテンツ・アイテムを検索します。

SELECT dID
FROM Revisions
WHERE Revisions.dReleaseState = N'N' AND Revisions.dStatus in
(N'DONE', N'RELEASED', N'DELETED')
AND Revisions.dInDate<={ts '2005-02-23 17:46:38.321'}

問合せの最適化された結果では、dReleaseStateの索引を使用します。

SELECT/*+ LEADING(Revisions) INDEX (Revisions dReleaseState)*/
dID
FROM Revisions
WHERE Revisions.dReleaseState = N'N' AND Revisions.dStatus in
(N'DONE', N'RELEASED', N'DELETED')
AND Revisions.dInDate<={ts '2005-02-23 17:46:38.321'}

11.5.4 認識されるヒントのタイプ

コンテンツ・サーバー問合せは、様々なリソースで定義されている静的問合せ、動的WHERE句が追加されているデータ・ソース、および臨時のまたはアーカイバなどのアプリケーションで定義されている動的問合せのいずれかです。静的問合せは、Oracleデータベースのヒントによって更新される場合があります。ただし、臨時の問合せや動的WHERE句のヒントを事前に定義することは、ほとんど不可能です。

コンテンツ・サーバーのヒントでは、同じ問合せ内で複数のヒントをサポートする、データベースを選ばないヒント構文が使用されます。コンテンツ・サーバーのヒントは、どの問合せ、データ・ソースおよびWHERE句でも使用できます。ただし、Oracleデータベースのヒントとは結合できません。1つの問合せに両方のタイプのヒントが含まれている場合、Oracle Query Optimizerでは、Oracleデータベースのヒントが保持され、コンテンツ・サーバーのヒントは無視されます。

11.5.5 問合せヒントの構文

最適化処理の各ステージで、Oracle Query Optimizerでは、両方のタイプのヒントの異なった構文を認識し、それに応じて発行された問合せを処理します。最適化プロセスの詳細は、第11.5.2項を参照してください。

11.5.5.1 Oracleヒントの構文

Oracleヒントでは、次のフォーマットを使用します。

/*+ hint */

次に例を示します。

/*+ Index(Revisions dID)*/

11.5.5.2 コンテンツ・サーバーのヒントの構文

コンテンツ・サーバーのヒントの構文は、データベースを選ばず、同じ問合せの中で複数のコンテンツ・サーバーのヒントをサポートできます。最適化プロセス中に、コンテンツ・サーバーのヒントは、評価され、最適のヒントが再フォーマットされて、元の問合せに追加されます。

最適化のプロセスでは、1つ以上のコンテンツ・サーバーのヒントを含む問合せは解析されません。コンテンツ・サーバーのヒントのみが、索引選択時に検討されます。

- コンテンツ・サーバーのヒントの構文:
問合せが最適化プロセスを経ると、次の構文を使用して、再フォーマットされた問合せにコンテンツ・サーバーのヒントが追加されます。

/*$tableName[ aliasName]:columnName[:operator [:<value>]][, …]*/

説明:

- 山カッコに囲まれた値(<value>)は必須です。

- 角カッコに囲まれた値([value])はオプションです。

- 省略符(…)は、前の表現の繰り返しを示します。

- 最適化プロセス前の問合せ:

SELECT *
FROM Revisions, DocTypes, RoleDefinition
WHERE /*$Revisions:dStatus*/(Revisions.dStatus<>'DELETED' AND
Revisions.dStatus<>'EXPIRED' AND Revisions.dStatus<>'RELEASED') AND
Revisions.dDocType = DocTypes.dDocType AND
/*$Revisions:dReleaseState*/Revisions.dReleaseState<>'E' AND
(Revisions.dSecurityGroup = RoleDefinition.dGroupName AND
RoleDefinition.dRoleName = ? AND RoleDefinition.dPrivilege > 0

- コンテンツ・サーバーのヒントを追加して再フォーマットされた問合せ:
問合せが最適化プロセスを経ると、両方の索引が使用され、ネイティブ索引に追加されます。

SELECT/*+ LEADING(revisions) INDEX (revisions dStatus dReleaseState)*/ *
FROM Revisions, DocTypes, RoleDefinition
WHERE (Revisions.dStatus<>'DELETED' AND Revisions.dStatus<>'EXPIRED' AND
Revisions.dStatus<>'RELEASED') AND Revisions.dDocType = DocTypes.dDocType AND
Revisions.dReleaseState<>'E' AND (Revisions.dSecurityGroup =
RoleDefinition.dGroupName AND RoleDefinition.dRoleName = ? AND
RoleDefinition.dPrivilege > 0)

11.5.6 サポートされているその他のソート構造体

検索問合せ句でOracleソート構造体を使用すると、問合せを実行する際のユーザーの自由度が向上します。ソート構造体は、複数の表で抽出、ソートおよび結合される行データを指定します。基本的に、ソート構造体は、返される行数を制限する目的に役立ちます。Oracle Query Optimizerでは、次のソート構造体が認識されます。

- Group by: 一連のレコードをソートし、結果のグループ化の方法を指定します。

- Order by: 一連のレコードをソートし、結果を昇順または降順のいずれで返すかを指定します。

- Inner join: 一致するものを探して返すことにより、一連のレコードをソートします。

- Outer join: 一致しないものを探して返すことにより、一連のレコードをソートします。

11.5.7 ヒント・ルール表

ヒント・ルール表には、最適化機能で、最適化プロセス中に動的問合せやデータ・ソースに追加する適切なヒントを決めるために使用されるルールが含まれています。「ヒント・ルール・フォームの編集」を使用すれば、特定のフィールドや演算子に対して、ヒント・ルールを定義できます。ヒント・ルールは、値や日付/数の範囲に基づいて定義することもできます。ヒント・ルール表は、他のコンポーネントによって拡張可能で、コンテンツ・サーバー・インスタンスの実行中に更新できます。

図11-4 ヒント・ルール表

Oracle Query Optimizerに含まれているデフォルトのヒント・ルールの一部については、この後説明します。表の列の詳細は、第11.5.7項を参照してください。ヒント・ルール表の内容は、「管理」トレイからアクセスする「ヒント・ルールの構成」ページを見ればわかります。

ヒント・ルール表は、毎晩、およびルールが追加または変更されるたびに、再ロードするようにスケジュールされています。ヒント値は、再ロードのたびに再計算されます。

重要:
ヒント・ルール表には、複数の索引を相互に使用できる列がありますが、Oracleではbitmap索引のみが結合可能です。これは、ヒント・ルール表が核となるコンテンツ・サーバー機能用に設計されているためです。
したがって、追加の表を作成したり、追加のメタデータ・フィールドを追加したり、あるいはその両方を行うコンポーネントを持つシステムには、不十分かもしれません。しかし、ヒント・ルール表は、追加の表、索引およびフィールドの知識を提供するために、他のコンポーネントによって拡張や上書きができます。

- 第1のヒント・ルールの説明:
このルールでは、WHERE句に次の条件が含まれている場合、PK_Revisions索引が使用され、最適化された問合せにヒントとして追加されます。

Revisions.dID = some_value

- 第2のヒント・ルールの説明:
このルールでは、WHERE句に次のいずれかの条件が含まれている場合、dDocName索引が使用され、最適化された問合せにヒントとして追加されます。

Revisions.dDocName = some_value
Revisions.dDocName LIKE 'some_value'

- 第3のヒント・ルールの説明:
このルールでは、WHERE句に次の条件が含まれている場合、この条件は要件を満たさないため、修飾できません。

dStatus = 'DONE'

ただし、WHERE句に次の条件が含まれている場合、dStatus索引が使用され、最適化された問合せにヒントとして追加されます。

dStatus = 'RELEASED'

次の各項では、次に示すヒント・ルール表の列について説明します。

- 第11.5.7.1項「キー」

- 第11.5.7.2項「表」

- 第11.5.7.3項「列」

- 第11.5.7.4項「演算子」

- 第11.5.7.5項「索引」

- 第11.5.7.6項「順序」

- 第11.5.7.7項「値」

- 第11.5.7.8項「AllowMultiple」

- 第11.5.7.9項「無効」

11.5.7.1 キー

この列には、ルールを識別する一意の名前が含まれています。コンポーネントは、一意のキーを使用して、特定のルールを上書きできます。同じデータベース・スキーマ内では索引名は一意であるため、このキーは通常その索引名と同一です。

デフォルトでは、OracleはB+ Tree(バイナリ・ツリー)を索引構造として使用し、論理レコードへのアクセスを効率化します。B+ Tree索引は、結果の行数が少ない問合せや、ユーザーが変化する基準(等価条件および範囲条件など)を使用して問合せを実行する必要のある場合に、最も便利です。B+ Tree索引には索引の付いたデータ値が格納されるため、リクエストされた値が格納されている値である場合、データの便利なソースとなります。

しかし、ビットマップ索引は、デフォルトのB+ Tree索引と比べて、最小限のストレージ・コストで、大幅にパフォーマンスを向上させます。ビットマップ索引は、異なる値がほとんどないために選択性の低い列の検索に特に効果的です。また、ビットマップは、NULL値を含め(つまりNULLに索引が付けられる)、値ごとに作成されます。全般的に、索引参照プロセスはビットレベルの操作であり、複数の索引へのアクセスが可能であるため、ビットマップ索引の使用は非常に効率的です。

注意:
ヒント・ルールは上書きできるため、Oracle Query Optimizerでは、既存のキーを使用してヒント・ルールを追加することはできません。したがって、一意のキーを割り当てる列にビットマップ索引を作成している場合、これは重要です。

次のリストに示した表の列にはビットマップ索引を使用し、索引名は対応する列名に設定することをお薦めします。

- Revisions表:

- dIndexerState

- dReleaseState

- dProcessingState

- dIsCheckedOut

- dSecurityGroup

- dStatus

- WorkflowDocuments表:

- dWfDocState

11.5.7.2 表

この列は、特定のデータベース表を識別します。

11.5.7.3 列

「表」列に記載されているデータベース表内の特定の列を識別します。

11.5.7.4 演算子

この列は、許容演算子のカンマ区切りリストです。有効な演算子オプションの詳細は、「演算子」フィールドおよび「ヒント・ルールの構成」ページのメニューを参照してください。ヒント・ルールの演算子は、ヒント・ルールを条件に適用するかどうかを決定する際に重要です。

たとえば、WHERE句に次の条件が含まれている場合、PK_Revisions索引を使用すると、最適化された問合せに含める非常に貴重なヒントになります。

Revisions.dID = 3

ただし、WHERE句に次の条件が含まれている場合、PK_Revisions索引を使用しても役に立ちません。

Revisions.dID > 3

11.5.7.5 索引

この列は、条件がヒント・ルール要件を満たしている場合に、最適化された問合せで使用される特定の索引を識別します。

11.5.7.6 順序

この列には、ヒント・ルール表にルールが記載されている場合に使用される優先順位が含まれています。問合せで最上位のルールは、どのヒントを使用するかを決める際に優先されます。

順序には次の値があります。

- 5: この値は、指定した索引が一意か、どの値に対しても一致する行が50行以下であることを示します。たとえば、Revisions、DocumentsまたはDocMeta表でdIDを指定します。

- 4: この値は、指定した索引の選択性がいくぶん低いことを示します。指定した値は、通常、数行、多くてもせいぜい数百行と一致します。たとえば、Revisions表でdDocTitleを指定します。

- 3: この値は、指定した索引が1000行未満の行と一致することを示します。たとえば、dInDateまたはdOutDateを指定します。

- 2: この値は、指定した索引が1万行未満の行と一致することを示します。

- 1: この値は、指定した索引が1万行を超える行と一致することを示します。

11.5.7.7 値

この列は、Idocスクリプト作成可能です。この列は、「演算子」列値が次のいずれかであるときにしか定義できません。

- inまたはnotIn: これらの演算子のいずれかを使用する場合、値をカッコで囲まれたカンマ区切りのリストにします。

- range: この演算子を使用する場合、値は次のいずれかのフォーマットを使用する必要があります。

- フォーマット1:

([<lowValue>],range[,<highDateValue>])

指定可能な値の例は、次のとおりです。

('Y', 'O')
(,7d)
({ts '2004-12-11 12:03:23.000'}, 2d, <$dateCurrent()$>)

- フォーマット2:

#[d|h]

たとえば、5日の範囲は5d、7時間は7hです。

ヒント:
演算子inまたはnotInは、それぞれ、対応する値とともに、演算子equalおよびnotEqualのかわりに使用できます。演算子オプションの詳細は、「演算子」フィールドおよび「ヒント・ルール・フォームの編集」のメニューを参照してください。

次の使用例は、この列がどのようにヒント・ルールにさらなる柔軟性をもたらすかを示しています。

- 使用例1: 表の「状態」または「ステータス」列
dReleaseStateまたはdStatusなどの状態またはステータスを示す表の列は、完成した状態に関して偏りがあります。たとえば、dReleaseStateは、「Y」(リリース済)または「O」(旧バージョン)になる傾向があります。同様に、dStatusはRELEASEDになる傾向があります。したがって、WHERE句では、dReleaseState = YまたはdStatus = RELEASEDなどの条件は、Revisions表の大部分の行と一致します。このように、これら2列はほとんど役に立ちません。逆に、条件dReleaseState = N(新規、索引なし)は、わずかの行にしか一致しません。したがって、この列の索引は非常に役に立ちます。

- 使用例2: 表の「日付」または「数」列
日付または数を示す表の列は、状態またはステータスと同様の動作を示します。たとえば、条件dInDate < <$dateCurrent()$>は、大部分の表の行と一致し、このフィールドの索引は無意味になります。ただし、結合した条件dInDate < <$dateCurrent()$> AND dInDate > <$dateCurrent(-1)$>は通常、少量の行とのみ一致し、対応する索引をヒントとして使用するのが有益です。

11.5.7.8 AllowMultiple

この列は、定義した索引を他の索引とともに使用するかどうかを示します。Oracleでは、bitmap索引のみが結合可能です。

11.5.7.9 無効

この列は、ヒント・ルールが無効になっているかどうかを示します。表内のどのルールも、有効か無効のいずれかです。ヒント・ルールを無効にすると、「Y」の値が表示されます。既存のルールを無効にして、コンテンツ・サーバーの現在の状態に合せることができます。

たとえば、コンテンツ・サーバー・インスタンスに、異なるrevClassがわずかしかなくても、各revClassに数千のリビジョンがある場合があります。その結果、dRevClass_2索引は、あまり効果的ではありません。この場合、これに対応するヒント・ルールは無効にして、異なる優先順位を持つ1つ以上の新しいルールを追加する必要があります。

注意:
表内のすべてのルールは有効化または無効化できますが、削除できるのは「ヒント・ルール・フォームの編集」を使用して追加されたルールのみです。Oracle問合せ最適化機能に含まれるデフォルトのヒント・ルールは無効化のみ可能で、削除はできません。

11.5.8 ヒント・ルール・フォームの編集

「ヒント・ルール・フォームの編集」を使用すると、「ヒント・ルールの構成」ページでルールの追加、削除、有効化または無効化ができます。新しいルールを追加して、新しい表と索引を反映できます。既存のルールを削除または無効化して、コンテンツ・サーバー・インスタンスの現在の状態に合せることができます。ヒント・ルール表からヒント・ルールを選択した場合は、該当する値が「ヒント・ルール・フォームの編集」の各フィールドに自動的に移入されます。

「ヒント・ルール・フォームの編集」は、「ヒント・ルールの構成」ページのヒント・ルール構成表の隣に表示されます。

ヒント・ルール構成表は、毎晩、および新しいルールが追加されるか既存のルールが変更されるたびに、再ロードするようにスケジュールされています。ヒント値は、再ロードのたびに再計算されます。

表内のすべてのルールは有効または無効にできますが、削除できるのは「ヒント・ルール・フォームの編集」を通じて追加されたルールのみです。OracleQueryOptimizerコンポーネントに含まれるデフォルトのヒント・ルールは無効化のみ可能です。これらのルールは削除できません。

11.5.9 ヒント・キャッシュ

Oracle Query Optimizerには、動的に生成されるヒントを格納するためのヒント・キャッシュも含まれます。たとえば、解析された問合せまたはデータ・ソースから導出されたヒントは、持続性を維持するためにキャッシュされます。このようにして、ヒント・キャッシュは、問合せやデータ・ソースを安定したものにします。

ヒント・キャッシュは、最適化プロセスで、Oracleまたはコンテンツ・サーバーのヒントが含まれていない問合せにヒントを選択するために使用されます。ヒント・キャッシュは、問合せヒントを微調整するメカニズムを提供します。さらに、管理者は実行時に、キャッシュのチェックまたは編集、および問合せのヒントの変更ができます。

ヒント・キャッシュは、2時間ごとにディスクに格納され、コンテンツ・サーバー・インスタンスの起動時に再ロードされます。

ヒント・キャッシュには次の特性があります。

- ヒント・キャッシュ・エントリの再利用

- ヒント・キャッシュ管理

- デフォルトの容量アルゴリズム

- ヒント・キャッシュ・キーの元

- ヒント・キャッシュの持続性

11.5.9.1 ヒント・キャッシュ・エントリの再利用

同じ問合せは、新しい値がヒント・ルールの条件を満たさない場合を除いて、その値に関係なく、同じキャッシュ・エントリに一致します。次の2つの例では、同じヒント・キャッシュ・エントリが、複数の問合せにどのように使用できるか、できないかを説明しています。

例1: 類似のヒント・キャッシュ・エントリの使用

次の2つの問合せでは、両方の問合せがヒント・ルールの要件に一致するため、同じヒント・キャッシュ・エントリが使用されています。

- 問合せA:

SELECT *
FROM Revisions
WHERE dDocName = 'name1'

- 問合せB:

SELECT *
FROM Revisions
WHERE dDocName = 'name2'

例2: 異なるヒント・キャッシュ・エントリの使用

次の2つの問合せでは、問合せBがdReleaseStateヒント・ルールの要件に違反しているため、同じヒント・キャッシュ・エントリを使用できません。dReleaseStateヒント・ルールでは、dReleaseStateの値がY(リリース済)でもO(旧リビジョン)でもないことが必要です。

- 問合せA:

SELECT *
FROM Revisions
WHERE dReleaseState = 'U' AND dStatus = 'DONE'

- 問合せB:

SELECT *
FROM Revisions
WHERE dReleaseState = 'Y' AND dStatus = 'DONE'

11.5.9.2 ヒント・キャッシュ管理

ヒント・キャッシュでは、「ヒント・キャッシュ更新機能」ページを使用して、新規エントリの追加、既存エントリの編集または削除を行えます。ヒント・キャッシュ・エントリの追加または編集の際には、コンテンツ・サーバーのヒント構文を使用する必要があります。ヒント・キャッシュの管理機能は、問合せヒントの微調整に非常に役立ちます。次の例は、ヒント・キャッシュ・エントリの微調整の利点を示しています。

例: 索引のないコンテンツのバッチロード

100KBのコンテンツ・アイテムをコンテンツ・サーバーにバッチロードしたばかりで、まだ索引を付けていない場合、先ほど(「例2: 異なるヒント・キャッシュ・エントリの使用」)使用した索引ベースの問合せは、バッチロードされたすべてのドキュメントに一致します。

- 問合せA:
バッチロードされたドキュメントの大部分にまだ索引が付いていない場合、この問合せで使用されるdReleaseState索引は最良の選択ではありません。この場合で最良の結果を得るには、ヒント・キャッシュ・エントリでdReleaseState索引とdStatus索引の両方を使用するように微調整する必要があります。ヒント・キャッシュ・エントリを更新するには、「ヒント・キャッシュ更新機能」ページを使用してください。

SELECT dID
FROM Revisions
WHERE Revisions.dReleaseState = N'N' AND Revisions.dStatus in (N'DONE', N'RELEASED', N'DELETED') AND Revisions.dInDate<={ts '2005-02-23 17:46:38.321'}

- 問合せB:
ヒント・キャッシュ・エントリの更新後、新たに最適化された問合せは、次のとおりです。

SELECT/*+ LEADING(revisions) INDEX (revisions dReleaseState dStatus)*/ dID
FROM Revisions
WHERE Revisions.dReleaseState = N'N' AND Revisions.dStatus in (N'DONE', N'RELEASED', N'DELETED') AND Revisions.dInDate<={ts '2005-02-23 17:46:38.321'}

11.5.9.3 デフォルトの容量アルゴリズム

デフォルトでは、ヒント・キャッシュの最大容量は1000ヒントです。ヒント・キャッシュでは、OracleおよびMySQLで使用されるのと同様の中央挿入最小使用頻度(LRU)アルゴリズムが使用されます。新規エントリはキューの中央に挿入され、副問合せを実行するごとに、エントリは1つ上に上昇します。

キャッシュ内のヒント数が最大容量を超えると、キューの一番下のエントリがキャッシュから削除されます。こうして、LRUアルゴリズムにより、最後に実行された問合せヒントは必ずキューの上位に残るようになります。

11.5.9.4 ヒント・キャッシュ・キーの元

ヒント・キャッシュ・キーは、正規化された問合せから生成されます。第11.5.2.3項を参照してください。キャッシュ・キーは、修飾済の列(表またはエイリアス名で修飾された列)と、ヒント・ルールが定義された列から成ります。キャッシュ・キーにより、結合または副問合せを含む条件は除外されます。

次の例では、キャッシュ・キーがどのように指定の問合せから生成されるかを示しています。

SELECT DocMeta.*, Documents.*, Revisions.*
FROM DocMeta, Documents, Revisions
WHERE DocMeta.dID = Revisions.dID AND Revisions.dID=Documents.dID AND Revisions.dDocName='abc' AND Revisions.dStatus<>'DELETED' AND (Revisions.dReleaseState='U' OR Revisions.dReleaseState='I' OR Revisions.dReleaseState='Y') AND Documents.dIsPrimary<>0

生成されたキャッシュ・キーは次のようになります。

documents.disprimary:notequal:documents|revisions.ddocname:equal:revisions|revisions.dreleasestate:in:revisions|revisions.dstatus:notequal:revisions

11.5.9.5 ヒント・キャッシュの持続性

ヒント・キャッシュは、持続するように設計されています。持続性を確保するために、ヒント・キャッシュは、2時間ごとにファイル・システムに保存されます。保存されたヒント・キャッシュは、コンテンツ・サーバー・インスタンスの起動時に再ロードされます。

11.5.10 ヒント・ルールの使用

ヒント・ルールを使用するには、次の作業が必要です。

- 新規ヒント・ルールの追加および有効化

- 既存ヒント・ルールの編集

- ヒント・ルールの無効化

- ヒント・ルールの有効化

- ヒント・ルールの削除

「ヒント・ルール・フォームの編集」にアクセスするには、「管理」→「Oracle Query Optimizer」→「ヒント・ルールの構成」を選択します。「ヒント・ルール・フォームの編集」が含まれる「ヒント・ルールの構成」ページが表示されます。

11.5.10.1 新規ヒント・ルールの追加および有効化

ヒント・ルール表に新規ルールを追加するには、次のようにします。

1. 「管理」→「Oracle Query Optimizer」→「ヒント・ルールの構成」を選択します。

2. 「ヒント・ルール・フォームの編集」で、すべてのフィールドに入力します。各フィールドの詳細は、第11.5.7項を参照してください。

3. 「追加」をクリックします。新規のヒント・ルールが、「ヒント・ルール表」に追加され、ただちに有効になります。

11.5.10.2 既存のヒント・ルールの編集

「ヒント・ルール表」の既存のヒント・ルールを編集するには、次のようにします。

1. 「管理」→「Oracle Query Optimizer」→「ヒント・ルールの構成」を選択します。

2. 「ヒント・ルールの構成」ページの「ヒント・ルール表」で必要なヒント・ルールを選択します。「ヒント・ルール・フォームの編集」の該当するすべてのフィールドに、ヒント・ルールの値が移入されます。

3. 希望どおりにフィールドを編集します。各フィールドの詳細は、第11.5.7項を参照してください。

4. キーを変更します。

5. 「追加」をクリックします。「ヒント・ルール表」がリフレッシュされ、新規のヒント・ルールが追加されます。変更はただちに有効になります。

6. 古いヒント・ルールを削除します。詳細は、第11.5.10.5項を参照してください。

11.5.10.3 ヒント・ルールの無効化

表内のすべてのルールは有効化および無効化できますが、削除できるのは「ヒント・ルールの構成」ページを通じて追加されたルールのみです。Oracle問合せ最適化機能に含まれるデフォルトのヒント・ルールは無効化のみ可能で、削除はできません。

「ヒント・ルール表」のヒント・ルールを無効にするには、次のようにします。

1. 「管理」→「Oracle Query Optimizer」→「ヒント・ルールの構成」を選択します。

2. 「ヒント・ルールの構成」ページの「ヒント・ルール表」で必要なヒント・ルールを選択します。「ヒント・ルール・フォームの編集」の該当するすべてのフィールドに、ヒント・ルールの値が移入されます。

3. 「無効化」をクリックします。「ヒント・ルール表」がリフレッシュされ、「無効」列にそのヒント・ルールが無効化されたことを示す「Y」が表示されます。

11.5.10.4 ヒント・ルールの有効化

表内のすべてのルールは有効化および無効化できますが、削除できるのは「ヒント・ルールの構成」ページを通じて追加されたルールのみです。Oracle問合せ最適化機能に含まれるデフォルトのヒント・ルールは無効化のみ可能で、削除はできません。

「ヒント・ルール表」で無効のヒント・ルールを有効にするには、次のようにします。

1. 「管理」→「Oracle Query Optimizer」→「ヒント・ルールの構成」を選択します。

2. 「ヒント・ルールの構成」ページの「ヒント・ルール表」で必要なヒント・ルールを選択します。「ヒント・ルール・フォームの編集」の該当するすべてのフィールドに、ヒント・ルールの値が移入されます。

3. 「有効化」をクリックします。「ヒント・ルール表」がリフレッシュされ、「無効」列がクリアされて、そのヒント・ルールが再び有効になったことを示します。

11.5.10.5 ヒント・ルールの削除

表内のすべてのルールは有効化および無効化できますが、削除できるのは「ヒント・ルールの構成」ページを通じて追加されたルールのみです。Oracle問合せ最適化機能に含まれるデフォルトのヒント・ルールは無効化のみ可能で、削除はできません。

「ヒント・ルール表」からヒント・ルールを削除するには、次のようにします。

1. 「管理」→「Oracle Query Optimizer」→「ヒント・ルールの構成」を選択します。

2. 「ヒント・ルールの構成」ページの「ヒント・ルール表」で必要なヒント・ルールを選択します。「ヒント・ルール・フォームの編集」の該当するすべてのフィールドに、ヒント・ルールの値が移入されます。

3. ヒント・ルールが有効になっていることを確認します。ヒント・ルールが無効の場合は、削除できません。無効なヒント・ルールを再び有効にするには、第11.5.7項を参照してください。

4. 「削除」をクリックします。「ヒント・ルール表」がリフレッシュされ、選択したヒント・ルールが削除されます。

11.5.11 問合せコンバータの使用

「問合せコンバータ」を使用して、変換済の問合せの結果を表示したり、WHERE句に条件を追加したりWHERE句の条件を編集または削除することにより、変換済の問合せを変更できます。変換済の問合せを変更すると、問合せが発行されたときに実際にどのような処理が実行されるかがわかります。必要に応じて、変換済の問合せにデータ・ソースを含めることもできます。

問合せコンバータを使用する際には、次の作業が必要です。

- データ・ソースの変換

- 問合せの変換

- 変換されたデータ・ソースまたは問合せの編集

11.5.11.1 「問合せコンバータ」ページへのアクセス

「問合せコンバータ」ページにアクセスするには、「管理」→「Oracle Query Optimizer」→「問合せコンバータ」を選択します。

11.5.11.2 データ・ソースの変換

データ・ソース問合せを変換するには、次の手順を実行します。

1. 該当する場合、「問合せコンバータ」ページで「データ・ソースの使用」を選択します。「問合せコンバータ」ページにデータ・ソース関連のフィールドが表示されます。

2. 「DS名」メニューから希望するデータ・ソースを選択します。「DS名」フィールドの下にデータ・ソース問合せが表示されます。

3. 追加のパラメータおよびWHERE句の適切な情報を入力します。

4. 「問合せの変換」をクリックします。データ・ソースが変換され、結果が「データ・ソースの使用」チェック・ボックスの上のテキスト領域に表示されます。変換されたデータ・ソース問合せの例は、図11-5を参照してください。

11.5.11.3 問合せの変換

問合せを変換するには、次のようにします。

1. 該当する場合、「問合せコンバータ」ページで「データ・ソースの使用」を選択解除します。「問合せコンバータ」ページのデータ・ソース関連のフィールドが非表示になります。

2. 問合せの適切な情報を入力します。

3. 「問合せの変換」をクリックします。問合せが変換され、結果が「データ・ソースの使用」チェック・ボックスの上のテキスト領域に表示されます。変換済問合せの例は、図11-6を参照してください。

図11-5 「変換済データ・ソース」ページの例

図11-6 「変換済問合せ」ページの例

11.5.11.4 変換されたデータ・ソースまたは問合せの編集

データ・ソースまたは問合せが変換されると、「データ・ソースの使用」チェック・ボックスの上に結果が表示されます。変換プロセスによりフィールドがクリアされるため、変換済問合せはフィールドに新しい情報を入力しないと変更できません。データ・ソースまたは問合せの情報を編集するには、第11.5.11.2項で該当する項を参照してください。

11.5.12 ヒント・キャッシュの更新

ヒント・キャッシュを更新する際には、次の作業が必要です。

- 「ヒント・キャッシュ更新機能」ページへのアクセス

- データ・ソースからのヒント・キャッシュのチェック

- 問合せからのチェック

- データ・ソースを使用した既存のヒント・キャッシュ問合せの変更

- 問合せを使用した既存のヒント・キャッシュの変更

- ヒント・キャッシュ・データ・ソース・エントリの削除

- ヒント・キャッシュ問合せの削除

11.5.12.1 「ヒント・キャッシュ更新機能」ページへのアクセス

「ヒント・キャッシュ更新機能」ページにアクセスするには、「管理」→「Oracle Query Optimizer」→「ヒント・キャッシュ更新機能」を選択します。

11.5.12.2 データ・ソースからのヒント・キャッシュのチェック

データ・ソースを使用してヒント・キャッシュをチェックするには、次のようにします。

1. 「ヒント・キャッシュ更新機能」ページで、「データ・ソースの使用」を選択します。「ヒント・キャッシュ更新機能」ページにデータ・ソース関連のフィールドが表示されます。

2. 「DS名」メニューから希望するデータ・ソースを選択します。「DS名」フィールドの下にデータ・ソース問合せが表示されます。

3. 追加のパラメータ、WHERE句およびヒントの適切な情報を入力します。

4. 「キャッシュのチェック」をクリックします。「データ・ソースの使用」チェック・ボックスの上に結果が表示されます。失敗したヒント検索の例は、図11-7を参照してください。

図11-7 データ・ソースを使用したヒント・キャッシュ更新機能の結果の例

11.5.12.3 問合せからのチェック

問合せを使用してヒント・キャッシュをチェックするには、次のようにします。

1. 「ヒント・キャッシュ更新機能」ページで、「データ・ソースの使用」チェック・ボックスが選択解除になっていることを確認します。「問合せコンバータ」ページのデータ・ソース関連のフィールドが非表示になります。

2. 適切な情報を入力します。

3. 「キャッシュのチェック」をクリックします。「データ・ソースの使用」チェック・ボックスの上に結果が表示されます。失敗したヒント検索の例は、図11-8を参照してください。成功したヒント検索の例は、図11-9を参照してください。

図11-8 データ・ソースを使用したヒント・キャッシュ更新機能の結果の例

図11-9 ヒント・キャッシュで見つかったヒント

11.5.12.4 データ・ソースを使用した既存のヒント・キャッシュ問合せの変更

データ・ソースを使用してヒント・キャッシュ問合せを変更するには、次のようにします。

1. 「ヒント・キャッシュ更新機能」ページで、「データ・ソースの使用」を選択します。「ヒント・キャッシュ更新機能」ページにデータ・ソース関連のフィールドが表示されます。

2. 「DS名」メニューから希望するデータ・ソースを選択します。データ・ソース問合せは、「DS名」フィールドの下に表示されます。

3. 追加のパラメータ、WHERE句およびヒントの適切な情報を入力します。

4. 「キャッシュの更新」をクリックして、前のヒント・キャッシュを上書きします。「データ・ソースの使用」チェック・ボックスの上にあるテキスト・ボックスに結果が表示されます。問合せへの新規ヒントの追加とヒント・キャッシュの更新に成功した例は、この項にあるスクリーン・キャプチャを参照してください。

11.5.12.5 問合せを使用した既存のヒント・キャッシュの変更

問合せを使用してヒント・キャッシュを変更するには、次のようにします。

1. 「ヒント・キャッシュ更新機能」ページで、「データ・ソースの使用」チェック・ボックスが選択解除になっていることを確認します。「問合せコンバータ」ページのデータ・ソース関連のフィールドが非表示になります。

2. 適切な情報を入力します。

3. 「キャッシュの更新」をクリックして、前のヒント・キャッシュを上書きします。「データ・ソースの使用」チェック・ボックスの上に結果が表示されます。スクリーン・キャプチャでは、新規のヒントが追加され、ヒント・キャッシュが更新されていることに注意してください。

図11-10 追加された新規のヒント、更新されたヒント・キャッシュ

11.5.12.6 ヒント・キャッシュ・データ・ソース・エントリの削除

ヒント・キャッシュ・データ・ソース・エントリを削除するには、次のようにします。

1. 「ヒント・キャッシュ更新機能」ページで、「データ・ソースの使用」を選択します。「ヒント・キャッシュ更新機能」ページにデータ・ソース関連のフィールドが表示されます。

2. 「DS名」メニューから希望するデータ・ソースを選択します。データ・ソース問合せは、「DS名」フィールドの下に表示されます。

3. 追加のパラメータ、WHERE句およびヒントの適切な情報を入力します。

4. 「削除」をクリックします。フィールドに入力された情報が削除されます。問合せからの削除に成功したヒントとヒント・キャッシュの例は、この項のスクリーン・キャプチャを参照してください。

11.5.12.7 ヒント・キャッシュ問合せの削除

ヒント・キャッシュ問合せを削除するには、次のようにします。

1. 「ヒント・キャッシュ更新機能」ページで、「データ・ソースの使用」チェック・ボックスが選択解除になっていることを確認します。「問合せコンバータ」ページのデータ・ソース関連のフィールドが非表示になります。

2. 問合せおよびヒントの適切な情報を入力します。

3. 「削除」をクリックします。「データ・ソースの使用」チェック・ボックスの上に結果が表示されます。スクリーン・キャプチャでは、以前に追加されたヒントが、問合せおよびヒント・キャッシュから削除されたことに注意してください。

図11-11 キャッシュから削除されたヒントの例

11.6 検索パフォーマンスの向上

この項には、検索パフォーマンスの向上に関する情報が含まれます。

11.6.1 「タイトル」フィールドでのデータベース検索の向上

「タイトル」フィールドの検索を頻繁に行い、サイトに100万件を超えるレコードがあり、データベース検索を使用する場合、dDocTitleおよびdReleaseStateに基づいて索引を作成することをお薦めします。

11.6.2 不要SQL問合せの削減

各問合せが検索結果セットの各エントリ部分に対するフォルダ・パスを特定しているために、トリガーされている不要なSQL問合せがあることが見つかり、フォルダ・パス情報が必要ではない場合、config.cfgファイルの「追加の構成変数」部分のFolderPathInSearchResults構成変数をオフにすることにより、パフォーマンスを向上させることができます。詳細は、ブログ記事「WebCenter Content Web Search Performance: Do you really need that folder path info?」を参照してください。

12 ファイル・ストア・システムの管理

この章では、Oracle WebCenter Content Serverのファイル・ストア・システムを構成する方法と、ファイル・ストア・プロバイダを使用する方法について説明します。

この章の内容は次のとおりです。

- ファイル・ストア・システムの概要

- ファイル・ストア・プロバイダのアップグレードについて

- ファイル・ストア・プロバイダの管理

- ファイル・ストア・プロバイダのサンプル実装

- Sun Storage Archive Managerの使用

注意:
Oracleでは、WORMオプションが指定されたSun Storage Archive Manager (SAM-QFS)を、コンテンツ・サーバーの標準ファイル・ストア・システムの代替システムとしてサポートしています。詳細は、第12.5項を参照してください。
SAM-QFSを使用するようにコンテンツ・サーバーを構成した後で、標準のファイル・ストア・システムを使用するように戻すことはできません。

12.1 ファイル・ストア・システムの概要

バージョン11gR1の発売により、コンテンツ・サーバーでは、コンテンツの格納および編成用の従来のファイル・システムにかわり、データ管理用のファイル・ストア・システムが実装されました。FileStoreProviderコンポーネントは、コンテンツ・サーバー・インタフェースでファイル・ストア機能を公開し、追加の構成オプションを許可します。たとえば、コンテンツ・サーバー・インスタンスを、ファイル・システムを使用するかわりに、バイナリ・ラージ・オブジェクト(BLOB)データ型を使用して、コンテンツをデータベースに格納するように構成できます。この機能にはいくつかの利点があります。

- 一貫したバックアップおよび監視プロセスのために、リポジトリ管理をデータベース管理と統合します。

- ファイル・システムの方法での、ディレクトリ構造とディレクトリ当たりのファイル数に関連した制限を克服するのに役立ちます。

- システム間でのコンテンツの配布をより簡単にする上で役立ち、コンテンツ・サーバーの拡大縮小が容易になります。

- たとえば、コンテンツ・アドレス・ストレージ・システムや、一部のビジネス用に必要な書込み専用デバイスなど、一般にファイル・システムとは関連付けられていない様々なタイプのストレージ・デバイスが使用できます。

データベースで管理するデータの量が大規模な場合にデータベースを実行し続けるための1つのソリューションは、コンテンツ・リポジトリに対してデータベース・パーティションを使用することです。この場合は、注意深く計画する必要があります。詳細は、Oracle Database 11gを使用したWebCenter Content用のパーティション化されたリポジトリのブログを参照してください。

注意:
FileStoreProviderコンポーネントは、コンテンツ・サーバーのデプロイ時にデフォルトでインストール、有効化およびアップグレードされます。デフォルトのファイル・ストアがアップグレードされた後で、アンインストールまたは無効化を実行しないでください。アップグレードの詳細は、第12.2項を参照してください。
コンテンツ・サーバー・ソフトウェアの旧バージョンを使用していて、デフォルトのファイル・ストアをまだアップグレードしていない場合、第9.2.2項にある手順に従い、そのコンポーネントを無効にできます。

この項の内容は次のとおりです。

- 第12.1.1項「データ管理」

- 第12.1.2項「ファイル・ストア・プロバイダの機能」

12.1.1 データ管理

コンテンツ・サーバーでは、電子ファイルおよびそれらの関連メタデータのストレージを追跡することにより、コンテンツを管理します。その結果、ユーザーはチェックイン・ファイル、すべての関連情報および関連レンディションの格納とアクセスが可能です。この項では、これまでコンテンツ・サーバーで使用されてきたデータ管理方法と、FileStoreProviderコンポーネントでそれらにどのように対処するかについて説明します。

- 第12.1.1.1項「ファイル管理」

- 第12.1.1.2項「メタデータ管理」

- 第12.1.1.3項「ファイル・ストア」

12.1.1.1 ファイル管理

データ管理の前半は、コンテンツ・サーバー・リポジトリにチェックインした電子ファイルの格納です。コンテンツ・サーバーでは、通常、ファイル保存は従来のファイル・システムによって行われ、電子ファイルは、ボールト・ディレクトリおよびWebレイアウト・ディレクトリを含む階層型ディレクトリ構造に格納されます。コンテンツ・タイプ、セキュリティ・グループおよびアカウント(使用されている場合)によって指定されたリビジョン情報を使用して、ファイルおよびそれらの関連レンディションが、ボールト・ディレクトリおよびWebレイアウト・ディレクトリ内の特定のディレクトリに格納されます。たとえば、チェックイン時に指定したプライマリ・ファイルと代替ファイルは、ボールト・ディレクトリのサブディレクトリに格納されます。特定のファイルの場所は、次のように定義します。

IntradocDir/vault/dDocType/account/dID.dExtension

このパス名で、dDocTypeはチェックイン時にユーザーが選択したコンテンツ・タイプ、dIDはこのリビジョンを識別するシステムで生成された一意のID、dExtensionはチェックインされたファイルの拡張子です。この階層モデルでは、dDocTypeメタデータ・フィールドを使用して、ボールト・ディレクトリ内に構築された階層内でファイルが配布されます。同様に、すべてのWebレンディションは、IntradocDir/weblayout/groups/ディレクトリ内の階層全体で配布されます。Webレンディションとは、Webサーバーから供給されたファイルで、従来のファイル・システムの保存方法では、ネイティブ・ファイル、代替ファイル、またはInbound Refineryやその他の変換アプリケーションによって生成されたWeb表示可能ファイルでした。

この簡単なファイルの保存場所の決定は、コンポーネントおよび機能作成者にとっては便利で、ファイルの保存場所やそれらの操作方法を理解するのに役立ちます。ただし、ストレージ管理を制限する影響もあります。位置メタデータの管理を慎重に行わないと、ディレクトリが飽和状態になって、システムの処理速度低下の原因になる可能性があります。

12.1.1.2 メタデータ管理

データ管理の後半は、電子ファイルに関連付けられたメタデータの格納です。コンテンツ・サーバーでは、メタデータ管理は通常、主として3つのデータベース表を含むリレーショナル・データベースを使用して行われてきました。メタデータは、ユーザーによるコンテンツのカタログ作成を可能にし、コンテンツ・サーバー・リポジトリ内でファイルを見つけやすくするファイル記述子作成の手段にもなります。ユーザーにとって、取得はコンテンツ・サーバーによって行われ、ファイルの格納方法や場所は完全に非表示にできます。ファイルの生成または操作が必要になる可能性のあるコンポーネントおよび機能作成者にとっては、メタデータはアクセスの強力な手段となります。

12.1.1.3 ファイル・ストア

コンテンツ・サーバーでこれまで使用されてきた従来のファイル・システム・モデルは、拡張性にかぎりがあります。データ管理の必要が増えるにつれて、記憶領域を増やすために記憶装置を追加すると、Webベースのインタフェースを通して簡単にファイルを共有しにくくなります。ネストされて複雑になったファイル構造は、パフォーマンスを低下させる可能性があります。ネイティブ・ファイル形式が使用される可能性のある場合、重複するWeb表示可能ファイルの作成を抑制することは難しくなります。たとえばコンテンツ・アイテムが1億を超えるような大規模システムに対応するため、コンテンツ・サーバーでは、ファイル・ストアを使用するようになりました。これは、拡張性、柔軟性および管理容易性に効果を発揮します。

12.1.2 ファイル・ストア・プロバイダの機能

FileStoreProviderコンポーネントを使用すれば、コンテンツ・サーバーによって管理されるコンテンツの格納およびアクセスに、データ駆動型のルールを定義できます。ファイル・ストア・プロバイダには、次の機能が用意されています。

- ファイルの場所を簡単に移動する機能

- Web表示可能ファイルをオプションにする機能

- ディレクトリの飽和状態を管理および制御する機能

- サード・パーティの記憶装置を統合する機能

- 様々なストレージの例を使用、拡張および強化するAPI

ファイル・ストア・プロバイダにより、チェックインされたコンテンツおよび関連のメタデータは検査され、システム管理者によって設定された基準に基づきストレージ・ルールが割り当てられます。基準としてはメタデータ、プロファイルまたはその他の考慮事項が含まれます。ストレージ・ルールは、ボールト・ファイルおよびWebファイルをコンテンツ・サーバーで格納する方法、およびWebサーバーによりアクセスする方法を決定します。

12.2 ファイル・ストア・プロバイダのアップグレードについて

コンテンツ・サーバー・インスタンス(ドキュメントなし)の場合、FileStoreProviderコンポーネントはデフォルトでインストール、有効化およびアップグレードが行われます。アップグレードでは、ファイル・ストア・システム(DefaultFileStore)用のデフォルト値の入ったメタデータ・フィールドが作成されます。ドキュメントが含まれる既存のコンテンツ・サーバー・インスタンスがあり、新しいバージョンのコンテンツ・サーバーにファイル・ストア・プロバイダがアップグレードされていない場合、ファイル・ストア・プロバイダのアップグレードは自動的には実行されません。

現在の設定からファイル・ストア・プロバイダをアップグレードしないようにするには、アップグレードのインストールの前に、構成変数FsAutoConfigure=falseをコンテンツ・サーバーのconfig.cfgファイルに追加する必要があります。

注意:
コンテンツ・サーバー・インスタンスを起動して、「一般構成」ページの「追加の構成変数」フィールドで変数を設定すると、コンテンツ・サーバーにより自動的にファイル・ストア・プロバイダがアップグレードされます。

12.2.1 DefaultFileStoreの設定

ドキュメントが含まれておらず、FileStoreProviderコンポーネントが自動的にアップグレードされているコンテンツ・サーバー・インスタンスでは、次のDefaultFileStore設定を使用します。設定はコードの単一行で、ここに示すように折り返されてはいません。

- ボールト・パス:

$#env.VaultDir$$dDocType$/$dDocAccount$/$dispersion$/$dID$$ExtensionSeparator$
$dExtension$

- 分散ルール:

$dRevClassID[-9:-6:0:b]/$dRevClassID[-6:-3:0:b]

エンコーディングが不要な場合は、次のように指定します。

$dRevClassID[-9:-6:0]/$dRevClassID[-6:-3:0]

- Web表示可能パス:

$#env.WeblayoutDir$groups/$dSecurityGroup$/$dDocAccount$/documents/$dDocType$/
$dispersion$/$edisp$/$dDocName$$RenditionSpecifier$$RevisionLabel$
$ExtensionSeparator$$dWebExtension$

- Web URLファイル・パス:

$HttpWebRoot$groups/$dSecurityGroup$/$dDocAccount$/documents/$dDocType$/
$dispersion$/$edisp$/$dDocName$$RenditionSpecifier$$RevisionLabel$
$ExtensionSeparator$$dWebExtension$

分散のフィールドは、ストレージ・ルールのパス情報に追加され、編集できます。「Web表示可能パス」フィールドおよび「Web URLファイル・パス」フィールドは、編集できません。分散ルールは、$dispersion$の位置でWebパスに追加されます。

分散ルールにより、URLのbase 64エンコードの部分に:bを指定できます。たとえば、次の分散ルールは、2つの部分をbase 64にエンコードします。

$dRevClassID[-9:-6:0:b]/$dRevClassID[-6:-3:0:b]

ドキュメントが含まれていて、FileStoreProviderコンポーネントのアップグレードがないコンテンツ・サーバー・インスタンスでは、Revisions表が空ではないため、デフォルトのストレージ・ルールの分散がDefaultFileStoreに設定されていないという情報メッセージが返されます。

12.2.2 空のストレージ・ルール

ファイル・ストア・システムを使用せずに、旧バージョンのコンテンツ・サーバーを使用し、FileStoreProviderコンポーネントをアップグレードして実装しているサイトの場合、またはFileStoreProviderコンポーネントを完全にアンインストールし、ファイル・ストア・プロバイダにより追加されたメタデータ・フィールドも削除したサイトの場合、ユーザーがドキュメントをチェックインしたとき、そのサイトには関連のストレージ・ルールがない(xStorageRuleフィールドがない)ことになります。このような状況の後でファイル・ストア・プロバイダが実装されると、ファイル・ストア・プロバイダの実装前にチェックインされたドキュメントには空のxStorageRuleフィールドが含まれます。この状況を解消するには、ユーザーはそれらのドキュメントのコンテンツ情報を更新する必要があります。ドキュメントはxStorageRuleフィールドのデフォルト値に更新され、ストレージ・ルールで指定されている場所に移されます。xStorageRuleの詳細は、第12.3.2.2項を参照してください。

12.3 ファイル・ストア・プロバイダの管理

コンテンツ・サーバーでは、コンテンツの格納および編成用の従来のファイル・システムのかわりに、データ管理用のファイル・ストアが使用されます。FileStoreProviderコンポーネントは、コンテンツ・サーバーのデプロイ時にデフォルトでインストールされ、有効化されます。FileStoreProviderコンポーネントでは、自動的にデフォルトのファイル・ストア(DefaultFileStore)をアップグレードし、Web、ボールトおよびWeb URLパス式の変更など、コンポーネントで公開される機能を利用できるようにします。

注意:
コンテンツ・サーバーの実行にはパーティションは必要ありませんが、パーティションの作成前にコンテンツをチェックインしようとすると、ボールト・パス・ルートの変更や、新しい整形式のストレージ・ルールの作成に失敗します。詳細は、ストレージ・ルールやパスの構成に関する項が含まれている第12.3.1項を参照してください。

注意:
Oracle WebLogic Serverでは、作成されるパーティションごとに、Webレイアウト・ディレクトリを指す新しい仮想ディレクトおよびエイリアスを追加するように、コンテンツ・サーバー・インスタンス用のWebサーバーは構成されません。パーティションは、ボールト・ファイルに使用でき、Webファイル用にサポートされますが、デフォルトのボールトおよびWebレイアウト・ディレクトリ下にパーティション・ルートが存在している必要があります。

注意:
リソース・ファイルは直接編集しないでください。リソース・ファイルの適切な変更は、コンテンツ・サーバー・ユーザー・インタフェース内で行うか、または追加のコンポーネント開発により行う必要があります。コンポーネント開発の詳細は、第9章を参照してください。

ファイル・パスの定義および処理には、3つのリソース表が使用されます。PathMetaData表およびPathConstruction表のデフォルト値で、ほとんどのシナリオに対応できます。StorageRules表には、ストレージ・ルールの定義時に指定する値が格納されます。これら3つの表はプロバイダ固有で、そのことはdefaultfilestore/ディレクトリのprovider.hdaファイルで定義されています。defaultfilestore/ディレクトリは、IntradocDir/data/providers/ディレクトリにあります。4番目の表FileSystemFileStoreAlgorithmFilters表の変更には、Javaコードとともにコンポーネントが必要です。

この項の内容は次のとおりです。

- 第12.3.1項「ファイル・ストア・プロバイダ・ストレージの原則の理解」

- 第12.3.2項「ファイル・ストア・プロバイダによるコンテンツ・サーバーへの変更について」

- 第12.3.3項「ファイル・ストア・プロバイダのリソース表」

- 第12.3.4項「ファイル・ストア・プロバイダの使用」

12.3.1 ファイル・ストア・プロバイダ・ストレージの原則の理解

コンテンツ・アイテムがコンテンツ・サーバーにチェックインされるとき、アイテムはメタデータ、ユーザーが選択したプライマリ・ファイルと、場合によっては代替ファイルで構成されています。代替ファイルは、ユーザーによって選択され、チェックインされる場合もあり、Web表示可能ファイルとみなされます。コンテンツ・サーバーへのファイル・システムによるアプローチでは、プライマリ・ファイルはDomainHome/ディレクトリのルートにあるvaultディレクトリに格納され、ネイティブ・ファイルと呼ばれます。代替ファイルがチェックインされると、これもvaultに格納されますが、weblayoutディレクトリにコピーされるか、変換アプリケーション(Inbound Refineryなど)に渡されます。代替ファイルがチェックインされない場合は、vaultディレクトリから2箇所に存在するweblayoutディレクトリへネイティブ・ファイルがコピーされます。代替ファイルがチェックインされず、Inbound Refineryがインストールされている場合、ネイティブ・ファイルのレンディションが作成され、Webレイアウト・ディレクトリに格納されます。

コンテンツ・サーバーへのファイル・システムによるアプローチでは、指定したディレクトリにコンテンツを格納することで、コンテンツへのパスが定義されます。コンテンツが特定の場所にあることを知っている場合は、静的Web URLファイル・パスを使用してブラウザからコンテンツにアクセスでき、場所がわからない場合は、GET_FILEなどの動的なコンテンツ・サーバー・サービス・リクエストを使用してアクセスします。ファイル・ストア・プロバイダでは、コンテンツがファイル・システムに格納されることも、されないこともあります。したがって、新しい方法でコンテンツへのパスを定義する必要があります。

ファイル・ストア・プロバイダの設定の仕方によっては、静的Web URLがある場合も、ない場合もあります。具体的な場所がわからない場合は、動的なコンテンツ・サーバー・サービス・リクエストを使用することで、コンテンツにアクセスできます。ファイル・ストア・プロバイダを使用すると、静的Web URLがWeb URLファイルとして定義され、動的アクセスは単にWeb URLと呼ばれます。ファイル・ストア・プロバイダ・ユーザー・インタフェースを使用すると、静的Web URLファイル・パス以外は構成できません。ただし、静的Web URLを、コンテンツ・サーバー・サービス・リクエストとして実行し、本質的に動的にすることを決定できます。

この項の内容は次のとおりです。

- 第12.3.1.1項「レンディションへのストレージ・ルールの使用によるストレージ・クラスの決定」

- 第12.3.1.2項「パスの構成およびURLの解析の理解」

12.3.1.1 レンディションへのストレージ・ルールの使用によるストレージ・クラスの決定

コンテンツがチェックインすると、コンテンツ・サーバーによって管理されているコンテンツのすべてのバージョンがレンディションとみなされます。これらのレンディションには、ネイティブ・ファイル、Web表示可能ファイル、およびInbound Refineryやサードパーティの変換アプリケーションによりレンダリングされた可能性のあるその他のファイルが含まれます。

複数のレンディションは1つのストレージ・クラスにまとめられ、これによりレンディションにアクセスする場所と方法が決まります。複数のストレージ・クラスは1つのストレージ・ルールにまとめられ、これにより1つのストレージ・クラスを経由するボールト、WebおよびWeb URLのパス式が定義されます。さらに、ストレージ・ルールにより、レンディションを、Webレス・ファイル・ストアと同様に格納しないかどうか、またはファイル・システムではなくデータベースなどの別のデバイスに格納するかどうかを決めます。

次の例では、ストレージ・ルールで、様々なコンテンツ・アイテムの格納場所や格納方法をどのように指定できるかを説明しています。

例1

ストレージ・ルールは、「ストレージ・ルール名」ダイアログで「ファイル・システムのみ」として定義され、「Web表示非対応のファイル・ストア」は選択されていません。ここでは、システムによりプライマリ・ファイルのコピーが作成され、Webレイアウト・ディレクトリに置かれます。

この従来のファイル・システム・ストレージの例では、通常、データベース・ストレージと比較すると、コンテンツへのアクセス時間が速くなる利点があります。ファイル・システムの階層が複雑だったり、飽和状態になったりした場合、あるいはコンテンツ・アイテムの量が増えるにつれて、この利点は少なくなります。

例2

ストレージ・ルールは、「ストレージ・ルール名」ダイアログで「ファイル・システムのみ」として定義され、「Web表示非対応のファイル・ストア」が選択されます。ここでは、プライマリ・ファイルのコピーは作成されないため、ネイティブ・ファイルはレンディションのみです。Web表示可能ファイルに対するリクエストは、ボールトに格納されているネイティブ・ファイルに送られます。

注意:
ファイル・ストア・プロバイダのWebレス・オプションにより、Webレンディションが作成されないように指定できます。これをInbound Refineryとともに使用すると、Webレンディションが常に作成され、有効なストレージ・ルールに応じて、ファイル・システムまたはデータベースのいずれかに格納されます。

この従来のファイル・システム・ストレージの例では、前の例と同様に、コンテンツへのアクセス時間が速くなる利点があります。また、コンテンツのバージョンをボールト・ディレクトリからWebレイアウト・ディレクトリにコピーしないことで、記憶領域の節約にもなります。かわりに、Web表示可能のアクセスはボールト・ディレクトリのコンテンツにリダイレクトされます。これは、チェックインされた大部分のネイティブ・ファイルがWeb表示可能フォーマットの場合、またはコンテンツ・サーバーがブラウザで表示する必要のないコンテンツの管理に使用されている場合に役立ちます。

例3

ストレージ・ルールは、「ストレージ・ルール名」ダイアログで「JDBCストレージ」として定義され、「レンディション」選択リストからは選択されません。ここでは、ボールト・ファイルとWebファイルの両方がデータベースに格納されます。

このデータベース記憶域の例では、一貫したバックアップおよびプロセス監視のために、リポジトリ管理とデータベース管理を統合するという利点を提供し、ファイル・システムでのディレクトリ構造やディレクトリ当たりのファイル数に関連した制限の克服に役立ちます。

重要:
必要な場合、たとえば索引付けや変換の間、データベースに格納されたコンテンツ・アイテムを強制的にファイル・システムに置くことができます。ファイル・システム上のファイルは、一時キャッシュとして扱われ、IntradocDir/config/ディレクトリにあるconfig.cfgファイルで指定されているパラメータに続いて削除されます。使用されるパラメータの詳細は、第12.3.3.7項を参照してください。

例4

ストレージ・ルールは、「ストレージ・ルール名」ダイアログで「JDBCストレージ」として定義され、「レンディション」選択リストから「Webファイル」が選択されます。ここでは、ボールト・ファイルはデータベースに格納され、Webファイルはファイル・システムに永久的に格納されます。

ネイティブ・ファイルはデータベースに、Web表示可能ファイルはファイル・システムに格納するというこの混成アプローチには、前例のネイティブ・ファイルのデータベース記憶域(バックアップと監視を統合し、ファイル・システムの制限を克服)という利点があり、一方でWeb表示可能レンディションへの迅速なWebアクセスを実現します。最初の例と同様に、ファイル・システム構造が複雑すぎる場合や、ファイルの量が極端に多い場合には、この利点は少なくなる可能性があります。

12.3.1.2 パスの構成およびURLの解析の理解

コンテンツ・サーバーに格納されているコンテンツへのパスは、PathConstruction表のPathExpression列で定義されています。パスは複数の要素で構成され、各要素はスラッシュ(/)で区切られています。各要素は、1つの静的文字列または一連の動的部分でできています。動的部分は、ドル記号($)で囲まれています。1つの部分は、アルゴリズム、Idoc Script変数、環境変数、またはメタデータ参照を使用して計算でき、次のような解釈が考えられます。

- PathMetaData表で定義されたフィールドである可能性があります。PathMetaData表で定義されている場合、次の例のような1つのアルゴリズムにマップできます。

$dDocType$

- 接頭辞#env.がある場合は、次のような環境変数です。

$#env.VaultDir$ or $#env.WeblayoutDir$

- Idocスクリプト変数(たとえば、$HttpWebRoot$)である可能性があります。たとえば、標準的なボールトの場所は、次のように定義されます。

$PartitionRoot$/vault/$dDocType$/$dDocAccount$/$dID$$ExtensionSeparator$
$dExtension$

解析すると、パス式は5つの要素になり、PathMetaData表で指定されているルールに従い、次のように解釈されます。

- $PartitionRoot$: partitionSelectionアルゴリズムにマップされ、パーティション・ルートを確認するために、xPartitionIdをPartitionList表への参照として使用します。

- /vault/: 文字列であるため、計算や代入はありません。

- $dDocType$: PathMetaData表では、これはファイル・パラメータでの参照です。

- $dDocAccount$: これは、dDocAccountを取り込み、すべての適切なデリミタを使用して、標準のコンテンツ・サーバー・アカウント表現に解析するdocumentAccountアルゴリズムにマップされます。

- $dID$$ExtensionSeparator$$dExtension$: この要素は次の3つの部分から成ります。

- $dID$: dDocTypeと同様、ファイル・パラメータで定義される必須のフィールドです。

- $ExtensionSeparator$: アルゴリズムによって決まり、デフォルトでは「.」を返します。

- $dExtension$: dDocTypeと同様です。

Web表示可能パスの標準的な構成では、URLに、dDocName、レンディション、拡張子情報はもとより、Web表示可能パスへのパーティション・ルート、セキュリティ、dDocType、分散情報も追加する変数が含まれています。デフォルトでは、FsWeblayoutDirは$#env.WeblayoutDir$を意味します。

$FsWeblayoutDir$groups/$dSecurityGroup$/$dDocAccount$/documents/$dDocType$/$dispersion$/~edisp/$dDocName$$RenditionSpecifier$$RevisionLabel$$ExtensionSeparator$$dWebExtension$

Web URLの標準的な構成では、URLに、dDocName、レンディション、拡張子情報はもとより、Web表示可能パスへのパーティション・ルート、セキュリティ、dDocType、分散情報も追加する変数が含まれています。デフォルトでは、FsHttpWebRootは$HttpWebRoot$を意味します。

$FsHttpWebRoot$groups/$dSecurityGroup$/$dDocAccount$/documents/$dDocType$/$dispersion$/~edisp/$dDocName$$RenditionSpecifier$$RevisionLabel$$ExtensionSeparator$$dWebExtension$

groupsセパレータはコンテンツ・サーバーに対して、後続のディレクトリが、コンテンツ・アイテムの属するセキュリティ・グループおよびアカウントの名前であることを示します。アカウントはオプションで、その結果、アルゴリズムによって計算されます。セキュリティ情報の後はdocumentsセパレータで、その直後にはdDocTypeが続きます。分散はオプションです。URLの最後の部分は、dDocName、そのレンディションおよびリビジョン情報、フォーマットの拡張子です。

URLはこのフォーマットになると予想されるため、コンテンツ・サーバーは、ここからメタデータを正常に抽出できます。さらに重要なことは、これによりコンテンツ・アイテムのセキュリティ情報を指定でき、特定のユーザーのアクセス権限を導出できることです。

解析のガイドラインは、Webディレクトリ内の分散を可能にするために拡張されました。$dRevClass$が出現したら、システムでは分散情報を処理してから、従来どおりdDocNameおよびdWebExtensionの処理を続けます。つまり、システムにより次のフォーマットのURLの解析がうまくできるようになりました。

../groups/$dSecurityGroup$/$dDocAccount$/documents/$dDocType$/$dispersion$/~edisp/$dDocName$$RenditionSpecifier$$RevisionLabel$$ExtensionSeparator$$dWebExtension$

12.3.2 ファイル・ストア・プロバイダによるコンテンツ・サーバーへの変更について

FileStoreProviderコンポーネントは、コンテンツ・サーバー・データベース、コンテンツ・サーバー・メタデータ・フィールドおよびその他の構成ファイルに対して、いくつかの変更を加え、考えられる構成オプションを可能にします。

この項の内容は次のとおりです。

- 第12.3.2.1項「データベースのオプション」

- 第12.3.2.2項「コンテンツ・サーバーのメタデータ・フィールド」

12.3.2.1 データベースのオプション

場合によっては、データベースに格納されたコンテンツを、ファイル・システム上に強制的に置くことが必要になります。その1例が、Oracle WebCenter Content: Inbound Refineryで、変換のためにファイルへのアクセス権が必要な場合です。ファイル・システム上に強制的に置かれたファイルは、一時キャッシュとみなされます。次の構成値は、一時的にキャッシュされたファイルをクリーンアップする時期を制御するために使用されます。システムでクリーンアップされるのは、FileCache表にエントリのあるファイルのみです。

変数

説明

FsCacheThreshold

最大キャッシュ・サイズをMBで指定します。デフォルトは100です。しきい値に達すると、コンテンツ・サーバー・インスタンスでは、FsMinimumFileCacheAgeパラメータで指定されている最低保持期間より古くなったファイルの削除を開始します。

FsCleanUpCacheDuringIndexing

索引付けのサイクル中にキャッシュを削除するかどうかを指定します。デフォルトは、falseです。

FsCleanUpCacheIndexingMax

各索引付けサイクルで削除するキャッシュ・ファイルの数を指定し、そのサイクルでのロードを制限します。デフォルトでは、索引付けサイクルのすべての対象キャッシュ・ファイルを削除します。

FsMaximumFileCacheAge

ファイルがキャッシュされるまでの最大保持期間を日数で指定します。デフォルトは365です。

FsMinimumFileCacheAge

キャッシュされたファイルを削除できる最低保有期間を日数で指定します。デフォルトは1です。このパラメータは、FsCacheThresholdパラメータとともに使用され、キャッシュ・ファイルを削除する時期を決定します。

12.3.2.2 コンテンツ・サーバーのメタデータ・フィールド

ファイル・ストア・プロバイダによりいくつかのコンテンツ・サーバー・メタデータ・フィールドが追加され、構成ファイルで使用する追加のオプションが利用できるようになります。

12.3.2.2.1 メタデータ・フィールドの構成

ファイル・ストア・プロバイダにより、コンテンツ・サーバー・インスタンスに次の3つのメタデータ・フィールドが追加されます。

- xPartitionId: このメタデータ・フィールドは、PartitionList表とともに使用され、コンテンツ・ファイル・アイテムのrootの位置を決定します。パーティション選択アルゴリズムで値が指定されるため、このフィールドはユーザー・インタフェースで非表示にすることをお薦めします。

- xWebFlag: このメタデータ・フィールドでは、コンテンツ・アイテムにWeb表示可能ファイルがあるかどうかを判断します。したがって、システムのコンテンツ・アイテムにボールト・ファイルしかない場合、このメタデータ・フィールドを削除すると、システムではWeb表示可能ファイルがあるものと予想し、システムに悪影響が生じる可能性があります。メタデータ・フィールドは、構成値WebFlagColumnによって指定できます。

- xStorageRule: このメタデータ・フィールドでは、ファイルをどのように格納するかを指定します。メタデータ・フィールドは、構成値StorageRuleFieldで指定できます。

注意:
これらのメタデータ・フィールドは、起動時にファイル・ストア・プロバイダによって追加され、削除されている場合は、コンテンツ・サーバー・インスタンスが再起動したときに再び追加されます。メタデータ・フィールドを永久に削除する必要がある場合、intradoc.cfgファイルにある構成変数FsAddExtraMetaFields=falseを設定して、フィールドの自動作成を無効にします。intradoc.cfgファイルは、DomainHome/ucm/cs/bin/ディレクトリにあります。

12.3.2.2.2 デフォルトのストレージ・ディレクトリの設定

StorageDirパラメータは、PartitionRoot列値が指定されていないすべてのパーティションに使用されるルート・ディレクトリと同等のものとして設定できます。この場合、ストレージ・ディレクトリおよびパーティション名がPartitionRootパラメータの作成に使用されます。StorageDirパラメータは、DomainHome/ucm/cs/bin/ディレクトリにあるintradoc.cfgファイルで設定されます。

12.3.2.2.3 標準のファイル・ストアの変数

IntradocDir/data/providers/defaultfilestore/ディレクトリにあるprovider.hdaファイルでは、次のパラメータおよびクラスがファイル・システム・ストアの標準です。

ProviderType=FileStore
ProviderClass=intradoc.filestore.BaseFileStore
IsPrimaryFileStore=true
# Configuration information specific to a file system store provider.
ProviderConfig=intradoc.filestore.filesystem.FileSystemProviderConfig
EventImplementor=intradoc.filestore.filesystem.FileSystemEventImplementor
DescriptorImplementor=intradoc.filestore.filesystem.FileSystemDescriptorImplementor
AccessImplementor=intradoc.filestore.filesystem.FileSystemAccessImplementor

12.3.3 ファイル・ストア・プロバイダのリソース表

この項の内容は次のとおりです。

- 第12.3.3.1項「PartitionList表」

- 第12.3.3.2項「StorageRules表」

- 第12.3.3.3項「PathMetaData表」

- 第12.3.3.4項「PathConstruction表」

- 第12.3.3.5項「FileSystemFileStoreAlgorithmFilters表」

- 第12.3.3.6項「FileStorage表」

- 第12.3.3.7項「FileCache表」

12.3.3.1 PartitionList表

PartitionList表では、partitionSelectionアルゴリズムに使用可能なパーティションが定義されています。表は、DomainHome/ucm/cs/data/filestore/config/ディレクトリにあるfsconfig.hdaファイルで定義されており、コンテンツ・サーバー・インタフェースの「パーティションの追加」または「パーティションの編集」ページを使用して変更されます。表の列は、次のように使用されます。

列

説明

PartitionName

パーティションの名前を指定します。この名前は、パス式内で参照されます。

PartitionRoot

partitionSelectionアルゴリズムに渡された引数。

IsActive

パーティションが現在アクティブで、新規ファイルを受け入れるかどうかを確認します。

CapacityCheckInterval

使用可能なディスク領域の確認に使用される間隔を秒単位で指定します。これは、すべてのプラットフォームで機能するわけではありません。

SlackBytes

パーティションにコンテンツを格納するのに十分な領域があるかどうかを確認します。使用可能な領域が遊びバイトより少ない場合、パーティションは非アクティブになり、コントリビューションには使用されなくなります。

DuplicationMethods

Web表示可能レンディションに変換されないネイティブ・ファイルをどのように扱うかを指定します。
コピー(デフォルト): ネイティブ・ファイルをWebパスにコピーします。

リンク: Webパスをボールトのネイティブ・ファイルに解決します。

コピーおよびリンクは、コンテンツ・サーバー・インスタンスがインストールされているオペレーティング・システムの機能に依存します。したがって、すべてのプラットフォームですべてのメソッドが使用可能というわけではありません。

12.3.3.2 StorageRules表

StorageRules表では、コンテンツ・アイテムの格納に使用されるルールを定義します。ルールは、どのストレージ・クラスにどのパス式を使用するか、およびコンテンツ・アイテムをどのように格納するかを指定します。

表は、DomainHome/ucm/cs/data/providers/defaultfilestore/ディレクトリにあるprovider.hdaファイルで定義されており、コンテンツ・サーバー・インタフェースの「ストレージ・ルール名」ダイアログを使用して変更できます。表の列は、次のように使用されます。

列

説明

StorageRule

ストレージ・ルールの名前。動的インクルードから計算され、コンテンツ・アイテムのxStorageRuleメタデータ・フィールドに格納されます。

StorageType

ストレージの実装を指定します。
FileStorage: ファイルは、ファイル・システムに格納されます。

JdbcStorage: ファイルはデータベースに格納されます。

IsWeblessStore

システムでWebレス・ファイルを使用できるかどうかの指定に使用されます。
true: デフォルトでは、新規作成されたコンテンツ・アイテムにWeb表示可能ファイルはありません。ある特定の状況では、Web表示可能ファイルにこだわる必要があります。そのような場合、呼出しコードの引数を使用して、Web表示可能ファイルを作成する必要があることを指定できます。Web表示可能ファイルがあるかどうかに関する情報は、xWebFlagメタデータ・フィールドに格納されています。

false: デフォルトでは、新規作成されたコンテンツ・アイテムにWeb表示可能ファイルがあります。

RenditionsOnFileSystem

JdbcStorageにより、ファイルがデータベースのかわりにファイル・システムに格納されるかどうかを指定するために使用されます。

12.3.3.3 PathMetaData表

PathMetaData表では、ファイルの場所を決定するためにどのメタデータが使用されるかを定義します。メタデータは、コンテンツ・アイテムのメタデータから直接得たものか、またはアルゴリズムを使用して計算されます。PathMetaData表は、defaultfilestore/ディレクトリのprovider.hdaファイルで定義されています。defaultfilestore/ディレクトリは、DomainHome/ucm/cs/data/providers/ディレクトリにあります。

表の列は、次の表に示すように使用されます。

列

説明

FieldName

パス式に表示されるフィールドの名前。

GenerationAlgorithm

フィールドの値を解決または計算するために使用されるアルゴリズムを指定します。

RequiredForStorage

どのストレージ・クラスにメタデータが必要なのかを定義します。
#all: ボールトおよびWeb表示可能の両レンディションで、メタデータが必要です。

web: Web表示可能レンディションにのみメタデータが必要です。

vault: ネイティブ・ファイル・レンディションにのみメタデータが必要です。

指定されていないすべてのレンディションでは、このフィールドはオプションです。したがって、この列が空の場合、すべてのレンディションまたはストレージ・クラスで、メタデータ・フィールドはオプションになります。アルゴリズムが指定されている場合、この値は空です。アルゴリズムでは、必要なフィールドを指定するために、ArgumentFields列で指定されている値を使用します。

Arguments

GenerationAlgorithmフィールドで指定されているアルゴリズムに渡されるオプションの引数。

ArgumentFields

Arguments列で定義されている引数で必要とされ、その結果GenerationAlgorithmフィールドで指定されているアルゴリズムでも必要となるフィールドのカンマ区切りのリスト。

12.3.3.4 PathConstruction表

PathConstruction表では、ファイルをパスにマップします。PathConstruction表は、defaultfilestore/ディレクトリのprovider.hdaファイルで定義されています。defaultfilestore/ディレクトリは、DomainHome/ucm/cs/data/providers/ディレクトリにあります。詳細は、第12.3.1.2項を参照してください。

注意:
PathConstruction表で提供されているデフォルト値は、想定されるたいていの事態に機能します。このリソース・ファイルは直接編集しないでください。追加のコンポーネント開発により、適切な変更を行う必要があります。コンポーネント開発の詳細は、『Oracle WebCenter Contentでの開発』のコンポーネントに関する章を参照してください。

PathConstruction表の列は、次の表で定義されます。

列

説明

FileStore

計算されるストレージ・パスを指定します。
web: Web表示可能ファイルへのパス。

vault: ネイティブ・ファイルへのパス。

weburl: コンテンツ・サーバーによって生成されます。GET_FILEになる傾向があります。

weburl.file: ブラウザでWeb表示可能レンディションにアクセスするために使用する正しい構成のURL。

dispersion: ファイル・システム上のコンテンツの分散用の変数。

FsWeblayoutDir: Webレイアウト・ディレクトリのWeb表示可能パス用の変数。

FsHttpWebRoot: Webレイアウト・ディレクトリのWeb URLファイル・パス用の変数。

PathExpression

パスを定義します。

AutoCreateLimit

作成される可能性のあるディレクトリの深さを指定します。

StorageRule

このパス構成が属するストレージ・ルールを指定します。

12.3.3.5 FileSystemFileStoreAlgorithmFilters表

FileSystemFileStoreAlgorithmFilters表は、FilterImplementorインタフェースの実装にアルゴリズム名をマップするために使用されます。アルゴリズムは、PathMetaData表で参照でき、希望するパス・フィールドの計算に使用されます。そのアルゴリズムを実装するクラスは、ファイル・パラメータ・オブジェクトがNULLの場合、計算に使用する必須のメタデータ・フィールドを返す必要があります。ExecutionContextにより、doFilterメソッドが、フィールド、コンテンツ・アイテムおよび呼出しを開始したファイル・ストア・プロバイダに関する情報に渡されます。具体的には、ファイル・システム・プロバイダの場合、アルゴリズムにはExecutionContextにより次の情報が渡されます。その他のファイル・ストア・プロバイダが、もっと多くの、または場合によっては異なる情報を渡す選択をする可能性があることを念頭に置いてください。

Properties fieldProperties = (Properties)
context.getCachedObject("FieldProperties");
Parameters data = (Parameters)
context.getCachedObject("FileParameters");
Map localData = (Map) context.getCachedObject("LocalProperties");
String algorithm = (String) context.getCachedObject("AlgorithmName");

FileSystemFileStoreAlgorithmFilters表は、ファイル・ストア・プロバイダの一部で、変更するJavaコードとともにコンポーネントが必要です。

注意:
FileSystemFileStoreAlgorithmFilters表で提供されているデフォルト値は、想定されるたいていの事態に機能します。このリソース・ファイルは直接編集しないでください。Javaコードと追加のコンポーネント開発により、適切な変更を行う必要があります。コンポーネント開発の詳細は、『Oracle WebCenter Contentでの開発』を参照してください。

12.3.3.6 FileStorage表

ファイル・ストア・プロバイダがインストールされると、FileStorage表がコンテンツ・サーバーに追加されます。これは、コンテンツがデータベースに格納される場合に、JdbcStorageストレージ・タイプによって排他的に使用されます。FileStorage表には、コンテンツ・アイテムのレンディションが含まれていて、どのレンディションがどのコンテンツ・アイテムに属しているかを一意に識別するために、コンテンツ・アイテムおよびレンディションのdIDが使用されます。

12.3.3.7 FileCache表

ファイル・ストア・プロバイダがインストールされると、FileCache表がコンテンツ・サーバーに追加されます。これは、どのレンディションがファイル・システム上に置かれているかを記憶するために、JdbcStorageストレージ・タイプによって排他的に使用されます。データベースに格納されているレンディションは、索引付けや変換など、特定のイベントに必要な場合、ファイル・システムに置かれます。これらのファイルは一時的であることが多く、スケジュールされたイベントの一部として、指定した間隔の後に削除されます。

12.3.4 ファイル・ストア・プロバイダの使用

ファイル・ストア・プロバイダのデフォルト・ファイル・ストアがアップグレードされると、チェックインされたコンテンツおよび関連のメタデータが検査され、システム管理者によって設定された基準に基づきストレージ・ルールが割り当てられます。基準としてはメタデータ、プロファイルまたはその他の考慮事項が含まれます。ストレージ・ルールは、ボールト・ファイルおよびWebファイルをコンテンツ・サーバーで格納およびアクセスする方法、およびWebサーバーによりアクセスする方法を決定します。ファイルは、データベースに格納することも、1つ以上のファイル・システムまたは記憶媒体に格納することもできます。パーティションは、格納場所の管理に役立てるために作成できますが、必須ではありません。

注意:
FileStoreProviderコンポーネントは、いったんコンテンツ・サーバーで使用されると、無効にすることはできません。

この項の項目は次のとおりです。

- 第12.3.4.1項「パーティションの追加または編集」

- 第12.3.4.2項「ファイル・ストア・プロバイダの編集」

- 第12.3.4.3項「ストレージ・ルールの追加または編集」

12.3.4.1 パーティションの追加または編集

パーティションを作成すると、コンテンツ・サーバーにより管理されるファイルへの追加のルート・パスを定義できますが、異なる場所や、異なるタイプの媒体への格納が必要です。パーティションは、パーティション・リスト・ページを使用して作成します。新規パーティションが作成されると、コンテンツ・サーバーにより、IntradocDir/data/filestore/config/ディレクトリにあるfsconfig.hdaファイルでPartitionListリソース表が変更されます。

注意:
Oracle WebLogic Serverでは、作成されるパーティションごとに、Webレイアウト・ディレクトリを指す新しい仮想ディレクトおよびエイリアスを追加するように、コンテンツ・サーバー・インスタンス用のWebサーバーは構成されません。パーティションは、ボールト・ファイルに使用でき、Webファイル用にサポートされます。

コンテンツ・サーバー・インスタンスにパーティションを追加するには:

1. コンテンツ・サーバー・インスタンスにシステム管理者としてログインします。

2. 「管理」→「ファイル・ストアの管理」を選択します。

3. パーティションが定義されていない場合、「パーティションの追加」をクリックします。それ以外の場合は、「パーティションの追加/編集」ページが開きます。

4. パーティション名を入力します。名前を一意にする必要があります。

5. パーティション・ルート、重複メソッドおよびその他の関連パラメータを変更します。

6. 「アクティブ」が有効であることを確認します。

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

12.3.4.2 ファイル・ストア・プロバイダの編集

ファイル・ストア・プロバイダはいつでも編集できます。プロバイダを編集するには:

1. コンテンツ・サーバー・インスタンスにシステム管理者としてログインします。

2. 「管理」→「プロバイダ」を選択します。

3. 「プロバイダ」ページで、DefaultFileStoreプロバイダの隣にある「アクション」列の「情報」をクリックします。

4. 「ファイル・ストア・プロバイダ情報」ページで、「編集」をクリックします。

5. 「ファイル・ストア・プロバイダの編集」ページで、必要な変更を加え、「更新」をクリックして、変更を送信します。

注意:
「更新」をクリックして変更を送信する前に、「ファイル・ストア・プロバイダの編集」ページから離れないでください。

6. コンテンツ・サーバー・インスタンスを再起動します。

12.3.4.3 ストレージ・ルールの追加または編集

複数のストレージ・ルールをファイル・ストアに追加できます。

重要:
ストレージ・ルールは削除できません。各ストレージ・ルールについては、作成する前に慎重に検討してください。

注意:
コンテンツがコンテンツ・サーバー・リポジトリにチェックインされた後でストレージ・ルールを変更すると、コンテンツ・サーバーでコンテンツを見失うことになる可能性があります。

ストレージ・ルールを追加または編集するには、次のようにします。

1. コンテンツ・サーバー・インスタンスにシステム管理者としてログインします。

2. 「管理」→「プロバイダ」を選択します。

3. 「プロバイダ」ページで、DefaultFileStoreプロバイダの隣にある「アクション」列の「情報」をクリックします。

4. 「ファイル・ストア・プロバイダ情報」ページで、「編集」をクリックします。

5. 「ファイル・ストア・プロバイダの編集」ページで、「新規ルールの追加」をクリックするか、ストレージ選択リストから編集するルール名を選択し、「ルールの編集」をクリックします。

6. 「ストレージ・ルール名」ダイアログで、ストレージ・ルールに必要な変更を加え、「OK」をクリックします。

注意:
編集中のストレージ・ルールに関連付けられたレコードがある場合、FsWeblayoutDir (Webレイアウト・ディレクトリ)およびFsHttpWebRoot (HttpWebRootおよびURL接頭辞)の2つのルールは変更できません。

7. 「ファイル・ストア・プロバイダの編集」ページで、「更新」をクリックします。

重要:
記憶域ルール内に定義されているWeb URLファイル・パスで使用されているWebルートが、コンテンツ・サーバーに定義されているデフォルトのweblayoutディレクトリ以外にある場合は、記憶域ルール内に使用されているWebルートのWebサーバーに別名または仮想ディレクトリを追加する必要があります。そうしない場合、コンテンツ・サーバーによりファイルへのアクセス場所が認識されません。仮想ディレクトリをWebサーバーに追加する手順の詳細は、Webサーバーに付属のドキュメントを参照してください。

12.4 ファイル・ストア・プロバイダのサンプル実装

この項では、例ごとに、プロバイダ定義ファイル(provider.hda)に含まれている表のコンテンツを示します。provider.hdaファイルは、手動で編集する必要がありません。provider.hdaファイルの適切な変更は、「パーティションの追加」または「パーティションの編集」ページを使用してコンテンツ・サーバー・インタフェース内で行うか、または追加のコンポーネント開発により行う必要があります。その他のリソース表(PathMetaData表、PathConstruction表およびFileSystemFileStoreAlgorithmFilters表など)に提供されているデフォルト・オプションで、想定されるたいての事態に十分柔軟に対応できます。

この項の項目は次のとおりです。

- 第12.4.1項「PathMetaData表オプションの例」

- 第12.4.2項「標準ファイル・パスの構成」

- 第12.4.3項「WebレスまたはオプションWebストアの構成」

- 第12.4.4項「データベース記憶域の構成」

- 第12.4.5項「変更されたパス構成およびアルゴリズム」

12.4.1 PathMetaData表のオプションの例

大部分の例では、次のPathMetaData表の構成定義が使用されます。表では、理解しやすいように、例に該当しない一部の列は省略されいます。

@ResultSet PathMetaData
6
FieldName
GenerationAlgorithm
RequiredForStorage
<trimmed columns>
dID
#all
dDocName
#all
dDocAccount
documentAccount
dDocType
#all
dExtension
#all
dWebExtension
weburl
dSecurityGroup
#all
dRevisionID
#all
dReleaseState
#all
dStatus
web
xPartitionId
partitionSelection
ExtensionSeparator
extensionSeparator
xWebFlag
RenditionId
#all
RevisionLabel
revisionLabel
RenditionSpecifier
renditionSpecifier
@end

12.4.2 標準ファイルパスの構成

ファイル・ストア・プロバイダは、標準的なコンテンツ・サーバーの場所にあるファイル・システムに、コンテンツを格納するように構成できます。

12.4.2.1 ストレージ・ルールの定義

まず最初にストレージ・ルールを定義します。この例では、すべてのコンテンツがファイル・システムに格納されるので、ストレージ・ルールはFileStorageタイプのものになります。

例:

@ResultSet StorageRules
4
StorageRule
StorageType
IsWeblessStore
RenditionsOnFileSystem
default
FileStorage
@end@

12.4.2.2 パス構成の定義

次に、ルールのストレージ・クラスごとに、パス構成を定義します。一般に、パスの最後の部分は、すべての使用例にとって標準的なものにする必要があります。そうでないと、コンテンツ・サーバーで正しくhcs*ファイルを使用できません。ただし、Web URLファイル・パス・ルートの変更が、Webサーバーでコンテンツ・サーバーWebルートとして正しく認識されると仮定すれば、ルート・パスは機能に影響を与えることなく変更できます。

この構成では、ボールト、WebおよびWeb URLストレージ・クラスは、PathConstruction表で定義する必要があります。ボールトのパス式は、すでに第12.3.1.2項で述べています。$dispersion$により、ファイル・システム上のコンテンツの分散が実装されます。呼出し側は、ストレージ・ルール・ページでこの分散を指定できます。

この設定では、Webパス式のみを見ていますが、Web URLと異なるのはルートのみです。すなわち、Webパスがファイル・システム上の絶対パスであるのに対して、Web URLはWebサーバーのサービスを受けるURLです。

例:

@ResultSet PathConstruction
4
FileStore
PathExpression
AutoCreateLimit
IsWritable
StorageRule
vault
$#env.VaultDir$$dDocType$/$dDocAccount$/$dispersion$/$dID$$ExtensionSeparator$
$dExtension$
6
true
default
weburl
$FsHttpWebRoot$groups/$dSecurityGroup$/$dDocAccount$/documents/$dDocType$/
$dispersion$/~edisp/$dDocName$$RenditionSpecifier$$RevisionLabel$
$ExtensionSeparator$$dWebExtension$
3
false
default
web
$FsWeblayoutDir$groups/$dSecurityGroup$/$dDocAccount$/documents/$dDocType$/
$dispersion$/~edisp/$dDocName$$RenditionSpecifier$$RevisionLabel$
$ExtensionSeparator$$dWebExtension$
3
true
default
@end

- Webパス構成は、次のように定義されます。

$FsWeblayoutDir$groups/$dSecurityGroup$/$dDocAccount$/documents/$dDocType$/
$dispersion$/~edisp/$dDocName$$RenditionSpecifier$$RevisionLabel$
$ExtensionSeparator$$dWebExtension$

- これは、次の表に示すようにパーツに解析されます。

パス・セグメント

説明

$FsWeblayoutDir$

Webレイアウト・ディレクトリのWeb表示可能パスの変数。

$FsHttpWebRoot$

Web URLの代替Idoc Script変数。

/groups/

文字列。

$dSecurityGroup$

PathMetaData表により使用されます。これは必須フィールドであり、そのため呼出し側または記述子の作成者により指定される必要があります。これは、コンテンツ・アイテムのメタデータ情報の一部です。

$dDocAccount$

これは、dDocAccountを取り込み、すべての適切なデリミタを使用して、標準のコンテンツ・サーバー・アカウント表現に解析するdocumentAccountアルゴリズムにマップされます。

/documents/

文字列。

$dDocType$

PathMetaData表により使用されます。これは必須フィールドであり、そのため呼出し側または記述子の作成者により指定される必要があります。これは、コンテンツ・アイテムのメタデータ情報の一部です。

$dispersion$

ファイル・システム上のコンテンツの分散を実装します。

!edisp

このマーカーが指定された箇所で分散が終了したことを示します。たとえ分散が空であっても、~edispマーカーが指定されます。

$dDocName$

PathMetaData表により使用されます。これは必須フィールドであり、そのため呼出し側または記述子の作成者により指定される必要があります。これは、コンテンツ・アイテムのメタデータ情報の一部です。

$RenditionSpecifier$

これは、renditionSpecifierによって指定され、システムでサムネールなどの追加のレンディションを作成中の場合のみ必要です。それ以外の場合は、空の文字列を返します。

$RevisionLabel$

リビジョン・ラベルは、revisionLabelアルゴリズムによって指定され、コンテンツ・アイテムのステータスに応じて、パスに「~dRevLabel」が追加されます。

$ExtensionSeparator$

ここではextensionSeparatorアルゴリズムが使用され、デフォルトでは「.」を返します。

$dWebExtension$

dWebExtensionは、WebおよびWeb URLストレージ・クラスの必須フィールドで、ファイル・パラメータにより渡されます。

12.4.3 WebレスまたはオプションのWebストアの構成

この例では、前の例のストレージ・ルールが、IsWeblessStoreをtrueに設定し、その結果、Web表示可能ファイルがデフォルトで作成されないように構成されます。ただし、ドキュメントが、Web表示可能ファイルを必要とするInbound RefineryやWebForms、またはその他のコンポーネントで処理される場合は、Webファイルが作成されます。ファイルの場所は、前述の標準構成どおりです。しかし、ファイルにはWebレンディションのない場合があるため、Web URLパスを調整する必要があります。また、weburl.fileの使用にも注意してください。これは、Web表示可能ファイルが実際に存在する場合に、そのURLを計算するために使用されます。ブラウザでそのファイルがどのように提供されるかを決定するために、メタデータ・フィールドxWebFlagが使用されます。

12.4.3.1 ストレージ・ルールの定義の例

@ResultSet StorageRules
4
StorageRule
StorageType
IsWeblessStore
RenditionsOnFileSystem
default
FileStorage
true
@end@

12.4.3.2 パス構成の定義の例

@ResultSet PathConstruction
4
FileStore
PathExpression
AutoCreateLimit
IsWritable
vault
$#env.VaultDir$$dDocType$/$dDocAccount$/$dispersion$/$dID$$ExtensionSeparator$
$dExtension$
6
true
default
weburl
$HttpCgiPath$?IdcService=GET_FILE&dID=$dRevClassID$
&dDocName=$dDocName$&allowInterrupt=1&noSaveAs=1&fileName=$dOriginalName$
3
false
default
weburl.file
$FsHttpWebRoot$groups/$dSecurityGroup$/$dDocAccount$/documents/$dDocType$/
$dispersion$/~edisp/$dDocName$$RenditionSpecifier$$RevisionLabel$
$ExtensionSeparator$$dWebExtension$
3
false
default
web
$FsWeblayoutDir$groups/$dSecurityGroup$/$dDocAccount$/documents/$dDocType$/
$dispersion$/~edisp/$dDocName$$RenditionSpecifier$$RevisionLabel$
$ExtensionSeparator$$dWebExtension$
3
true
default
@end

12.4.4 データベース記憶域の構成

データベースにファイルを格納するには、JdbcStorageタイプのストレージ・ルールが必要です。デフォルトでは、このルールに属するすべてのコンテンツ・アイテムは、ファイルがデータベースに格納されています。しかし、たとえファイルがデータベースに格納されていても、ファイル・システムが基礎となることが考えられ、システムではファイルを一時的にファイル・システムにキャッシュすることが必要になる場合があります。特に、索引付けや一部の変換でこれが発生する可能性があります。

技術的ヒント:
指定したストレージ・クラスに属するレンディションが、常にファイル・システム上に格納されるように、ルールを構成できます。これは、ボールト・ファイルをデータベースに格納する一方、Webファイルはファイル・システムに格納するシステムの場合、非常に便利です。

12.4.5 変更されたパス構成およびアルゴリズム

前述の例では、ファイル・パスを標準構成に合せています。非常に大きな実装の場合、これではディレクトリが飽和状態になり、パフォーマンスが低下する可能性があります。次の例は、複数の選択肢がある記憶域でファイルを分散させる際に役立ちます。

12.4.5.1 パーティション化の使用

ファイル・ストア・プロバイダでは、よりすっきりしたディレクトリ構造を作成するために、パーティションを使用しやすくなります。デフォルトでは、xPartitionIdメタデータが使用され、コンテンツ・アイテム・リビジョンのメタデータ情報の一部になります。このフィールドをコンテンツ・サーバー・インタフェースで無効にし、かわりにパーティション選択アルゴリズムで使用するパーティションを決定することをお薦めします。パーティション選択アルゴリズムでは、すべてのアクティブ・パーティションを調べ、新規のコンテンツがシステムに入ってくると、それらのパーティションが順番に選択されます。各パーティションは、PartitionList表にエントリがあり、アクティブであることを宣言できます。PartitionRootは、xPartitionIdから計算され、ここで値はPartitionList表への参照キーとなります。xPartitionIdが指定されていない場合、システムでは、次の使用可能でアクティブなパーティションを見つけ、この値を場所の計算に使用します。xPartitionIdは、その後コンテンツ・アイテムのメタデータの一部として格納されます。

パーティション選択を使用するには、PathConstruction表で次のようにボールト・ストレージ・クラスを定義します。

vault
$PartitionRoot$/$dDocType$/$dDocAccount$/$dRevClassID$$ExtensionSeparator$$dExtension$
6
true

システム管理者があるパーティションをコントリビューションに対して閉じる必要がある場合(たとえば、ストレージ・デバイスでメンテナンスが必要な場合など)、パーティションの追加/編集ページを使用して、パーティションをいつでも非アクティブ化できます。

12.4.5.2 Webレイアウト・パスへのパーティションの追加

この例では、ボールトおよびWebレイアウトの両ディレクトリをパーティション化し、有効なWeb URLファイル・パスも保持する方法を説明します。

Web表示可能パスおよびWeb URLファイル・パスにパーティション・ルートを追加し、変数$FsWeblayoutDir$および$FsHttpWebRoot$を「ストレージ・ルール名」ダイアログで編集します。

$FsWeblayoutDir$は$PartitionRoot$/weblayoutを表します。$FsHttpWebRoot$は$HttpWebRoot$/$xPartitionId$/weblayout/を表します。

partitionRootをパーティションの追加/編集ページで次のように定義します。

パーティション名

パーティション・ルート

partition1

$#env.WeblayoutDir$/partition1/

partition2

$#env.WeblayoutDir$/partition2/

Web URLファイル・パスをWebレイアウト・ディレクトリ内のWeb表示可能パスと一致させるために、変数xPartitionIdが使用され、Web URLファイル・パスの作成時に、partition1またはpartition2が正しく置換されます。

Web表示可能パスおよびWeb URLファイル・パスが、同じパスに評価されることを確認してください。

- $FsWeblayoutDir$は、$PartitionRoot$/weblayout/を表します。partition1の場合、$#env.WeblayoutDir$/partition1/weblayout/に評価されます。partition2の場合、$#env.WeblayoutDir$/partition2/weblayout/に評価されます。

- $FsHttpWebRoot$は、$HttpWebRoot$/$xPartitionId$/weblayout/を表します。partition1の場合、$HttpWebRoot$/partition1/weblayout/に評価されます。partition2の場合、$HttpWebRoot$/partition2/weblayout/に評価されます。

$#env.VaultDir$/partition1および$#env.VaultDir$/partition2のパーティション・ルートを$#env.WeblayoutDir$および$HttpWebRoot$設定のかわりに使用するように、パーティション(partition1およびpartition2)を設定する場合、Webレイアウト・ファイルがボールト・ディレクトリに格納されることになります。これにより、ボールト・ファイルのパーティション化にのみ使用できます。

12.4.5.3 1ディレクトリ内のファイル数の制限

ファイル分散のもう1つの方法は、パスを変更して、コンテンツ・アイテムのdRevClassIDによってファイルを分割することです。次の例では、ディレクトリは、最大10,000ファイル、プラス追加レンディション用の追加ファイルに制限されます。

パス式に$RevClassID[-12:-10:0]/$dRevClassID[-10:-8:0]$/$dRevClassID[-8:-4:0]$が含まれていて、$dRevClassIDが1234567890の場合、結果は00/12/3456です。

パス式内の$dRevClassID[-12:-10:0]に注意してください。これは、次のように解釈されます。

- 文字列の末尾から12文字戻ったところから始まる文字を、文字列の末尾から10文字戻った文字まで取得します。

- 結果の文字列を長さ2 (12-10)まで0の文字を埋め込みます。

12.5 Sun Storage Archive Managerの使用

この項では、Sun Storage Archive Manager (SAM-QFS)製品を紹介し、SAM-QFSを使用するようにコンテンツ・サーバーを構成する方法について説明します。

- 第12.5.1項「SAM-QFSについて」

- 第12.5.2項「SAM-QFSを使用する上での考慮事項」

- 第12.5.3項「SAM-QFSのインストール」

- 第12.5.4項「WORMを使用するコンテンツ・サーバーおよびSAM-QFSの構成」

12.5.1 SAM-QFSについて

Sun Storage Archive Manager (SAM-QFS)は、Oracle Solarisオペレーティング・システムで実行される階層型ファイル・ストレージ・システムです。WORM (Write Once Read Many)オプションを指定して構成すると、ファイル・システム・データのアーカイブがサポートされ、ユーザーにはデータの読取りのみが許可されるようになります。SAM-QFS環境には、ストレージおよびアーカイブ・マネージャに加え、Sun QFSファイル・システム・ソフトウェアが含まれます。SAM-QFSは、コンテンツ・サーバー・マシンによるNFSマウントおよび追加のコンテンツ・サーバー構成で使用できます。

SAM-QFSは、次の2つの製品で構成されます。

- Quick File System (QFS)は、カーネル・レベルのファイル・システムで、Oracle SolarisおよびSPARCプラットフォームにインストールできます。この製品ではWORM機能および保存マネージャ機能が提供され、コンテンツ・サーバーでこれらを使用できます。

注意:
WORMを使用してWebレイアウトを保存することはできません。

- Storage Archive Manager (SAM)には、最初にQFSにファイリングされたファイルをアーカイブしたり、オンデマンドでファイルを取得したり、領域を解放してアーカイブを管理するためにユーザー領域で実行されるいくつかのプログラムが含まれます。

- アーカイバ・プログラムには、ファイルが変更される際に前もって通知されるため、ファイル・システムのポーリングによってではなく、イベント駆動型の方法でファイルがアーカイブされます。必要に応じて、アーカイブの管理やバックアップ・コピーの作成も行われます。

- リリーサ・プログラムは、アーカイバによってすべてのコピーが作成されたことを確認した後、プライマリ・ストレージからコンテンツを解放します。

- ステージャ・プログラムは、データを(アーカイブ・ディスクまたはアーカイブ・テープ上にある)アーカイブ・コピーからプライマリ・ストレージにロードまたはステージングして、QFSからユーザーがデータを取得できるようにします。このアクティビティは、オンデマンドでまたはポリシーに従って実行されるように構成できます。

- リサイクラ・プログラムは、削除されたファイルをセカンダリ・ストレージからパージして、領域を解放して再使用できるようにします。

ファイルはTARユーティリティ・フォーマットで格納されるため、ファイル・システム・メタデータも実際のファイルとともに保持されます。効率化のため、同じTARに複数のファイルを格納できます。

12.5.2 SAM-QFSを使用する上での考慮事項

SAM-QFSを実装する前に、次の点を考慮してください。

- SAM-QFSにより、WORM (Write Once Read Many)機能とともに、WORM制約が解除された後の保存期間を指定する機能が提供されます。

- ファイルは自動的にテープにアーカイブできます。SAM-QFSでは、透過的なリストアを含む、統合されたシームレスなバックアップ・ソリューションが提供されます。

- アーカイブされたファイルのリサイクルがSAM-QFSでスケジュールされた場合、ドキュメントのリビジョンは、メタデータ・バックアップのスナップショットを保持し、必要に応じてそれらをマウントすることにより取得できます。

- コンテンツ・アイテムは削除できません。削除操作は失敗し、エラー・メッセージが生成されます。

- ワークフロー・ステップでユーザーが現在のリビジョンを編集(置換)できるオプションが使用されている場合、そのステップでは、WORMが有効なストレージ・ルールを使用してチェックインされたコンテンツを編集できなくなります。ワークフロー・ステップでこのオプションが使用されている場合、ファイルのボールト・レンディションが置換されます(読取り専用ファイル・システムではこれは行えません)。

- ネイティブ・ファイル・パスは、ストレージ・ルールのボールト・パス・フィールドによって異なります。ネイティブ・ファイル・パスの値にパスの一部としてメタデータ・フィールドが含まれている場合、メタデータ・フィールドは更新できません。これは、更新操作によりファイル・システム・パスが変更されるためです(読取り専用システムでは変更されません)。メタデータ属性を変更しようとすると失敗し、エラー・メッセージが生成されます。ネイティブ・ファイル・パスを後から変更する可能性がある場合、WORMが有効なストレージ・ルールでは、ネイティブ・ファイル・パスにメタデータ・フィールドを含めないように設定することをお薦めします。

12.5.3 SAM-QFSのインストール

Oracle SolarisシステムにSAM-QFSをインストールしてWORMを有効化する方法の詳細は、https://wikis.oracle.com/display/SAMQFS/Homeで、Sun QFSおよびSun Storage Archive Manager (SAM-QFS) wikiを参照してください。SUNWsamfswmパッケージにはSAM-QFS 5.2ダウンロード・バージョンは付属しないため、このパッケージについては、SAM-QFSグループにお問い合せください。

12.5.4 WORMを使用するコンテンツ・サーバーおよびSAM-QFSの構成

SAM-QFSを使用するには、特定の構成を設定する必要があります。デフォルトのストレージ・ルールでWORMを有効にするには、コンテンツ・サーバー・ファイル・ストア・プロバイダでデフォルト・ルール(DispByContentId)を変更する必要があります。その他のストレージ・ルールも、必要に応じてWORMを有効にするように変更できます。

12.5.4.1 ボールト・パスの構成

ボールト・パスを構成するには:

1. コンテンツ・サーバー・インスタンスで、「管理」→「管理サーバー」→「一般構成」を選択します。

2. 「追加の構成変数」フィールドに、環境変数IsVaultFileSystemWorm=trueを入力します。

3. DomainHome/ucm/cs/bin/intradoc.cfgファイルを編集して、VaultDirパラメータをSAM-QFSの場所のボールト・ファイル・パスに設定します。

4. SAM-QFSマウント・ポイントから開始し、chmod -R 4000 directoryNameをvault/~tempディレクトリのサブディレクトリexceptに適用します。vault/~tempディレクトリではWORMを有効にしないでください。
最上位のレベルから下に向かって操作を行います。WORMトリガーは、親ディレクトリでWORMトリガーが有効になっている場合にのみ適用できます。

5. Solaris /etc/vfstabファイルを編集して、デフォルトの保存期間を指定します。

12.5.4.2 WORMを有効にするためのファイル・ストア・プロバイダの構成

ボールト・ファイルでWORMが有効になるようにファイル・ストア・プロバイダを構成するには:

1. コンテンツ・サーバー・インスタンスで、「管理」→「プロバイダ」を選択します。

2. プロバイダ・リストのDefaultFileStore行から、「アクション」列の「情報」をクリックします。

3. 「ファイル・ストア・プロバイダ情報」ページで、「編集」をクリックします。

4. 「ファイル・ストア・プロバイダ」ページの「ストレージ・ルール」の行で、「ルールの編集」をクリックします。

5. 「ストレージ・ルール名」ページで、「ファイル・システムのみ」が選択されていることを確認します。

6. 「WORM/保存を許可する(SAM/QFSのみ)」を選択します。

7. 保存期間を設定する必要がある場合は、「ボールト・ファイルのデフォルトの保存期間を設定します。」を選択し、保存する年数と月数を入力します。
SAM-QFSファイル・システムが32ビットであるか、コンテンツ・サーバーが実行されているオペレーティング・システムが32ビットである場合、このオプションの上限は2038になります。より長い保存期間が必要な場合は、このコンテンツ・サーバー・オプションを選択するかわりに、SAM-QFSのmountオプション・パラメータを使用してデフォルトの保存期間を設定してください。

13 プロバイダの構成

この章では、Oracle WebCenter Contentでサポートされるプロバイダと、WebCenter Content ServerとOracle WebLogic Serverまたはライトウェイト・ディレクトリ・アクセス・プロトコル(LDAP)などその他のプロバイダ間のプロバイダ接続の使用が必要な状況と使用方法について説明します。

この章の内容は次のとおりです。

- コンテンツ・サーバーのプロバイダについて

- 適切なプロバイダの選択

- コンテンツ・サーバーのセキュリティ・プロバイダの理解

- プロバイダの管理

13.1 コンテンツ・サーバーのプロバイダについて

プロバイダとは、コンテンツ・サーバー・インスタンスと外部エンティティ間の接続を確立するアプリケーション・プログラミング・インタフェース(API)です。エンティティには、次のものがあります。

- Oracle WebLogic Server

- LDAPサーバー

- データベース

- サーバー・ソケット

- ファイル・ストア・システム

- Inbound Refinery

デフォルトでは、コンテンツ・サーバー・インスタンスには、3つのシステム・プロバイダがあります。

- SystemDatabase: システム・データベース。

- SystemServerSocket: ブラウザ・リクエストをリスニングするサーバー・ソケット。

- DefaultFileStore: ファイル・ストア・システム。

さらに、次のタイプのプロバイダを作成できます。

- 送信: 外部エンティティに対して開始された接続。このタイプを使用して、コンテンツ・サーバー・インスタンス間の通信ができます。送信プロバイダでSSLを使用する方法の詳細は、第13.3項を参照してください。

- 受信: :ブラウザまたはクライアント・アプリケーションのような、外部エンティティから開始された接続。プロバイダは、受信接続を認識するために、指定されたポート上でリスニングを行います。受信プロバイダでSSLを使用する方法の詳細は、第13.3項を参照してください。

- データベース: 接続および通信用のAPIを提供する情報リポジトリ・サーバー。これは、情報を取得し、情報をデータベースで変更できるようにします。このタイプの例は、システム・データベースです。

- プレビュー: : 出力プロバイダ接続で、オプションのHTML Preview機能とともに使用します。

- JpsUser: Oracle WebLogic Serverインスタンスに対する接続。このプロバイダでは、Java Platform Security (JPS)を使用して、Oracle WebLogic Serverインスタンスを介したユーザー認証、ユーザー認可、およびユーザー・メタデータの取得を実行します。このタイプのプロバイダは、JpsUserProviderコンポーネントによってサポートされており、これはデフォルトではコンテンツ・サーバー・インスタンスとともにインストール(有効化)されます。

- Ldapuser: ライトウェイト・ディレクトリ・アクセス・プロトコル(LDAP)サーバーに対して開始される接続で、コンテンツ・サーバー・インスタンスに対する外部ユーザー・アクセスを管理します。このタイプのプロバイダは、ActiveDirectoryLdapコンポーネントによってサポートされており、これはデフォルトではインストール時にインストール(無効化)されます。

注意:
11g リリース1 (11.1.1)以後、Ldapuserの機能はほとんどの場合(特にネストされたグループのサポートの場合)、JpsUserがかわりに使用されています。

- HTTP: HTTPプロトコルを使用して、コンテンツ・サーバー・インスタンス間の通信を可能にする接続。このタイプのプロバイダは、ProxyConnectionsコンポーネントによってサポートされており、これはデフォルトではコンテンツ・サーバー・インストール時にインストール(有効化)されます。このタイプの接続の使用が必要な状況と使用方法の詳細は、第21章を参照してください。

13.2 適切なプロバイダの選択

前項で説明した様々なタイプのプロバイダは、特定の状況の下で、その他の各種Oracle製品およびユーティリティを使用するために使用されます。この後の各項では、それらの状況と、各状況で使用する必要のある特定のプロバイダのタイプについて説明します。

- 第13.2.1項「送信プロバイダの使用が必要な状況」

- 第13.2.2項「データベース・プロバイダの使用が必要な状況」

- 第13.2.3項「受信プロバイダの使用が必要な状況」

- 第13.2.4項「プレビュー・プロバイダの使用が必要な状況」

- 第13.2.5項「JpsUserプロバイダの使用が必要な状況」

- 第13.2.6項「Ldapuserプロバイダの使用が必要な状況」

13.2.1 送信プロバイダの使用が必要な状況

送信プロバイダは、コンテンツ・サーバーのアーカイバ・ユーティリティおよびOracle WebCenter Content: Inbound Refineryを使用するために必要です。送信プロバイダでSSLを使用するか、キープアライブにする場合、第13.3項の詳細を参照してください。

- アーカイバ・ユーティリティ(コンテンツ・サーバー): アーカイバは、核となるコンテンツ・サーバー内のユーティリティで、システム管理者がコンテンツをコピーおよび削除し、今後の使用のために格納できるようにします。ユーザーは、コンテンツ・サーバー・インスタンスに一連のコンテンツを問い合せ、それをアーカイブにエクスポートできます。アーカイブはその他のコンテンツ・サーバー・インスタンスにインポートすることも、メタデータ・フィールドを変更した元のインスタンスにインポートすることもできます。
送信プロバイダは、ファイアウォールを越えて、あるいは1つのファイル・システムを共有していない2つのシステム間で、コンテンツをアーカイブするために使用されるアーカイバ転送機能を使用する際に必要です。転送機能、各種の転送および送信プロバイダの要件の詳細は、第23章を参照してください。

- Inbound Refinery: Inbound Refineryサーバーでは、コンテンツ・サーバーにチェックインされたコンテンツを処理し、それを指定されたフォーマットに変換します。Inbound Refineryサーバーへの送信接続は、コンテンツ・サーバーとの通信に必要です。詳細は、『Oracle WebCenter Contentのマネージング』を参照してください。

13.2.2 データベース・プロバイダの使用が必要な状況

データベース・プロバイダは、外部データベースを使用するために必要です。デフォルトのコンテンツ・サーバー・データベースではないデータベースでデータベース問合せを実行する場合に、望ましい、または必要になることがしばしばあります。この場合、カスタマイズされたデータベース・プロバイダを作成して、データを処理しているデータベース管理システムに関係なく、任意のアプリケーションから任意のデータにアクセスできるようにすることが可能です。カスタマイズされたデータベース・プロバイダを使用して、外部データベースをコンテンツ・サーバーに統合すると、1つの検索ページで検索結果を結合して表示できます。さらに、これらの外部データベース・ソースからデータをインポートできます。

管理者は、次の2つの方法のいずれかで、データベース・プロバイダを作成できます。

- Oracle WebLogic Serverの管理コンソールを使用して、データベースにOracle WebLogic Serverデータ・ソースを作成し、コンテンツ・サーバー・データベース・プロバイダでそのデータ・ソースが使用できるように構成します。WebLogicドメイン・サーバー用のJDBCデータ・ソースの作成の詳細は、『Oracle Application Development Framework Fusion開発者ガイド』を参照してください。

- コンテンツ・サーバー・データベース・プロバイダを作成して、Oracle WebLogic Serverデータ・ソースを使用せずに、JDBC接続を介してデータベースに直接接続します。このモードは、構成内に事前に接続が存在するインスタンス用に提供されています。

13.2.3 受信プロバイダの使用が必要な状況

受信プロバイダは、WebDAVサポートおよびコンテンツ・サーバー・アーカイバ・ユーティリティを使用するために必要です。受信プロバイダでSSLを使用するか、キープアライブにする場合、第13.3項の詳細を参照してください。

- アーカイバ・ユーティリティ(コンテンツ・サーバー): アーカイバは、コンテンツ・サーバー内のユーティリティで、システム管理者がコンテンツをコピーおよび削除し、今後の使用のために格納できるようにします。ユーザーは、コンテンツ・サーバー・インスタンスに一連のコンテンツを問い合せ、それを別のインスタンスにエクスポート、インポートまたはレプリケートしたり、メタデータ・フィールドを変更したりできます。システム内で最も頻繁に実行されるタスクは、情報の転送、バックアップおよび再編成です。
一般に、データまたはコンテンツ・アイテムが1つのリポジトリから別のリポジトリに移されると、アーカイバ・ユーティリティではプッシュ・テクノロジを使用してファイルを移動します。ただし、システムではファイルのプッシュよりプルが必要になることがあります。この場合、受信プロバイダを作成する必要があります。

- Oracle WebDAVサポート: コンテンツ・サーバーのバージョン7.0以降では、カスタム機能によりWebベース分散オーサリングおよびバージョニングが提供されるため、受信プロバイダとサーブレット・エンジンは必要ありません。
WebDAVの詳細は、『Oracle WebCenter Contentのマネージング』を参照してください。

13.2.4 プレビュー・プロバイダの使用が必要な状況

プレビュー・プロバイダは、HTMLプレビューおよびContent Categorizerを使用するために必要です。

- HTMLプレビュー: HTMLプレビューは、公開Webサイトでユーザーのコンテンツがどのように表示されるのかのフィードバックを、即時にユーザーに提供する機能です。この機能によりユーザーは、コンテンツが実際にチェックインされる前に、元のコンテンツを変更できます。HTMLプレビューは、正しいメタデータがコンテンツに割り当てられていることをユーザーが確認するのにも役立ちます。プレビュー・プロバイダは、インストール・プロセス中に作成する必要があります。HTMLプレビューに関する追加の概要およびインストール情報は、『Oracle WebCenter Contentのマネージング』を参照してください。

- Content Categorizer: Content Categorizerでは、コンテンツ・サーバーにチェックインするドキュメントや、メタデータを再適用する必要がある既存のドキュメントに対して、メタデータ値を提案します。Content Categorizerでドキュメントの構造上のプロパティが認識されるには、ファイルをXMLに変換する必要があります。
Content Categorizerの詳細は、『Oracle WebCenter Contentのマネージング』を参照してください。このマニュアルでは、必須またはオプションの追加製品の関連情報を提供しています。

13.2.5 JpsUserプロバイダの使用が必要な状況

JpsUserは、Oracle WebLogic Server管理コンソールで管理されるユーザー情報および資格証明と通信するための、WebCenter Content Serverインスタンスのデフォルトのプロバイダです。Oracle WebCenter Contentインスタンスおよびコンテンツ・サーバー・インスタンスには、JpsUserプロバイダを使用することをお薦めします。

注意:
リリース11g R11以降、コンテンツ・サーバー・インスタンスでは、特にネストされたグループのサポートの場合などに、JpsUserプロバイダが直接のLDAPプロバイダ機能のかわりに使用されています。

注意:
サイトがWebCenter Contentソフトウェアの10g以前のリリースからアップグレードしている場合、またActive Directory、LDAPまたはActive DirectoryとLDAPを使用している場合、これらのプロバイダに関する情報は、リリース10gR3ドキュメントセキュリティおよびユーザー・アクセスの管理で参照できます。JpsUserプロバイダを使用するようにサイトをアップグレードすることをお薦めします。

システム定義のJpsUserプロバイダでは、コンテンツ・サーバー・インスタンスに接続し、Oracle WebLogic Server認証メカニズム(基本、フォーム、シングル・サインオン、WNAなど)をサポートします。Javaプラットフォーム・セキュリティ(JPS)には、バックエンドのユーザー・ストレージ(XML、LDAP、データベース、Active Directoryなど)に関係なく、Oracle WebCenterアプリケーションからユーザーの認証および認可を行う統一インタフェースがあります。JPS APIコールは、ユーザー認証、ユーザー認可およびユーザー・メタデータ取得の実行に使用されます。

JpsUserProviderコンポーネントは、コンテンツ・サーバー・インスタンスがOracle WebLogic Serverインスタンスに対してインストールされているときに、システム・コンポーネントとしてインストールし、有効化します。JpsUserProviderは、標準のコンテンツ・サーバー・コンポーネントとしても使用可能です。

注意:
サイトでシステム定義のJpsUserプロバイダに加えてさらにJpsUserプロバイダが追加されることはまずありません。そのようにもう1つプロバイダを追加すると、WebCenter Content Serverのインストールに問題が生じる可能性があります。

コンテンツ・サーバー・インスタンスの「プロバイダ」ページを使用してJpsUserプロバイダを編集できます。接続の構成も、アイデンティティ・ストアおよび資格証明ストアを使用するように、jps-config.xmlファイルを介して編集できます。

JPSストアに対して認証する場合、JpsUserプロバイダを使用してOracle WebLogic Serverインスタンス上の別のアプリケーションと同じセキュリティ記憶域を共有できます。たとえば、JpsUserプロバイダを使用すると、Oracle WebLogic Serverインスタンスにインストールされているイメージおよび処理マネージャ・ソフトウェアと、セキュリティ記憶域を共有できます。

注意:
リリース11gR1 (11.1.1.6.0)以降、Oracle WebCenter ContentではOracle Virtual Directoryライブラリ(LibOVD)機能の使用がサポートされるようになり、これにより、サイトではJpsUserProviderを通じてログイン用の複数のプロバイダおよびグループ・メンバーシップ情報を使用できるようになりました。たとえば、Oracle Internet Directory (OID)とActive Directoryの両方をユーザーおよびロール情報のソースとして使用できます。Oracle WebLogic Server上での複数のLDAP構成の詳細は、『Oracle Fusion Middlewareアプリケーション・セキュリティ・ガイド』を参照してください。

13.2.5.1 ユーザーの直接および間接グループ・メンバーシップの取得

JpsUserプロバイダには、コンテンツ・サーバーで認証プロバイダでのユーザーの直接および間接グループ・メンバーシップを取得するか、またはユーザーの直接グループ・メンバーシップのみを使用するかを指定するUseNestedGroups構成オプションが含まれます。

UseNestedGroupsがFALSEに設定されている場合、ユーザーの直接メンバーシップのみが認証プロバイダから取得されます。

UseNestedGroupsがTRUEに設定されている場合、直接および間接メンバーシップの両方が認証プロバイダから取得されます。これはJpsUserプロバイダのデフォルトの動作です。

構成設定はファイルIntradocDir/data/providers/jpsuserprovider/provider.hda内に配置されています。

13.2.5.2 LDAPサーバーからのカスタム・フィールドのマッピング

JpsUserプロバイダを介してLDAPサービスからWebCenter Contentにカスタム・フィールドをマップする場合に、カスタム・フィールドが空であった場合のデフォルトの動作では、何のアクションも実行されません。たとえば、値123456789を持つカスタム・フィールドがあり、この値を削除すると、Oracle WebCenter Contentでは欠落している属性が無視され、通常カスタム・フィールドが空になることはないという原則に基づいて、引き続き123456789が反映されます。

WebCenter Contentでカスタム・フィールドを空にするには、JpsUserプロバイダのprovider.hdaファイルで変数ClearMissingAttributes=trueを有効化および設定して、デフォルト動作を変更する必要があります。このファイルのデフォルトの場所は、Domain_Home/ucm/cs/data/providers/jpsuserprovider/provider.hdaです。ファイル内の@end行より前に変数を追加してください。次に例を示します。

SourcePath=jpsuser
ProviderClass=idc.provider.jps.JpsUserProvider
ClearMissingAttributes=true
@end

この変数の詳細は、『Oracle WebCenter Content構成リファレンス』を参照してください。

13.2.5.3 アカウントの1文字のマッピング

WebCenter Contentでは、/ (スラッシュ)文字にマップされるセパレータとして % (パーセント記号)文字など、フラットLDAP構造から取得されたアカウント階層を指定するための1文字のマッピングの使用がサポートされます。マッピングは、その他すべてのフィルタリングが実行され、名前が閉じられてから行われます。

次の3つの設定によりこの動作が制御されます。これらはDomain_Home/ucm/cs/data/providers/jpsuserprovider/provider.hdaファイルまたはDomainHome/ucm/cs/config/config.cfgファイル内で指定できます。

- DoAccountCharMap: (ブール型) オプションを有効または無効にします。1またはtrueに設定できます。デフォルトは、falseです。

- AccountCharMapSource: ユーザー・ストア・グループ(アカウント)内の1つの文字を指定します。デフォルトは%です。

- AccountCharMapTarget: Oracle WebCenter Contentアカウント名内の1つの文字を指定します。デフォルトは/です。

次に例を示します。

DoAccountCharMap=true
AccountCharMapSource=%
AccountCharMapTarget=/

13.2.5.4 JpsUserプロバイダの資格証明マップ

Domain_Home/ucm/cs/data/providers/jpsuserprovider/provider.hdaファイルで変数ProviderCredentialsMap=name_of_mapを有効化および設定して、JpsUserプロバイダに資格証明マップを定義できます。この変数の詳細は、『Oracle WebCenter Content構成リファレンス』を参照してください。資格証明マッピングの詳細は、第21.2項を参照してください。

13.2.6 Ldapuserプロバイダの使用が必要な状況

Lightweight Directory Access Protocol (LDAP)は、TCP/IPで実行されるディレクトリ・サービス・プロトコルです。これは、ネットワーク内のリソース管理の高度な機能性を提供し、アプリケーションとともに使用して、セキュリティおよびユーザー認証を管理します。LDAPディレクトリ・サービス・モデルは、属性のコレクションに基づいており、情報ディレクトリに格納されている情報へのアクセスに使用されます。このように、LDAPは、ユーザー名およびパスワード資格証明のセットを認証ソースに照合して検証するために使用されます。このプロセスにより、ユーザーにはWebリソースにアクセスする権限が付与されます。

LDAPサーバーには、コンテンツ・サーバーやその他のOracle製品のモジュールなどのアプリケーションからアクセスできるユーザー関連情報のソースが1つあります。

注意:
リリース11gR1以後、コンテンツ・サーバーにはLdapuserプロバイダ機能のかわりにJpsUserProviderが使用されています。コンテンツ・サーバーのユーザーおよびセキュリティ管理にコンテンツ・サーバーLDAPプロバイダを使用することはお薦めできません。詳細は、第13.2.5項を参照してください。

LDAPサーバー(コンテンツ・サーバー・インスタンスと直接統合できるActive Directory以外)の使用を決定する場合、コンテンツ・サーバー・インスタンスとLDAPサーバー間の通信を設定するために、Ldapuserプロバイダを設定する必要があります。正しく構成されている場合、Ldapuserプロバイダでは、ロールの割当ておよびアカウント権限(LDAPプロバイダ・ページで定義)にリンクするマッピング・プロパティを通じて、外部ユーザーが認可されます。

Oracle Fusion MiddlewareでサポートされるLDAPサーバーの詳細は、次のOracle Technology Networkで動作保証情報を参照してください。

>http://www.oracle.com/technetwork/middleware/webcenter/content/documentation/documentation-155348.html

必須ではありませんが、コンサルティング・サービスを利用して、LDAPセキュリティ・モデルを作成し、LDAP統合をデプロイすることをお薦めします。詳細は、営業担当者にご連絡ください。

次のコンテンツ管理製品およびアーキテクチャでも、LDAP統合が役立つことがあります。

- Content Tracker: Content Trackerは、組み合せたときに、ユーザーが標準ブラウザを使用して、統合された一連の分析ツールを介してコンテンツの使用を追跡できるソフトウェア機能の集まりから構築されるシステムです。コンテンツ・サーバー・インスタンスにより提供されるデータは、Webサーバー・ログ・データ、コンテンツ・サーバー・データおよびユーザー情報などのログ・データから導出されます。Content Trackerでは、このデータにアクセスし、データの分析を行い、説明的なレポートを作成します。LDAPディレクトリ・サーバーとContent Trackerの統合はオプションです。ただし、LDAPが使用される場合、LDAPプロバイダを作成する必要があります。
関連するデータ・リポジトリ、レポート生成、問合せの作成およびインストール手順の詳細は、『Oracle WebCenter Contentのマネージング』を参照してください。

13.3 コンテンツ・サーバーのセキュリティ・プロバイダの理解

コンテンツ・サーバーとその他のOracleアプリケーション間のセキュリティ構成統合に加えて、コンテンツ・サーバー自体のSecurityProvidersコンポーネントは、基本の受信および送信ソケット・プロバイダに2つの新しいタイプのプロバイダを加えて拡張することで、セキュリティ強化に使用できます。

- Secure Socket Layer (SSL)プロバイダ

- キープアライブ・プロバイダ

セキュリティ・プロバイダを鍵および証明書とともに適切に使用すると、コンテンツ・サーバー・インスタンスとのネットワークおよびインターネット通信のセキュリティを強化できます。SecurityProvidersコンポーネントを使用する利点には、次のものがあります。

- 通信の暗号化および認証を提供することにより、SSLがWeb通信のセキュリティを強化します。

- セキュリティ・プロバイダにより、ソケットまたはサーバー認証に証明書を使用できます。

- キープアライブおよび接続プーリング・ロジックは、SSLソケットの作成および解除の量を減らすことで、SSL費用のオーバーヘッドを避けるのに役立ちます。

SecurityProvidersコンポーネントは、デフォルトではコンテンツ・サーバー・インスタンスによりインストール(有効化)されます。

リファレンス

SecurityProvidersコンポーネントを使用するには、ソケット・プロバイダ、セキュリティおよび認証、SSL、キープアライブ、およびネットワーク通信のその他のセキュリティ面に精通している必要があります。SecurityProvidersコンポーネントで作業する場合、次の情報ソースが役立ちます。

- 『Java Secure Socket Extension (JSSE) Reference Guide for the Java 2 SDK, Standard Edition』
このオンライン・ドキュメントはオラクル社から入手可能です。これには広範囲に及ぶ関連ドキュメント・セクションがあり、参考図書、セキュリティ基準、政府のセキュリティに関する政策および規制、暗号化およびSSLに関する書籍一覧が含まれています。

- 『keytool Key and Certification Management Tool』
このオンライン・ドキュメントはオラクル社から入手可能です。

- RSA社の『Public Key Cryptography Standards』
このオンライン・ドキュメントは、RSA社から入手可能です。

http://www.emc.com/emc-plus/rsa-labs/standards-initiatives/public-key-cryptography-standards.htm

- RSA社の『Cryptography FAQ』
このオンライン・ドキュメントは、RSA社から入手可能です。

http://www.emc.com/emc-plus/rsa-labs/historical/crypto-faq.htm

- 『SSL Certificate FAQ』
このオンライン・ドキュメントは、Linux Documentation Projectから入手可能です。

http://www.tldp.org

用語集

次の表では、この項で使用されるいくつかのセキュリティ用語の定義を示しています。詳細は、情報参照先のリスト、またはセキュリティおよび認証基準の情報源を参照してください。

用語

説明

証明書

エンティティ(人または組織)のアイデンティティおよび公開鍵を確認するデジタル署名。証明書は、認証局または個々のエンティティで発行できます。

認証局(CA)

他のエンティティのために証明書を発行するエンティティで、VeriSignやThawteのような、有名で信頼できる証明書の発行元として認識されています。

キーストア

認証処理に使用される鍵の情報のファイルまたはデータベース。

秘密鍵

発行者であるエンティティのみが知っている鍵としてパッケージ化された情報。秘密鍵は、署名生成で使用されます。

公開鍵

エンティティに公に関連付けられた鍵としてパッケージ化された情報。公開鍵は、署名の確認に使用されます。

SSL

Secure Socket Layerは、公開鍵と秘密鍵のテクノロジの組合せを使用するセキュアなネットワーク通信用のプロトコル。

トラストストア

トラスト・マネージャが信頼できると判断した鍵のファイルまたはデータベース。

13.3.1 セキュリティ・プロバイダの使用計画

コンテンツ・サーバー用のSSLソケット・プロバイダまたはキープアライブ・ソケット・プロバイダを実装する前に、セキュリティ・プロバイダをどのように使用するかを決めることをお薦めします。キープアライブおよびSSLの接続タイプを調べ、選択したセキュリティ・プロバイダを使用するために、キーストアやトラスト・ストアを作成する必要性など、追加の構成が必要かどうかを決定します。

次の項では、プロバイダ・タイプの動作を制御するために使用するJavaクラスや、必要になる可能性のある追加構成など、SSLおよびキープアライブ・プロバイダ・タイプについてより多くの情報を提供しています。

- 第13.3.1.1項「キープアライブ接続」

- 第13.3.1.2項「SSL接続」

- 第13.3.1.3項「追加のセキュリティ構成」

13.3.1.1 キープアライブ接続

キープアライブ機能は、永続的接続やサービス・リクエスト用のソケット接続のプーリングを可能にします。キープアライブ接続の設定は、接続の設定および解除に時間がかかる可能性のあり、そのアクティビティにかかる時間を最小限にする必要がある場合に、最も役に立ちます。SecurityProvidersコンポーネントは、受信および送信の2つのキープアライブ・ソケット・プロバイダを提供します。

キープアライブ受信ソケット・プロバイダの設定には、次のJavaクラスが使用されます。

Javaクラス

説明

プロバイダ・クラス

idc.provider.ExtendedSocketIncomingProvider

接続クラス

idc.provider.KeepaliveSocketIncomingConnection

サーバー・スレッド・クラス

idc.server.KeepaliveIdcServerThread

キープアライブ送信ソケット・プロバイダの設定には、次のJavaクラスが使用されます。

Javaクラス

説明

プロバイダ・クラス

idc.provider.KeepaliveSocketOutgomingProvider

接続クラス

idc.provider.KeepaliveSocketOutgomingConnection

リクエスト・クラス

idc.server.KeepaliveServerRequest

13.3.1.2 SSL接続

SSLプロバイダの設定により、キープアライブ環境でSSL接続が使用できるようになります。この設定は、SSLソケットの設定および解除のコストを最小限にするのに役立つため、単純なSSLプロバイダ設定にお薦めします。SecurityProvidersコンポーネントは、キープアライブ付きの受信および送信の2つのSSLソケット・プロバイダを提供します。

SSLキープアライブ受信ソケット・プロバイダの設定には、次のJavaクラスが使用されます。

Javaクラス

説明

プロバイダ・クラス

idc.provider.ssl.SSLSocketIncomingProvider

接続クラス

idc.provider.KeepaliveSocketIncomingConnection

サーバー・スレッド・クラス

idc.server.KeepaliveIdcServerThread

キープアライブSSL送信ソケット・プロバイダの設定には、次のJavaクラスが使用されます。

Javaクラス

説明

プロバイダ・クラス

idc.provider.KeepaliveSocketOutgoingProvider

接続クラス

idc.provider.ssl.SSLSocketOutgoingConnection

リクエスト・クラス

idc.provider.KeepaliveServerRequest

13.3.1.3 追加のセキュリティ構成

どのタイプのセキュリティ・プロバイダを選択するかに応じて、追加の構成が必要になる場合があります。

- キープアライブおよびSSL送信プロバイダ: 「プロバイダの追加」ページには、プールする接続数を指定する「接続の数」フィールドがあります。

- SSL受信プロバイダ: 「プロバイダの追加」ページには2つの追加オプションがあります。

- 「クライアント認証をリクエスト」オプション: クライアントに能力があれば、接続を行うときに自身を認証する必要があります。

- 「クライアントの認証が必要」オプション: クライアントは、接続をするために、自身を認証する必要があります。

「クライアント認証をリクエスト」オプションの値、「クライアントの認証が必要」オプションの値、およびどんなタイプの認証局がこれらのオプションで処理される証明書に署名をしたかにより、SSLプロバイダでは、クライアントとサーバーの両方で、1つまたは複数のキーストアと1つのトラストストアの設定が必要になる可能性もあります。キーストアおよびトラストストアの詳細は、第13.3.2項を参照してください。

13.3.2 キーストアおよびトラストストア

SSLプロバイダには、複数のキーストアの使用が必要になる場合と、1つのトラストストアが必要になる場合があります。キーストアとは、SSLで使用するための公開鍵および秘密鍵の情報を保持するファイルです。トラストストアには、信頼できると判断された証明書が格納されます。サーバーおよびクライアント上で使用される証明書が、VeriSignやThawteなどの有名な認証局(CA)によって署名されている場合、デフォルトのJVMトラストストアにはこれらのCAの証明書が含まれてるため、トラストストアは不要です。トラストストアは、SSLプロバイダにより使用される証明書が自己署名または民間のCAによって署名されている場合に必要です。SSLプロバイダにキーストアとトラストストアが必要な場合、それらを作成および管理する必要があります。

次の各項では、キーストアとトラストストアの概要を説明します。

- 第13.3.2.1項「キーストアおよびトラストストアの使用が必要な状況」

- 第13.3.2.2項「キーストアおよびトラストストア情報の指定」

- 第13.3.2.3項「キーストアの生成」

- 第13.3.2.4項「トラストストアの作成」

キーストアおよびトラストストアの詳細は、第13.3項のリストにある情報源を参照してください。

13.3.2.1 キーストアおよびトラストストアの使用が必要な状況

次の例は、キーストアおよびトラストストアが必要となる様々な状況と使用について示しています。

- サーバーでは、SSLソケットを作成するために、署名入りSSL証明が入っているキーストアが1つ必要です。

- サーバーでは、クライアント認証を要求または必要とし、これにはトラストストアが1つ必要になる場合があります。クライアントの証明書が有名なCAによって署名されていない場合、サーバーではそのCAの証明書が入っているトラストストアが必要になります。

- サーバーではクライアント認証を要求または必要とし、これにはクライアントに、認証のために提示する証明書を格納するキーストアが必要になる場合があります。

- サーバーでは、有名なCAによって署名されていない証明書を使用するため、クライアントにはサーバーの証明書が入っているトラストストアが必要になります。

13.3.2.2 キーストアおよびトラストストア情報の指定

キーストアおよびトラストストア情報を使用するために、SSL受信および送信プロバイダでは、sslconfig.hdaというファイルがプロバイダ・ディレクトリ(provider.hdaファイルの隣)で設定されている必要があります。sslconfig.hdaファイルには、キーストアおよびトラストストアのために指定する構成情報が含まれています。これは次の例に似たフォーマットです。セキュリティ上の理由で、このファイルの編集に便利なWebインタフェースはなく、編集はすべて、テキスト・エディタ使用して手動で行う必要があります。これまたは任意の.hdaファイルの各行の末尾に、スペースがないことを確認してください。

@Properties LocalDataTruststoreFile=/servers/idc/data/providers/ssloutgoing1/truststoreKeystoreFile=/servers/idc/data/providers/ssloutgoing1/keystore@end

構成名

値の説明

TruststoreFile

トラストストア・ファイルへのフル・パス。

KeystoreFile

キーストア・ファイルへのフルパス。

13.3.2.3 キーストアの生成

この項では、キーストア生成の基本プロセスを説明します。自分のSSLプロバイダ用に作成する鍵およびキーストアに、固有の要件と名前を決める必要があります。sslconfig.hdaファイルには、そのファイルのKeystoreFile構成設定のフルパスが含まれているため、キーストア・ファイルは任意の場所に格納できます。ただし、キーストア・ファイルは、IntradocDir/data/providers/provider_nameディレクトリ(provider.hdaファイルおよびsslconfig.hdaファイルの隣)か、IntradocDir/config/ディレクトリに格納することをお薦めします。コンテンツ・サーバー・インスタンスのプロバイダ・ページを使用して、エイリアスおよびパスワードを設定します。

キーストアを生成するキーツール・ユーティリティの使用方法の詳細は、オラクル社からオンラインで入手可能な『keytool Key and Certification Management Tool』というタイトルのドキュメントを参照してください。

注意:
Java keytoolユーティリティには、秘密鍵との直接の対話を防ぐ機能があります。この機能とは、キーツールを使用して生成される証明書をキーストアに貼り付けることで、そのため証明書から秘密鍵の部分を取得することはできません。逆に、キーツールで、前から存在する証明書をJavaキーストアにインポートする方法はありません。
Portecle Javaキーストアを使用すると、Javaキーストアからの秘密鍵のインポートおよびエクスポートができます。詳細は、portecle.sourceforge.netを参照してください。

キーツールを使用するには、コマンドを入力する際に、自分のパスにそのユーティリティを持っている必要があります。

1. キーストアで鍵を作成します。次のコマンドラインの例は、aliasという名前の鍵のエントリを、keystoreという名前のキーストアに作成する方法を示しています。このコマンドは、キーストアのパスワード、鍵を生成するために使用される情報、および鍵自体のパスワードの入力を要求します。鍵のパスワードがキーストアのパスワードと異なる場合、鍵の取得にKeystoreAliasおよびKeystoreAliasPasswordの値が必要です。

keytool -genkey -v -alias alias -keystore keystore

2. 証明書の署名リクエストを生成します。次のコマンドラインの例は、keystoreという名前のキーストアでaliasという名前の鍵エントリを生成し、これをcsr_fileという名前のファイルに格納する方法を示しています。このファイルは、CAに送信して署名してもらうことができます。

keytool -certreq -v -alias alias -keystore keystore -file csr_file

3. CAの証明書をキーストアにインポートします。キーツールが、ユーザーの証明書がインポートされると同時に、一連の信用をチェックします。証明書に有名でないCAの署名が入っていて、キーツールにそのCAに関する情報がない場合、その証明書は却下されます。したがって、有名ではないCAからの証明書はすべて、まずはキーストアにインポートし、そのユーザーの証明書が次のステップで正常にインポートされるようにする必要があります。次のコマンドラインの例は、cert_fileという名前のファイルにある証明書を、keystoreという名前のキーストアにインポートする方法を示しています。

keytool -import -v -alias ca_alias -keystore keystore -file cert_file

4. 署名の入った証明書を元のキーストアにインポートします。証明書の署名リクエストがCAで受信され、署名の入った証明書がCAから送り返されてくると、その証明書は、エイリアスで識別されるキーストア・エントリに読み込むことができきます。次のコマンドラインの例は、署名の入った証明書をインポートする方法を示しています。

keytool -import -v -alias alias -keystore keystore_name -file csr_file

5. すべてがキーストアにあることを確認します。

keytool -list -v -keystore keystore_name

13.3.2.4 トラストストアの作成

この項では、トラストストア生成の基本プロセスを説明します。トラストストアは、SSLプロバイダで有名な認証局の署名のない鍵を使用する場合に必要です。トラストストアには、コンテンツ・サーバー・インスタンス用にトラストストアの管理者(トラスト・マネージャ)によって確認された公開証明書のみが格納されています。作成するトラストストア固有の要件および名前を決める必要があります。sslconfig.hdaファイルにはTruststoreFile構成設定のフルパスが含まれているため、トラストストア・ファイルは好きなところに格納できます。ただし、トラストストア・ファイルは、IntradocDir/data/providers/provider_nameディレクトリ(provider.hdaファイルおよびsslconfig.hdaファイルの隣)か、IntradocDir/config/ディレクトリに格納することをお薦めします。

トラストストアを生成するキーツール・ユーティリティの使用方法の詳細は、http://docs.oracle.com/javase/6/docs/technotes/tools/solaris/keytool.htmlからオンラインで入手可能な『keytool Key and Certification Management Tool』というタイトルのドキュメントを参照してください。キーツール・ユーティリティを使用するには、コマンドを入力する際に、自分のパスにそのユーティリティを持っている必要があります。

次のコマンドラインの例は、トラストストアの作成方法を示しています。

keytool -import -v -alias alias -keystore keystore -file cert_files

変数

説明

alias

キーのエイリアス名。

keystore

キーストアの名前。

cert_file

認証局の証明書へのパス。

13.4 プロバイダの管理

この項の内容は次のとおりです。

- 第13.4.1項「送信プロバイダの追加」

- 第13.4.2項「データベース・プロバイダの追加」

- 第13.4.3項「受信プロバイダの追加」

- 第13.4.4項「プレビュー・プロバイダの追加」

- 第13.4.5項「受信セキュリティ・プロバイダの追加」

- 第13.4.6項「送信セキュリティ・プロバイダの追加」

- 第13.4.7項「JpsUserプロバイダの追加」

- 第13.4.8項「HTTP送信プロバイダの追加」

- 第13.4.9項「プロバイダ構成の編集」

- 第13.4.10項「プロバイダの削除」

13.4.1 送信プロバイダの追加

送信プロバイダを追加するには、次のようにします。

1. Webブラウザを使用して、コンテンツ・サーバーのホームページにアクセスし、「管理」→「プロバイダ」を選択します。

2. 「プロバイダ」ページの「新規プロバイダの作成」表で、「送信」プロバイダ・タイプの「アクション」列で「追加」をクリックします。

3. 「送信ソケット・プロバイダ」ページで構成値を入力します。
必須のフィールド

- プロバイダ名

- プロバイダの説明

- サーバー・ホスト名

- サーバー・ポート

- プロバイダ・クラス(事前定義)

オプションのフィールド

- 接続クラス(事前定義)

- 構成クラス

- 相対Webルート

- HTTPサーバー・アドレス

- インスタンス名

- 必要なロール

- アカウント・フィルタ

オプションのチェック・ボックス

- プロキシ

- ターゲットへの通知

- ユーザー

- リリースされたドキュメント

4. 「追加」をクリックします。「プロバイダ」表に追加した新規プロバイダが入った「プロバイダ」ページが開きます。

5. コンテンツ・サーバー・インスタンスを再起動します。

13.4.2 データベース・プロバイダの追加

データベース・プロバイダの構成は、WebCenter Contentおよびコンテンツ・サーバー・インスタンスがOracle WebLogic Serverドメインにインストールされるときに指定されます。

注意:
スタンドアロン・モードのデータベース接続を構成する場合は、第3.5.2.3項、第3.5.2.4項、および第3.5.2.5項を参照してください。

データベース・プロバイダを追加するには、次のようにします。

1. Webブラウザを使用して、コンテンツ・サーバーのホームページにアクセスし、「管理」→「プロバイダ」を選択します。

2. 「プロバイダ」ページの「新規プロバイダの作成」項で、「データベース」プロバイダ・タイプの「アクション」列で「追加」をクリックします。

3. 「データベース・プロバイダ」ページで構成値を入力します。
必須のフィールド

- プロバイダ名

- プロバイダの説明

- プロバイダ・クラス(事前定義)

- データベース・タイプ

- JDBCドライバ

- JDBC接続文字列

- 問合せのテスト

オプションのフィールド

- 接続クラス(事前定義)

- 構成クラス

- データ・ソース

- データベース・ディレクトリ

- データベース名

- JDBCユーザー

- JDBCパスワード

- 接続の数(デフォルト指定)

- 追加のストレージ・キー(デフォルト指定)

- 追加設定

オプションのチェック・ボックス

- データ・ソースの使用

4. 「追加」をクリックします。「プロバイダ」表に追加した新規プロバイダが入った「プロバイダ」ページが開きます。

5. コンテンツ・サーバー・インスタンスを再起動します。

13.4.3 受信プロバイダの追加

プロバイダを使用してサーバー・ソケットに接続するには、コンサルティング・サービスが必要です。

受信プロバイダを追加するには、次のようにします。

1. Webブラウザを使用して、コンテンツ・サーバーのホームページにアクセスし、「管理」→「プロバイダ」を選択します。

2. 「プロバイダ」ページの「新規プロバイダの作成」項で、「受信」プロバイダ・タイプの「アクション」列で「追加」をクリックします。

3. 「受信プロバイダ」ページで構成値を入力します。
必須のフィールド

- プロバイダ名

- プロバイダの説明

- サーバー・ポート

- プロバイダ・クラス(事前定義)

オプションのフィールド

- 接続クラス(事前定義)

- 構成クラス

4. 「追加」をクリックします。「プロバイダ」表に追加した新規プロバイダが入った「プロバイダ」ページが開きます。

5. コンテンツ・サーバー・インスタンスを再起動します。

13.4.4 プレビュー・プロバイダの追加

プレビュー・プロバイダを追加する手順は、HTMLプレビュー機能のzipファイル内で提供される情報を参照してください。HTMLプレビュー機能のzipファイルおよびガイドは、Oracle Technology NetworkのWebサイトからダウンロード可能です。

13.4.5 受信セキュリティ・プロバイダの追加

受信セキュリティ・プロバイダを追加する手順は次のとおりです。

1. Webブラウザを使用して、コンテンツ・サーバーのホームページにアクセスし、「管理」→「プロバイダ」を選択します。

2. 「プロバイダ」ページの「新規プロバイダの作成」表で、「keepaliveincoming」または「sslincoming」プロバイダ・タイプの「アクション」列の「追加」をクリックします。

3. keepaliveincomingプロバイダのページまたはsslincomingプロバイダのページで、次のように構成値を入力します。
必須のフィールド

- プロバイダ名

- プロバイダの説明

- プロバイダ・クラス(事前定義)

- サーバー・ポート

オプションのフィールド

- 接続クラス(事前定義)

- 構成クラス

- サーバー・スレッド・クラス(事前定義)

オプションのチェック・ボックス(sslincomingプロバイダのみ)

- クライアント認証をリクエスト

- クライアントの認証が必要

4. 「追加」をクリックします。「プロバイダ」表に追加した新規プロバイダが入った「プロバイダ」ページが開きます。

5. コンテンツ・サーバー・インスタンスを再起動します。

13.4.6 送信セキュリティ・プロバイダの追加

送信セキュリティ・プロバイダを追加する手順は次のとおりです。

1. Webブラウザを使用して、コンテンツ・サーバーのホームページにアクセスし、「管理」→「プロバイダ」を選択します。

2. 「プロバイダ」ページの「新規プロバイダの作成」表で、「keepaliveoutgoing」または「ssloutgoing」プロバイダ・タイプの「アクション」列の「追加」をクリックします。

3. keepaliveoutgoingプロバイダのページまたはssloutgoingプロバイダのページで、次のように構成値を入力します。
必須のフィールド

- プロバイダ名

- プロバイダの説明

- プロバイダ・クラス(事前定義)

- サーバー・ホスト名(事前定義)

- サーバー・ポート

- インスタンス名

- 相対Webルート

オプションのフィールド

- 接続クラス(事前定義)

- 構成クラス

- リクエストのクラス(事前定義)

- 接続の数(事前定義)

- HTTPサーバー・アドレス

- 必要なロール

- アカウント・フィルタ

オプションのチェック・ボックス

- プロキシ

- ターゲットへの通知

- ユーザー

- リリースされたドキュメント

4. 「追加」をクリックします。「プロバイダ」表に追加した新規プロバイダが入った「プロバイダ」ページが開きます。

5. コンテンツ・サーバー・インスタンスを再起動します。

13.4.7 JpsUserプロバイダの追加

Oracle JPS (Oracle WebLogic Serverインスタンス用)を統合するデフォルトのJPSユーザー・プロバイダは、WebCenter Contentシステムをインストールすると提供されます。

注意:
サイトでシステム定義のJpsUserプロバイダに加えてさらにJpsUserプロバイダが追加されることはまずありません。そのように別のプロバイダを追加すると、Content Serverのインストールに問題が生じる可能性があります。

「JpsUserプロバイダ」ページで指定した以外の構成オプションの詳細は、第13.2.5.1項を参照してください。

JpsUserプロバイダを追加する手順は次のとおりです。

1. Webブラウザを使用して、コンテンツ・サーバーのホームページにアクセスし、「管理」→「プロバイダ」を選択します。

2. 「プロバイダ」ページの「新規プロバイダの作成」表で、「jpsuser」プロバイダ・タイプの「アクション」列で「追加」をクリックします。

3. 「JPSユーザー・プロバイダ」ページで構成値を入力します。
必須のフィールド

- プロバイダ名

- プロバイダの説明

- プロバイダ・クラス(事前定義)

- ソース・パス

オプションのフィールド

- 接続クラス

- 構成クラス

- JPSコンテキスト

- デフォルト・ネットワーク・ロール

4. 属性マップを指定するには、次のようにします。

1. 「JPS属性」リストから情報フィールドを選択します。

2. 「ユーザー属性」リストからコンテンツ・サーバーのユーザー情報フィールドを選択します。

3. 「追加」をクリックします。テキスト・ボックスに、その属性マップが追加されます。

4. 必要ならば、「属性マップ」テキスト・ボックスで属性を直接編集します。

5. 必要ならば、デフォルト・ネットワーク・ロールを変更または追加します。

6. 「追加」をクリックします。「プロバイダ」表に追加した新規プロバイダが入った「プロバイダ」ページが開きます。

7. コンテンツ・サーバー・インスタンスを再起動します。

8. Webサーバーを再起動します。

13.4.8 HTTP送信プロバイダの追加

HTTP送信プロバイダを追加するには、次の手順を実行します。

1. Webブラウザを使用して、コンテンツ・サーバーのホームページにアクセスし、「管理」→「プロバイダ」を選択します。

2. 「プロバイダ」ページの「新規プロバイダの作成」表で、「httpoutgoing」プロバイダ・タイプの「アクション」列で「追加」をクリックします。

3. 「送信HTTPプロバイダ」ページで構成値を入力します。
必須のフィールド

- プロバイダ名

- プロバイダの説明

- プロバイダ・クラス(事前定義)

- CGI URL

- インスタンス名

- 相対Webルート

オプションのフィールド

- 接続クラス(事前定義)

- 構成クラス

- 接続パスワード名

- 接続パスワード

- クライアントのIPフィルタ

4. 「追加」をクリックします。「プロバイダ」表に追加した新規プロバイダが入った「プロバイダ」ページが開きます。

5. コンテンツ・サーバー・インスタンスを再起動します。

13.4.9 プロバイダ構成の編集

既存のプロバイダ(デフォルトのシステム・プロバイダを除く)の構成を編集する手順は、次のとおりです。

1. Webブラウザを使用して、コンテンツ・サーバーのホームページにアクセスし、「管理」→「プロバイダ」を選択します。

2. 「プロバイダ」ページの「プロバイダ」表で、編集するプロバイダの「アクション」列の「情報」をクリックします。

3. 「プロバイダ情報」ページで「編集」をクリックします。

4. 「Add/Edit Provider」ページで、必要な変更を行います。

5. 「更新」をクリックして変更内容を保存し、「プロバイダ」ページに戻ります。

6. コンテンツ・サーバー・インスタンスを再起動します。

13.4.10 プロバイダの削除

既存のプロバイダ(デフォルトのシステム・プロバイダを除く)を削除するには、次のようにします。

1. Webブラウザを使用して、コンテンツ・サーバーのホームページにアクセスし、「管理」→「プロバイダ」を選択します。

2. 「プロバイダ」ページの「プロバイダ」表で、削除するプロバイダの「アクション」列の「情報」をクリックします。

3. 「プロバイダ情報」ページで「削除」をクリックします。

4. 「確認」ウィンドウで「OK」をクリックします。「プロバイダ」表からそのプロバイダが削除されます。

重要:
単に情報を編集するのではなく、プロバイダの削除が目的であることを確認してください。プロバイダを削除すると、プロバイダ名およびその関連情報すべてが、「プロバイダ」表から永久に削除されます。

14 URLのマッピング

この章では、短縮形のURLをその他のURLにマップするWebUrlMapPluginコンポーネント使用方法について説明します。このコンポーネントは、Webブラウザを通じてページをフィルタ処理するために、Oracle WebCenter Content ServerによるOracle WebLogic Server Webサーバーの使用をサポートします。

この章の内容は次のとおりです。

- WebUrlMapPluginコンポーネント

- スクリプト構成

- 参照用にサポートされている変数

- URLマッピング・エントリの追加/編集

- マッピングの例

14.1 WebUrlMapPluginコンポーネント

WebCenter Contentでは、ビルトインのWebサーバーを持つOracle WebLogic Serverを使用して、Webブラウザを通してページをフィルタ処理します。ユーザー・リクエストは、Oracle WebLogic Serverユーザー・ストアまたはその他の構成済ユーザー・ストアにより認証され、コンテンツ・サーバー・インスタンスと通信します。

WebUrlMapPluginコンポーネントを使用すると、短縮形のURLを、マッピング用の置換スクリプトを使用して、他のURLにマップでき、これによって、長いURLを短縮形にマップすることもできます。WebUrlMapPluginコンポーネントは、デフォルトではコンテンツ・サーバー・インスタンスによりインストール(有効化)されます。

14.2 スクリプト構成

作成できる短縮形のURLでは、一般に次のフォーマットを使用します。

http://myhostexample.com/prefix/suffix

実際のマッピング・プロセスは、ホスト名の部分に続くURLの部分に基づきます。短縮形のURLを解決するため、コンテンツ・サーバー・インスタンスでは、接頭辞を定義済のWebUrlMapPluginエントリのリストのものと比較します。一致するものがある場合、コンテンツ・サーバー・インスタンスでは、一致する接頭辞に対応するマップ・スクリプトを使用して、該当するドキュメントまたはコンテンツ・サーバー・ページを表示します。接尾辞の詳細は、第14.3項を参照してください。

「Web URLマップ」画面を使用してURLマッピング・エントリを構成するには、接頭辞を確定し、対応するマップを定義する必要があります。

接頭辞

マッピング・エントリの接頭辞の部分は、特定の形のURLを識別するために使用する任意の短縮形です。たとえば、短縮形のURLでドキュメントの動的変換が返されるようにする場合、idcを自分の接頭辞として使用できます(たとえば、dynamic converterの短縮形)。

コンテンツ・サーバー・インスタンスでは、接頭辞テストの実行前に、受信したURLから最初のスラッシュが削除されるため、接頭辞を作成する際には、先頭にスラッシュ(/)文字を入力しないでください。

注意:
URLマップの接頭辞の最後には、スラッシュ(/)を含めてください。そうしないと、マッピングが適用されるURLが増えて、標準的なコンテンツ・サーバーの操作の妨げになる可能性があります。

マップ

マッピング・エントリのマップの部分は、コンテンツ・サーバー・インスタンスで短縮形のURLを解決するために使用されるIdocスクリプト・コードです。マップの部分では、置換タグ(<!--$variable-->)を使用できます。たとえば、次のものが含まれます。

<!--$cgipath-->
<!--$internetuser-->
<!--$suffix-->

これらの置換タグは、URLの該当するパラメータを参照する変数です。

単純なif構造体もサポートされています。たとえば、次のスクリプト・セグメントは、値が存在し、空でないかどうかを確認するためのテストを実行します。

<!--$if myconfigvar-->something<!--$endif-->

14.3 参照用にサポートされている変数

URLマッピング・エントリのマップ部分では、参照用の次の標準変数が使用されます。

- CGIパス
これは、Oracle WebLogic Server Webサーバー・フィルタの構成済コンテンツ・サーバー・インスタンスの現在のCGIパスです。Webサーバー・フィルタは、このコンテンツ・サーバー・インスタンスのための通信とセキュリティの両方を提供するように構成されます。典型的な例は、/idcm1/idcplgです。

- suffixパラメータ
接尾辞変数(<!--$suffix-->)の値は、URLで先行するマッピング接頭辞の後に続き、疑問符(?)の前にある部分から導出されます。接尾辞の先頭にあるスラッシュ(/)は、この変数に代入される前に削除されます。たとえば、次のURLでは、dcがマッピング接頭辞で、後に接尾辞が続きます。

http://myhostexample.com/dc/mydocumentname

スラッシュを削除した後、mydocumentnameが、マッピング・エントリのマップ部分で置換タグとして使用される接尾辞変数の値として使用されます。また、接尾辞変数には、CGIパラメータは含まれません。したがって、次のURLでは、mydocumentnameがそのまま接尾辞変数の値として使用されています。

http://myhostexample.com/dc/mydocumentname?a=1

接頭辞と接尾辞の間をスラッシュで強制的に区切るには、接頭辞の短縮形の最後にスラッシュを追加します。

- 任意のプラグイン変数
たとえば、現在ログインしているユーザーのユーザーIDと置換するために、構造体<!--$internetuser-->を使用できます。

- 任意のCGIパラメータ

14.4 URLマッピング・エントリの追加/編集

URLマッピング・エントリを追加または編集するには、次のようにします。

1. コンテンツ・サーバーのホーム・ページで、「管理」→「WebUrlMapPlugin」を選択します。

2. 「Web URLマップ」ページで、「接頭辞」フィールドと「マップ」フィールドに適切な値を入力して、既存のマッピング・エントリを編集するか、新規のエントリを定義するか、またはその両方を行います。

3. 「更新」をクリックします。ページがリフレッシュされ、「接頭辞」フィールドと「マップ」フィールドの値が保存されます。表示されたすべてのフィールドに値が入っている場合、ページの再表示後に追加の「接頭辞」と「マップ」のフィールドのペアが2つ表示されます。

重要:
WebUrlMapPlugin機能は、数百のマッピング・エントリをサポートするように設計されています。ただし、マッピング・エントリが数千に及ぶと、Webサーバーのパフォーマンスに影響が出るので注意してください。

14.5 マッピングの例

次の例では、マッピングのスクリプトとテクニックを示します。

- 第14.5.1項「情報更新フォーム」

- 第14.5.2項「動的変換」

- 第14.5.3項「CGIパラメータ」

14.5.1 情報更新フォーム

既存のコンテンツ・アイテムに情報更新フォームを生成するために、短縮形のURLを作成できるようにするWeb URLマッピング・スクリプトを定義できます。ユーザーが特定のドキュメントに任意の識別変数を入力できるように、マッピング・スクリプトを作成できます。たとえば、次のフォーマットのURLがあるとします。

http://myhostexample.com/u/mydoc_parameter

このURLは、次のURLにマップできます。

http://myhostexample.com/idcm1//idcplg?IdcService=GET_UPDATE_FORM&dDocName=mydocumentname

URLをマップするには、「Web URLマップ」画面を使用して、次のWeb URLマップ・エントリを定義します。

- 接頭辞:

u/

- マップ:

<!--$cgipath-->?IdcService=GET_UPDATE_FORM<!--$suffix-->&myparam=<!--$myparam-->

14.5.2 動的変換

このURLマッピング例を機能させるには、Dynamic Converterをインストールする必要があります。Dynamic Converterの詳細は、『Oracle WebCenter Contentのマネージング』を参照してください。

ドキュメントの様々な動的変換に短縮形のURLを作成できるようにするWeb URLマッピング・スクリプトを定義できます。たとえば、次のフォーマットのURLがあるとします。

http://myexamplename.com/dc/mydocumentname

このURLは、次のURLにマップできます。

http://myhostexample.com/idcm1/idcplg?IdcService=GET_DYNAMIC_CONVERSION&dDocName=mydocumentname&RevisionSelectionMethod=LatestReleased

URLをマップするには、「Web URLマップ」画面を使用して、次のWeb URLマップ・エントリを定義します。

- 接頭辞:

dc/

- マップ:

<!--$cgipath-->?IdcService=GET_DYNAMIC_CONVERSION&dDocName=<!--$suffix-->&RevisionSelectionMethod=LatestReleased

14.5.3 CGIパラメータ

CGIパラメータを直接参照することもできます。たとえば、次のフォーマットのURLがあるとします。

http://myhostexample.com/dcp/mydocumentname?myparam=myvalue

このURLは、次のURLにマップできます。

http://myhostexample.com/idcm1/idcplg?IdcService=GET_DYNAMIC_CONVERSION&dDocName=mydocumentname&RevisionSelectionMethod=LatestReleased&myparam=myvalue

URLをマップするには、「Web URLマップ」画面を使用して、次のWeb URLマップ・エントリを定義します。

- 接頭辞:

dcp/

- マップ:

<!--$cgipath-->?IdcService=GET_DYNAMIC_CONVERSION&dDocName=<!--$suffix-->&RevisionSelectionMethod=LatestReleased&myparam=<!--$myparam-->

第V部

セキュリティの管理

この部では、Oracle WebCenter Contentのセキュリティの管理についての情報を提供します。これには、システムとその他のOracleセキュリティ・ソフトウェアとの統合、ユーザー・タイプ、ログイン、エイリアス、アカウントの構成、ACLの管理、およびイメージングとレコード機能のセキュリティの管理についての詳細が含まれます。

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

- 第15章「セキュリティおよびユーザー・アクセスの理解」

- 第16章「コンテンツ・サーバー用Fusion Middlewareセキュリティの構成」

- 第17章「ユーザー・タイプ、ログインおよびエイリアスの管理」

- 第18章「セキュリティ・グループ、ロール、および権限の管理」

- 第19章「アカウントの管理」

- 第20章「アクセス制御リストのセキュリティの管理」

- 第21章「追加のコンテンツ・サーバーのセキュリティ接続の管理」

- 第22章「コンテンツ・サーバーの通信のカスタマイズ」

15 セキュリティおよびユーザー・アクセスの理解

この章では、その他のOracle製品と統合されたOracle WebCenter Contentセキュリティの概要と、それ自体の内部セキュリティ機能と補助的なセキュリティ・オプションについて説明します。

この章の内容は次のとおりです。

- コンテンツ・サーバー・セキュリティの概要

- コンテンツ・サーバー内のセキュリティ

- 追加のセキュリティ・オプション

- 詳細セキュリティ・オプション

15.1 コンテンツ・サーバー・セキュリティの概要

コンテンツ・サーバー・インスタンスは、Oracle Fusion MiddlewareのOracle WebLogic Serverドメインでデプロイされる、WebCenter Contentドメインでデプロイされます。セキュリティは、コンテンツ・サーバー・インスタンス、WebCenter Contentドメイン、Oracle WebLogic Serverドメイン、Oracle Platform Security Services (OPSS)を含む、複数のレベルでサポートされます。

コンテンツ・サーバー・リポジトリのコンテンツへのアクセスには、コンテンツ、ユーザーおよびグループを、ロール、権限およびアカウントとともに管理するコンテンツ・サーバー管理者が必要です。Oracle WebLogic Server管理者はコンテンツ・サーバー管理者と同様の働きをします。Oracle WebLogic Server管理者はコンテンツ・サーバー・インスタンスにログインしますが、デプロイ中に該当ユーザーが構成されなかった場合には、プライマリ・コンテンツ・サーバー管理者アカウントおよびパスワードを設定します。コンテンツ・サーバー管理者が構成されたら、管理タスクをコンテンツ・サーバー・インスタンスで実行できるようになります。WebCenter Content管理者の初期構成の詳細は、『Oracle WebCenter Contentのインストールと構成』を参照してください。

ほとんどのユーザー管理タスクは、コンテンツ・サーバー・インスタンスのユーザー管理アプレットではなく、Oracle WebLogic Server管理コンソールを使用して実行する必要があります。デフォルトでは、WebCenter ContentはOracle WebLogic Serverユーザー・ストアを使用してユーザー名およびパスワードを管理し、資格証明ストアを使用してユーザーにコンテンツ・サーバー・インスタンスへのアクセス権を付与します。エンタープライズ・レベルのシステムの場合、ユーザーを認証および認可するために、デフォルトのOracle WebLogic Serverユーザー・ストアではなく、Oracle Platform Security Services (OPSS)を使用できます。WebCenter ContentセキュリティとOracle WebLogic ServerおよびOPSSとの統合の詳細は、第16章を参照してください。

コンテンツ・サーバーのリポジトリ・コンテンツのレベルには、セキュリティ・グループ(必須)およびアカウント(オプション)の2つがあります。各コンテンツ・アイテムはセキュリティ・グループに割り当てられ、アカウントが有効な場合は、アカウントにも割り当てることができます。ユーザーには各セキュリティ・グループおよびアカウントに応じ特定のレベルの権限(読取り、書込み、削除または管理)が割り当てられ、これによりユーザーは、アイテムのセキュリティ・グループおよびアカウントへの権限の範囲内でコンテンツ・アイテムを操作できます。コンテンツ・サーバー内部のユーザー、グループ、およびアカウントの詳細は、第17章、第18章、および第19章を参照してください。

アクセス制御リスト(ACL)がコンテンツ・サーバー・インスタンス用に構成され、エンタープライズレベル・システム上のユーザーへのコンテンツ・アクセスの拡張された制御を提供します。アクセス制御リストは、ユーザー、グループまたはエンタープライズ・ロールのリストであり、コンテンツ・アイテムに対するアクセス権限または操作権限が指定されています。詳細は、第20章を参照してください。

15.2 コンテンツ・サーバー内のセキュリティ

管理者はコンテンツ・サーバーの初期ユーザーとコンテンツのセキュリティを、ユーザー管理アプリケーションを使用して設定し、ユーザー・ロール、グループへの権限およびアカウントを定義します。次に、管理者はOracle WebLogic Server管理コンソールを使用してユーザーを作成し、各ユーザーを1つ以上のコンテンツ・サーバーのロールに割り当てると、セキュリティ・グループに対する特定の権限が割り当てられます。アカウントがコンテンツ・サーバー・システムで有効な場合、管理者は特定のアカウントに対する特定の権限をユーザーに割り当てることができ、これにより、割り当てられたロールを介して付与される可能性のある権限を制限できます。

ユーザーの詳細は、第17章を参照してください。セキュリティ・グループ、ロール、および権限の詳細は、第18章を参照してください。アカウントの詳細は、第19章を参照してください。

次のコンポーネントも、追加の内部コンテンツ・サーバー・セキュリティを提供するために使用できます。

- ExtranetLookコンポーネントを使用して、ユーザー・アクセスのセキュリティをカスタマイズできます。このコンポーネントはコンテンツ・サーバーとともにインストールされて有効化されます。詳細は、第22.1項を参照してください。

注意:
ExtranetLookコンポーネントはOracle WebLogic Serverドメインがコンテンツ・サーバー・インスタンスのサーバーとして使用されている場合には適用できません。セキュリティの実装の変更は、Oracle WebLogic Serverドメインおよび管理構成を直接カスタマイズすることで制御できます。

- NeedtoKnowコンポーネントを使用して、ユーザー・アクセスおよび検索結果のセキュリティをカスタマイズできます。このコンポーネントを使用すると、ユーザー・アクセスの制限の追加構成、検索結果の表示の変更、検索動作の変更、およびヒット・リスト・ロールの設定を実行できます。このコンポーネントを使用するには、これをインストールして有効化する必要があります。

Internet Explorer 7では、安全な接続を使用しないBasic認証でログインしているユーザーに対して、次のメッセージが表示されることに注意してください。

Warning: This server is requesting that your username and password be sent in an insecure manner

この動作(ユーザー名とパスワードのテキストでの送信)は、Basic認証では新しいことではなく、問題は発生しません。

15.3 追加のセキュリティ・オプション

WebCenter Contentでは追加の認証方式を組み合せることができます。たとえば、Oracle WebLogic Server管理コンソールを使用してユーザーを定義して、一部のユーザーにはMicrosoftドメインのIDを使用したログインを許可し、その他のユーザーには外部のLightweight Directory Access Protocol (LDAP)資格証明に基づいてコンテンツ・サーバー・インスタンスへのアクセス権を付与できます。しかし、認証はOracle WebLogic Serverを介して構成されるので、方式の組合せには制限があります。ユーザーは複数の認証ストアに対し認証できますが、Oracle Platform Security Services (OPSS)とOracle WebLogic Serverの統合により、認証(グループ)情報を抽出するために使用できるのは、構成済みユーザー・ストアのうちいずれか1つのみです。

注意:
11g リリース1 (11.1.1.6.0)以後、Oracle WebCenter ContentではOracle Virtual Directoryライブラリ(libOVD)機能の使用がサポートされており、この機能を使用すると、ログインやグループ・メンバーシップ情報に対してサイトで複数のプロバイダを使用できます。たとえば、Oracle Internet Directory (OID)とActive Directoryの両方をユーザーおよびロール情報のソースとして使用できます。Oracle WebLogic Server上での複数のLDAP構成の詳細は、『Oracle Fusion Middlewareアプリケーション・セキュリティ・ガイド』を参照してください。

次のオプションを使用して、追加のセキュリティを提供できます。

- SecurityProvidersコンポーネントを使用して、暗号化されたソケット通信および認証をサポートするようにセキュリティをカスタマイズできます。このコンポーネントはデフォルトでWebCenter Contentとともにインストールされ、有効化されます。このコンポーネントは、ソケットまたはサーバー認証用の証明書を使用するように構成できるSecure Sockets Layer (SSL)プロバイダを有効化します。
WebCenter Contentへの接続にSSLおよびHTTPSを使用していて、WebDAVを介して接続できない場合は、WebDAV接続文字列に使用したのと同じURLを使用してブラウザからコンテンツ・サーバー・インスタンスへの接続を試行してください。これにより、暗号化に使用する証明書に問題があるかどうかが確認できます。証明書に問題があることを示すダイアログ・ボックスが表示された場合は、問題を解決して、WebDAVを介した接続を再試行します。

- ユーザーが異なるWebサーバーのフロント・エンド(一方のサーバーのフロント・エンドがHTTPSでもう一方はHTTP)を使用してコンテンツ・サーバー・インスタンスにアクセスできるようにする場合は、BrowserUrlPathコンポーネントを使用してコンテンツ・サーバーの構成をカスタマイズできます。このコンポーネントはデフォルトでWebCenter Contentとともにインストールされて無効化され、HTTPSを使用するWebサーバーのフロント・エンドと、HTTPホスト・ヘッダーとして転送されるロード・バランサをサポートします。1つのアクセス方式のみ(HTTPSのみまたはHTTPのみ)を使用する場合や、ブラウザからのホスト・パラメータをブロックするロード・バランサを使用していない場合は、このコンポーネントは必要ありません。詳細は、第22.2項を参照してください。

- 拡張セキュリティ属性は外部ユーザーまたは特定のアプリケーションのユーザーに割り当てることができます。拡張属性は既存のユーザー属性とマージされ、ユーザーの管理の柔軟性を向上させることができます。詳細は、第22.3項を参照してください。

すべての環境で、組織のセキュリティの要望と、完全な計画フェーズを包括的に理解することは、セキュリティの統合の成功にとって非常に重要です。

15.4 詳細セキュリティ・オプション

詳細セキュリティ・オプションを使用すると、WebCenter Contentで推奨されるすべてのセキュリティ構成を操作できます。ユーザーが問合せテキストに無効なフィールド名を指定した場合、エラー・メッセージがユーザーに表示されます。

注意:
詳細セキュリティ・オプションは、APIかユーザー・インタフェースのいずれかを使用して指定できます。

APIを使用した詳細セキュリティの構成

詳細セキュリティ・オプションを有効にするには、次のAPIを使用します。

- ASC_GET_SECURITY_CONFIGURATIONS: WebCenter Contentの既存のセキュリティ構成に関する詳細が提供されます。

- ASC_UPDATE_SECURITY_CONFIGURATIONS: 新しい表が追加または削除されたとき、各入力パラメータを渡すことにより、セキュリティ構成およびフィールド名や列名を更新できます。
APIおよびパラメータの詳細は、『Oracle WebCenter Contentサービス・リファレンス』の「コアContent Serverサービス」を参照してください。

ユーザー・インタフェースを使用した詳細セキュリティの構成

詳細セキュリティ・オプションは、Oracle Advanced Security Configurationsページで指定できます。ただし、このページはデフォルトでは使用可能になっていません。このページは、要件に基づいて有効化または無効化できます。詳細は、「Oracle Advanced Security Configurationsページの有効化」を参照してください。

15.4.1 Oracle Advanced Security Configurationsページの有効化

Oracle Advanced Security Configurationsページを有効化することにより、Core QueryTextおよびFrameworkFolders QueryTextにセキュリティ・オプションを指定できます。

Oracle Advanced Security Configurationsページを有効化する手順:

1. テキスト・エディタを使用して、IntradocDir/config/ディレクトリにあるconfig.cfgfileを開きます。

2. 次のパラメータを追加します。

IsAdvanceSecurityConfigUIEnabled=True

3. config.cfgファイルを保存します。

4. Content Serverインスタンスを再起動します。
「管理」メニューで、「Oracle Advanced Security Configurations」オプションが使用可能になります。

注意:
Oracle Advanced Security Configurationsページは、「管理」、「管理サーバー」、「一般構成」の順に選択しても有効化できます。「追加の構成変数」領域で、パラメータIsAdvanceSecurityConfigUIEnabled=Trueを追加できます。ただし、「管理サーバー」メニューに「Oracle Advanced Security Configurations」オプションが表示されるのは、コンテンツ・サーバーを再起動した後です。

この項の内容は次のとおりです。

- Core QueryTextに対する詳細セキュリティ・オプションの指定

- FrameworkFolders QueryTextに対する詳細セキュリティ・オプションの指定

15.4.1.1 Core QueryTextに対する詳細セキュリティ・オプションの指定

Core QueryTextに詳細セキュリティ・オプションを指定すると、検索機能が実行され、入力した検索基準との一致が検索されて、それに応じた結果が返されます。

Core QueryTextに詳細セキュリティ・オプションを指定する手順:

1. 「管理」、「Oracle Advanced Security Configurations」の順に選択します。
Oracle Advanced Security Configurationsページが表示されます。

2. 「Core QueryTextセキュリティ構成」チェック・ボックスを選択して、このセクションを編集および更新します。
「Core QueryTextセキュリティ構成」チェック・ボックスが選択されていない場合、このセクションに対する変更は保存されません。

3. 「QueryTextセキュリティ検証の有効化」チェック・ボックスを選択して、カスタム問合せ検証を有効化します。
「QueryTextセキュリティ検証の有効化」チェック・ボックスが選択されていない場合、Core QueryTextの検証は無効になります。

4. 「カスタム表名」フィールドに1つ以上の表名を入力して、これらの表を検索基準に含めます。

5. 「カスタム・フィールド名」フィールドに1つ以上のフィールド名を入力して、これらのフィールドを検索基準に含めます。
「カスタム表名」フィールドおよび「カスタム・フィールド名」フィールドに入力する値は、セミコロン(;)で区切る必要があります。

6. 「更新」をクリックして、入力した詳細を保存します。

15.4.1.2 FrameworkFolders QueryTextに対する詳細セキュリティ・オプションの指定

FrameworkFolders QueryTextに詳細セキュリティ・オプションを指定すると、フレームワーク・フォルダ内に入力した検索基準が実行され、それに応じた結果が返されます。

FrameworkFolders QueryTextに詳細セキュリティ・オプションを指定する手順:

1. 「管理」、「Oracle Advanced Security Configurations」の順に選択します。
Oracle Advanced Security Configurationsページが表示されます。

2. 「FrameworkFolders QueryTextセキュリティ構成」チェック・ボックスを選択して、このセクションを編集および更新します。
「FrameworkFolders QueryTextセキュリティ構成」チェック・ボックスが選択されていない場合、このセクションに対する変更は保存されません。

3. 「QueryTextセキュリティ検証の有効化」チェック・ボックスを選択して、カスタム問合せ検証を有効化します。
「QueryTextセキュリティ検証の有効化」チェック・ボックスが選択されていない場合、FrameworkFolders QueryTextの検証は無効になります。

4. 「カスタム表名」フィールドに1つ以上の表名を入力して、これらの表を検索基準に含めます。

5. 「カスタム・フィールド名」フィールドに1つ以上のフィールド名を入力して、これらのフィールドを検索基準に含めます。
「カスタム表名」フィールドおよび「カスタム・フィールド名」フィールドに入力する値は、セミコロン(;)で区切る必要があります。

6. 「更新」をクリックして、入力した詳細を保存します。

16 コンテンツ・サーバー用Fusion Middlewareセキュリティの構成

この章では、セキュリティ構成情報と、Oracle Fusion Middleware、Oracle WebLogic Server、Oracle認証および認可ソフトウェアを、Oracle WebCenter ContentおよびOracle WebCenter Content Serverに統合する手順について説明します。

この章の内容は次のとおりです。

- LDAP認証プロバイダ

- SSLを使用するためのOracle WebCenter Contentの構成

- シングル・サインオン用のWebCenter Contentの構成

- Oracle Infrastructure Webサービスの構成

Oracle Fusion MiddlewareおよびOracle WebLogic Serverのセキュリティの詳細は、表16-1にリストするドキュメントを参照してください。

16.1 LDAP認証プロバイダ

Oracle WebCenter ContentはOracle WebLogic Server上で実行されます。Oracle WebLogic Serverドメインには、デフォルト認証、認可、資格証明マッピングおよびロール・マッピング・プロバイダ用のデフォルトのセキュリティ・プロバイダ・データ・ストアとして動作する、組込みLightweight Directory Access Protocol (LDAP)サーバーが含まれます。WebCenter ContentはOracle WebLogic Serverと通信するデフォルトのJpsUserProviderを提供します。組込みLDAPサーバーの詳細は、『Oracle WebLogic Serverの保護』の組込みLDAP サーバーの管理に関する項、および『Oracle WebLogic Server Administration Consoleオンライン・ヘルプ』の組込みLDAPサーバーの構成に関する項を参照してください。

ほとんどの場合、組込みLDAPサーバーを使用するのではなく、Oracle WebCenter Content本番システムのアイデンティティ・ストアを外部LDAP認証プロバイダに再度関連付ける必要があります。新規LDAP認証プロバイダを構成した後、組込みLDAPプロバイダから新規LDAPプロバイダにユーザーを移行します。Oracle Internet Directory (OID)などの外部LDAP認証プロバイダは、デフォルトの認証プロバイダを含む、すべてのその他の認証プロバイダよりも前にリストされる必要があります。外部LDAPプロバイダのWebCenter Contentの構成の詳細は、『Oracle WebCenter Contentのインストールと構成』を参照してください。

注意:
11gリリース1 (11.1.1.6.0)以後、Oracle WebCenter ContentではOracle Virtual Directoryライブラリ(libOVD)機能の使用がサポートされており、この機能を使用すると、ログインやグループ・メンバーシップ情報に対してサイトで複数のプロバイダを使用できます。たとえば、2つのOracle Internet Directory (OID)プロバイダをユーザーおよびロール情報のソースとして使用できる場合もあります。Oracle WebLogic Serverでの複数のLDAP構成の詳細は、『Oracle Platform Security Servicesによるアプリケーションの保護』を参照してください。

表16-1に、ユーザー認証用に構成できるLDAPプロバイダを示します。

表16-1 LDAPオーセンティケータ・タイプ

LDAPサーバー

オーセンティケータ・プロバイダ

Microsoft AD

ActiveDirectoryAuthenticator

SunOne LDAP

IPlanetAuthenticator

Oracle Directory Server Enterprise Edition (ODSEE)

IPlanetAuthenticator

Oracle Unified Directory (OUD)

IPlanetAuthenticator

Oracle Internet Directory

OracleInternetDirectoryAuthenticator

Oracle Virtual Directory

OracleVirtualDirectoryAuthenticator

EDIRECTORY

NovellAuthenticator

OpenLDAP

OpenLDAPAuthenticator

EmbeddedLDAP

DefaultAuthenticator

外部LDAPサーバーを使用してWebCenter Contentを構成し、WebCenter Contentが認識する権限を持つディレクトリに動的グループ(および静的グループ)が存在する場合は、追加の構成が必要になります。ユーザーの作成、認証および認可はOracle Platform Services Security (OPSS)を使用して管理されており、これは、外部LDAPサーバーのネイティブOracle WebLogic Serverプロバイダと比較されたときに、別のメカニズムを使用してディレクトリ・サーバーの情報を収集します。詳細は、ブログ記事「Oracle WebCenter and Dynamic Groups from an External LDAP Server」を参照してください。

16.2 SSLを使用するためのOracle WebCenter Contentの構成

SSLを使用してWebCenter Contentとセキュアな通信を行うようにOracle Fusion Middlewareを構成できます。Oracle Fusion MiddlewareではSSLバージョン3に加えて、TLSバージョン1をサポートしています。

この項の内容は次のとおりです。

- 第16.2.1項「WebCenter Contentの双方向SSL通信の構成」

- 第16.2.2項「Oracle JDeveloperの一方向SSL環境での参照の呼出し」

- 第16.2.3項「WebCenter ContentおよびOracle HTTP ServerのSSL通信の構成」

- 第16.2.4項「WebCenter Contentでの非SSLからSSL構成への切替え」

- 第16.2.5項「WebCenter ContentインスタンスとOracle WebCache間のSSLの構成」

- 第16.2.6項「一方向SSLでのカスタム・トラスト・ストアの使用」

- 第16.2.7項「非同期プロセスの呼び出しのための非同期プロセスの有効化」

- 第16.2.8項「有効な証明書パスのためのRIDC SSLの構成」

詳細は、『Oracle WebLogic Serverの保護』のSSLの構成に関する項を参照してください。Web層の構成の詳細は、『管理者ガイド』のOracle Fusion MiddlewareでのSSLの構成に関する項を参照してください。

16.2.1 WebCenter Contentの双方向SSL通信の構成

WebCenter Contentでは、双方向SSL通信を構成するために、Oracle WebLogic ServerでSecure Socket Layer (SSL)スタックを使用します。

- インバウンドのWebサービス・バインディングの場合、WebCenter ContentではOracle WebLogic Serverインフラストラクチャを使用し、SSL用にOracle WebLogic Serverライブラリを使用します。

- アウトバウンドのWebサービス・バインディングの場合、WebCenter ContentではJRF HttpClientを使用し、SSL用にOracle Sun JDKライブラリを使用します。

このように違いがあるため、次のJVMオプションを使用してOracle WebLogic Serverを起動します。

1. 次のファイルを開きます。

- UNIXオペレーティング・システムでは、$MIDDLEWARE_HOME/user_projects/domains/domain_name/bin/setDomainEnv.shを開きます。

- Windowsオペレーティング・システムでは、MIDDLEWARE_HOME\user_projects\domains\domain_name\bin\setDomainEnv.batを開きます。

2. サーバーが一方向SSL(サーバー認可のみ)に対して有効な場合は、次の行をJAVA_OPTIONSセクションに追加します。

-Djavax.net.ssl.trustStore=your_truststore_location

双方向SSLの場合は、キーストア情報(場所とパスワード)は不要です。

WebCenter Contentが別のアプリケーションを呼び出すために双方向SSLを有効化する手順は、次のとおりです。

注意:
サーバーとクライアントの両方が相互認証でSSL用に構成されていることが前提となります。

1. クライアント側で、キーストアの場所を指定します。

1. 「SOAインフラストラクチャ」メニューから、「SOA管理」、「共通プロパティ」の順に選択します。

2. ページの下部で、「詳細SOAインフラ拡張構成プロパティ」をクリックします。

3. 「KeystoreLocation」をクリックします。

4. 「値」列に、キーストアの場所を入力します。

5. 「適用」をクリックします。

6. 「戻る」をクリックします。

2. クライアント側のDOMAIN_HOME\config\soa-infra\configuration\soa-infra-config.xmlでキーストアの場所を指定します。

<keystoreLocation>absolute_path_to_the_keystore_location_and_the_file_name
</keystoreLocation>

3. Oracle JDeveloperでの設計時に、composite.xmlファイル内の参照セクションをoracle.soa.two.way.ssl.enabledプロパティで更新します。

<reference name="Service1"
ui:wsdlLocation=". . .">
<interface.wsdl interface=". . ."/>
<binding.ws port=". . .">
<property name="oracle.soa.two.way.ssl.enabled">true</property>
</binding.ws>
</reference>

4. Oracle Enterprise Manager Fusion Middleware管理コンソールで、「WebLogicドメイン」、「ドメイン名」の順に選択します。

5. 「ドメイン名」を右クリックし、「セキュリティ」、「資格証明」の順に選択します。

6. 「マップの作成」をクリックします。

7. 「マップ名」フィールドに名前(SOAなど)を入力し、「OK」をクリックします。

8. 「キーの作成」をクリックします。

9. 次の詳細を入力します。

フィールド

説明

マップの選択

ステップ7で作成したマップ(この例ではSOA)を選択します。

キー

キー名を入力します(KeystorePasswordがデフォルトです)。

タイプ

「パスワード」を選択します。

ユーザー名

ユーザー名を入力します(KeystorePasswordがデフォルトです)。

パスワード

キーストアに対して作成したパスワードを入力します。

注意:
WebLogic ServerドメインでSSLを設定する場合、キーの別名が必要です。別名の値として「mykey」を入力する必要があります。この値は必須です。

10. Oracle Enterprise Manager Fusion Middleware Controlコンソールでキーストアの場所を設定します。方法については、ステップ1を参照してください。

11. httpsおよびsslportを使用してOracle WebCenter Contentを起動するようにcomposite.xml構文を変更します。たとえば、次の太字で示されている構文を変更します。

<?xml version="1.0" encoding="UTF-8" ?>
<!-- Generated by Oracle SOA Modeler version 1.0 at [4/1/09 11:01 PM]. -->
<composite name="InvokeEchoBPELSync"
revision="1.0"
label="2009-04-01_23-01-53_994"
mode="active"
state="on"
xmlns="http://xmlns.example.com/sca/1.0"
xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:wsp="http://schemas.xmlsoap.org/ws/2004/09/policy"
xmlns:orawsp="http://schemas.example.com/ws/2006/01/policy"
xmlns:ui="http://xmlns.example.com/soa/designer/">
<import
namespace="http://xmlns.example.com/CustomApps/InvokeEchoBPELSync/BPELProcess1"
location="BPELProcess1.wsdl" importType="wsdl"/>
<import namespace="http://xmlns.example.com/CustomApps/EchoBPELSync/
BPELProcess1"location="http://hostname:port/soa-infra/services/default/EchoBPEL
Sync/BPELProcess1.wsdl"
importType="wsdl"/>

httpsおよびsslportを使用するように変更します。

location="https://hostname:sslport/soa-infra/services/default/EchoBPELSync
/BPELProcess1.wsdl"

16.2.2 Oracle JDeveloperの一方向SSL環境での参照の呼出し

Webサービスを一方向SSL環境でWebCenter Contentからの外部参照として呼び出す場合は、サーバーの証明書名(CN)とホスト名が完全に一致することを確認します。これにより、正しいSSLハンドシェイクが保証されます。

たとえば、Webサービスの名前がadfbcで、証明書のサーバー名がhostの場合は、次のコードでSSLハンドシェーク例外が発生します。

<import namespace="/adfbc1/common/"
location="https://host.example.com:8002/CustomApps-adfbc1-context-root/AppModuleService?WSDL"
importType="wsdl"/>
<import namespace="/adfbc1/common/" location="Service1.wsdl"
importType="wsdl"/>

importの順序を入れ替えると、SSLハンドシェイクに成功します。

<import namespace="/adfbc1/common/" location="Service1.wsdl"
importType="wsdl"/>
<import namespace="/adfbc1/common/"
location="https://host.example.com:8002/CustomApps-adfbc1-context-root/AppModuleService?WSDL"
importType="wsdl"/>

この問題に関連して次の制限があります。

- Oracle WebLogic Server管理コンソールにあるようなホスト名の検証を無視するオプションはOracle JDeveloperにありません。これは、Oracle JDeveloperで使用されているSSLキットが異なるためです。トラスト・ストアのみコマンドラインから構成できます。他のすべての証明書引数は渡されません。

- WSDLファイルで、https://hostnameは前述のように証明書内の名前と一致する必要があります。ブラウザで行う場合と同じ手順は実行できません。たとえば、証明書のCNのホスト名がhost.example.comの場合、ブラウザではhost、host.example.comまたはIPアドレスを使用できます。Oracle JDeveloperでは、必ず証明書内の名前と同じ名前(host.example.com)を使用する必要があります。

16.2.3 WebCenter ContentおよびOracle HTTP ServerのSSL通信の構成

ここでは、WebCenter ContentとOracle HTTP Server間でSSL通信を構成する手順について説明します。

詳細は、『管理者ガイド』のWeb層でのSSLの構成に関する項を参照してください。

Oracle HTTP ServerのSSL通信を構成する手順は、次のとおりです。

1. ssl.confに<Location /cs>ロケーション・ディレクティブを追加します。この場合のportはターゲットの管理対象サーバーのポート番号です。

<Location /cs>
WebLogicPort 8002
SetHandler weblogic-handler
ErrorPage http://host.example.com:port/error.html
</Location>

2. 第16.2.1項の説明に従ってOracle WebLogic Serverを起動します。

Oracle Client、Oracle HTTP ServerおよびOracle WebLogic Serverの証明書を構成する手順は、次のとおりです。

1. Oracle HTTP Serverウォレットからユーザー証明書をエクスポートします。

orapki wallet export -wallet . -cert cert.txt  -dn 'CN=\"Self-Signed Certificate for ohs1 \",OU=OAS,O=ORACLE,L=REDWOODSHORES,ST=CA,C=US'

2. エクスポートした証明書をOracle WebLogic Serverトラストストアに信頼できる証明書としてインポートします。

keytool -file cert.txt -importcert -trustcacerts -keystore DemoTrust.jks

3. Oracle WebLogic Serverトラストストアから証明書をエクスポートします。

keytool -keystore DemoTrust.jks -exportcert -alias wlscertgencab -rfc -file
certgencab.crt

4. エクスポートした証明書をOracle HTTP Serverウォレットに信頼できる証明書としてインポートします。

orapki wallet add -wallet . -trusted_cert -cert certgencab.crt -auto_login_only

5. Oracle HTTP Serverを再起動します。

6. 第16.2.1項の説明に従ってOracle WebLogic Serverを再起動します。

16.2.4 WebCenter Contentでの非SSLからSSL構成への切替え

WebCenter Contentで非SSLからSSL構成に切り替えるには、Oracle WebLogic Server管理コンソールで「フロントエンド・ホスト」および「フロントエンドHTTPSポート」フィールドを設定する必要があります。設定しないと、To-Doタスクを作成するときに例外エラーが発生します。

1. Oracle WebLogic Server管理コンソールにログインします。

2. 「環境」セクションで「サーバー」を選択します。

3. 管理対象サーバーの名前(UCM_server1など)を選択します。

4. 「プロトコル」を選択してから、「HTTP」を選択します。

5. 「フロントエンド・ホスト」フィールドで、WebCenter Contentドメインが配置されているホスト名を入力します。

6. 「フロントエンドHTTPSポート」フィールドに、SSLリスナー・ポートを入力します。

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

16.2.5 WebCenter ContentインスタンスとOracle WebCache間のSSLの構成

Oracle WebCacheおよびOracle HTTP Server環境では、「Webサービスのテスト」ページでOracle WebCacheとの通信が必要になる場合があります。したがって、WebCenter ContentインスタンスとOracle WebCache間でSSLを構成する必要があります(つまり、ユーザー証明書をOracle WebCacheウォレットからエクスポートし、その証明書をOracle WebLogic Serverトラストストアに信頼できる証明書としてインポートします)。

『管理者ガイド』のOracle Web CacheエンドポイントでのSSLの有効化に関する項を参照してください。

16.2.6 一方向SSLでのカスタム・トラスト・ストアの使用

keytoolやorapkiなどのツールで作成したカスタム・トラスト・ストアを使用している場合にHTTPSを介してWebCenter Contentを起動するには、Oracle JDeveloperで次の操作を実行します。

1. 参照セクションでWSDLファイルをフェッチするには、「ツール」、「プリファレンス」、「HTTPアナライザ」、「HTTPS設定」、「クライアントの信頼する証明書キーストア」の順でトラスト・ストア情報を設定します。

2. SSL対応サーバーへのデプロイメント時に、コマンドラインでJSSEプロパティを使用します。

jdev -J-Djavax.net.ssl.trustStore=your_trusted_location

16.2.7 非同期プロセスの呼び出しのための非同期プロセスの有効化

SSL対応の管理対象サーバーにデプロイされた非同期プロセスを有効化して、別の非同期プロセスをHTTPで呼び出すには、まず次の環境を作成することを前提とします。

- 非同期BPELプロセスAが非同期BPELプロセスBを呼び出す

- 非同期BPELプロセスAは一方向SSL対応の管理対象サーバーにデプロイされる

- すべてのWSDL参照およびバインディングでプレーンHTTPを使用する

実行時に、WSDLはHTTPSを介して検索され、非同期BPELプロセスBからのコールバック・メッセージが失敗します。

この問題を解決するには、callbackServerURLプロパティをcomposite.xmlファイルの参照バインディング・レベルで渡す必要があります。これは、特定の参照呼出しのコールバックURLの値を示します。クライアント・コンポジットがSSL管理対象サーバーで実行されている場合、コールバックはデフォルトでSSLになります。

<reference name="Service1" ui:wsdlLocation="http://localhost:8000/soa-infra/services/default/
AsyncSecondBPELMTOM/BPELProcess1.wsdl">
<interface.wsdl interface="http://xmlns.example.com/Async/AsyncSecondBPELMTOM/BPELProcess1#
wsdl.interface(BPELProcess1)" callbackInterface="http://xmlns.example.com/Async/
AsyncSecondBPELMTOM/BPELProcess1#wsdl.interface(BPELProcess1Callback)"/>
<binding.ws port="http://xmlns.example.com/Async/AsyncSecondBPELMTOM/BPELProcess1#
wsdl.endpoint(bpelprocess1_client_ep/BPELProcess1_pt)"
location="http://localhost:8000/soa-infra/services/default/AsyncSecondBPELMTOM
/bpelprocess1_client_ep?WSDL">
<wsp:PolicyReference URI="oracle/wss_username_token_client_policy"
orawsp:category="security" orawsp:status="enabled"/>
<wsp:PolicyReference URI="oracle/wsaddr_policy"  orawsp:category="addressing"
orawsp:status="enabled"/>
<property name="callbackServerURL">http://localhost:8000/</property>
</binding.ws>
<callback>
<binding.ws port="http://xmlns.example.com/Async/AsyncSecondBPELMTOM/BPELProcess1#
wsdl.endpoint(bpelprocess1_client_ep/BPELProcess1Callback_pt)">
<wsp:PolicyReference URI="oracle/wss_username_token_service_policy"
orawsp:category="security" orawsp:status="enabled"/>
</binding.ws>
</callback>
</reference>

16.2.8 有効な証明書パスのためのRIDC SSLの構成

Remote Intradoc Client (RIDC)および自己署名証明書を使用するには、証明書をローカルのJVM証明書ストアにインポートして証明書が信頼されるようにする必要があります。

1. コンテンツ・サーバー・インスタンスからキーを取得します。次に例を示します。

openssl s_client -connect host.example.com:7045 2>/dev/null

CONNECTED(00000003)
---
Certificate chain

0 s:/C=US/ST=MyState/L=MyTown/O=MyOrganization/OU=FOR TESTING ONLY/CN=hostname
i:/C=US/ST=MyState/L=MyTown/O=MyOrganization/OU=FOR TESTING ONLY/CN=CertGenCAB
---
Server certificate
-----BEGIN CERTIFICATE-----
MIIB6zCCAZUCEItVMwHDFXAnYG//RoVbXQgwDQYJKoZIhvcNAQEEBQAweTELMAkG
A1UEBhMCVVMxEDAOBgNVBAgTB015U3RhdGUxDzANBgNVBAcTBk15VG93bjEXMBUG
A1UEChMOTXlPcmdhbml6YXRpb24xGTAXBgNVBAsTEEZPUiBURVNUSU5HIE9OTFkx
EzARBgNVBAMTCkNlcnRHZW5DQUIwHhcNMDkwMzI5MjM0NDM0WhcNMjQwMzMwMjM0
NDM0WjB5MQswCQYDVQQGEwJVUzEQMA4GA1UECBYHTXlTdGF0ZTEPMA0GA1UEBxYG
TXlUb3duMRcwFQYDVQQKFg5NeU9yZ2FuaXphdGlvbjEZMBcGA1UECxYQRk9SIFRF
U1RJTkcgT05MWTETMBEGA1UEAxYKZGFkdm1jMDAyMjBcMA0GCSqGSIb3DQEBAQUA
A0sAMEgCQQCmxv+h8kzOc2xyjMCdPM6By5LY0Vlp4vzWFKmPgEytp6Wd87sG+YDB
PeFOz210XXGMx6F/14/yFlpCplmazWkDAgMBAAEwDQYJKoZIhvcNAQEEBQADQQBn
uF/s6EqCT38Aw7h/406uPhNh6LUF7XH7QzmRv3J1sCxqRnA/fK3JCXElshVlPk8G
hwE4G1zxpr/JZu6+jLrW
-----END CERTIFICATE-----
subject=/C=US/ST=MyState/L=MyTown/O=MyOrganization/OU=FOR TESTING
ONLY/CN=host
issuer=/C=US/ST=MyState/L=MyTown/O=MyOrganization/OU=FOR TESTING
ONLY/CN=CertGenCAB
---
No client certificate CA names sent
---
SSL handshake has read 625 bytes and written 236 bytes
---
New, TLSv1/SSLv3, Cipher is RC4-MD5
Server public key is 512 bit
Compression: NONE
Expansion: NONE
SSL-Session:
Protocol  : TLSv1
Cipher    : RC4-MD5
Session-ID: 23E20BCAA4BC780CE20DE198CE2DFEE4
Session-ID-ctx:
Master-Key:
4C6F8E9B9566C2BAF49A4FD91BE90DC51F1E43A238B03EE9B700741AC7F4B41C72D2990648DE103
BB73B3074888E1D91
Key-Arg   : None
Start Time: 1238539378
Timeout   : 300 (sec)
Verify return code: 21 (unable to verify the first certificate)
---

2. -----BEGIN CERTIFICATE-----と-----END CERTIFICATE-----行で囲まれたサーバー証明書をコピーして貼り付けます。証明書を新しいファイルに保存します。次に例を示します。

/tmp/host.pem:

-----BEGIN CERTIFICATE-----
MIIB6zCCAZUCEItVMwHDFXAnYG//RoVbXQgwDQYJKoZIhvcNAQEEBQAweTELMAkG
A1UEBhMCVVMxEDAOBgNVBAgTB015U3RhdGUxDzANBgNVBAcTBk15VG93bjEXMBUG
A1UEChMOTXlPcmdhbml6YXRpb24xGTAXBgNVBAsTEEZPUiBURVNUSU5HIE9OTFkx
EzARBgNVBAMTCkNlcnRHZW5DQUIwHhcNMDkwMzI5MjM0NDM0WhcNMjQwMzMwMjM0
NDM0WjB5MQswCQYDVQQGEwJVUzEQMA4GA1UECBYHTXlTdGF0ZTEPMA0GA1UEBxYG
TXlUb3duMRcwFQYDVQQKFg5NeU9yZ2FuaXphdGlvbjEZMBcGA1UECxYQRk9SIFRF
U1RJTkcgT05MWTETMBEGA1UEAxYKZGFkdm1jMDAyMjBcMA0GCSqGSIb3DQEBAQUA
A0sAMEgCQQCmxv+h8kzOc2xyjMCdPM6By5LY0Vlp4vzWFKmPgEytp6Wd87sG+YDB
PeFOz210XXGMx6F/14/yFlpCplmazWkDAgMBAAEwDQYJKoZIhvcNAQEEBQADQQBn
uF/s6EqCT38Aw7h/406uPhNh6LUF7XH7QzmRv3J1sCxqRnA/fK3JCXElshVlPk8G
hwE4G1zxpr/JZu6+jLrW
-----END CERTIFICATE-----

3. 証明書をローカルのJVM証明書ストアにインポートします。キーストア・パスワードが必要になります。例を次に示します(パスワードはchangeitです)。

sudo /opt/java/jdk1.6.0_12/bin/keytool -import -alias host -keystore
/opt/java/jdk1.6.0_12/jre/lib/security/cacerts -trustcacerts -file
/tmp/host.pem

Enter keystore password: changeit
Owner: CN=host, OU=FOR TESTING ONLY, O=MyOrganization, L=MyTown,
ST=MyState, C=US
Issuer: CN=CertGenCAB, OU=FOR TESTING ONLY, O=MyOrganization, L=MyTown,
ST=MyState, C=US
Serial number: -74aaccfe3cea8fd89f9000b97aa4a2f8
Valid from: Sun Mar 29 16:44:34 PDT 2009 until: Sat Mar 30 16:44:34 PDT 2024
Certificate fingerprints:
MD5:  94:F9:D2:45:7F:0D:E3:87:CF:2B:32:7C:BF:97:FF:50
SHA1: A8:A5:89:8B:48:9B:98:34:70:56:11:01:5C:14:32:AC:CB:18:FF:1F
Signature algorithm name: MD5withRSA
Version: 1
Trust this certificate? [no]:  yes
Certificate was added to keystore

16.3 シングル・サインオン用のWebCenter Contentの構成

Oracle WebCenter Content向けの次のシングル・サインオン(SSO)ソリューションのいずれかを構成できます。

- Oracle Access Manager 11g

- Oracle Access Manager 10g

- Oracleシングル・サインオン(OSSO)

- Windowsネイティブ認証(WNA)

Oracle Access Manager (OAM)は、WebCenter Contentを含むOracle Fusion Middlewareエンタープライズ・クラスのインストールに推奨するシングル・サインオン(SSO)ソリューションです。OAMはOracleのアイデンティティ管理およびセキュリティ用のエンタープライズ・クラス製品スイートの一部です。詳細は、『Oracle Platform Security Servicesによるアプリケーションの保護』のデプロイメント用の正しいSSOソリューションの選択に関する項を参照してください。

エンタープライズ・クラスのインストールが、Microsoftドメイン・コントローラを使用してActive Directory内のユーザー・アカウントを認証するMicrosoftデスクトップ・ログインを使用する場合、Windows Native Authentication (WNA)のシングル・サインオンの構成はオプションの場合があります。WNAの詳細は、第16.3.6項を参照してください。

Oracle WebLogic Server認証プロバイダの概要は、『Oracle WebLogic Serverの保護』の認証プロバイダの構成に関する項を参照してください。

注意:
WebDAV (/dav)は、WebDAVプロトコルごとにBasic認証によって保護されていますが、通常はフォームベースのログインが必要となるSSOによっては保護されていません。WebDAVに対してカスタムSSOソリューションを使用する場合は、カスタム・コンポーネントが必要となります。

構成情報は次の項で説明します。

- 第16.3.1項「WebCenter Contentを使用したOracle Access Manager 11gの構成」

- 第16.3.2項「WebCenter Contentを使用したOracle Access Manager 10gの構成」

- 第16.3.3項「WebCenter Content用のOracle Single Sign-Onの構成」

- 第16.3.4項「最初の認証プロバイダの構成」

- 第16.3.5項「シングル・サインオン用のWebCenter Content URLの構成」

- 第16.3.6項「Windowsのネイティブ認証用のWebCenter Contentおよびシングル・サインオンの構成」

16.3.1 WebCenter Contentを使用したOracle Access Manager 11gの構成

この項では、WebCenter ContentとOracle Access Manager (OAM) 11gの統合方法について説明します。Oracle WebCenter Content: コンテンツ・サーバー(CS)、Oracle WebCenter Content: Records (URM)、Oracle WebCenter Content: Inbound Refinery (IBR)、およびOracle WebCenter Content: Site Studio (SS)についての構成情報が提供されます。

OAM 11gを構成する前に、『Oracle Identity Managementインストレーション・ガイド』のOracle Identity Managementのインストールと構成に関する項で提供されている手順に従って、ソフトウェアをインストールします。

1. 『Oracle Identity Managementインストレーション・ガイド』のOAMエージェントの設定に関する項の説明に従って、OAM 11g、Oracle HTTP Server (OHS)およびWebGateを構成します。

1. mod_wl_ohs.confファイルにエントリを追加して、転送するWebCenter Content Uniform Resource Identifier (URI)を追加します。次の例から適切なロケーション・エントリを使用します。例の各エントリは受信パスを対応するアプリケーションが存在する適切なOracle WebLogic Serverにマップします。
次のエントリのリストで、hostnameはコンテンツ・サーバーをホストしているコンピュータ名を示し、portnumberは対応するアプリケーションが存在するOracle WebLogic Serverのポート番号を示します。hostnameおよびportnumberは、使用しているシステムのホスト名とポート名に置き換えます。

注意:
転送するURIはインストールしたWebCenter Content機能により異なります。機能に応じて適切なロケーション・エントリを使用します。たとえば、/cs、/adfAuthentication、/_ocsh、/ibr、/urmなどです。
Site Studioの場合、転送するURIはお客様が構成します。たとえば、サイトが/mysiteとしてアクセスされる場合、/mysiteのロケーション・エントリを追加する必要があります。

注意:
コンテンツ・サーバーのロケーション/csはカスタマイズできるため、/cs指定ではHTTPリクエストが正しいロケーションを含むことを保証できません。/csが変更されると、管理者が構成したロケーションが転送されます。

# Content Server
<Location /cs>
SetHandler weblogic-handler
WebLogicHost <hostname>
WebLogicPort <portnumber>
</Location>

# Content Server authentication
<Location /adfAuthentication>
SetHandler weblogic-handler
WebLogicHost <hostname>
WebLogicPort <portnumber>
</Location>

# WebCenter online help
<Location /_ocsh>
SetHandler weblogic-handler
WebLogicHost <hostname>
WebLogicPort <portnumber>
</Location>

# IBR
<Location /ibr>
SetHandler weblogic-handler
WebLogicHost <hostname>
WebLogicPort <portnumber>
</Location>

# URM
<Location /urm>
SetHandler weblogic-handler
WebLogicHost <hostname>
WebLogicPort <portnumber>
</Location>

# SS
<Location /customer-configured-site-studio
SetHandler weblogic-handler
WebLogicHost <hostname>
WebLogicPort <portnumber>
</Location>

2. OAM 11gリモート登録ツール(oamreg)を使用して、保護およびパブリックにするWebCenter ContentのURIを指定して、OAMエージェントを登録します。『Oracle Platform Security Servicesによるアプリケーションの保護』のOracle Access Manager 11gを使用したOAMエージェントのプロビジョニングに関する項を参照してください。
詳細は、『Oracle Identity Managementインストレーション・ガイド』のOAMエージェントの設定に関する項を参照してください。

注意:
保護およびパブリックにするURIは、コンテンツ・サーバー(CS)、Inbound Refinery (IBR)、Records (URM)、Site Studio (SS)など、インストールしたWebCenter Content機能により異なります。
Site Studioの場合、保護するURIはお客様が構成します。たとえば、サイトが/mysiteとしてアクセスされる場合、URI /mysiteを指定する必要があります。

機能

タイプ

URI

CS

保護

/adfAuthentication

CS

パブリック

/cs

CS

パブリック

/_ocsh

IBR

保護

/ibr/adfAuthentication

IBR

パブリック

/ibr

URM

保護

/urm/adfAuthentication

URM

パブリック

/urm

SS

保護

/customer_configured_site_studio

3. シングル・サインオン・ログアウトが正常に機能するよう、URL /oamsso/logout.htmlをAccessGateのログアウトURL設定に追加します。詳細は、『Oracle Fusion Middleware Oracle Access Management管理者ガイド』のシングル・サインオン・ログアウトURLおよびAccessGate構成パラメータの構成に関する説明を参照してください。

2. これらのタスクを確実に実行することにより、WebCenter Contentドメインを構成します。『Oracle Platform Security Servicesによるアプリケーションの保護』のOracle Access Manager 11gのSSOソリューションのデプロイに関する項を参照してください。

1. OAMアイデンティティ・アサータを構成します。OAMアイデンティティ・アサータの制御フラグは、REQUIREDに設定される必要があり、OAM_REMOTE_USERおよびObSSOCookieはアクティブなタイプとして選択される必要があります。
『Oracle Platform Security Servicesによるアプリケーションの保護』のシングル・サインオン機能用のIDアサーションに関する項、Oracle Access ManagerでのIDアサーション機能の使用に関する項、およびOracle Access Manager 11gでのSSO用IDアサーションの構成に関する項を参照してください。

2. 認証プロバイダを構成します。これはOracle Internet Directory (OID)またはOracle Virtual Directory (OVD)のような、OAMで使用されるLDAPサーバーと一致する、ユーザー・ストア用の外部LDAPサーバーを指定するのに必要です。たとえば、OAMでOIDを使用している場合、OID認証プロバイダがWebCenter Contentドメインに追加される必要があります。

注意:
WebCenter Content用のOracle WebLogic ServerドメインがDefaultAuthenticatorプロバイダとは異なる認証プロバイダを使用するように構成される場合、新しい認証プロバイダはセキュリティ・レルム構成にリストされた最初の認証プロバイダである必要があり、そうでないと、WebCenter Contentはユーザー権限をロードできません。新しい認証プロバイダがDefaultAuthenticatorプロバイダよりも前にリストされるように、認証プロバイダの順番を変更してください。また、DefaultAuthenticator制御フラグがSUFFICIENTに設定されていることを確認してください。詳細は、第16.3.4項を参照してください。

『Oracle Platform Security Servicesによるアプリケーションの保護』のOracle Access Manager 11gでの認証プロバイダのインストールに関する項およびOracle Access Manager IDアサーションのプロバイダの設定に関する項を参照してください。

OAM 10gとOAM 11gで認証プロバイダをデプロイするときの違いの詳細は、『Oracle Platform Security Servicesによるアプリケーションの保護』のOAM 11gとOAM 10gでの認証プロバイダ実装タスクの違いに関する項にある表を参照してください。

3. OPSS (OAM)シングル・サインオン・プロバイダを構成します。
『Oracle Platform Security Servicesによるアプリケーションの保護』のADFセキュリティ、OAM SSOおよびOPSS SSOを使用したWebアプリケーション用のOracle WebLogic Serverの構成に関する項を参照してください。

3. OAM 11gのインストールおよび構成後、すべての構成済アプリケーションにアクセスできることと、ログインにより再度サインインすることを要求されずにすべての構成済アプリケーションにアクセスできることを確認します。また、可能な場合、グローバル・ログアウトをテストし、その他のすべての関連アプリケーションからログアウトしていることを確認します。
詳細は、『Oracle Platform Security Servicesによるアプリケーションの保護』のOracle Access Manager 11gの一元化ログアウトの構成に関する項および『Oracle Fusion Middleware Oracle Access Management管理者ガイド』を参照してください。

16.3.2 WebCenter Contentを使用したOracle Access Manager 10gの構成

この項では、WebCenter ContentとOracle Access Manager (OAM) 10gの統合方法について説明します。Oracle WebCenterコンテンツ・サーバー(CS)、Oracle WebCenter Content: Records (URM)、Oracle WebCenter Content: Inbound Refinery (IBR)、およびOracle WebCenter Content: Site Studio (SS)についての構成情報が提供されます。

OAMを構成する前に、ソフトウェアをインストールします。OAM統合の詳細は、『Oracle WebCenter Contentエンタープライズ・デプロイメント・ガイド』を参照し、OAM 10gソフトウェアのインストールの詳細は、『Oracle Identity Managementインストレーション・ガイド』を参照してください。

1. 『Oracle Platform Security Servicesによるアプリケーションの保護』のOracle Access Manager 10gを使用したSSOソリューションのデプロイに関する項の説明に従って、OAM 10g、Oracle HTTP Server (OHS)およびWebGateを構成します。

1. mod_wl.confファイルにエントリを追加して、転送するWebCenter Content Uniform Resource Identifier (URI)を追加します。次の例から適切なロケーション・エントリを使用します。次のLocationリストのエントリは、対応するアプリケーションが存在する適切なOracle WebLogic Serverへの受信パスをマップします。
次のエントリのリストで、hostnameはコンテンツ・サーバーをホストしているコンピュータ名を示し、portnumberは対応するアプリケーションが存在するOracle WebLogic Serverのポート番号を示します。hostnameおよびportnumberは、使用しているシステムのホスト名とポート名に置き換えます。

注意:
転送するURIはインストールしたWebCenter Content機能により異なります。機能に応じて適切なロケーション・エントリを使用します。たとえば、/cs、/adfAuthentication、/_ocsh、/ibr、/urmなどです。
Site Studioの場合、転送するURIはお客様が定義します。たとえば、サイトが/mysiteとしてアクセスされる場合、/mysiteのロケーション・エントリを追加する必要があります。

注意:
コンテンツ・サーバーのロケーション/csはカスタマイズできるため、/cs指定ではHTTPリクエストが正しいロケーションを含むことを保証できません。/csが変更されると、管理者が構成したロケーションが転送されます。

# Content Server
<Location /cs>
SetHandler weblogic-handler
WebLogicHost <hostname>
WebLogicPort <portnumber>
</Location>

# Content Server authentication
<Location /adfAuthentication>
SetHandler weblogic-handler
WebLogicHost <hostname>
WebLogicPort <portnumber>
</Location>

# WebCenter online help
<Location /_ocsh>
SetHandler weblogic-handler
WebLogicHost <hostname>
WebLogicPort <portnumber>
</Location>

# IBR
<Location /ibr>
SetHandler weblogic-handler
WebLogicHost <hostname>
WebLogicPort <portnumber>
</Location>

# URM
<Location /urm>
SetHandler weblogic-handler
WebLogicHost <hostname>
WebLogicPort <portnumber>
</Location>

# SS
<Location /customer-configured-for-site-studio>
SetHandler weblogic-handler
WebLogicHost <hostname>
WebLogicPort <portname>
</Location>

2. OAM 10g構成ツール(OAMCfgTool)を使用して、保護するWebCenter Content URIを指定します。
OAM構成ツールはコマンドライン・ユーティリティで、情報を要求する一連のスクリプトを起動し、OAMで必要なプロファイルとポリシーを設定するために使用します。詳細は、『Oracle Platform Security Servicesによるアプリケーションの保護』のOAMCfgToolの概要に関する項を参照してください。

注意:
保護するURIは、Oracle WebCenter Content (CS)、Inbound Refinery (IBR)、Records (URM)、Site Studio (SS)など、インストールしたWebCenter Content機能により異なります。
Site Studioの場合、保護するURIはお客様が構成します。たとえば、サイトが/mysiteとしてアクセスされる場合、URI /mysiteを指定する必要があります。

機能

URI

CS

/adfAuthentication

IBR

/ibr/adfAuthentication

URM

/urm/adfAuthentication

SS

/customer_configured_site_studio

注意:
OAMの構成が完了した後で、WebCenter ContentのURLが正しくリンクしていない場合、サーバー・ホストとサーバーのポート値の変更が必要な場合があります。詳細は、第16.3.5項を参照してください。

3. OAMグローバル・ログアウトの設定を完了するには、end_urlが処理されるようWebゲートを構成します。この構成を追加しない場合、ログアウトしても、end_urlが処理されないため、終了URLへのリダイレクトが行われません。構成手順の詳細は、『Oracle Platform Security Servicesによるアプリケーションの保護』のOracle Access Manager 10gおよび10g WebGateのグローバル・ログアウトの構成に関する項を参照してください。

4. シングル・サインオン・ログアウトが正常に機能するよう、URL /oamsso/logout.htmlをAccessGateのログアウトURL設定に追加します。詳細は、『Oracle Fusion Middleware Oracle Access Management管理者ガイド』のシングル・サインオン・ログアウトURLおよびAccessGate構成パラメータの構成に関する説明を参照してください。

注意:
WebCenter Contentバージョン11gR1をOAMバージョン10gを使用する環境にデプロイするには、ログアウト・リクエストを適切に処理するための追加の構成が必要です。詳細は、『Oracle Platform Security Servicesによるアプリケーションの保護』のOracle Access Manager 10gおよび10g WebGateのグローバル・ログアウトの構成に関する項を参照してください。

2. 次のタスクを実行して、WebCenter Contentドメインを構成します。詳細は、『Oracle Platform Security Servicesによるアプリケーションの保護』のOracle Access Manager 10gを使用したSSOソリューションのデプロイに関する項を参照してください。

1. OAMアイデンティティ・アサータを構成します。OAMアイデンティティ・アサータの制御フラグをREQUIREDに設定する必要があります。
『Oracle Platform Security Servicesによるアプリケーションの保護』のOracle Access Manager 10gを使用したSSO用のOAM IDアサーションの構成に関する項を参照してください。

2. 認証プロバイダを構成します。これはOracle Internet Directory (OID)またはOracle Virtual Directory (OVD)のような、OAMで使用されるLDAPサーバーと一致する、ユーザー・ストア用の外部LDAPサーバーを指定するのに必要です。たとえば、OAMでOIDを使用している場合、OID認証プロバイダがOracle WebCenter Contentドメインに追加される必要があります。

注意:
WebCenter Content用のOracle WebLogic ServerドメインがDefaultAuthenticatorプロバイダとは異なる認証プロバイダを使用するように構成される場合、新しい認証プロバイダはセキュリティ・レルム構成にリストされた最初の認証プロバイダである必要があり、そうでないと、WebCenter Contentはユーザー権限をロードできません。新しい認証プロバイダがDefaultAuthenticatorプロバイダよりも前にリストされるように、認証プロバイダの順番を変更してください。また、DefaultAuthenticator制御フラグがSUFFICIENTに設定されていることを確認してください。詳細は、第16.3.4項を参照してください。

『Oracle Platform Security Servicesによるアプリケーションの保護』のOAM 10gの認証プロバイダのインストールおよび設定に関する項およびOracle Access Manager 10gの認証の構成に関する項を参照してください。

『Oracle Platform Security Servicesによるアプリケーションの保護』のOAM 11gとOAM 10gでの認証プロバイダ実装タスクの違いに関する項にある表を参照してください。

3. OPSS (OAM)シングル・サインオン・プロバイダを構成します。
『Oracle Platform Security Servicesによるアプリケーションの保護』のOracle Access Manager 10gを使用したシングル・サインオンの構成に関する項を参照してください。

3. OAM 10gのインストールおよび構成後、すべての構成済アプリケーションにアクセスできることと、ログインにより再度サインインすることを要求されずにすべての構成済アプリケーションにアクセスできることを確認します。また、可能な場合、グローバル・ログアウトをテストし、その他のすべての関連アプリケーションからログアウトしていることを確認します。
OAM 10gのグローバル・ログアウトの構成に関する詳細は、『Oracle Platform Security Servicesによるアプリケーションの保護』および『Oracle Fusion Middleware Oracle Access Management管理者ガイド』を参照してください。

16.3.3 WebCenter Content用のOracle Single Sign-Onの構成

Oracle Single Sign-On (OSSO)は10g Oracle Application Serverスイートの一部です。OSSOは、Oracle Internet DirectoryおよびOracle HTTP Server (OHS) 11gと組み合せたOC4Jアプリケーション・サーバーで使用できるエンタープライズ・レベルのシングル・サインオン・ソリューションです。

既存のOracleデプロイメントにOSSOがエンタープライズ・ソリューションとしてすでにデプロイされている場合、Oracle Fusion Middlewareは、既存のOSSOソリューションを引き続きサポートします。ただし、OAM 11g Single Sign-onソリューションへのアップグレードを検討することをお薦めします。

この項では、WebCenter ContentとOSSOの統合に関する情報について説明します。Oracle WebCenterコンテンツ・サーバー(CS)、Oracle WebCenter Content: Records (URM)、Oracle WebCenter Content: Inbound Refinery (IBR)、およびOracle WebCenter Content: Site Studio (SS)についての構成情報が提供されます。

『Oracle Fusion Middleware Oracle Identity Managementエンタープライズ・デプロイメント・ガイド(Oracle Fusion Applications Edition)』、『Oracle Platform Security Servicesによるアプリケーションの保護』、『アップグレード・プランニング・ガイド』および『Oracle Identity Managementアップグレード・ガイド』も参照してください。

OSSOを構成する前に、ソフトウェアがインストールされていることを確認します。OSSOおよびOracle Delegated Administration Serviceは11g リリースの一部ではありません。お客様は、11g Oracle Internet DirectoryおよびOracle Directory Integration Platformと互換性があり、いわゆる10gでのApplication Serverインフラストラクチャを形成する、これらの製品の10.1.4.*バージョンをダウンロードする必要があります。これらの10g製品でのデプロイ手順は、Oracle Identity Managementリリース10.1.4.0.1用のOracle Application Serverエンタープライズ・デプロイメント・ガイド(原本部品番号B28184-02)のJAZN-SSO/DASのインストールおよび構成に関する説明を参照してください。このマニュアルは次のOracle Technology Networkから使用可能です。

http://download.oracle.com/docs/cd/B28196_01/core.1014/b28184/toc.htm

1. OSSOを構成します。詳細は、『Oracle Platform Security Servicesによるアプリケーションの保護』のOracleAS SSO 10gを使用したシングル・サインオンの構成に関する項を参照してください。

1. WebCenter Content Uniform Resource Identifier (URI)エントリをmod_wl_ohs.confファイルに追加します。次の例から適切なロケーション・エントリを使用します。例の各エントリは受信パスを対応するアプリケーションが存在する適切なOracle WebLogic Serverにマップします。
次のエントリのリストで、hostnameはコンテンツ・サーバーをホストしているコンピュータ名を示し、portnumberは対応するアプリケーションが存在するOracle WebLogic Serverのポート番号を示します。hostnameおよびportnumberは、使用しているシステムのホスト名とポート名に置き換えます。

注意:
転送するURIはインストールしたWebCenter Content機能により異なります。機能に応じて適切なロケーション・エントリを使用します。たとえば、/cs、/adfAuthentication、/_ocsh、/ibr、/urmなどです。
Site Studioの場合、転送するURIはお客様が構成します。たとえば、サイトが/mysiteとしてアクセスされる場合、/mysiteのロケーション・エントリを追加する必要があります。

注意:
コンテンツ・サーバーのロケーション/csはカスタマイズできるため、/cs指定ではHTTPリクエストが正しいロケーションを含むことを保証できません。/csが変更されると、管理者が構成したロケーションが転送されます。

# Content Server
<Location /cs>
SetHandler weblogic-handler
WebLogicHost <hostname>
WebLogicPort <portnumber>
</Location>

# Content Server authentication
<Location /adfAuthentication>
SetHandler weblogic-handler
WebLogicHost <hostname>
WebLogicPort <portnumber>
</Location>

# WebCenter online help
<Location /_ocsh>
SetHandler weblogic-handler
WebLogicHost <hostname>
WebLogicPort <portnumber>
</Location>

# IBR
<Location /ibr>
SetHandler weblogic-handler
WebLogicHost <hostname>
WebLogicPort <portnumber>
</Location>

# URM
<Location /urm>
SetHandler weblogic-handler
WebLogicHost <hostname>
WebLogicPort <portnumber>
</Location>

# SS
<Location /customer-configured-site-studio
SetHandler weblogic-handler
WebLogicHost <hostname>
WebLogicPort <portnumber>
</Location>

2. 保護するWebCenter Content Uniform Resource Identifier (URI)を含めるようにmod_osso.confファイル(ORACLE_HOME/ohs/conf/)を変更します。

注意:
保護するURIは、コンテンツ・サーバー(CS)、Inbound Refinery (IBR)、Records (URM)、Site Studio (SS)など、インストールしたWebCenter Content機能により異なります。
Site Studioの場合、保護するURIはお客様が構成します。たとえば、サイトが/mysiteとしてアクセスされる場合、URI /mysiteを指定する必要があります。

機能

URI

CS

/adfAuthentication

IBR

/ibr/adfAuthentication

URM

/urm/adfAuthentication

SS

/customer_configured_site_studio

2. これらのタスクを確実に実行することにより、WebCenter Contentドメインを構成します。『Oracle Platform Security Servicesによるアプリケーションの保護』のOracleAS SSO 10gを使用したシングル・サインオンの構成に関する項を参照してください。

1. WebCenter Content用のOracle WebLogic ServerのOSSOアイデンティティ・アサータを追加および構成します。認証プロバイダとして、OSSOアイデンティティ・アサータ、OIDオーセンティケータ、デフォルト・オーセンティケータを推奨します。
OIDオーセンティケータ・プロバイダはOracle Internet Directoryサーバー用で、本稼働レベルのシステムで使用されます。デフォルト・オーセンティケータ・プロバイダは、Oracle WebLogic Server組込みLDAPサーバー用です。

OSSOIdentityAsserterをドメイン用のプライマリ・プロバイダ・オーセンティケータとして設定し、ユーザー・プロファイルが関連Oracle Internet Directoryサーバーから取得できるようにします。必要な場合、リストされているように制御フラグを設定し、プロバイダの順序を変更して次の順序で表示されるようにします。

OSSOIdentityAsserter (REQUIRED)

OIDAuthenticator (SUFFICIENT)

DefaultAuthenticator (SUFFICIENT)

注意:
WebCenter Content用のOracle WebLogic ServerドメインがDefaultAuthenticatorプロバイダとは異なる認証プロバイダを使用するように構成される場合、新しい認証プロバイダはセキュリティ・レルム構成にリストされた最初の認証プロバイダである必要があり、そうでないと、WebCenter Contentはユーザー権限をロードできません。新しい認証プロバイダがDefaultAuthenticatorプロバイダよりも前にリストされるように、認証プロバイダの順番を変更してください。また、DefaultAuthenticator制御フラグがSUFFICIENTに設定されていることを確認してください。詳細は、第16.3.4項を参照してください。

2. 認証プロバイダを構成します。これはOracle Internet Directory (OID)またはOracle Virtual Directory (OVD)のような、OAMで使用されるLDAPサーバーと一致する、ユーザー・ストア用の外部LDAPサーバーを指定するのに必要です。たとえば、OSSOでOIDを使用している場合、OID認証プロバイダがWebCenter Contentドメインに追加される必要があります。

注意:
OSSOの構成が完了した後で、WebCenter ContentのURLが正しくリンクしていない場合、サーバー・ホストとサーバーのポート値の変更が必要な場合があります。詳細は、第16.3.5項を参照してください。

16.3.4 最初の認証プロバイダの構成

WebCenter Content用のOracle WebLogic Serverドメインが、ユーザー認証(Oracle Internet Directoryまたはその他のLDAPプロバイダなど)用にデフォルトの認証プロバイダ以外の認証プロバイダを使用するように構成されている場合、プライマリ・プロバイダはセキュリティ・レルム構成の最初の認証プロバイダである必要があります。そうでないと、ログイン認証が失敗します。

プライマリ・プロバイダが最初にリストされていない(たとえば、Oracle WebLogic ServerプロバイダであるDefaultAuthenticatorの下にリストされている)場合、WebCenter Contentはユーザーのグループ・メンバーシップを正常にロードできず、その結果、ユーザー権限もロードできません。Oracle WebLogic Server管理コンソールを使用して、構成済み認証プロバイダが呼び出される順番を変更できます。詳細は、『Oracle WebLogic Serverの保護』を参照してください。

注意:
Oracle Internet Directoryを使用する場合、すべてのWebCenter Content管理者とその他のユーザーは、Oracle Internet Directoryで定義される必要があります。

注意:
コンテンツ・サーバーはコンテンツ・サーバー管理者ロールを、内部Oracle WebLogic Serverユーザー・ストアに定義された管理ユーザーに割り当てます。これはOracle Internet Directoryが使用されているかどうかに関わらず当てはまります。ただし、Oracle Internet DirectoryおよびOracle Internet Directory Authenticationプロバイダが最初にリストされていない場合、コンテンツ・サーバー・インスタンスによるOracle WebLogic Serverが定義した管理ユーザーのロールを取得するリクエストは失敗します。

注意:
11g リリース1 (11.1.1.6.0)以後、Oracle WebCenter ContentではOracle Virtual Directoryライブラリ(libOVD)機能の使用がサポートされており、この機能を使用すると、ログインやグループ・メンバーシップ情報に対してサイトで複数のプロバイダを使用できます。たとえば、Oracle Internet Directory (OID)とActive Directoryの両方をユーザーおよびロール情報のソースとして使用できます。Oracle WebLogic Serverでの複数のLDAP構成の詳細は、『Oracle Fusion Middlewareアプリケーション・セキュリティ・ガイド』のFusion Middleware Controlを使用した、複数のLDAP用のサービスの構成に関する項を参照してください。

16.3.5 シングル・サインオン用のWebCenter Content URLの構成

Oracleアプリケーションをシングルサインオン(SSO)とともに使用するように構成し、Oracle Access Manager (OAM)またはOracle Single Sign-On (OSSO)を設定した場合、WebCenter Content GET_ENVIRONMENTサービスにより、サーバー名、サーバー・ポート、アプリケーション・サービス・コール(WebCenter Doclibサービスなど)への相対Webルートが提供されます。ただし、GET_ENVIRONMENTにより提供される値は、使用するSSO構成には適切でない場合があります。

OHSサーバー・ホストおよびサーバー・ポートを使用するアプリケーション・サービスをリダイレクトする場合(OAMおよびOSSOソリューションは両方ともOHSを使用するフロント・エンド・アプリケーションが必要なため)、コンテンツ・サーバー・ホストおよびサーバー・ポートの構成値を変更する必要があります。

次の2つのいずれかの方法を使用して、コンテンツ・サーバー・ホストおよびサーバー・ポート値を変更できます。

- Oracle WebLogic Server管理コンソールを使用します。

- スタンドアロンのWebCenter Contentシステム・プロパティ・アプリケーションを使用します。

1. WebCenter Contentドメイン・ディレクトリに移動します。

2. ディレクトリをucm/cs/binに変更します。

3. スタンドアロン・アプリケーションを実行します。./SystemProperties

4. 「システム・プロパティ」ウィンドウで、「インターネット」タブを選択します。

5. HTTPサーバー・アドレスをOHS(またはロード・バランサ)サーバー・ホストおよびサーバー・ホスト値に更新します。

6. 「システム・プロパティ」ウィンドウを閉じます。

7. Oracle WebLogic Serverドメインを再起動します。

16.3.6 Windowsのネイティブ認証用のWebCenter Contentおよびシングル・サインオンの構成

Windows Native Authentication (WNA)用にWebCenter Contentおよびシングル・サインオン(SSO)を設定するには、Microsoft Active Directory、クライアントおよびOracle WebLogic Serverドメインが必要です。MicrosoftクライアントでのSSOへのシステム要件を含む詳細は、『Oracle WebLogic Serverの保護』のMicrosoftクライアントでのシングル・サインオンの構成に関する項に記載されています。

MicrosoftクライアントでのSSOの構成の一部として、外部Microsoft Active DirectoryにアクセスするようにLDAP認証プロバイダを指定する必要があります。Oracle WebLogic Serverでは、Active Directory認証プロバイダを提供します。『Oracle WebLogic Serverの保護』のLDAP認証プロバイダの構成に関する項を参照してください。

注意:
WebCenter Content用のOracle WebLogic ServerドメインがDefaultAuthenticatorプロバイダとは異なる認証プロバイダを使用するように構成される場合、新しい認証プロバイダはセキュリティ・レルム構成にリストされた最初の認証プロバイダである必要があり、そうでないと、WebCenter Contentはユーザー権限をロードできません。新しい認証プロバイダがDefaultAuthenticatorプロバイダよりも前にリストされるように、認証プロバイダの順番を変更してください。また、DefaultAuthenticator制御フラグがSUFFICIENTに設定されていることを確認してください。詳細は、第16.3.4項を参照してください。

MicrosoftクライアントでのSSOの構成の一部として、Oracle WebLogic Serverセキュリティ・レルムにネゴシエートIDアサーション・プロバイダを構成する必要があります。IDアサーション・プロバイダは、Simple and Protected Negotiate (SPNEGO)トークンをデコードしてKerberosトークンを取得し、このKerberosトークンを検証してWebLogicユーザーにマップします。Oracle WebLogic Server管理コンソールを使用して、ドメイン構造内の適切なセキュリティ・レルムに新しいプロバイダを追加し、名前を付けて、そのタイプとしてNegotiateIdentityAsserterを選択します。変更をアクティブ化して、Oracle WebLogic Serverを再起動します。サーバーはKerberosチケットを使用できるようになり、それはブラウザから受信します。

関連デプロイ・プランを使用して、Windows Native Authentication (Kerberos)環境で使用される各WebCenter Contentアプリケーション(コンテンツ・サーバー、Inbound Refinery、Records)を再デプロイする必要があります。デプロイ・プランはXMLドキュメントです。Oracleでは、3つのWebCenter Contentアプリケーションのそれぞれに対して、cs-deployment-plan.xml、ibr-deployment-plan.xml、urm-deployment-plan.xmlというプランを提供します。Oracle WebLogic Scripting Toolを使用してデプロイ・プランを実装することもできます。

1. Oracle WebLogic Server管理コンソールにログインします。

2. 「ドメイン構造」ナビゲーション・ツリーで、「デプロイメント」をクリックします。

3. 「制御」タブで、変更するWebCenter Contentデプロイメントが表示されるまで「次へ」をクリックします。

- Oracle WebCenter Contentサーバー

- Oracle WebCenter Content: Inbound Refinery

- Oracle WebCenter Content: Records

4. 変更するデプロイメントの左のチェック・ボックスを選択します。

5. 「更新」をクリックします。

6. デプロイ・プラン・パスの下で「パスの変更」を選択します。

7. 適切なプラン・ファイルに移動して選択します。

- cs-deployment-plan.xml (Content Server用)

- ibr-deployment-plan.xml (Inbound Refinery用)

- urm-deployment-plan.xml (Records用)

8. 「このアプリケーションを次のデプロイメント・ファイルを使用して再デプロイします。」が選択されていることを確認します。

9. 「次へ」をクリックします。

10. 「終了」をクリックします。

11. MicrosoftクライアントでのSSOが適切に構成されていることを確認するには、使用するMicrosoft WebアプリケーションまたはWebサービスへのブラウザをポイントします。Windowsドメインにログインし、ドメインのActive Directoryサーバーから取得したKerberos資格証明がある場合、ユーザー名またはパスワードを指定せずにWebアプリケーションまたはWebサービスにアクセスできるはずです。

cs-deployment-plan.xml

提供されたcs-deployment-plan.xmlファイルを使用するか、または.xmlファイルを作成してそれにcs-deployment-plan.xmlという名前を付けます。

<?xml version='1.0' encoding='UTF-8'?>
<deployment-plan
xmlns="http://xmlns.oracle.com/weblogic/deployment-plan"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://xmlns.oracle.com/weblogic/deployment-plan http://xmlns.oracle.com/weblogic/deployment-plan/1.0/deployment-plan.xsd"
global-variables="false">
<application-name>cs.ear</application-name>
<variable-definition>
<variable>
<name>http-only</name>
<value>false</value>
</variable>
</variable-definition>
<module-override>
<module-name>cs.war</module-name>
<module-type>war</module-type>
<module-descriptor external="false">
<root-element>weblogic-web-app</root-element>
<uri>WEB-INF/weblogic.xml</uri>
<variable-assignment>
<name>http-only</name>
<xpath>/weblogic-web-app/session-descriptor/cookie-http-only</xpath>
</variable-assignment>
</module-descriptor>
</module-override>
</deployment-plan>

ibr-deployment-plan.xml

提供されたibr-deployment-plan.xmlファイルを使用するか、または.xmlファイルを作成してそれにibr-deployment-plan.xmlという名前を付けます。

<?xml version='1.0' encoding='UTF-8'?>
<deployment-plan xmlns="http://xmlns.oracle.com/weblogic/deployment-plan" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation= "http://xmlns.oracle.com/weblogic/deployment-plan http://xmlns.oracle.com/weblogic/deployment-plan/1.0/deployment-plan.xsd" global-variables="false">
<application-name>ibr.ear</application-name>
<variable-definition>
<variable>
<name>http-only</name>
<value>false</value>
</variable>
</variable-definition>
<module-override>
<module-name>ibr.war</module-name>
<module-type>war</module-type>
<module-descriptor external="false">
<root-element>weblogic-web-app</root-element>
<uri>WEB-INF/weblogic.xml</uri>
<variable-assignment>
<name>http-only</name>
<xpath>/weblogic-web-app/session-descriptor/cookie-http-only</xpath>
</variable-assignment>
</module-descriptor>
</module-override>
</deployment-plan>

urm-deployment-plan.xml

提供されたurm-deployment-plan.xmlファイルを使用するか、または.xmlファイルを作成してそれにurm-deployment-plan.xmlという名前を付けます。

<?xml version='1.0' encoding='UTF-8'?>
<deployment-plan
xmlns="http://xmlns.oracle.com/weblogic/deployment-plan"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://xmlns.oracle.com/weblogic/deployment-plan http://xmlns.oracle.com/weblogic/deployment-plan/1.0/deployment-plan.xsd"
global-variables="false">
<application-name>urm.ear</application-name>
<variable-definition>
<variable>
<name>http-only</name>
<value>false</value>
</variable>
</variable-definition>
<module-override>
<module-name>urm.war</module-name>
<module-type>war</module-type>
<module-descriptor external="false">
<root-element>weblogic-web-app</root-element>
<uri>WEB-INF/weblogic.xml</uri>
<variable-assignment>
<xpath>/weblogic-web-app/session-descriptor/cookie-http-only</xpath>
</variable-assignment>
</module-descriptor>
</module-override>
</deployment-plan>

16.4 Oracle Infrastructure Webサービスの構成

Oracle Infrastructure Webサービスでは、ポリシー・セットを作成してグローバル・スコープのサブジェクト(ドメイン、サーバー、アプリケーションまたはSOAコンポジット)にアタッチする機能が提供されています。Oracle Infrastructure WebサービスはWeb Services for Java EE 1.2仕様に従って実装されます(この仕様は、JavaでWebサービスを実装するための標準のJava EEランタイム・アーキテクチャを定義したものです)。この仕様には、標準Java EE Webサービス・パッケージング形式、デプロイメント・モデルおよびランタイム・サービスも記述されており、Oracle Infrastructure Webサービスにはこれらがすべて実装されています。

WebサービスへのOWSMセキュリティの適用の詳細は、Oracle Fusion Middleware Webサービスのためのセキュリティおよび管理者ガイドのWebサービスへのポリシーのアタッチに関する項を参照してください。

IBM WebSphereでサポートされているOracle Infrastructure Webサービスの動作の違いや制限事項は、サード・パーティ・アプリケーション・サーバー・ガイドのIBM WebSphereでのWebサービスの管理に関する項を参照してください。

17 ユーザー・タイプ、ログインおよびエイリアスの管理

この章では、Oracle WebCenter Contentのユーザー・ログイン・タイプ、ユーザー・ログイン、ユーザー情報フィールド、およびエイリアスについて説明します。ログインとエイリアスの管理方法についても説明します。Oracle WebCenter Contentのユーザー・ログイン・タイプ、ログイン、および情報のエイリアスは、デフォルトでOracle WebLogic Serverユーザー情報と統合されており、カスタム構成に応じてOPSSおよびその他のユーザー情報と統合されています。

この章の内容は次のとおりです。

- ユーザー・ログイン・タイプの概要

- ユーザー・ログインおよびエイリアスの概要

- ログインとエイリアスの管理

- ユーザー情報フィールド

17.1 ユーザー・ログイン・タイプの概要

Content Serverソフトウェアは次のユーザー・ログイン・タイプをサポートします。

- 外部ユーザー

- ローカル・ユーザー

17.1.1 外部ユーザー

Oracle WebCenter Content 11g リリース1 (11.1.1)でサポートされるデフォルトのユーザー・タイプは外部ユーザーです。外部ユーザーはWebCenter Contentシステム外で定義され、Oracle WebLogic Server管理コンソールおよびOracle Platform Security Services (OPSS)を使用して、外部セキュリティにより認証されます。認証されると、外部ユーザーはOracle WebLogic Server経由でコンテンツ・サーバー・インスタンスにアクセスできます。一般的に、外部ユーザーは信頼できるドメインのユーザーで、アクセス権は付与されますが、WebCenter Contentシステムからは管理されないユーザーです。そのパスワードはOracle WebLogic Serverドメイン、ネットワーク・ドメイン、またはOracle Internet Directoryなどのその他のプロバイダにより所有されますが、ユーザー管理アプレットを使用して、外部ユーザーからローカル・ユーザーへの変換時にユーザー・パスワードを設定できます。ローカル・ユーザーとは異なり、未定義の外部ユーザーにはguestロールは割り当てられません。

ユーザーがコンテンツ・サーバー・インスタンスにOracle WebLogic Server経由で初めてログインすると、コンテンツ・サーバー・データベースに追加され、管理者はリポジトリ・マネージャを使用して外部ユーザー情報を表示できます。ただし、外部ユーザーは、コンテンツの「チェックイン」ページの「作成者」フィールドなどの、ユーザー・リストに自動的には含まれません。「オーバーライド」チェック・ボックスがユーザーの「ユーザー・プロファイル」ページで選択されている場合、コンテンツ・サーバー・データベースで定義されたユーザー情報により、外部ユーザー・ベースから導出されたユーザー情報はオーバーライドされます。

管理ユーザー・アプレットは少なくとも一度はコンテンツ・サーバー・インスタンスにログインしたことのあるユーザーのみを表示します。Oracle WebLogic Serverユーザー・ストアまたはコンテンツ・サーバー・インスタンス外のその他のユーザーストアからのすべてのユーザーは、外部ユーザーとして表示されます。

デフォルトでは、外部セキュリティ統合は、外部ユーザー・ベースからの限定されたユーザー情報のセット(ユーザー名、パスワード、ロール、アカウントおよび電子メール・アドレスなどの追加情報)をコンテンツ・サーバー・インスタンスにマップします。LDAP統合を使用している場合、電子メール・アドレスやユーザー・ロケールなどの追加のユーザー情報は、Oracle WebLogic Server管理コンソールを使用して組込みLDAPサーバーからマップでき、Oracle Platform Security Servicesと統合できます。

次に外部ユーザーの共通の特性をリストします。

- ログイン(認証)の定義: ユーザーIDおよびパスワードで定義され、これらは次に示すWebCenter Contentシステム以外のユーザー・データベースに格納されます。

- 信頼できるドメイン(Oracle WebLogic Serverなど)

- Lightweight Directory Application Protocol (LDAP)

- その他のデータベース

- アクセス(認証)の決定: 信頼できるドメインまたはその他のユーザー・データベース(Oracle WebLogic Serverユーザー・ストア、Oracle Internet Directoryまたはその他のLDAPプロバイダなど)およびWebCenter Contentからの資格証明(ロールなど)により決定されます。

- ユーザー・ログイン: ユーザーがログインするには、Oracle WebLogic Serverおよびコンテンツ・サーバー・インスタンスが実行されている必要があります。

- ユーザー・パスワード: ユーザー・パスワードはOracle WebLogic Serverまたはその他のユーザー・データベース(LDAPサーバーなど)で管理者により定義されます。ユーザーはコンテンツ・サーバー・インスタンスでパスワードを変更できません。

- インタフェースの問題: ユーザー名はコンテンツ・チェックイン・リストに表示されません。しかし、ユーザーはワークフローに参加できます。

注意:
カレット「^」はWebCenter Contentの特殊文字であり、ユーザー名、グループ名、またはルール名には使用できません。「^」文字は、WebCenter ContentによりStringUtilsクラス用と解析されます。StringUtilsクラスでは、この文字が文字列のエンコーディングとデコーディングに使用されます。

このプロセスに従い、外部ユーザー用のロール、グループおよびアカウントを設定します。

1. セキュリティ・グループを設定します。第18.2.1項を参照してください。

2. ロールを設定します。第18.4.1項を参照してください。

3. 権限を配置します。第18.4.5項を参照してください。

4. (オプション)アカウントを使用します。第19.2.1項を参照してください。

外部ユーザーの作成の詳細は、『Oracle WebLogic Server Administration Consoleオンラインヘルプ』を参照してください。

17.1.2 ローカル・ユーザー

ローカル・ユーザーは、コンテンツ・サーバー・インスタンス内で管理者によって定義されます。管理者はユーザーに1つ以上のロールを割り当て、これにより、ユーザーがセキュリティ・グループにアクセスできるようになります。

注意:
ローカル・ユーザーはOracle WebLogic Serverドメインではサポートされません。コンテンツ・サーバー管理者はユーザー管理アプレットを使用してローカル・ユーザーを作成および構成できますが、コンテンツ・サーバー・インスタンスへのアクセスに対して認証されるローカル・ユーザーに対しては、ユーザーおよびパスワードもOracle WebLogic Server管理コンソールで作成することが必要です。11g リリース1 (11.1.1)でサポートされるデフォルトのユーザー・タイプは外部ユーザーです。

次にローカル・ユーザーの一般的な特性を示します。

- ログイン(認証)の作成: コンテンツ・サーバーの管理者により作成されます。

- アクセス(認証)の決定: セキュリティ・グループへのアクセスを提供する、コンテンツ・サーバーのロールにより決定されます。

- ユーザー・ログイン: 管理サーバーはOracle WebLogic Server経由でのログインが必要なため、ローカル・ユーザーはコンテンツ・サーバー管理サーバーにログインできません。

- ユーザー・パスワード: ユーザーはパスワードを変更できます。

- インタフェースの問題: ユーザー名はコンテンツのチェックイン・リストに表示されます。ユーザーは、フルネーム、電子メール・アドレス、ユーザー・タイプを変更するかどうかを指定できます。

- 資格証明: 以前は1000人以下のユーザーに対してお薦めされましたが、コンテンツ・サーバーのトラブルシューティングなどの目的でシステム管理者により要求されるときのみの推奨になりました。パフォーマンス上の問題から、1000を超えるローカル・ユーザーを構成しないでください。

注意:
カレット「^」はWebCenter Contentの特殊文字であり、ユーザー名、グループ名、またはルール名には使用できません。「^」文字は、WebCenter ContentによりStringUtilsクラス用と解析されます。StringUtilsクラスでは、この文字が文字列のエンコーディングとデコーディングに使用されます。

このプロセスに従ってローカル・ユーザーを設定します。

1. セキュリティ・グループを設定します。第18.2.1項を参照してください。

2. ロールを設定します。第18.4.1項を参照してください。

3. 権限を配置します。第18.4.5項を参照してください。

4. ユーザー・ログインを割り当てます。第17.3.1項を参照してください。

5. (オプション)アカウントを使用します。第19.2.1項を参照してください。

17.2 ユーザー・ログインおよびエイリアスの概要

ユーザー・ログインは、コンテンツ・サーバーにアクセスするユーザーに関連付けられた名前です。11g リリース1 (11.1.1)以降では、デフォルトでユーザー・ログインはWebCenter Contentおよびコンテンツ・サーバー・インスタンスをホストするOracle WebLogic Serverドメインに作成されます。認証および資格証明は、デフォルトではOracle WebLogic Serverユーザー・ストアで処理され、コンテンツ・サーバーによるかわりにセキュリティ・ソフトウェアに関連付けられます。詳細は、『Oracle Platform Security Servicesによるアプリケーションの保護』を参照してください。

注意:
Oracle WebLogic Server管理コンソールを使用する手順は、Oracle WebLogic認証プロバイダのユーザーおよびグループにのみ適用されます。デフォルト・セキュリティ構成をカスタマイズしてカスタム認証プロバイダを使用している場合、ユーザーを作成するにはそのセキュリティ・プロバイダの管理ツールを使用します。Oracle WebLogic Server認証プロバイダにアップグレードする場合、既存のユーザーとグループをWebLogic認証プロバイダのデータベースにロードできます。『Oracle WebLogic Serverの保護』のセキュリティ・データの移行に関する項を参照してください。

注意:
ユーザー・ログインは、ユーザー管理アプレットを使用してコンテンツ・サーバーで作成および管理できますが、Oracle WebLogic Server管理コンソールでも作成されるまで、認証目的にとって有効ではありません。
LDAPサーバーを使用して、コンテンツ・サーバーでユーザー管理アプレットを使用して定義したローカル・ユーザーと同じ名前のユーザー・ログインを作成する場合、LDAPユーザーはログイン時にLDAPに対して認証されますが、ローカル・ユーザーに割り当てられたロールを受信します。

Oracle WebLogic Server管理者は、各ユーザーに1つ以上のグループを割り当てます。グループによって、セキュリティ・グループ内のファイルに対するアクセス権限がユーザーに付与されます。未定義のユーザーはゲスト・グループに割り当てられ、デフォルトで表示できるのはパブリック・セキュリティ・グループ内のドキュメントのみです。

ワークフロー、サブスクリプションおよびプロジェクトに、単一の名前またはエイリアスで参照できるユーザーのグループを作成することもできます。たとえば、user1、user2、user3、などを追加するよりも、Supportというエイリアスをワークフローに追加する方が簡単です。

異なるログイン方法(標準ログイン、Microsoftログインまたは自動登録ログインなど)で同じコンピュータ上の複数のブラウザ・ウィンドウにログインすると、それぞれのウィンドウにどのユーザーがログインしているかに関してコンテンツ・サーバーが混乱する可能性があります。異なるログイン方法のテスト中は、開いているブラウザ・ウィンドウを閉じてください。

重要:
ユーザー・ログインでは、大文字と小文字が区別されます。

17.3 ログインとエイリアスの管理

デフォルトでは、ユーザー・ログインはOracle WebLogic Server管理コンソールで作成され、管理されます。ユーザー・ログインの作成および管理の情報および手順については、Oracle WebLogic Server管理コンソールのオンライン・ヘルプを参照してください。デフォルト・セキュリティ構成をカスタマイズして、Oracle Internet Directoryなどの別の認証プロバイダを使用している場合、ユーザー・ログインを作成および管理するには、そのセキュリティ・プロバイダの管理ツールを使用します。

システム・プロパティなどのスタンドアロンのコンテンツ・サーバー・ユーティリティを使用するユーザー(コンテンツ・サーバー管理者以外)を設定する必要がある場合、コンテンツ・サーバーのユーザー管理アプレットを使用してローカル・ユーザーを作成できます。ただし、ユーザー管理アプレットで作成したユーザーは、ユーザーがOracle WebLogic Server管理コンソールでも作成されないかぎり、スタンドアロンのコンテンツ・サーバー・ユーティリティ以外の機能に対しては認証されません。

この項の残りの部分では、スタンドアロン・ユーティリティ用のコンテンツ・サーバーのユーザー・ログイン管理にのみ関連するタスクについて説明します。

- 第17.3.1項「ユーザー・ログインの追加」

- 第17.3.2項「ユーザー・ログインの編集」

- 第17.3.3項「ユーザー・ログインの削除」

- 第17.3.4項「エイリアスの作成」

- 第17.3.5項「エイリアスの編集」

- 第17.3.6項「エイリアスの削除」

17.3.1 ユーザー・ログインの追加

11gリリース1 (11.1.1)からは、外部ユーザー・ログインはOracle WebLogic Server管理コンソールを使用して追加する必要があります。ユーザー・ログインは、特別な目的の場合はコンテンツ・サーバーで管理できますが、Oracle WebLogic Server管理コンソールで作成されるまで、コンテンツ・サーバーに対する認証は有効ではありません。これらのユーザー・ログインの作成および管理の情報および手順については、『Oracle WebLogic Server Administration Consoleオンラインヘルプ』を参照してください。

注意:
カレット「^」はWebCenter Contentの特殊文字であり、ユーザー名、グループ名、またはルール名には使用できません。「^」文字は、WebCenter ContentによりStringUtilsクラス用と解析されます。StringUtilsクラスでは、この文字が文字列のエンコーディングとデコーディングに使用されます。

コンテンツ・サーバーのスタンドアロン・ユーティリティでの使用にかぎりユーザー・ログインを追加するには、次の手順を実行します。

1. 「ユーザー管理」画面: 「ユーザー」タブで、「追加」をクリックします。

2. メニューから「認可タイプ」を設定します。詳細は、第17.1項を参照してください。

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

4. 「ユーザーの追加」または「ユーザーの編集」のウィンドウで、ユーザーに関する情報を入力します。

- パスワードを入力した場合、「パスワードの確認」フィールドに同じパスワードを再入力する必要があります。

- ユーザー名とパスワードでは、大文字と小文字が区別されます。

5. ロールをユーザーに割り当てます。

6. アカウントが有効化されている場合は、アカウントをユーザーに割り当てます。

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

17.3.2 ユーザー・ログインの編集

11gリリース1 (11.1.1)からは、外部ユーザー・ログインはOracle WebLogic Server管理コンソールを使用して編集する必要があります。ユーザー・ログインは、特別な目的の場合はコンテンツ・サーバーで管理できますが、Oracle WebLogic Server管理コンソールで作成されるまで、コンテンツ・サーバーに対する認証は有効ではありません。ユーザー・ログインの編集および管理の情報および手順については、Oracle WebLogic Server管理コンソールのオンライン・ヘルプを参照してください。

コンテンツ・サーバーのスタンドアロン・ユーティリティでの使用にかぎりユーザー・ログインを編集するには、次の手順を実行します。

1. 「ユーザー管理」画面の「ユーザー」タブで、ユーザー名をダブルクリックするか、ユーザー名を選択して「編集」をクリックします。

2. 「ユーザーの追加」/「ユーザーの編集」ウィンドウまたは「ユーザーの追加」/「ユーザーの編集」: 「情報」タブ(グローバル・ユーザー)で、必要に応じてユーザー・ログインを編集します。

sysmanagerロールを持つユーザーのユーザー・ロケールを変更する場合は、管理サーバー・サービスを再起動して、そのユーザーのロケール言語で管理サーバー・インタフェースが表示されるようにする必要があります。

17.3.3 ユーザー・ログインの削除

11gリリース1 (11.1.1)からは、外部ユーザー・ログインはOracle WebLogic Server管理コンソールを使用して削除する必要があります。ユーザー・ログインは、特別な目的の場合はコンテンツ・サーバーで管理できますが、Oracle WebLogic Server管理コンソールで作成されるまで、コンテンツ・サーバーに対する認証は有効ではありません。ユーザー・ログインの削除および管理の情報および手順については、『Oracle WebLogic Server Administration Consoleオンラインヘルプ』を参照してください。

コンテンツ・サーバーのスタンドアロン・ユーティリティでの使用にかぎりユーザー・ログインを削除するには、次の手順を実行します。

1. 「ユーザー管理」ウィンドウの「ユーザー」タブで、ユーザー名を選択します。

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

3. 「はい」をクリックします。

ワークフローに関連するユーザーを削除した場合は、削除を確認するよう要求されます。ワークフローを調整し、ワークフロー・レビューアのリストからそのユーザーを削除する必要があります。

17.3.4 エイリアスの作成

11gリリース1 (11.1.1)からは、外部ユーザー・ログインはOracle WebLogic Server管理コンソールを使用して管理する必要があります。ユーザー・ログインは、特別な目的の場合はコンテンツ・サーバーで管理できますが、Oracle WebLogic Server管理コンソールで作成されるまで、コンテンツ・サーバーに対する認証は有効ではありません。ユーザー・ログインの作成および管理の情報および手順については、Oracle WebLogic Server管理コンソールのオンライン・ヘルプを参照してください。

コンテンツ・サーバーのスタンドアロン・ユーティリティでの使用にかぎりエイリアスを定義するには、次の手順を実行します。

1. 「ユーザー管理」ウィンドウの「エイリアス」タブを表示します。

2. 「追加」をクリックします。

3. 「新しいエイリアスの追加」/「エイリアスの編集」ウィンドウの「エイリアス名」フィールドに、ユーザーのグループを識別するための名前を入力します。

4. 「説明」フィールドに、エイリアスの詳細な説明を入力します。

5. 「追加」をクリックします。

6. 「ユーザーの選択」ウィンドウで、リストからユーザー名を選択します。

- 「ユーザーの選択」ページのユーザーのリストを絞り込むには、「フィルタの使用」を選択し、「フィルタの定義」をクリックしてフィルタ基準を選択し、「OK」をクリックします。

- 一連のユーザーを選択するには、1つのユーザー・ログインをクリックしてから、[Shift]キーを押しながら別のユーザー・ログインをクリックします。

- ユーザーを個別に選択するには、[Ctrl]キーを押しながら各ユーザー・ログインをクリックします。

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

8. 「ユーザー管理」ページを閉じます。

17.3.5 エイリアスの編集

11gリリース1 (11.1.1)からは、外部ユーザー・ログインはOracle WebLogic Server管理コンソールで管理する必要があります。ユーザー・ログインは、特別な目的の場合はコンテンツ・サーバーで管理できますが、Oracle WebLogic Server管理コンソールで作成されるまで、コンテンツ・サーバーに対する認証は有効ではありません。ユーザー・ログインの編集および管理の情報および手順については、Oracle WebLogic Server管理コンソールのオンライン・ヘルプを参照してください。

コンテンツ・サーバーのスタンドアロン・ユーティリティでの使用にかぎりエイリアスを編集するには、次の手順を実行します。

1. 「ユーザー管理」ウィンドウの「エイリアス」タブを表示します。

2. エイリアスをハイライトして「編集」をクリックします。

3. 必要に応じて、「新しいエイリアスの追加」/「エイリアスの編集」ウィンドウの情報を変更します。

4. 「説明」フィールドに、エイリアスの詳細な説明を入力します。

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

6. 「ユーザー管理」ページを閉じます。

17.3.6 エイリアスの削除

11gリリース1 (11.1.1)からは、外部ユーザー・ログインはOracle WebLogic Server管理コンソールで管理する必要があります。ユーザー・ログインは、特別な目的の場合はコンテンツ・サーバーで管理できますが、Oracle WebLogic Server管理コンソールで作成されるまで、コンテンツ・サーバーに対する認証は有効ではありません。ユーザー・ログインの削除および管理の情報および手順については、Oracle WebLogic Server管理コンソールのオンライン・ヘルプを参照してください。

コンテンツ・サーバーのスタンドアロン・ユーティリティでの使用にかぎりエイリアスを削除するには、次の手順を実行します。

1. 「新しいエイリアスの追加」/「エイリアスの編集」ウィンドウを表示します。

2. 削除するエイリアスを選択し、「削除」をクリックします。
削除の確認を要求するページが表示されます。エントリを削除するには、「はい」をクリックし、保持するには「いいえ」をクリックします。

3. 「ユーザー管理」ページを閉じます。

17.4 ユーザー情報フィールド

ユーザー情報では、フル・ネーム、パスワード、電子メール・アドレスなど、ユーザー固有の属性を定義します。ユーザー情報フィールドでは、メタデータ・フィールドでコンテンツ・アイテムを説明するのと同様にユーザーを説明します。ユーザー情報はコンテンツ・サーバー・データベースに格納され、ユーザーのソート、コンテンツ・サーバーWebページでのユーザー情報の表示、またはユーザー属性に基づいたWebページの表示のカスタマイズに使用できます。

次のユーザー情報のフィールドがシステムで事前定義されています。これらのフィールドの削除、およびフィールド名やタイプの変更はできません。

名前

タイプ

キャプション

オプション・リスト

dFullName

ロング・テキスト

フル・ネーム

False

dEmail

ロング・テキスト

電子メール・アドレス

False

dUserType

テキスト

ユーザー・タイプ

True

dUserLocale

テキスト

ユーザー・ロケール

True

この項の項目は次のとおりです。

- 第17.4.1項「新しいユーザー情報フィールドの追加」

- 第17.4.2項「「オプション・リスト」の編集」

- 第17.4.3項「ユーザー情報フィールドの編集」

17.4.1 新しいユーザー情報フィールドの追加

新しいユーザー情報フィールドを追加するには:

1. 「ユーザー管理」画面: 「情報フィールド」タブで、「追加」をクリックします。

2. 「メタデータ・フィールド名の追加」ウィンドウに新しいフィールド名を入力します。重複する名前は使用できません。最大フィールド長は29文字です。次の文字は使用できません。空白、タブ、行送り、改行および ^ ? : @ & + " # % < * ~ |

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

4. 「メタデータ・フィールドの編集」ウィンドウで、フィールドのプロパティを構成し、「OK」をクリックします。

5. 「データベース設計の更新」をクリックします。

17.4.2 「オプション・リスト」の編集

「オプション・リスト・キー」を編集するには:

1. 「メタデータ・フィールドの編集」ウィンドウで、「オプション・リストの有効化」をクリックします。

2. 「編集」をクリックします。

3. 「オプションリスト」ウィンドウで、オプションの値を追加、編集または削除します。

- 各値は、別々の行に表示される必要があります。

- 空白の行は、オプション・リストで空白の値になります。

4. リストをソートするには、ソート・オプションを選択して「今すぐソートする」をクリックします。

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

17.4.3 ユーザー情報フィールドの編集

ユーザー情報フィールドを編集するには:

1. フィールドをダブルクリックするか、フィールドを選択して「編集」をクリックします。

2. 「メタデータ・フィールドの編集」ウィンドウで、オプションの値を追加、編集または削除します。

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

18 セキュリティ・グループ、ロール、および権限の管理

この章では、Oracle WebCenter Content Serverのセキュリティ・グループ、ロール、および権限の使用と管理について説明します。

この章の内容は次のとおりです。

- コンテンツ・サーバーのセキュリティ・グループの概要

- コンテンツ・サーバーのグループの管理

- コンテンツ・サーバーのロールおよび権限の概要

- コンテンツ・サーバーのロールおよび権限の管理

18.1 コンテンツ・サーバーのセキュリティ・グループの概要

セキュリティ・グループは、一意の名前でグループ化された一連のファイルです。コンテンツ・サーバー・リポジトリ内のすべてのファイルはセキュリティ・グループに属します。セキュリティ・グループへのアクセスは権限によって制御され、権限はコンテンツ・サーバーのロールに割り当てられます。ロールはOracle WebLogic Serverで管理されるユーザーに割り当てられます。

ユーザーはOracle WebLogic Server管理コンソールを使用してグループに割り当てられます。ユーザーがコンテンツ・サーバー・インスタンスにログインすると、ユーザーのグループがコンテンツ・サーバーのロールにマップされます。@(アット)記号で始まるOracle WebLogic Serverユーザー・グループはコンテンツ・サーバー・アカウントにマップされます。

コンテンツ・サーバーで認識されるOracle WebLogic Serverグループでは、正確に同じ名前のロールがコンテンツ・サーバーに作成され、セキュリティ・グループに割り当てられる必要があります。これが行われていないと、ユーザーに割り当てられたOracle WebLogic Serverグループは、コンテンツ・サーバーでのユーザーの権限に何の影響も及ぼしません。

セキュリティ・グループを使用すると、コンテンツ・ファイルを特定のユーザーのみがアクセス可能な個別のグループに編成できます。たとえば、人事指定のドキュメントを表すHRDocsという名前のセキュリティ・グループにファイルを割り当て、このグループには人事部門で働く人のみがアクセスするようにできます。事前定義済セキュリティ・グループが2つあります。

- パブリック: デフォルトでは、すべてのユーザーがログインなしでパブリック・グループのドキュメントを表示できます。

- セキュア: システム・ファイルはセキュア・グループに格納され、システム管理者のみが使用できます。

18.1.1 セキュリティ・グループの操作のベスト・プラクティス

セキュリティ・グループを定義するときには、次の考慮事項に注意してください。

- セキュリティ・グループは、保護する必要のあるファイルがチェックされる前に定義してください。

- 検索およびユーザー管理の効率を最適化するために、セキュリティ・グループの数は最小限に維持する必要があります。セキュリティ・モデルに50を超えるセキュリティ分類が必要な場合は、アカウントを有効化し、それらを使用してユーザーの権限を制御する必要があります。この数は検索効率およびユーザー管理効率により異なります。

- 同じアクセスを共有するすべてのファイルを1つのセキュリティ・グループに含めます。

- セキュリティ・グループに論理命名規則を設定します。たとえば、イントラネットを設定している場合は部門名を使用し、エクストラネットを設定している場合にはセキュリティのレベル(内部や分類済みなど)を使用します。

たとえば、図18-1に3つの定義されたセキュリティ・グループを示します(Public、HRDocs、EngDocs)。これらは異なるロール(Admin、Contributor、Guest、Sysadmin、Subadmin)と特定の権限のセット(読取り、書込み、削除、管理者)に割り当てられた5ユーザーに関連付けられています。

図18-1 セキュリティ・グループの定義の例

18.1.2 パフォーマンスに関する考慮事項

セキュリティ・グループおよびロールに関するユーザー・アクセス設定は、システム効率の次の内容に影響する可能性があります。

- 検索効率

- ユーザー管理効率

18.1.2.1 検索効率

検索効率は、ユーザーがアクセス権を持つセキュリティ・グループの数に影響されます。ユーザーが表示権限を持つコンテンツのみを戻すには、データベースのWHERE句にセキュリティ・グループのリストを含めます。WHERE句には、ユーザーがアクセス権を持っているすべてのセキュリティ・グループ、アクセス権を持っていないすべてのセキュリティ・グループを含めます。どちらの方法にするかは、ユーザーの持っている権限が、定義されているセキュリティ・グループの50%を超えているかまたは50%に満たないかにより異なります。

たとえば、100のセキュリティ・グループが定義されていて、ユーザーが10のセキュリティ・グループの権限を持っている場合は、WHERE句に10のセキュリティ・グループを含めます。反対に、ユーザーが90のセキュリティ・グループのアクセス権を持っている場合は、そのユーザーがアクセス権を持っていない10のセキュリティ・グループをWHERE句に含めます。

そのため、ユーザーが50%に近いセキュリティ・グループに対する権限を持っている場合、検索効率は低下します。ユーザーがすべてのセキュリティ・グループに対する権限を持っている場合、またはどのセキュリティ・グループに対する権限も持っていない場合は、検索効率が向上します。

18.1.2.2 ユーザー管理効率

セキュリティ・グループの合計数にロールの合計数を掛けた数が、RoleDefinitionデータベース表の行数になります。この数は、ユーザー管理アプリケーションのローカル・ユーザーに関連する作業効率に影響します。ユーザー管理アプリケーションにおける、セキュリティ・グループの追加やロールの権限の変更などの操作の実行に必要な概算の時間を判断するには、次の式を使用します。

(# of security groups) X (# of roles) / 1000 = Time of operation in seconds

たとえば、400 MHzプロセッサと128 MBのRAMを備えたPCを使用すると、RoleDefinition表に10,000行ある場合、ユーザー管理アプリケーションを使用したセキュリティ・グループまたはロール(あるいはその両方)の追加には約10秒かかります。

セキュリティ・グループの数が増加すると、使用者の検索効率よりも管理効率が影響を受けます。

18.2 コンテンツ・サーバーのグループの管理

コンテンツ・サーバーを使用して、次のタスクによりセキュリティ・グループを管理します。

- コンテンツ・サーバーでのセキュリティ・グループの追加

- コンテンツ・サーバーでのセキュリティ・グループの削除

グループ管理の詳細は、『Oracle WebLogic Serverの保護』を参照してください。

18.2.1 コンテンツ・サーバーでのセキュリティ・グループの追加

セキュリティ・グループを作成し権限を割り当てるには:

注意:
カレット「^」はWebCenter Contentの特殊文字であり、ユーザー名、グループ名、またはルール名には使用できません。「^」文字は、WebCenter ContentによりStringUtilsクラス用と解析されます。StringUtilsクラスでは、この文字が文字列のエンコーディングとデコーディングに使用されます。

1. 「ユーザー管理」画面から、「セキュリティ」→「グループの権限」を選択します。

2. 「グループの権限」ウィンドウで、「グループの追加」をクリックします。

3. 「新しいグループの追加」ウィンドウで、グループ名および説明を入力します。

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

5. セキュリティ・グループに権限を設定します。

1. セキュリティ・グループを選択します。

2. 編集するロールを選択します。

3. 「アクセス権の編集」をクリックします。

4. グループのロールに必要な権限を有効化したら、「OK」をクリックして、「グループの権限」ページを閉じます。

18.2.2 コンテンツ・サーバーでのセキュリティ・グループの削除

注意:
コンテンツ・サーバー・リポジトリに格納されたコンテンツ・アイテムと関連付けられているセキュリティ・グループまたはアカウントは、絶対に削除しないでください。

セキュリティ・グループを削除するには:

1. 削除するセキュリティ・グループにコンテンツ・アイテムが関連付けられていないことを確認します。コンテンツが存在しているセキュリティ・グループを削除することはできません。

2. 「ユーザー管理」画面から、「セキュリティ」→「グループの権限」を選択します。

3. 「グループの権限」ウィンドウで、削除するグループを選択します。

4. 「グループの削除」をクリックします。

5. 「はい」をクリックします。セキュリティ・グループが削除されます。

6. セキュリティ・グループを削除したら、「OK」をクリックして、「グループの権限」ページを閉じます。

18.3 コンテンツ・サーバーのロールおよび権限の概要

ロールは、各セキュリティ・グループに対する一連の権限(読取り、書込み、削除、管理者)です。ロールはユーザーのジョブと考えられます。ユーザーは、様々なセキュリティ・グループに対して異なるジョブを持つことができます。ユーザーは参加する様々なチームを識別するために、異なるジョブを持つこともできます。次の操作を実行できます。

- ロールを定義します。

- 1人のユーザーに複数のロールを割り当てます。

- 複数のユーザーで1つのロールを共有するよう設定します。

- ロールの権限を複数のセキュリティ・グループに設定できます。

たとえば、図18-2に、3つのロールと、そのロールが同じセキュリティ・グループに対して持つ権限を示します。

図18-2 ロールとその権限の例

ロールは、セキュリティ・グループにアクセス権を提供するためにシステム管理者によって1人以上のユーザーに割り当てられます。図18-3に、HRDocsセキュリティ・グループに対して読取り権限のみを持つEngUsersロールを示します。ただし、このロールは、EngDocsセキュリティ・グループに対して読取り、書込みおよび削除権限も持っています。これにより、セキュリティが強化され、特定のドキュメントにアクセスする必要のあるユーザーのみがそれらのドキュメントを変更できるようになります。

図18-3 ロールおよびセキュリティ・グループのアクセスの例

18.3.1 事前定義済のロール

コンテンツ・サーバーには、次のロールが事前定義されています。

ロール

説明

admin

adminロールはシステム管理者に割り当てられます。デフォルトでは、このロールには、すべてのセキュリティ・グループおよびすべてのアカウントに対する管理権限があり、すべての管理ツールにアクセスできます。

contributor

contributorロールには、パブリック・セキュリティ・グループに対する読取りおよび書込みの権限があり、コンテンツを検索、表示、チェックインおよびチェックアウトできます。

guest

guestロールには、パブリック・セキュリティ・グループに対する読取り権限があり、コンテンツを検索および表示できます。

sysmanager

sysmanagerロールは、ユーザー・インタフェースの「管理」メニューから「管理サーバー」リンクにアクセスできる権限を持っています。

18.3.2 権限について

各ロールでは、各セキュリティ・グループに対して、読取り(R)、書込み(W)、削除(D)または管理者(A)の各権限が許可されます。セキュリティ・グループのファイルにアクセスするためにユーザーが持つ権限は、任意のユーザーのロールにより定義されている最高の権限です。ユーザーにguestロールとcontributorロールがあり、guestにはパブリック・セキュリティ・グループに対する読取り権限、contributorには書込み権限が付与されている場合、そのユーザーがパブリック・セキュリティ・グループのコンテンツに対して持つのは書込み権限です。

図18-4に示すように、Joe SmithおよびAnn Wallaceは2つのセキュリティ・グループに対する権限を持っています。

- Joe Smithには、EngDocsセキュリティ・グループに対して読取り、書込みおよび削除権限を持っていますが、HRDocsセキュリティ・グループに対しては読取り権限のみを持っています。EngUsersロールのメンバーとして、エンジニアリング・ドキュメントには読取り、書込みおよび削除のアクセス権が付与されていますが、人事ドキュメントには読取りアクセス権のみが付与されています。

- Ann Wallaceは、HRDocsセキュリティ・グループに対して読取り、書込みおよび削除権限を持っていますが、EngDocsセキュリティ・グループに対しては読取り権限のみを持っています。HRUsersロールのメンバーとして、人事ドキュメントには読取り、書込みおよび削除のアクセス権が付与されていますが、エンジニアリング・ドキュメントには読取りアクセス権のみが付与されています。

図18-4 割り当て済み権限の例

18.3.3 事前定義済の権限

各ロールには、各セキュリティ・グループに対して次の各権限を割り当てることができます。

権限

説明

読取り

セキュリティ・グループ内のドキュメントを表示できます。

書込み

セキュリティ・グループ内のドキュメントを表示、チェックイン、チェックアウトおよびコピーできます。作成者がドキュメントのセキュリティ・グループの設定を変更できるのは、新しいセキュリティ・グループで書込み権限がある場合です。

削除

セキュリティ・グループ内のドキュメントを表示、チェックイン、チェックアウト、コピーおよび削除できます。
構成変数AuthorDeleteがtrueに設定されており、コンテンツ・サーバーがFoldersを使用するように構成されている場合(FrameworkFoldersコンポーネントにより提供される)、作成者は読取り権限を持っていれば自分自身のリビジョンを削除できますが、読取り権限を持っていない場合、作成者はコンテンツ・アイテムのセキュリティ・グループへの削除権限を持っている必要があります。

構成変数AuthorDeleteがtrueに設定されており、コンテンツ・サーバーがコントリビューション・フォルダを使用するように構成されている場合(Folders_gコンポーネントにより提供される)、作成者はコンテンツ・アイテムのセキュリティ・グループへの削除権限を持っていなくても自分自身のリビジョンを削除できます。

管理

セキュリティ・グループ内のファイルを表示、チェックイン、チェックアウト、コピーおよび削除できます。ワークフロー権限があるユーザーは、そのセキュリティ・グループ内のワークフローを開始または編集できます。
該当するセキュリティ・グループ内にある、別のユーザーが作成者として指定されているドキュメントをチェックインすることもできます。ドキュメントの作成者以外のユーザーがドキュメントのセキュリティ・グループの設定を変更できるのは、新しいセキュリティ・グループで書込み権限がある場合です。

18.4 コンテンツ・サーバーのロールおよび権限の管理

ロールおよび権限はコンテンツ・サーバーで定義および管理されます。ロールはユーザー・ログインに割り当てられ、デフォルトで、Oracle WebLogic Server管理コンソールで管理されます。

次のタスクを使用してユーザー・ロールを管理します。

- コンテンツ・サーバーでのロールの作成

- コンテンツ・サーバーでのロールの削除

- Oracle WebLogic Serverを使用したユーザーへのロールの割当て

- Oracle WebLogic Serverを使用した類似ユーザーへのロールの割当て

- コンテンツ・サーバーでの権限の追加および編集

18.4.1 コンテンツ・サーバーでのロールの作成

コンテンツ・サーバーでロールを作成して権限を構成するには:

注意:
カレット「^」はWebCenter Contentの特殊文字であり、ユーザー名、グループ名、またはルール名には使用できません。「^」文字は、WebCenter ContentによりStringUtilsクラス用と解析されます。StringUtilsクラスでは、この文字が文字列のエンコーディングとデコーディングに使用されます。

1. 「ユーザー管理」画面から、「セキュリティ」→「ロールの権限」を選択します。

2. 「ロールの権限」ウィンドウで、「新しいロールの追加」をクリックします。

3. 「新しいロールの追加」ウィンドウで、ロール名を入力します。

- ロール名は255文字以内にする必要があります。

- 次の文字は使用できません。空白、タブ、行送り、改行および; : ^ ? & + " # % < > * ~ |

- 最初、ロールにはパブリック・セキュリティ・グループに対する読取り(R)権限が割り当てられており、その他のセキュリティ・グループに対する権限は割り当てられていません。

4. 次のようにロールに権限を設定します。

1. ロールを選択します。

2. 編集するセキュリティ・グループを選択します。

3. 「アクセス権の編集」をクリックします。

4. 権限を編集します。

5. 「OK」をクリックして「ロールの権限」ページを閉じます。

18.4.2 コンテンツ・サーバーでのロールの削除

コンテンツ・サーバーでロールを削除する手順は、次のとおりです。

1. 削除するロールにユーザーが割り当てられていないことを確認します(ロールにユーザーが割り当てられている場合は、そのロールを削除できません)。

2. 「ユーザー管理」画面から、「セキュリティ」→「ロールの権限」を選択します。

3. 「ロールの権限」ウィンドウで、削除するロールを選択します。

4. 「ロールの削除」をクリックします。

5. 「はい」をクリックします。

18.4.3 Oracle WebLogic Serverを使用したユーザーへのロールの割当て

コンテンツ・サーバーのユーザーにロールを割り当てるには、Oracle WebLogic Server管理コンソールを使用します。ロールはコンテンツ・サーバーで定義されますが、管理コンソールを使用してユーザーに割り当てる必要があります。詳細は、Oracle WebLogic Server管理者ガイドを参照してください。

ユーザーはOracle WebLogic Server管理コンソールを使用してグループに割り当てることもできます。コンテンツ・サーバーで認識されるOracle WebLogic Serverグループでは、グループと正確に同じ名前のロールがコンテンツ・サーバーに作成され、セキュリティ・グループに割り当てられる必要があります。

18.4.4 Oracle WebLogic Serverを使用した類似ユーザーへのロールの割当て

別のユーザー・ログインと類似のアクセス権を持つ、コンテンツ・サーバーのユーザーを作成するときにロールを割り当てるには、Oracle WebLogic Server管理コンソールを使用します。ロールはコンテンツ・サーバーで定義されますが、管理コンソールを使用してユーザーに割り当てる必要があります。詳細は、Oracle WebLogic Server管理者ガイドを参照してください。

ユーザーはOracle WebLogic Server管理コンソールを使用してグループに割り当てることもできます。コンテンツ・サーバーで認識されるOracle WebLogic Serverグループでは、グループと正確に同じ名前のロールがコンテンツ・サーバーに作成され、セキュリティ・グループに割り当てられる必要があります。

18.4.5 コンテンツ・サーバーでの権限の追加および編集

コンテンツ・サーバーでロールに権限を追加するか、または既存の権限を編集する手順は、次のとおりです。

1. 「ユーザー管理」画面から、「セキュリティ」→「ロールの権限」を選択します。

2. 「ロールの権限」ウィンドウで、既存のロールを選択するか、または新しいロールを追加します。セキュリティ・グループに関連付けられた権限が表示されます。

3. 「グループ/権限」列でアイテムを選択します。

4. 「アクセス権の編集」をクリックします。

5. 「アクセス権の編集」ウィンドウで、このロールまたはセキュリティ・グループと関連付ける権限を指定します。権限の詳細は、第18.3.3項を参照してください。

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

19 アカウントの管理

この章では、コンテンツ・サーバーで定義および管理されるコンテンツ・サーバー・アカウントについての情報を提供します。アカウントの権限はOracle WebLogic Server管理コンソールを使用してユーザー・ログインに割り当てられます。

この章の内容は次のとおりです。

- コンテンツ・サーバー・アカウントの概要

- コンテンツ・サーバー・アカウントの管理

- コンテンツ・サーバー・アカウントの事例

19.1 コンテンツ・サーバー・アカウントの概要

アカウントを使用すると、セキュリティ・グループのみの場合よりも、セキュリティ構造の柔軟性と精度が向上します。アカウントとアカウントの権限は、Oracle WebLogic Server管理コンソールを使用してユーザーに割り当てられ、グループはサーバーによりコンテンツ・サーバーのロールおよびアカウントにマップされます。アカウントは各コンテンツ・アイテムにも割り当てることができます。アカウントが割り当てられたコンテンツ・アイテムにアクセスするには、そのアカウントに対する適切な権限を持っている必要があります。

@(アット)記号で始まるOracle WebLogic Serverユーザー・グループはコンテンツ・サーバー・アカウントにマップされます。

注意:
アカウントを有効化して使用し、その後アカウントを無効化すると、データを損失する場合があります。リポジトリは変更されません。ただし、セキュリティ・モデルに特定の変更を行う場合、セキュア・コンテンツへのアクセスを継続できるように、ユーザーのアクセス権を更新する必要もあります。
この状況を避けるため、要件と、グループおよびアカウントのWebCenter Contentセキュリティ・モデルについて調査して、要件に最適なのは何かを判断します。確実に使用する必要がある場合以外は、アカウントを有効化しないでください。

アカウントは、いくつかの方法で作成できます。

- コンテンツ・サーバー管理者による、ユーザー管理ツールを使用した事前定義済アカウントの作成。詳細は、第19.2.2項を参照してください。

- ユーザー管理者による、コンテンツのチェックイン時におけるアカウントの作成。詳細は、第19.2.3項を参照してください。

注意:
アカウント名にストップワードを使用することはお薦めできません。ストップワードとは、他のキーワードと組み合せて使用したときに、検索問合せの中で検索エンジンが除外または無視する語のことです。アカウント名での検索がOracleTextSearchコンポーネントを使用して実行された場合、問合せにストップワードが含まれていると、返された検索結果に悪影響がおよぶ場合があります。ストップワードの使用の詳細またはストップワードを削除する手順については、『Oracle Textリファレンス11g』ドキュメントを参照してください。

使用するアカウントを有効化する必要があります。詳細は、第19.2.1項を参照してください。

19.1.1 アカウントおよびセキュリティ・グループ

アカウントを使用する場合、アカウントが、セキュリティ・グループ権限より優先されるプライマリ権限になります。特定のドキュメントへのユーザーのアクセスを、アカウント権限とセキュリティ・グループ権限の共通部分と考えることもできます。

たとえば、EngAdminロールには、EngDocsセキュリティ・グループ内のすべてのコンテンツに対する読取り、書込み、削除および管理権限があるとします。ユーザーはEngAdminロールに割り当てられ、AcmeProjectアカウントに対する読取りおよび書込み権限も割り当てられます。その結果、ユーザーは、EngDocsセキュリティ・グループとAcmeProjectアカウント内のコンテンツ・アイテムに対する読取りおよび書込み権限のみを持ちます。

図19-1に、AcmeProjectアカウント権限とEngDocsセキュリティ・グループ権限の共通部分を示します。

図19-1 セキュリティ・グループ権限の例

アカウントで任意のコンテンツへのアクセスが許可されていない場合、セキュリティ・グループ権限は無視されます。アカウントは、ユーザーのロールによって定義された権限より優先されるフィルタとして機能します。

19.1.2 階層アカウント

アカウントは階層構造に設定することができ、これにより、一部のユーザーには構造のブランチ全体に対するアクセス権を付与する一方で、構造の下位レベルのアカウントを割り当てることによりその他のユーザーの権限を制限できます。図19-2に、典型的な階層アカウント構造を示します。

図19-2 階層アカウント構造の例

重要:
アカウント名は、コンテンツ・アイテムのURLのディレクトリ・パスの一部を形成するため、30文字を超えることはできません。

- アカウント名のレベルを区切るためにスラッシュを使用すると(Eng/Acme/Budgetなど)、コンテンツ・サーバーによりアカウント構造に応じてWebレイアウト・ディレクトリ構造が作成されます(ただし、実際の各ディレクトリは、チェックイン・プロセス中にコンテンツ・アイテムがアカウントに割り当てられるまで作成されません)。アカウント名の各下位レベルは、そのディレクトリがアカウント・レベルであることを示す@記号接頭辞付きの上位レベルのサブディレクトリになります。

重要:
組込みLDAPサーバーを使用している場合は、スラッシュを使用しないでください。Oracle WebLogic Server Consoleを使用している場合、バックスラッシュ(/)およびスラッシュ(\)はセキュリティ・グループにはお薦めできません。

- ユーザーが特定の接頭辞のアカウントに対する権限を持っている場合、その接頭辞の付くすべてのアカウントへのアクセス権があります。たとえば、Eng/XYZアカウントにを割り当てられている場合、Eng/XYZアカウントおよびEng/XYZ接頭辞で始まる任意のアカウント(Eng/XYZ/Schedule、Eng/XYZ/Budgetなど)へのアクセス権があります。

重要:
アカウント接頭辞にスラッシュを含める必要はありません。たとえば、abc、abc_docs、abcdefgというアカウントがある場合、abcアカウントへのアクセス権を持つすべてのユーザーには、その他2つのアカウントに対するアクセス権もあります。

前述のセキュリティ構造に対応するには、次のアカウントを作成します。

- Eng

- Eng/Acme

- Eng/XYZ

- Eng/Acme/Schedule

- Eng/Acme/Budget

- Eng/XYZ/Schedule

- Eng/XYZ/Budget

図19-3 セキュリティ・ファイル構造の例

19.1.3 パフォーマンスに関する考慮事項

セキュリティ・モデルでアカウントを使用するときには次の作業効率の問題を考慮してください。

- 理論上、コンテンツ・サーバーのパフォーマンスに影響を与えずに無制限にアカウントを作成できます。100,000を超えるコンテンツが存在するシステムでは、1人当たり200アカウントの場合に管理効率上の限られた問題があります。ただし、1人当たり100を超えるアカウントがあると、検索効率に重大な影響があります(これは明示的なアカウントであり、階層アカウント接頭辞を介して暗黙的にユーザーに関連付けられたアカウントではありません。ユーザーは単一の接頭辞を介して多数の暗黙的アカウントに対する権限を持つことができます)。

- アカウントを有効化する場合は、作業効率上の理由から、使用するセキュリティ・グループが50を超えないようにしてください。

- セキュリティ・グループおよびアカウントには、比較的短い名前を付けるようにしてください。

19.1.4 外部ディレクトリ・サーバーの考慮事項

アカウントはコンテンツ・サーバー・インスタンスが外部ディレクトリ・サーバー(デフォルトのOracle WebLogic Serverなど)と統合されているかどうかに関係なく使用できます。外部ディレクトリを使用するアカウントを使用する場合は、次のガイドラインに従ってください。

- 適切なユーザーを含むグローバル・グループをアカウントに一致するように設定します。

- マッピング接頭辞を構成して、グループ名をロールまたはアカウントに関連付けます。

19.2 コンテンツ・サーバー・アカウントの管理

次のタスクがアカウントの管理に含まれます。

- コンテンツ・サーバーでのアカウントの有効化

- コンテンツ・サーバーでの定義済アカウントの作成

- コンテンツ・サーバーでのコンテンツのチェックイン時のアカウントの作成

- コンテンツ・サーバーでの定義済アカウントの削除

- Oracle WebLogic Serverでのユーザーへのアカウントの割当て

19.2.1 コンテンツ・サーバーでのアカウントの有効化

コンテンツ・サーバー・インスタンスでアカウントを有効化する手順は、次のとおりです。

重要:
アカウントを有効化して使用し、その後アカウントを無効化すると、データを損失する場合があります。リポジトリは変更されません。ただし、セキュリティ・モデルに特定の変更を行う場合、コンテンツへのアクセスを継続できるように、ユーザーのセキュリティの設定を更新する必要もあります。

1. コンテンツ・サーバー・ポータルで、「管理」→「管理サーバー」→「一般構成」を選択します。

2. 「一般構成」ページで、「アカウントの有効化」を選択します。

3. 変更を保存します。

4. コンテンツ・サーバー・インスタンスを再起動します。

または、「一般構成」ページにアクセスし、DomainHome/ucm/cs/config/config.cfgファイルのコンテンツを示す、「追加の構成変数」フィールドに次の行を追加します。

UseAccounts=true

変更を保存して、コンテンツ・サーバー・インスタンスを再起動します。

19.2.2 コンテンツ・サーバーでの定義済アカウントの作成

コンテンツ・サーバー・インスタンスで定義済アカウントを作成するには、次の手順を実行します。

1. 「ユーザー管理」ページから、「セキュリティ」、「定義済アカウント」の順に選択します。

2. 「定義済アカウント」ウィンドウで、「追加」をクリックします。

3. 「新しい定義済アカウントの追加」ウィンドウで、新規アカウントの名前を追加します。名前は簡潔で一貫性のあるものにします。たとえば、場所や部門による3文字の略語(MSP、NYCなど)を使用してすべてのアカウントを設定します。アカウント名は30以内にする必要があり、空白、タブ、行送り、改行および; ^ ? : & + " # % < > * ~の記号は使用できません。

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

5. すでにコンテンツ・サーバー・リポジトリにコンテンツがチェックインされていて、フルテキスト索引付けのデータベースを使用している場合は、検索索引を再作成します。
メタデータ・データベースの検索インデクサ・エンジンのみを使用している場合は、検索索引を再作成する必要はありません。

19.2.3 コンテンツ・サーバーでのコンテンツのチェックイン時のアカウントの作成

一般的に、コンテンツのチェックイン時にアカウントを作成するのではなく、事前定義済アカウントを作成する必要があります。定義済アカウントの詳細は、第19.2.2項を参照してください。

コンテンツ・アイテムのチェックイン時にアカウントを作成するには、ユーザー管理権限が必要で、次の手順を実行する必要があります。

1. 「コンテンツ・チェックイン・フォーム」ページを表示します。

2. 必須およびオプションの情報をすべて入力します。

3. 「アカウント」フィールドにアカウント名を入力します。

4. 「チェックイン」をクリックします。コンテンツ・アイテムに新規アカウントが割り当てられます。

注意:
アカウントに対する書込み(W)権限がある場合、コンテンツ・アイテムにチェックインしている間に、このアカウントを接頭辞として使用して別のアカウントを作成できます。たとえば、brアカウントへの書込み権限がある場合、brownアカウントを作成し、チェックイン中にコンテンツ・アイテムと関連付けることができます。

19.2.4 コンテンツ・サーバーでの定義済アカウントの削除

アカウントを含むコンテンツが存在する場合にもアカウントを削除できます。アカウント値はコンテンツ・アイテムに割り当てられたままですが、ユーザー定義のアカウントとみなされるようになります。

重要:
コンテンツ・サーバー・リポジトリに格納されたコンテンツ・アイテムと関連付けられているアカウントは、絶対に削除しないでください。

コンテンツ・サーバー・インスタンスで定義済アカウントを削除するには、次の手順を実行します。

1. 「ユーザー管理」ページから、「セキュリティ」、「定義済アカウント」の順に選択します。

2. 「定義済アカウント」ウィンドウで、削除するアカウントを選択します。

3. 「削除」をクリックします。アカウントが即時に削除されます。

19.2.5 Oracle WebLogic Serverでのユーザーへのアカウントの割当て

アカウントをユーザーに割り当てるには、Oracle WebLogic Server管理コンソールを使用してグループを作成し、それを1つまたは複数のユーザーに割り当てます。グループ名は@記号で始まり、アンダースコアで区切られた権限で終わる必要があります。次の例は、testaccountという名前のグループを作成し、それに読取り、書込みおよび削除権限を割り当てたものです(@testaccount_RWD)。JpsUserProviderを変更して、「アカウント権限のデリミタ」フィールドにアンダースコアが使用されていることを確認する必要もあります。JpsUserProviderの詳細は、第13.2.5項を参照してください。

Oracle WebLogic Server上のユーザーに割り当てられたアカウントはコンテンツ・サーバー・インスタンスにマップされます。ユーザーの作成とOracle WebLogic Serverでのアカウントの割当ての詳細は、『Oracle WebLogic Server Administration Consoleオンラインヘルプ』を参照してください。

19.3 コンテンツ・サーバー・アカウントの事例

この例において、Xalcoはロンドン、ニューヨーク、パリに支社のある世界的なソフトウェア企業です。コンテンツ・サーバー・インスタンスはロンドン支社にホストされていて、企業WAN経由で他のオフィスからアクセスされています。また、XalcoはパブリックWebサイトにの一部のファイルをレプリケートしています。まず、各地の営業部および経理部で、ファイルを公開するためにそのインスタンスを使用する必要があります。ニューヨーク支社は小規模で、営業部がありません。

次の各項では、Xalcoの事例に関するサンプル情報を示します。

- 第19.3.1項「Xalcoのセキュリティ」

- 第19.3.2項「Xalco社のアカウント」

- 第19.3.3項「Xalco社のロール」

- 第19.3.4項「ロールおよび権限の表」

- 第19.3.5項「ロールおよびユーザーの表」

- 第19.3.6項「アカウントおよびユーザーの表」

19.3.1 Xalcoのセキュリティ

- Xalcoの従業員およびセキュリティ・レベル:

- ロンドン: David Smith(全社CFO)、Jim McGuire(イギリス営業部長)

- ニューヨーク: Catherine Godfrey(地域経理部長)

- パリ: Helene Chirac(ヨーロッパ財務係)

- Xalco社のコンテンツのセキュリティ検査(セキュリティ・グループ)のレベル:

- パブリック: パブリックのメンバーに公開できるファイル(パブリック・コンテンツはXalco Webサイトにレプリケートされます)

- 内部: 社内ではアクセスの制限はないが、パブリックには公開できないファイル

- 機密: 業務上機密が要求され、中間管理職以上に制限されているファイル

- 極秘: 機密性が高く、役員にのみ公開されるファイル

- Xalco社の従業員のアクセス権:

- David Smith: 全社CFOとして、インスタンスに保持されているすべてのファイルへのフル・アクセス権が必要です。

- Jim McGuire: イギリスの営業部長として、ロンドンの営業ファイルへのフル・コントロールのアクセス権を持ち、パリの営業活動を把握できる必要があります。部長として、機密レベルへの許可があります。

- Helene Chirac: パリ支社を本拠地としていて、ヨーロッパの経理に関するファイルのみを参照する必要があり、内部レベルの許可のみがあります。

- Catherine Godfrey: ニューヨークを本拠地としちていて、地域経理部長として、ニューヨークの経理ファイルの登校、およびその他のすべての経理ドキュメントの参照を実行できる必要があります。部長として、機密レベルへの許可があります。

19.3.2 Xalco社のアカウント

アクセス権は場所や職務により異なるため、アカウント構造に反映されています。

- ロンドンには経理部および営業部があるため、次の2つのアカウントが必要です。

- London/Finance

- London/Sales

- ニューヨークには経理部のみがあります。

- NewYork/Finance

- パリには経理および営業部の両方があります。

- Paris/Finance

- Paris/Sales

このため、最上位レベルのアカウントは3つ(London、NewYork、Paris)で、下位レベルのアカウントは5つになります。

19.3.3 Xalco社のロール

各セキュリティ・グループに2つのロール(1つはコンシューマ用、もう1つはコントリビュータ用)を作成する必要があります。

- PublicConsumer

- PublicContributor

- InternalConsumer

- InternalContributor

- SensitiveConsumer

- SensitiveContributor

- ClassifiedConsumer

- ClassifiedContributor

19.3.4 ロールおよび権限の表

特定のユーザーにワークフローを開始する機能を付与するには、コントリビュータ・ロールに管理権限とワークフロー権限を追加する必要があります。

ロール

パブリック

内部

機密

極秘

PublicConsumer

R

PublicContributor

RWD

InternalConsumer

R

InternalContributor

RWD

SensitiveConsumer

R

SensitiveContributor

RWD

ClassifiedConsumer

R

ClassifiedContributor

RWD

19.3.5 ロールおよびユーザーの表

ロール

David Smith

Helene Chirac

Jim McGuire

Catherine Godfrey

PublicConsumer

×

PublicContributor

×

×

×

InternalConsumer

×

InternalContributor

×

×

×

SensitiveConsumer

SensitiveContributor

×

×

×

ClassifiedConsumer

ClassifiedContributor

×

×

×

19.3.6 アカウントおよびユーザーの表

David Smithにはロンドン、ニューヨークおよびパリのアカウントのRWDA権限を付与する必要があります。

Account

David Smith

Helene Chirac

Jim McGuire

Catherine Godfrey

London/Finance

RWDA

R

R

London/Sales

RWDA

RWDA

NewYork/Finance

RWDA

RW

Paris/Finance

RWDA

R

Paris/Sales

RWDA

R

20 アクセス制御リストのセキュリティの管理

この章では、コンテンツ・アイテムに対するアクセス権限または操作権限が指定された、ユーザー、グループまたはエンタープライズ・ロールのリストである、コンテンツ・サーバーのアクセス制御リスト(ACL)の情報を提供します。

この章の内容は、次のとおりです。

- アクセス制御リストのセキュリティの概要

- アクセス制御リストのセキュリティの構成

- メタデータ・フィールド

- アクセス制御リストの権限

20.1 アクセス制御リストのセキュリティの概要

コンテンツ・サーバー・システムは、標準のコンテンツ・サーバー・セキュリティ・ロール、セキュリティ・グループおよびアカウントの他に、アクセス制御リスト(ACL)をサポートするように構成できます。アクセス制御リストは、ユーザー、グループまたはエンタープライズ・ロールのリストであり、コンテンツ・アイテムに対するアクセス権限または操作権限が指定されています。

アクセス制御リスト・セキュリティの構成時に、コンテンツ・アイテムのチェックイン、更新または検索などのインタフェースのいくつかの場所で、次の3つの新規フィールドを使用できます。フィールドは次のとおりです。

- ユーザー・アクセス・リスト

- グループ・アクセス・リスト

- ロール・アクセス・リスト

アクセス制御リストのセキュリティ機能がコンテンツ・サーバーに構成されると、Oracle WebLogic Serverドメインとともに動作する、Oracle Access Manager (OAM) Authenticationプロバイダを含む、Oracle Platform Security Services (OPSS)を使用してアクセス制御リストを管理できます。詳細は、『Oracle Platform Security Servicesによるアプリケーションの保護』および『Oracle Internet Directory管理者ガイド』を参照してください。

コンテンツ・サーバーのアクセス制御リストはOracle Secure Enterprise Searchでサポートされ、ユーザーはアクセス制御リストの情報を使用して検索を実行できます。詳細は、第10.2項を参照してください。

注意:
RoleEntityACLコンポーネントをOracle WebCenter Content: Recordsとともに使用している場合、このコンポーネントは、カテゴリやレコード・フォルダなどの保存オブジェクトには影響しません。したがって、RecordsロールでACLを使用する機能は、RoleEntityACLコンポーネントが有効であっても、カテゴリ作成ページまたはフォルダ作成ページでは無効化されています。ただし、ロールACL機能は、コンテンツのチェックイン・ページでは有効になっています。

注意:
NeedtoKnow (NtkDocDisclosure、NTK)コンポーネントはコンテンツ・サーバー・セキュリティのカスタマイズをサポートしますが、セキュリティ・モデルと競合するため、アクセス制御リストとともには動作できません。詳細は、付録Bを参照してください。

20.2 アクセス制御リストのセキュリティの構成

アクセス制御リスト(ACL)を設定するには、次に示すコンテンツ・サーバーのアイテムを構成します。

- ユーザーおよびグループのアクセス制御リストをサポートするには、次の構成変数がコンテンツ・サーバーのconfig.cfgファイルで設定されている必要があります。

- UseEntitySecurity: この変数をtrueに設定します。

- SpecialAuthGroups: この変数を、ACLセキュリティを使用するコンテンツ・サーバー・セキュリティ・グループの名前に設定します。初期状態のコンテンツ・サーバーのセキュリティ・グループは、「Public」と「Secure」の2つのみです。通常、サイトでは、ACLセキュリティが適用される3番目のセキュリティ・グループが作成されます。
デフォルトでは、セキュリティ・グループはSpecialAuthGroupsリストに追加されません。

変数を設定するには、次のようにします。

1. Content Serverインスタンス用の管理インタフェースを使用して、「一般構成」ページを選択します。

2. このページで、「追加の構成変数」フィールドに変数を入力します。

3. 「更新」をクリックします。

構成変数UseEntitySecurity=trueは、コンテンツ・サーバーのセキュリティを、ユーザーおよびグループのアクセス制御リストのコンテンツ・アイテムを常に評価するように設定します。このパラメータは2つのメタデータ・フィールド、xClbraUserListおよびxClbraAliasListを作成します。

- エンタープライズ・ロールのアクセス制御リストをサポートするには、RoleEntityACLコンポーネントがコンテンツ・サーバーで有効にされる必要があります。このコンポーネントはデフォルトでコンテンツ・サーバーにインストールされ、無効化されています。コンポーネントを有効にするには、次のようにします。

1. Content Serverインスタンス用の管理インタフェースを使用して、コンポーネント管理ページを選択します。

2. このページの説明の段落で「拡張コンポーネント・マネージャ」をクリックします。

3. 「無効なコンポーネント」リストでコンポーネントRoleEntityACLを選択してから、「有効化」をクリックします。

4. Content Serverインスタンスを再起動します。

注意:
ロール名は30文字未満であるか、先頭から30文字までは一意であることが必要です。既存の外部ロール名が30文字を超える場合は、資格証明マップを使用してロール名を短い名前にマップします。
資格証明マップの詳細は、次を参照してください。

RoleEntityACLコンポーネントは、コンテンツ・サーバーを、別のアプリケーションと連携してエンタープライズ・ロールのアクセス制御リストを評価するように構成します。このコンポーネントはUseRoleSecurityパラメータをオンにして、コンテンツ・サーバー・セキュリティが、コンテンツ・アイテムに対するエンタープライズ・ロールのアクセス・リストの情報を統合するように設定します。UseRoleSecurityパラメータはxClbraRoleListメタデータ・フィールドを作成します。

ACLのロールを定義する利点は、ユーザー・ロールがエンタープライズ・セキュリティ・ディレクトリ(OID、Active Directoryなど)から来ることであり、そのため、WebCenter Content管理者はACLグループで行うようにそれらを定義する必要がありません。詳細は、ブログ記事「About Access Control Lists for Roles」を参照してください。

- コンテンツ・アイテムのチェックイン時に、管理者ではないユーザーに「ユーザーの追加」メニューを使用して「ユーザー・アクセス・リスト」でユーザーを選択できるようにする場合は、構成変数AllowQuerySafeUserColumns=trueを設定します。この変数が設定されていないと、「ユーザー・アクセス・リスト」フィールドのメニューに値が表示されません。

20.3 メタデータ・フィールド

アクセス制御リストは3つのメタデータ・フィールド、xClbraUserList、xClbraAliasListおよびxClbraRoleListの値に基づき処理されます。メタデータ値がユーザー、グループまたはエンタープライズ・ロール名およびコンテンツ・アイテムへの権限により移入される場合、コンテンツ・アイテムでの検索または動作がどのユーザー、グループまたはエンタープライズ・ロールに許可されるのかに影響します。

これらのメタデータ・フィールドはユーザー・アクセス・リスト、グループ・アクセス・リストおよびロール・アクセス・リスト・フィールドから移入され、コンテンツ・アイテムのチェックイン、更新、および拡張フォームを使用した検索の実行時に、表示またはアクセスできます。

管理者はスクリプトを使用して、アクセス・リストのメタデータ・フィールドに移入する値を指定できます。

20.3.1 xClbraUserListメタデータ・フィールド

xClbraUserListメタデータ・フィールドを使用して、コンテンツ・アイテムに対するユーザーとその権限を指定します。

次のリストでは、管理者がスクリプトにxClbraUserList値を指定する要件について説明します。

- 各ユーザー名の前にアンド記号(&)が付きます。

- ユーザー名の後に各ユーザーの権限がカッコで囲われて続きます。

- ユーザー名はカンマで区切られます。

- 例: xClbraUserList=&sysadmin(RWDA),&user1(RW),&guest(R)

20.3.2 xClbraAliasListメタデータ・フィールド

xClbraAliasListメタデータ・フィールドを使用して、コンテンツ・アイテムに対するグループとその権限を指定します。

注意:
コンテンツ・サーバーでは、エイリアスを使用してユーザーのグループ(LDAPグループとは異なる)を指定できます。ACLでは、エイリアス・アクセス・リストの実装を呼び出す代わりに、グループ・アクセス・リストが呼び出されます。ただし、メタデータ・フィールド名はエイリアスという用語を使用します。

次のリストでは、管理者がスクリプトにxClbraAliasList値を指定する要件について説明します。

- 各グループ名の前にはアット記号(@)が付きます。

- グループ名の後に各グループの権限がカッコで囲われて続きます。

- グループ名はカンマで区切られます。

- 例: xClbraAliasList=@Mktg(RWDA),@Mktg_ext(RW)

20.3.3 xClbraRoleListメタデータ・フィールド

xClbraRoleListメタデータ・フィールドを使用して、コンテンツ・アイテムに対するエンタープライズ・ロールとその権限を指定します。

次のリストでは、管理者がスクリプトにxClbraRoleList値を指定する要件について説明します。

- 各ロール名の前にはコロン記号(:)が付きます。

- ロール名の後に各ロールの権限がカッコで囲われて続きます。

- ロール名はカンマで区切られます。

- 例: xClbraRoleList=:role1(RWDA),:role2(RW)

20.4 アクセス制御リストの権限

アクセス制御リストの権限により、ユーザー、グループ、またはエンタープライズ・ロールのコンテンツ・アイテムに対するアクセス権のタイプが決まります。次の権限を付与できます。

権限

説明

読取り(R)

コンテンツ・アイテムを表示できます。

書込み(W)

コンテンツ・アイテムを表示、チェックイン、チェックアウト、更新およびコピーできます。

削除(D)

コンテンツ・アイテムを表示、チェックイン、チェックアウト、更新、コピーおよび削除できます。

管理(A)

コンテンツ・アイテムを表示、チェックイン、チェックアウト、更新、コピーおよび削除でき、「作成者」の指定とは別のユーザーでコンテンツ・アイテムをチェックインできます。

注意:
アクセス制御リストの権限はコンテンツ・サーバーのadminロールのユーザーには適用されません。
ただし、ユーザーがOracle WebCenter Contentのadminロールを持っている場合、またはユーザー管理権限がコンテンツ・アイテムのセキュリティ・グループに付与されている場合、ユーザーはACLに含まれていなくてもコンテンツにアクセスできます。

アクセス制御リストをコンテンツ・アイテムと関連付けるには、コンテンツ・アイテムのチェックインまたは更新時に、1つまたは複数のユーザー、グループまたはエンタープライズ・ロールを追加します。アクセス・リストに追加する各ユーザー、グループまたはロールに対し、適切な権限である読取り(R)、書込み(W)、削除(D)または管理(A)を割り当てます。アクセス制御リストの権限レベルは、コンテンツ・サーバーのセキュリティ・グループおよびアカウントに対して定義されたものと同じです。ユーザーがいずれかのアクセス・リストに追加されると、そのユーザーはコンテンツ・アイテムへアクセスする指定した権限を持ちます。

特定の権限が付与されたユーザーに対し、すくなくとも次のいずれかが当てはまる必要があります。

- ユーザー名がxClbraUserListメタデータ・フィールドに適切な権限とともに表示されている。

- ユーザーがxClbraAliasListメタデータ・フィールドに適切な権限とともに表示されているグループに属している。

- ユーザーがxClbraRoleListメタデータ・フィールドに適切な権限とともに表示されているエンタープライズ・ロールの一部である。

アクセス制御リストの権限は累積です。書込みを割り当てると、自動的に読取りが割り当てられます。管理者を割り当てると、読取り、書込みおよび削除が自動的に割り当てられます。

ただし、ユーザーはコンテンツ・サーバーのセキュリティ・グループおよびアカウント(アカウントが有効な場合)経由でのアクセスのセキュリティ基準も満たしている必要があります。これらのセキュリティ基準が特定の権限を拒否する場合、ユーザーはコンテンツ・アイテムへの権限を持たなくなります。

ユーザーがコンテンツ・アイテムを検索する場合は、3つのACL権限フィールドすべてがOR条件で結合されます。結果は、AND条件により、「セキュリティ・グループ」および「アカウント」フィールドの結果と結合されます。検索を実行するユーザーは、コンテンツ・アイテムを検索するためには、セキュリティ・グループ、アカウント(アカウントが有効にされている場合)、および3つのACLフィールドのうち少なくとも1つに対する読取り権限を保持している必要があります。

20.4.1 空のアクセス制御リスト・フィールド

すべてのユーザー・アクセス・リスト、グループ・アクセス・リストおよびロール・アクセス・リスト・フィールドが空の場合、デフォルトで権限がすべてのユーザーに付与されます。ユーザー・アクセス・リストおよびグループ・アクセス・リスト・フィールドだけが空白の場合(およびRoleEntityACLコンポーネントが有効化されていないためにロール・アクセス・リストが存在しない場合)、権限がすべてのユーザーに付与されます。この動作は、デフォルトでTRUEに設定される、AccessListPrivilegesGrantedWhenEmpty変数により構成されます。

AccessListPrivilegesGrantedWhenEmpty変数がFALSEに設定されている場合、すべてのアクセス制御リストが空白だと、権限はadminロールを除くすべてのユーザーに対して拒否されます。adminロールを付与されていないユーザーがドキュメントをチェックインできるようにするには、読取り/書込み(RW)権限を含むアクセス制御リストのロール(testroleなど)がユーザーに付与されており、ドキュメントのチェックイン時にこのロールを指定する必要があります。

注意:
コンテンツ・サーバー・インスタンスがリリース10gからアップグレードされた場合、空のアクセス制御リストは、リリース11gでは異なった動作をすることに注意してください。リリース10gおよびそれ以前では、AccessListPrivilegesGrantedWhenEmpty=falseの構成と同等です。リリース11gのデフォルトは、AccessListPrivilegesGrantedWhenEmpty=trueです。

21 追加のコンテンツ・サーバーのセキュリティ接続の管理

この章では、コンテンツ・サーバーで使用する追加のセキュリティ接続オプションについて説明します。

この章の内容は、次のとおりです。

- プロキシ接続

- 資格証明マッピング

- コンテンツ・サーバーへのセキュアな接続

- HTTPプロトコルを使用した接続

21.1 プロキシ接続

プロキシ接続、またはコンテンツ・サーバー・インスタンス間の接続を使用すると、次の機能により、コンテンツ・サーバーのセキュリティ・レベルが向上します。

- あるコンテンツ・サーバー・インスタンスから別のコンテンツ・サーバー・インスタンスへのセキュリティ資格証明マッピング

- コンテンツ・サーバー・インスタンスへのセキュアな名前付きパスワード接続(パスワードで保護されたプロバイダ接続)

- コンテンツ・サーバー・インスタンス間のHTTPプロトコルによる通信

名前付きパスワード接続とHTTPベースのコンテンツ・サーバー接続の両方が使用できますが、多くの場合、どちらかのタイプの接続を使用する方が便利です。どちらのタイプの接続でも、資格証明マッピングによりセキュリティが向上します。

注意:
1つのサイトに複数のContent Serverインスタンスが存在できますが、各Content Serverインスタンスはその固有のOracle WebLogic Serverドメインにインストールされる必要があります。

コンテンツ・サーバーでは、ProxyConnectionsコンポーネントはデフォルトでインストールされ、有効化されています。典型的なプロキシ接続の使用例には、次のものがあります。

- HTTPまたはHTTPSを介してコンテンツ・アイテムのアーカイブ・レプリケーションの実行を可能にするため。たとえば、ある企業が別の企業買収したが、情報を共有するための共通のインフラストラクチャがないとします。どちらの企業もSecure Sockets Layer (SSL)接続を使用してインターネットに接続しています。この企業で、2つのサイト間のコンテンツを共有するとします。プロキシ接続を使用してこの企業のサーバー間にセキュアなインターネット接続を設定できるため、コンテンツには一方のサイトから安全にアクセスでき、もう一方のサイトでレプリケートおよびアーカイブできます。

- ターゲット・プロキシ接続に対して名前付きパスワードを使用することにより、コンテンツ・サーバー・インスタンスへのアクセス制限を向上させるため。たとえば、ある企業が、1つのコンテンツ・サーバー・インスタンスから別のコンテンツ・サーバー・インスタンスへの接続に追加のセキュリティを適用するとします。名前付きパスワードを使用すると、受信接続によるアクセスを、管理者はプロキシ接続および名前付きパスワードが事前に設定されている接続に制限できます。

21.2 資格証明マッピング

資格証明マップは、コンテンツ・サーバー・インスタンスにより使用される資格証明の、リモート・システムで使用される資格証明へのマッピングであり、これにより、そのシステムでの指定されたリソースへの接続方法がコンテンツ・サーバー・インスタンスに通知されます。管理者はユーザー、ロールおよびアカウントに複数の資格証明マップを作成できます。資格証明マッピングは、プロキシのシナリオで有用な場合があります。たとえば、あるコンテンツ・サーバー・インスタンスで作成されたユーザー、ロールまたはアカウントの資格証明を、別のコンテンツ・サーバー・インスタンスのユーザー、ロールまたはアカウントにマップできるため、ユーザーは、検索などのタスクのために1つまたは複数のコンテンツ・サーバー・インスタンスに関する情報に対して制御されたアクセスが可能になります。

この項の内容は次のとおりです。

- 第21.2.1項「資格証明マッピングについて」

- 第21.2.2項「資格証明値」

- 第21.2.3項「アカウントおよびロールの一致」

- 第21.2.4項「プロキシ資格証明マップ」

- 第21.2.5項「資格証明マップの作成」

21.2.1 資格証明マッピングについて

資格証明マップを作成する際には、マップの一意識別子、およびユーザー、ロールやアカウントの固有の資格証明値を入力します。プロキシ接続では、ユーザー資格証明が入力値に一致すると、出力値で指定した資格証明がユーザーに付与されます。ユーザー資格証明は次の順序で評価されます。

1. すべてのロール。

2. すべてのアカウント。

3. ユーザー名。

変換の実行後、ユーザーは入力値から正常にマップされた属性値のみを持ちます。

資格証明マップを作成したら、送信プロバイダの構成時に、名前付きパスワード接続とともに資格証明マップを指定できます。ユーザー・プロバイダ(LDAPなど)の構成時にも資格証明マップを指定できます。

LDAPプロバイダのデフォルトの動作では、guestロールは自動的にユーザーに割り当てられません。

資格証明マッピングの実装は、Oracle WebCenter ContentのWebサーバー・プラグインで複製されます。最適なパフォーマンスを実現するために設計および実装されているため、マッピングでの変更はすぐに適用されます(変更内容はキャッシュされ、最大で2、3分間はコンテンツ・サーバー・インスタンスに反映されない、NTやNT管理者インタフェースを使用するADSIユーザー記憶域のパフォーマンスと比較できます)。

注意:
コンテンツ・サーバー・インスタンス以外の資格証明マッピングの詳細は、『Oracle WebLogic Serverセキュリティ・プロバイダの開発』の資格証明マッピング・プロバイダに関する項を参照してください。

21.2.2 資格証明値

ロールまたはユーザー名の場合、資格証明の入力値は、完全一致である場合に一致します。入力アカウント値は、フィルタの場合を除き、いずれかのユーザー・アカウントに接頭辞がある場合に一致します(第21.2.3項「アカウントおよびロールの一致」を参照してください)。たとえば、次の資格証明値により、adminロールを持つすべてのユーザーがguestロールを持つユーザーに変更されます。

admin, guest

次の表に、資格証明値の基本的な構文を示します。

値

接頭辞または順序

例

ユーザー名

&

&name

ロール

admin

Account

@

@marketing

空のアカウント

@#none

@#none

すべてのアカウント

@#all

@#all

値を無視または値をコメントアウト

#

#comment

資格証明マップが割り当てられていない場合は、どの資格証明がデフォルトで適用されているかを表示できます。変更せずにすべてをマップする次のマッピングを使用します。このマッピングでは、まずすべてのロールがフィルタされ、次にすべてのアカウントがフィルタされます。

|#all|,%%
@|#all|,@%%

マッピング構文の詳細は、第21.2.3項を参照してください。

注意:
資格証明マップに、匿名ユーザーがコンテンツ・サーバーWebサイトに接続する際に付与される最小限の権限も割り当てられていない場合、ログイン済のユーザーが異常な動作を体験する可能性があります。たとえば、ACCESS DENIEDというレスポンスを受信するブラウザでは、一般的に匿名ユーザーに戻ります。特に、ドキュメントにアクセスできる場合やできない場合に、予期しない動きが発生する可能性があります(その場合に、ブラウザがユーザーの認証資格証明を送信するかしないかによって異なります)。NTLM認証は定期的に更新する必要があるため、これは特にNTLM認証に当てはまります。

21.2.3 アカウントおよびロールの一致

アカウントおよびロールの一致には特別なフィルタを使用できます。たとえば、アカウント・フィルタの構文は、アカウント値を接頭辞@|で開始し、|で終了することで指定されます(たとえば@|accountname|)。パイプ(|)はフィルタを介して値を処理するコマンド・リダイレクト演算子を表します。プロキシ接続の場合は、空白で区切られたアカウントのリストが指定されます。アカウントをダッシュ(-)で開始して、負の値を指定することもできます。ダッシュで開始されていない指定した任意のアカウント文字列がユーザー・アカウントの接頭辞である場合や、ダッシュで開始されているすべてのアカウント文字列がそのユーザー・アカウントの接頭辞ではない場合に、フィルタが一致します。

注意:
フィルタでは、アカウント@#allはマップされません。all accountsというアカウント値を明示的にマップするには、@#all, @#allマッピングを使用する必要があります。

ロールは、フィルタの先頭から@記号を削除することで、同じルールを使用して、マップできます。たとえば、次の入力値では、接頭辞visitorで開始されるロールを除くすべてのロールが取得されます。#allという式では、すべてのロールが一致することに注意してください。

|#all -visitor|, %%

21.2.3.1 入力値の参照

出力値の特別な配列%%を使用して、入力値を参照できます。たとえば、次のマッピングでは、接頭辞financialで開始されないすべてのアカウントは同じアカウントにマップされますが、先頭に接頭辞employee/が追加されます。

@|#all -financial|, @employee/%%

ユーザーのアカウントがmarketingの場合、マッピング後、ユーザーのアカウントはemployee/marketingになります。

21.2.3.2 権限レベル

カッコで囲まれた文字"R"、"W"、"D"、"A"を使用したアカウント指定に準拠することで、出力値のアカウントに特定の権限レベル(読取り、書込み、削除、すべて)を付与できます。たとえば、次の構文で、すべてのアカウントのすべての権限レベルを読取り権限に変更できます。

@|#all -financial|, @employee/%%(R)

21.2.3.3 置換

置換%%を適用する前に、接頭辞を削除すると便利な場合があります。構文%%[n]を使用して、置換のオフセットを指定できます。ここで、nは、%%式に入力値をマップする前に使用する開始のオフセットです。オフセットはゼロベースであるため、%%[1]では入力値の先頭の文字が削除されます。たとえば、すべてのロールから接頭辞DOMAIN1\を削除するには、次の式を使用します。

|domain1\|, %%[8]

この機能を使用して、接頭辞marketing/で開始されるすべてのアカウントを、接頭辞org1/mktで置換することもできます。この場合の式は次のようになります。

@|marketing/|, @org1/mkt/%%[10]

21.2.3.4 特殊文字

入力値で指定するのが困難な一般的ではない文字が、ロールに含まれている場合があります。エスケープ・シーケンス%xx(ここでxxはASCIIの16進数)を使用して、入力値に文字を指定できます。たとえば、#,& |@(シャープ、カンマ、アンパサンド、スペース、パイプ、アット)で始まるすべてのロールを取得するには、次の式を使用します。

|%35%2c%26%20%7c%40|, %%

21.2.4 プロキシ資格証明マップ

プロキシ資格証明マップは、最初の資格証明がユーザーに割り当てられた後に適用されます。このマッピング例では、(LDAPグループではなく)ユーザーに割り当てられたアカウント値が使用され、同じアカウント値が付与されています。

@|Public|,         @Public

(R)などの接尾辞を適用しない場合、マッピング前にアカウントが付与されていた権限はすべて、マッピング後も保持されます。LDAPマップによって割り当てられるデフォルトの権限から権限を降格する場合は、次の構成を試します。

@|Public|,         @%%(R)

%%は、接頭辞Publicと一致した入力アカウント値を表します。たとえば、ユーザーのアカウントがPublic/mysuffixであり、|Public|接頭辞フィルタによって取得される場合、%%の値はPublic/mysuffixになります。

21.2.5 資格証明マップの作成

資格証明マップを作成する手順は、次のとおりです。

1. 新しいブラウザ・ウィンドウを開き、システム管理者としてコンテンツ・サーバー・インスタンスにログインします。

2. 「管理」→「資格証明マップ」を選択します。

3. 「資格証明マップ」ページに、作成する資格証明マップの一意の識別子を入力します。
コンテンツ・サーバー・インスタンスへの接続に、複数の名前付きパスワード接続を使用できます。それぞれの名前付きパスワード接続に、異なる資格証明マップを使用できます。

4. 値を2列で入力します。列はカンマで区切り、値の各行の間には改行を使用します。最初の列では入力値を、2番目の列では出力値を指定します。

5. 「更新」をクリックします。

NT統合を使用して取得したロールおよびアカウントに資格証明マップを適用するには、コンテンツ・サーバー構成エントリExternalCredentialsMapを、適用する資格証明マップの名前に設定します。

21.3 コンテンツ・サーバーへのセキュアな接続

コンテンツ・サーバー・インスタンスへのセキュアな接続は、着信リクエストにパスワードの保護を作成することでサポートできます。パスワードを保護すると、コンテンツ・サーバー・インスタンスは別のコンテンツ・サーバー・インスタンスと通信できます。

この項の内容は次のとおりです。

- 第21.3.1項「名前付きパスワード接続について」

- 第21.3.2項「プロキシ接続データのガイドライン」

- 第21.3.3項「プロキシ接続の作成」

21.3.1 名前付きパスワード接続について

「プロキシ接続の認証/認可情報」画面を使用して、名前付きパスワードを作成できます。これは特定の接続に名前で割り当てるパスワードです。各名前付きパスワードを関連付けられるのは、コンテンツ・サーバー・インスタンスへのダイレクト・ソケット通信と、コンテンツ・サーバー・インスタンスのWebサーバー(HTTPフィルタ)を制御することで実行される任意の通信の両方に対するホストおよびIPアドレス・フィルタです。外部エージェント(別のコンテンツ・サーバー・インスタンスのWebサーバーなど)でコンテンツ・サーバー・インスタンスと通信する必要がある場合、名前付きパスワード接続を使用できます。名前付きパスワード接続は、資格証明マップにも関連付けられるため、コンテンツ・サーバー・インスタンスにアクセスするユーザーの権限を引き下げることや変更することができます。

プロキシ接続のエントリ・フィールドは、送信ソケット・プロバイダおよび送信HTTPプロバイダを構成するためのフォームに提供されており、名前付きパスワード接続を指定できます(インスタンスに選択されているプロバイダを表示するには、「管理」、「プロバイダ」の順に選択します)。

パスワードは、クライアント側の許可されているホストおよびIPアドレス・ワイルドカード・フィルタを使用してハッシュされます(SHA1メッセージ・ダイジェストを使用)。これは、格納されているパスワードのコピーが露呈した場合、ホストおよびIPアドレス・フィルタの両方を満たすクライアントからのアクセスのみが許可されることを意味します。

パスワードに有効期限を実装する場合は、関連する様々なサーバーの時計がかなり正確(最低数分以内)に同期している必要があります。

注意:
すべてのパスワードは、サーバーに送信される前にタイムアウト値でハッシュされます。これは、サーバーへの通信中にパスワード値が露呈した場合、有効期限(リクエストが発行された後の約15分)までの間のみパスワードが使用できることを意味します。また、前述した同じソース・ホストおよびIPアドレスからの再生攻撃でのみ、パスワードは使用できます。ファイアウォールで保護された内部ホストおよびIPアドレスが使用されていない場合は、その実行した攻撃者が主要なDNSサーバーのいずれかをハイジャックすることで、ホストおよびIPアドレスが偽装される可能性があります(少なくとも数件発生しています)。

21.3.2 プロキシ接続データのガイドライン

「プロキシ接続の認証/認可情報」ページに入力するデータにより、外部エージェントがコンテンツ・サーバー・インスタンスに接続する際に使用可能な異なるパスワードを定義できます。様々な理由 (メッセージ・ダイジェスト・アルゴリズムはクリア・テキスト・パスワードが使用されていないなど)で クライアントに対して利用できない可能性があるため、 外部エージェントに各ユーザーのパスワードの入力を要求するのではなく、プロキシ接続を使用します。これにより、ユーザーは単一の名前付き接続パスワードを使用して認証できます。各名前付きパスワード接続をルールにリンクし、コンテンツ・サーバー・インスタンスに接続できるホストを制限したり、ユーザーに付与される権限を制御できます。各名前付きパスワード接続は一意に識別されますが、呼出し側のエージェントはパスワードとともに識別子を指定する必要があります。

ホスト名およびIPアドレス・フィルタは、コンテンツ・サーバー・インスタンスへのダイレクト・ソケット接続を実行する際に、どのホスト名またはIPアドレスで名前付きパスワード接続の使用が許可されているかの判断に使用されます。フィルタの定義ルールは、システム・プロパティ・エディタに定義されているルールと同様です( 0または複数の一致を表す*およびいずれかの一致を表す| のワイルドカード記号を使用して、柔軟なルールを作成できます)。エントリが空の場合には、ターゲット属性の制限はありません (次の2つのフィールドのどちらが関連するかによって、クライアントのホスト名またはIPアドレスのいずれかになります)。

「プロバイダ」ページを介して、次の2つのオプションが実装されます。

- 送信プロバイダを追加する場合には、名前付きパスワード接続の使用、および(Webアクセスとセキュリティがリモート・サーバーを介して制御されるように)プロバイダを接続サーバーにするかどうかの選択のオプションがあります。

- ユーザー・プロバイダ(LDAPなど)を追加した場合は、使用可能な資格証明マップの使用を選択できます。

資格照明マップは、「プロキシ接続の認証/認可情報」画面には定義されていません。資格証明マップの作成の詳細は、第21.2項を参照してください。

21.3.3 プロキシ接続の作成

プロキシ接続を作成する手順は、次のとおりです。

1. 新しいWebブラウザ・ウィンドウを開き、システム管理者としてコンテンツ・サーバー・インスタンスにログインします。

2. 「管理」→「接続パスワード」を選択します。

3. 「プロキシ接続の認証/認可情報」ページで、フィールドに情報を入力します。資格証明マップが存在する場合、既存の資格証明マップを使用することも、プロキシ接続用に作成することもできます。

4. 「更新」をクリックします。

21.4 HTTPプロトコルを使用した接続

管理者はHTTPプロトコルを使用してコンテンツ・サーバー・インスタンス間のプロキシ接続を作成できます。たとえば、どちらもそれぞれの機能にアクセスするためのWebサーバーを持つ、2つのコンテンツ・サーバー・インスタンスを作成できます。多数のユーザーがコンテンツ・サーバー・インスタンスのいずれかにある情報へのアクセスにWebブラウザを使用する必要があるが、すべてのユーザーがそのサーバーに直接アクセスできるわけではない場合に、この機能は便利です。

コンテンツ・サーバー・アーカイブの転送には、HTTPプロトコルも便利です。HTTPプロバイダは、Secure Sockets Layer (SSL)を使用したHTTPSプロトコルと連携し、2つのコンテンツ・サーバー・インスタンス間のセキュアな通信を可能にします。

この項の内容は次のとおりです。

- 第21.4.1項「コンテンツ・サーバー接続用のHTTPプロトコルの使用について」

- 第21.4.2項「HTTPプロバイダの構成」

21.4.1 コンテンツ・サーバー接続用のHTTPプロトコルの使用について

管理者は、「プロバイダ」ページで構成可能なhttp送信プロバイダを実装でき、このプロバイダにより、コンテンツ・サーバー・インスタンス間の通信が可能になります。

http送信プロバイダの追加を選択した場合、次の追加のオプションがあります。

- CGI URLの指定

- 名前付きパスワード接続およびクライアントIPフィルタの指定

http送信HTTPプロバイダの選択を表示するには、コンテンツ・サーバー・ポータルから「管理」、「プロバイダ」の順に選択します。

コンテンツ・サーバー・インスタンス間にプロキシ接続を作成するには、いくつかの準備が必要です。コンテンツ・サーバー・インスタンスで、Webレイアウト・ディレクトリに、同じ相対Webルートを使用することはできません。サーバー間の追加のナビゲーション・リンクを提供するには、コンポーネント・アーキテクチャを一部変更する必要があります。

WebサーバーでSSLが使用され、その他のサーバーのフロント・エンドでHTTPが使用されている状態で、コンテンツ・サーバー・インスタンスを設定した場合、ユーザーがWebブラウザでその他のサーバーのURLを変更して、最初のサーバーへのアクセスを試行すると、HTTPS(資格証明が必要)とHTTP間の差異が原因で、エラーが発生する可能性があります。この問題を解決するには、コンテンツ・サーバーとともに入手可能なBrowserUrlPathコンポーネントを使用してください。詳細は、第22.2項を参照してください。

21.4.2 HTTPプロバイダの構成

HTTPプロバイダを構成する手順は、次のとおりです。

1. 最初のコンテンツ・サーバー・インスタンスにhttp送信プロバイダを追加します。

1. ブラウザで「管理」ページに移動し、「プロバイダ」をクリックします。

2. htt送信プロバイダ・タイプの横の「追加」をクリックします。

3. http送信プロバイダの必要な情報を入力します。詳細は、送信Httpプロバイダ・ページの表を参照してください。

2. 前の手順で指定した名前付きパスワード接続および接続パスワードを使用する2番目のコンテンツ・サーバー・インスタンスにプロキシ接続を作成します。

1. このサーバーで、「管理」、「接続パスワード」の順に選択します。

2. 接続に関する情報を入力します。IPアドレス・フィルタ・エントリには最初のサーバーのIPアドレスが含まれている必要があります。

22 コンテンツ・サーバーの通信のカスタマイズ

この章では、コンテンツ・サーバー・インスタンスへのアクセスおよび通信をカスタマイズする方法に関する情報を提供します。

この章の内容は、次のとおりです。

- ログイン/ログアウトのカスタマイズ

- ブラウザURLのカスタマイズ

- 拡張ユーザー属性

22.1 ログイン/ログアウトのカスタマイズ

ExtranetLookコンポーネントを使用して、Webサーバーが発行したエラーと問題のページを介してOracle WebLogic Serverユーザー・ストアにより認証されないユーザーに対するインタフェースを抑制して、ユーザー・アクセスをカスタマイズできます。インタフェースの変更方法の詳細は、『Oracle WebCenter Contentでの開発』を参照してください。

ExtranetLookコンポーネントはデフォルトでコンテンツ・サーバーとともにインストールされ、無効化されます。このコンポーネントを使用するには、拡張コンポーネント・マネージャを使用して有効化する必要があります。

22.2 ブラウザURLのカスタマイズ

BrowserUrlPathコンポーネントは、コンテンツ・サーバーおよびWebサーバーの特定の構成で使用されるURLパスの特定をサポートします。このコンポーネントはデフォルトでコンテンツ・サーバーにインストールされ、無効化されています。このコンポーネントを使用するには、拡張コンポーネント・マネージャを使用して有効化する必要があります。

このコンポーネントはOracle WebLogic Serverドメインにデプロイされ、ロード・バランサの背後に配置されたコンテンツ・サーバー・インスタンスに対して有効です。

この項の内容は次のとおりです。

- 第22.2.1項「BrowserUrlPathのカスタマイズについて」

- 第22.2.2項「影響を受けるIdocスクリプト変数および関数」

- 第22.2.3項「URLパスの判断」

- 第22.2.4項「絶対フル・パスの計算の変更」

22.2.1 BrowserUrlPathのカスタマイズについて

BrowserUrlPathコンポーネントにより、特定のIdocスクリプト変数および関数のオーバーライド、特定の変数に対する計算の追加、およびURLパスを判断するための追加の構成エントリの提供が行われます。BrowserUrlPathコンポーネントは、コンテンツ・サーバーのネイティブ11gインタフェース用の「トレイ」および「トップ・メニュー」レイアウトでのみサポートされます。

- 異なるWebサーバー・フロント・エンドを使用してシステムを構成できます。一方のフロント・エンドにはHTTPを使用し、もう一方にはHTTPSを使用できるため、HTTPおよびHTTPSを使用して複数のWebサイトから同時にコンテンツ・サーバー・インスタンスにアクセスできます。BrowserUrlPathコンポーネントを適用して、コンテンツ・サーバー・インスタンスでどちらのタイプのアクセスも処理できるようにする必要があります。

- HTTPホスト・ヘッダーとして転送されるロード・バランサを使用している場合は、BrowserUrlPathコンポーネントを適用する必要があります。

BrowserUrlPath構成変数は、IntradocDir/config/config.cfgファイルに配置できます。

注意:
BrowserUrlPathコンポーネントには変数を使用した拡張構成が必要です。変数を変更する前に構成をバックアップする必要がある場合があります。

一般的なシナリオでは、Webサーバーにより、2つの重要な情報がコンテンツ・サーバー・インスタンスに転送されます。

- HTTP_HOST: ブラウザにより送信されるホスト・ヘッダー。ブラウザのアドレス・バーに表示される際にホストを識別します。

- SERVER_PORT: コンテンツ・サーバー・インスタンスへの接続時にブラウザにより使用されるポート。

2つの重要な機能には、ブラウザ・ベースのフル・アドレスが使用されます。

1. コンテンツ・サーバー・インスタンスの「トレイ」レイアウトのサイド・フレームにおけるURLの自動作成。特に、サイドのミニ検索には、相対URLではなく、フルURLを予測する必要があります。

2. PDFドキュメントを強調表示するセカンダリURL (PDFのURLの後に続く#xml-http...の部分)。

BrowserUrlPathコンポーネントにより、追加の構成なしで特定の変数の機能が強化され、SERVER_PORTの値が433の場合、コンポーネントではプロトコルはHTTPではなくHTTPSであると推測されます。同様に、SERVER_PORTの値が433ではない場合、コンポーネントではブラウザがHTTPSではなくHTTPを使用してリクエストを発行したと推測されます。この拡張により、SSL (HTTPS)および非SSL Webサーバー(HTTP)の両方から、同じコンテンツ・サーバー・インスタンスにアクセスできます。

このコンポーネントにはWebDAVアクセスに関する特別な機能もあります。構成エントリWebDavBaseUrlが追加されたため、動的に使用されます(ホストおよびプロトコルが絶対パス・ルールを使用して変更されます)。

注意:
WebDAVアクセスの機能により、一部のコンテンツ・サーバーのページにおけるCHECKOUTおよびOPEN関数の動作、およびSite Studioクライアントの一部の動作が変更されます。

22.2.2 影響を受けるIdocスクリプト変数および関数

BrowserUrlPathコマンドは、次のIdocスクリプト変数および関数の計算をオーバーライドします。

- HttpBrowserFullCgiPath

- HttpWebRoot

- HttpCgiPath

- HttpAdminCgiPath

- HttpImagesRoot

BrowserUrlPathコンポーネントにより、次の変数に計算が追加されます。

- HttpBrowserFullWebRoot: ユーザーが現在使用しているブラウザのアドレス・バーから提供される値を使用して、現在のコンテンツ・サーバー・インスタンスのWebルートへのフルURLパスを定義します。この変数は、Webルート用であることを除きHttpBrowserFullCgiPathに似ています。

- HttpAbsoluteWebRoot: 現在のコンテンツ・サーバー・インスタンスのWebルートへの汎用フルURLパスを定義します。HttpBrowerFullWebRootのパスとは異なるプロトコルまたはホスト名を使用できます。たとえば、ユーザーがホスト名に対するIPアドレスを指定した場合、HttpBrowserFullWebRoot変数ではそのIPアドレスが使用されますが、HttpAbsoluteWebRoot変数では無視され、内部的に構成された適切なホスト名が使用されます。

- HttpAbsoluteCgiPath: 現在のコンテンツ・サーバー・インスタンスの汎用フル動的ルートURLを定義します。これはコンテンツ・サーバー・インスタンスの動的コンテンツを呼び出すWebサーバーでプラグイン・コードを実行するパスです。HttpBrowserFullCgiPathのパスとは異なるプロトコルまたはホスト名を使用できます。たとえば、ユーザーがホスト名のIPアドレスを指定した場合、HttpBrowserFullCgiPath変数ではそのIPアドレスが使用されますが、HttpAbsoluteCgiPath変数では無視され、内部的に構成された適切なホスト名が使用されます。

ブラウザ・パス変数HttpBrowserFullCgiPathおよびHttpBrowserFullWebRootの場合、ユーザーが現在使用しているブラウザのプロトコル(HTTPとHTTPS)、ポート番号およびホスト名は実装コードにより判断されます。この判断は、Webサーバーがリクエストで何を受信するかに基づいています。

22.2.3 URLパスの判断

BrowserUrlPathコンポーネントでは、ブラウザがURLパスを判断する際にそれを推測するための次の構成エントリがサポートされています。

- HttpIgnoreWebServerInternalPortNumber: trueに設定すると、SERVER_PORTパラメータを使用できなくなります。このエントリは、SERVER_PORTがブラウザにより使用されるポートではなく、Webサーバーと通信するためにロード・バランサで使用されるポートであるロード・バランシングのシナリオに便利です。このエントリを有効にすると、コンテンツ・サーバー・インスタンスは、BrowserUrlPathコンポーネントなしでは、ブラウザがWebサーバーへのアクセスに使用したポートを判断できなくなります。追加のBrowserUrlPath構成がない場合、この変数が原因で、同じコンテンツ・サーバー・インスタンスへのSSLおよび非SSLアドレスの両方をサポートできなくなります。この変数を使用すると、ロード・バランシング・サーバーで、内部Webサーバーが実際にリクエストへの応答の送信に使用しているのとは異なるポート番号が使用されるというロード・バランシング構成の問題を防ぐことができます。

- HttpIgnoreServerNameForHostName: trueに設定すると、HTTP_HOSTパラメータが欠落している場合には、通常、コンテンツ・サーバーによりパラメータSERVER_NAME (Webサーバーの自己識別)が検索されるというフォールバック・ロジックが無効化されます。

- HttpBrowserSSLPort: この構成エントリは、SERVER_PORTエントリがコンテンツ・サーバー・インスタンスと通信するWebサーバーに転送される場合にのみ使用します。このエントリは、SERVER_PORTパラメータと比較することで、リクエストがHTTPSとHTTPのいずれであるかを判断する際に使用されます。デフォルトのSERVER_PORT値は443です。HTTPSを使用するが、443以外のポートを使用する場合は、使用するHTTPSポート番号をこのエントリを使用して設定する必要があります。

- HttpBrowserUseIsSslCookie: SSLを使用するかどうかが特定されていることを確認するためにCookieを調査する必要がある場合は、このエントリをtrueに設定します。

- HttpBrowserIsSslCookieName: このエントリはHttpBrowserUseIsSslCookieエントリが有効化されている場合にのみ使用します。ブラウザでSSLが使用されているかどうかをサーバーが判断するために使用するCookieの名前にこのエントリを設定します。デフォルトはCookie名UseSSLです。Cookieの値は1または0(ゼロ)です。この名前のCookieが存在する場合、SSLを使用するかどうかを判断するためのその他のルールより優先されます。

- HttpBrowserUseHostAddressCookie: trueに設定すると、ブラウザのフル・ホスト名(プロトコルおよび相対Webアドレスの間の部分)の判断にCookieを使用することが指定されます。

- HttpBrowserHostAddressCookieName: このエントリはHttpBrowserUseHostAddressCookieが有効化されている場合にのみ有効化されます。このエントリは、サーバーがブラウザの現在のホスト名であると判断した内容の確認に使用されるCookie名の指定に使用します。プロトコルのホスト名の部分には、ポート番号が含まれる場合があります。たとえば、HttpbrowserHostAddressCookieName=myhost:81では、Webポート81を使用するホストmyhostが指定されています。このCookieを使用する場合、myhost:433を使用するとhttps://myhost/%rest-of-url%に変換されるため、HttpBrowserUseIsSslCookieを有効化する必要はありません。

22.2.4 絶対フル・パスの計算の変更

BrowserUrlPathコンポーネントでは、絶対フル・パスの計算方法を変更するため次の構成エントリがサポートされています。ブラウザで別のURLが示されていても、固有のホスト名とプロトコルを使用する方がよい電子メールに便利です。このパスは絶対または汎用パスとみなされます。

- HttpBrowserAbsoluteUrlHasRelativeSSL: trueに設定すると、コンテンツ・サーバー・システムがユーザーのブラウザで現在使用されていると判断した内容に応じ、HTTPからHTTPS (config.cfgファイルでUseSSLが有効化されている場合はHTTPSからHTTP)に変更するために、「コンテンツ情報」ページでURLを計算できるようになります。HTTPとHTTPSを変更すると複数の電子メールの宛先リンクに対して電子メールの本文を作成するためのURLの計算も変更されます。この構成は自動的に生成される電子メールには影響しません。

- HttpBrowserAlternateWebAddress: 代替の絶対ホストWebアドレス(ホスト名とオプションでポート番号)を指定します。たとえば、HttpBrowserAlternateWebAddresss=host_name:447です。このWebアドレスは、現在のSSLの選択がコンテンツ・サーバー・インスタンスのデフォルトと異なる場合に、絶対パスの計算に使用されます。この構成は自動的に生成される電子メールには影響しません。

- HttpBrowserAbsoluteUrlUsesBrowserPath: trueに設定すると、ブラウザ・パス情報が計算される場合、絶対パスにブラウザ・パスが使用されます。これにより、基本的に、バックグラウンド・アクティビティ(電子メール通知の送信など)を除く絶対パスが無効化されます。

22.3 拡張ユーザー属性

ExtendedUserAttributesコンポーネントにより、管理者は拡張セキュリティ属性をコンテンツ・サーバー・ユーザーに追加できます。拡張セキュリティ属性は既存のユーザー属性とマージされ、ユーザーの管理に柔軟性を追加できます。たとえば、内部の設定を実行する必要なく、ロールおよびアカウント属性を外部LDAPユーザーに追加できます。また、ロールおよびアカウント属性を、ベース・ユーザー属性とは別に、カスタマイズされたアプリケーション用のユーザーに追加できます。

コンテンツ・サーバーでは、ExtendedUserAttributesコンポーネントはデフォルトでインストールされ、有効化されています。ExtendedUserAttributesコンポーネントにインストールされるサービスについては、『Oracle WebCenter Contentサービス・リファレンス』に記載されています。

この項では、拡張ユーザー属性の次のトピックについて説明します。

- 第22.3.1項「ExtUserAttribInfo結果セット」

- 第22.3.2項「拡張ユーザー属性の構成変数」

これらのリソースに加えて、拡張ユーザー属性用のデータを収集するために使用できる追加された問合せがあります。問合せは、コンポーネント・ウィザードまたはWC_CONTENT_ORACLE_HOME/ucm/idc/components/ExtendedUserAttributes/resources/extendeduserattributes_query.htmファイルで検索することにより表示できます。

22.3.1 ExtUserAttribInfo結果セット

ExtUserAttribInfoは、コンテンツ・サーバーが拡張ユーザー属性を処理するために使用する結果セットです。これは標準のユーザー属性の処理に使用されるUserAttribInfo結果セットと同様で、いくつかの追加の情報を使用します。

この結果セットには3つの列があります。1つの行につき1つの属性、または1つの行に複数の属性(アプリケーションごと)を指定できます。次の列が含まれます。

- dUserName: 属性が記載されているユーザー。

- dApplication: 属性がリンクされている先のアプリケーション

- AttributeInfo: 属性情報。これは3アイテムからなるカンマ区切りエントリです。

- 属性タイプ: 通常はロールまたはアカウントのいずれか。セキュリティ・グループまたはアカウントがユーザーに対して定義されているかどうかによります。

- 属性名: ロールまたはアカウントのタイトル

- 権限の属性: ユーザーに付与された権限の定義。UNIXの規則に従い権限が定義されます。

- 1: 読取り権限

- 2: 書込み権限

- 4: 削除権限

- 8: 管理

たとえば、エントリrole,contributor,3では、読取りおよび書込みのユーザー権限をコントリビュータ・セキュリティ・グループに付与します。

複数のAttributeInfoエントリをカンマで区切って1つの行に追加できます。たとえば、このエントリは2つの属性をAttributeInfo行に追加します: role,guest,15,account,\#all,15

次にこの結果セットの例を示します。

@ResultSet ExtUserAttribInfo
3
dUserName
dApplication
AttributeInfo
jsmith
appl
role,contributor,15
jsmith
app2
account,abc,15,account,xyz,15
@end

22.3.2 拡張ユーザー属性の構成変数

次の構成変数はコンテンツ・サーバーに追加でき、デフォルト属性と連携する場合に便利です。

- DefaultAttributesCacheTimeoutInSeconds: デフォルトの属性キャッシュがアクティブでいられる長さ(デフォルトは600)を定義します。

第VI部

システム移行およびアーカイブの管理

この部では、Oracle WebCenter Contentシステムとの間でOracle WebCenter Contentシステムのコンテンツ情報を移動する方法を説明します。アクティビティには、アーカイブからまたはアーカイブへの情報の移動、アーカイブまたはシステム・インストール間での情報の移動、およびその他のシステムからOracle WebCenter Contentへの情報の移動が含まれます。

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

- 第23章「システム移行およびアーカイブの理解」

- 第24章「システム構成の移行」

- 第25章「アーカイブ、コレクションおよびバッチ・ファイルの管理」

- 第26章「アーカイブのデータのエクスポート」

- 第27章「アーカイブからのデータのインポート」

- 第28章「ファイルの転送」

- 第29章「ファイルのレプリケート」

- 第30章「コントリビューション・フォルダのアーカイブ」

- 第31章「コントリビューション・フォルダ構造のアーカイブ」

- 第32章「FoldersへのFolders_gの移行」

- 第33章「Folders構造の移行」

- 第34章「アーカイブおよび移行の戦略」

- 第35章「アーカイバ・レプリケーションの例外の使用」

23 システム移行およびアーカイブの理解

この章では、Oracle WebCenter Contentシステムのメタデータ、コンテンツおよび構造を移行およびアーカイブ(バックアップ)するために使用される様々な方法とソフトウェア・ツールについて説明します。

この章の内容は、次のとおりです。

- 移行ツールおよびコンポーネントの概要

- 構成移行ユーティリティ

- アーカイバ・アプリケーション

- フォルダのアーカイブ・アプリケーション

- フォルダ構造のアーカイブ・アプリケーション

- ArchiveReplicationExceptionsアプリケーション

- アーカイブ・ツールの概要と比較

23.1 移行ツールおよびコンポーネントの概要

コンテンツ・サーバー・インスタンス間で情報をアーカイブして移行するために使用できるツールがいくつかあります。各ツールは用途が異なり、ほとんどは組み合せて使用できます。

- 構成移行ユーティリティ: 別のインスタンスに移行するコンテンツ・サーバー・インスタンスの要素を選択する場合に使用します。このコンポーネントは、コントリビューション・フォルダ(仮想フォルダまたはコンポーネントの名前からFolders_gとも呼ばれます)をサポートしていますが、FrameworkFoldersコンポーネント(コントリビューション・フォルダの代替コンポーネント)はサポートしません。

- アーカイバ: コンテンツ・サーバーのファイルと情報を転送および再編成するためのJavaアプレット。アーカイバを構成移行ユーティリティとともに使用すると、異なるシステム間でコンテンツ・サーバー・インスタンス全部(コンテンツを含む)を移行できます。コントリビューション・フォルダでのコンテンツの移行をサポートしていますが、Foldersでは表の移行のみをサポートします。

- フォルダのアーカイブ: コンテンツ・サーバー・インスタンスのコントリビューション・フォルダ構造を別の場所に移行する場合に使用します。

- フォルダ構造アーカイブ: コントリビューション・フォルダ構造(およびそのコンテンツ)をコピーし、そのコピーを別のコンピュータ上に作成する場合に使用します。フォルダのコピーおよび個々のコンテンツは、異なるシステム間で常に同期されます。

- アーカイバ・レプリケーションの例外: インポートが失敗してもレプリケーションを続行する場合に使用します。

23.2 構成移行ユーティリティ

構成移行ユーティリティ(ConfigMigrationUtilityコンポーネントにより提供される)は、別のインスタンスに移行するコンテンツ・サーバー・インスタンスの要素を選択する場合に使用します。このコンポーネントは、コンテンツ・サーバーではデフォルトでインストールされ、有効化されています。

注意:
ConfigMigrationUtilityコンポーネントでは、コントリビューション・フォルダ(Folders_gコンポーネントにより提供される)はサポートされますが、Folders (FrameworkFoldersコンポーネントにより提供される)はサポートされません。

概要

個々の要素(ワークフロー・トークンやコンテンツ・タイプなど)を選択することも、セクション全部(ユーザー関連のメタデータ全部、ワークフローに関連するメタデータ全部など)を選択することもできます。また、コンテンツ・サーバー・インスタンス全部をエクスポートおよびインポートすると、ある時点のコンテンツ・サーバー・インスタンスのスナップショットを作成できます。これは、システムをテストから本番に移行したり、古いバージョンのコンテンツ・サーバー・インスタンスからアップグレード・パスを取り込む場合に使用できます。移行ツールを使用すると、実働中の古いバージョンのコンテンツ・サーバー・ソフトウェアを保持しながら、新しいバージョンで新しい機能をテストできます。

各エクスポート構成は、別のシステムに構成を再作成するために必要な情報を含むバンドルとしてパッケージされます。バンドルは、他のシステムと簡単に共有できるzipファイルです。

機能

構成移行ユーティリティは、他のシステムにエクスポートするために移行バンドルを構成する場合に使用します。また、バンドルをインポート側システムにアップロードおよびインポートする場合にも使用します。次の4つの主要な機能があります。

- アップロード・バンドル: エクスポートされたバンドルのコピーを見つけて、それを受取り側のシステムで使用可能にする場合に使用します。

- 構成のバンドル: アップロードされたバンドルから構成をインポートする場合に使用します。この機能を使用すると、インポート時に選択したオプションに応じて、新しいメタデータ・フィールドが作成されるか、現在のフィールドが上書きされます。

- 構成テンプレート: 後からコンテンツ・サーバー・インスタンスにアップロードおよびインポート可能なエクスポート・バンドルを作成する場合に使用します。

- 最新のアクション: インポートやエクスポートなどの最新のアクティビティを表示したり、それらのアクティビティのログを表示する場合に使用します。

構成移行ユーティリティとアーカイバを組み合せて使用すると、既存のコンテンツ・サーバー・インスタンスのある時点でのスナップショットを作成したり、それを使用して既存システムの増分更新を追跡することができます。構成移行ユーティリティにより構成情報が取得され、アーカイバによりコンテンツが取得されます。

構成移行ユーティリティの使用方法の詳細は、第24章「システム構成の移行」を参照してください。

23.3 アーカイバ・アプリケーション

アーカイバを構成移行ユーティリティとともに使用すると、異なるシステム間でコンテンツ・サーバー・インスタンス全部(コンテンツを含む)を移行できます。

このアプリケーションでは、コントリビューション・フォルダ(Folders_gコンポーネントにより提供される)はサポートされますが、Folders (FrameworkFoldersコンポーネントにより提供される)に対しては表の移行のみがサポートされます。

注意:
アーカイバを障害回復の主要な方法として使用しないでください。データベースおよびファイル・システムの標準的なバックアップ・システムを使用してください。

注意:
アーカイバにより作成されるアーカイブにデジタル・アセット管理(DAM)のビデオおよびオーディオ・レンディションは含まれません。アーカイブには、ネイティブ・ファイル、サムネイル、ストーリーボード・サムネイルを含むzipレンディション、Web表示可能.hcspファイルは含まれますが、Inbound Refineryにより作成された追加のビデオおよびオーディオ・レンディションは含まれません。
この制約は設計上のものです。多くのビデオ・ファイルでは、アーカイブが非常に大きくなり、zipファイルの制約の2GBを超えてしまいます。また、制作インスタンスにおいては、ビデオ・レンディションを個別のファイル・システムに格納するのが普通です。

注意:
電子シグネチャ・コンポーネントとともにアーカイバを使用する場合は、必ず表アーカイブ機能を使用してEsig表を移動してください。これが行われない場合、「コンテンツ情報」ページの「シグネチャ」タブをクリックした後に、「シグネチャ情報」ページの「シグネチャ・リスティング」セクションにエラーが返されます。

概要

アーカイバは、「管理」メニューからアクセスして管理アプレットとして実行することも、スタンドアロン・ツールとして実行することもできます。スタンドアロン・ツールは次の作業のために必要です。

- コレクションを作成する場合

- 既存のプロファイルからコピーして新しいアーカイブを作成する場合

- ローカル・ファイル・システムを参照して新しいコレクションに接続する場合

詳細は、第25.2.5項「スタンドアロン・アプリケーションとしてのアーカイバの実行」を参照してください。

機能

アーカイバは、コンテンツ・サーバーのファイルと情報を転送および再編成するために使用するJavaアプレットです。アーカイバには次の4つの主要な機能があります。

- エクスポート: コンテンツ・サーバー・インスタンスのネイティブ・ファイルやWeb表示可能ファイルをコピーして、別のコンテンツ・サーバー・インスタンスにバックアップ、格納またはインポートする場合に使用します。また、コンテンツ・タイプおよびユーザー属性をエクスポートすることもできます。アーカイブにエクスポートすると、アーカイブにはエクスポートしたファイルとそのメタデータがバッチ・ファイルの形式で含まれます。

- インポート: エクスポートしたアーカイブからファイルおよびコンテンツ・サーバー情報を取得する場合に使用します。一般的にインポートは、別のコンテンツ・サーバー・インスタンスからコンテンツのコピーを取得する場合や、格納されているデータをリストアする場合に使用します。また、インポート中にメタデータ値を変更することもできます。

- 転送: 異なるコンテンツ・サーバー・インスタンス間でコンテンツをソケット経由で転送する場合に使用します。これは通常、ファイアウォールを経由して、または同じファイル・システムにアクセスできない2つのコンテンツ・サーバー・インスタンス間でコンテンツを移動またはコピーする場合に使用します。また、同じファイル・システムにアクセスできるコンテンツ・サーバー・インスタンス間でアーカイブ・ファイルを転送する場合にも、転送機能を使用できます。

- レプリケート: エクスポート、インポートおよび転送の機能を自動化する場合に使用します。たとえば、レプリケーションを使用すると、自動的にコンテンツ・サーバー・インスタンスからエクスポートし、アーカイブを別のコンピュータに転送して、別のコンテンツ・サーバー・インスタンスにインポートできます。

次の図にこれらの基本的な機能を示します。

図23-1 アーカイバの機能

23.4 フォルダのアーカイブ・アプリケーション

アーカイバを使用してフォルダの構造およびコンテンツを移動することはできませんが、フォルダのアーカイブを使用すると、コンテンツ・サーバー・インスタンスのフォルダ構造全部を別の場所に移行できます。この場合、フォルダのコンテンツはアーカイブされず、フォルダ構造のみがアーカイブされます。

フォルダのアーカイブを使用すると、Folders管理インタフェースからフォルダ階層構造を直接エクスポートおよびインポートできます。フォルダ階層全部がHDA形式でテキスト・ファイルにエクスポートされ、インポート時にはコンテンツ・サーバー・インスタンスがこのファイルを読み取ることができるようになります。

このコンポーネントでは、コントリビューション・フォルダ(Folders_gコンポーネントにより提供される)はサポートされますが、Folders (FrameworkFoldersコンポーネントにより提供される)はサポートされません。

23.5 フォルダ構造のアーカイブ・アプリケーション

フォルダ構造アーカイブ・コンポーネントはFolders_gコンポーネントとは別の製品であり、別個にインストールする必要があります。

注意:
このコンポーネントでは、コントリビューション・フォルダ(Folders_gコンポーネントにより提供される)はサポートされますが、Folders (FrameworkFoldersコンポーネントにより提供される)はサポートされません。

概要

フォルダ構造アーカイブ・コンポーネントは、Foldersコンポーネントのアーカイブ部分とともに使用できますが、その機能にはいくつかの違いがあります。

- フォルダ構造の一部を選択してエクスポートできます。フォルダ・アーカイブ機能では、フォルダ構造全部のエクスポートのみが可能です。

- 増分アーカイブを作成できます。これらは、変更されたフォルダのみが含まれるアーカイブです。組込みのフォルダ・アーカイブ機能では、すべてのアイテムを含むアーカイブが作成されます。

- アーカイブにはフォルダ構造とフォルダ・コンテンツの両方を含めることができます。フォルダ・アーカイブ機能では、フォルダ構造のみをエクスポートできます。コンテンツはエクスポートできません。

機能

このコンポーネントの主な用途は、次の3つです。

- バックアップ・ツールとしての使用。このコンポーネントを使用して、フォルダのコンテンツを含むフォルダ構造をコピーできます。

- 複製ツールとしての使用。このコンポーネントを使用すると、フォルダ構造およびコンテンツをコピーして、そのコピーを別のコンピュータ上に作成できるため、複数サーバーの設定が簡単になります。

- 同期ツールとしての使用。このコンポーネントを使用すると、フォルダおよびそのコンテンツのコピーは異なるシステム間で常に同期されます。

23.6 ArchiveReplicationExceptionsアプリケーション

ArchiverReplicationExceptionsコンポーネントは、デフォルトではコンテンツ・サーバー・インスタンスによりインストール(有効化)されます。これにより、管理者はインポートが失敗してもレプリケーションを続行できます。この処理では、失敗したインポートが取得されて例外アーカイブに挿入され、失敗したインポートが発生したことを示す電子メールが管理者に送信されます。

ArchiverReplicationExceptionsコンポーネントによりコンテンツ・アイテムが処理されるようにするには、管理者がIntradocDir/config/config.cfgファイル内に手動で構成エントリを設定する必要があります。構成変数により、特定の状況を許可したり、構成済の基準に基づいてエラー・レポートを配布するために、インポート側のコンテンツ・サーバー・インスタンスの動作をカスタマイズします。

注意:
このコンポーネントでは、コントリビューション・フォルダ(Folders_gコンポーネントにより提供される)はサポートされますが、Folders (FrameworkFoldersコンポーネントにより提供される)はサポートされません。

23.7 アーカイブ・ツールのサマリーと比較

コンテンツ・サーバーの構造、コンテンツおよびフォルダのアーカイブに使用できるツールは、それぞれ用途が異なります。これらのツールはすべて組み合せて使用できますが、場合によって適不適があります。次の表で、各ツールの長所および制限事項をまとめています。

機能

構成移行ユーティリティ(CMU)

アーカイバ

フォルダのアーカイブ

フォルダ構造アーカイブ・コンポーネント

主目的

コンテンツ・サーバー・インスタンスを別のコンテンツ・サーバー・インスタンスに移行する場合や、アップグレードしたインスタンスに移行する場合に使用するスナップショット・ツール。
コントリビューション・フォルダのみがサポートされます。

主にソケット経由でデータをバックアップ、格納および転送するために使用します。
コントリビューション・フォルダがサポートされます。FrameworkFoldersコンポーネントでは表の移行のみがサポートされます。

フォルダ構造または階層の全部をエクスポートおよびインポートするために使用します。
コントリビューション・フォルダのみがサポートされます。

フォルダ構造のバックアップおよび複製を行い、コンテンツを別のコンテンツ・サーバー・インスタンスと同期するために使用します。
コントリビューション・フォルダのみがサポートされます。

長所

移行するコンテンツ・サーバー・インスタンスの特定部分を選択できます。
ロギング・ファイルおよびトレース・ファイルが提供されます。

古いコンテンツを処理できます。
ロギング・ファイルおよびトレース・ファイルが提供されます。

ターゲットのコレクションIDとソースのコレクションIDが必ず一致します。

フォルダ構造の一部を選択してエクスポートできます。

制限

バージョン6.2より前のコンテンツ・サーバー・ソフトウェアでは使用できません。
コンポーネントの移行が困難になることがあります。

コレクションの作成には、スタンドアロン・バージョンが必要です。
インポートされたリビジョンは自動的にワークフローに入りません。

現在のフォルダおよびフォルダ内のコンテンツ・アイテムはすべてコンテンツ・サーバー・インスタンスから削除され、インポートされたフォルダ階層で置換されます。

ターゲットのフォルダのコレクションIDがソース・コンテンツのフォルダのコレクションIDと必ずしも一致しません。

アーカイブされるもの

- メタデータ

- セキュリティ(ロールおよびアカウント)

- プロファイル

- スキーマ

- ワークフロー

- パーソナライゼーション

- アドオン・コンポーネント

- コンテンツ

- コンテンツ・タイプ

- ユーザー属性

- サブスクリプション

- セキュリティ・グループ

- ファイル形式

- フォルダ階層全部(コンテンツを含まない)

- フォルダ階層およびコンテンツの全部または一部

- 変更されたコンテンツのみ(必要に応じて)

アーカイブされないもの

- コンテンツ

- ワークフローの状態

- これは追加アーカイブなので、同期されません。

- フォルダ構造

- CMUによりアーカイブされたメタデータ、セキュリティおよびその他のフィーチャ

- Webレイアウト構造

- フォルダ階層の一部または選択部分

- コラボレーション・フォルダ

- コンテンツ

- メタデータ、セキュリティ(CMUによりアーカイブされたその他のフィーチャ)

コラボレーション・フォルダ

24 システム構成の移行

この章では、構成移行ユーティリティをアーカイバ・ユーティリティとともに使用して、コンテンツを移行し、構成とカスタマイズのメタデータをエクスポートする方法について説明します。

この章の内容は、次のとおりです。

- 構成移行ユーティリティの理解

- 構成移行の管理

- 移行のヒント

24.1 構成移行ユーティリティの理解

構成移行ユーティリティをアーカイバとともに使用して、コンテンツ・サーバー・インスタンス構成を別のコンテンツ・サーバー・インスタンスにエクスポートします。アーカイバによりコンテンツが移行され、構成移行ユーティリティによりコンテンツ・サーバー・インスタンスの構成およびカスタマイズがエクスポートされます。

この項では、構成移行ユーティリティの構造と、このユーティリティでテンプレートおよびバンドルがどのように使用されるかについて説明します。このユーティリティの概要および他のアーカイブ・ツールとの違いについては、第23.1項を参照してください。

- 第24.1.1項「移行の構造」

- 第24.1.2項「移行テンプレートおよびバンドルについて」

24.1.1 移行の構造

バンドルとは、1つのzipファイルにパッケージされて、別のコンテンツ・サーバー・インスタンスにエクスポートできる状態になった一連の構成情報のことです。

情報は、DomainHome/ucm/cs/cmu/instance/ディレクトリに格納されます。

図24-1 移行ディレクトリの構造

bundlesサブディレクトリには、特定のバンドルおよび関連する情報が含まれます。templatesサブディレクトリには、新規のエクスポート・ファイルに使用できる構成テンプレートが含まれます。

情報は、DomainHome/ucm/cs/cmu/instance/bundles/ディレクトリに格納されます。

図24-2 bundlesサブディレクトリ

各構成バンドルは個別のサブディレクトリ内にあり、そのバンドルのエクスポートに必要なすべての関連ファイルが含まれています。

情報は、DomainHome/ucm/cs/cmu/instance/bundles/UserBundle/ディレクトリに格納されます。

図24-3 構成バンドル内のファイル

特定のディレクトリ内では、そのエクスポートのインスタンスに固有のカスタマイズ(カスタマイズ済のメタデータ・フィールドやスキーマなど)が個別のサブディレクトリに含まれています。

情報は、DomainHome/ucm/cs/cmu/instance/bundles/UserBundle/usermetadef/ディレクトリに格納されます。

図24-4 ディレクトリに格納されたカスタマイズ

これらの各サブディレクトリには、次のファイルが含まれています。

ファイルまたはディレクトリ

説明

bundleディレクトリ

bundles/ディレクトリには各バンドルのサブディレクトリがあります。サブディレクトリには、構成エクスポートの作成時にバンドルに割り当てられた名前が付けられます。

templatesディレクトリ

バンドルから作成されたエクスポート・ルールが含まれます。構成エクスポートが作成されて保存されると、そのエクスポートに名前が付けられ、構成がテンプレートとしてtemplatesディレクトリに保存されます。

hdaファイル

カスタマイズの定義と詳細、およびエクスポートされるインスタンスの他の要素が含まれます。エクスポートがどのように定義されたかによって、情報は1つまたは複数のHDAファイルにバンドルされます。

24.1.2 移行テンプレートおよびバンドルについて

移行テンプレートとは、エクスポートされるコンテンツ・サーバー・アイテムを指定する一連の構成オプションです。たとえば、FullCSExportというテンプレートにすべてのコンテンツ・サーバー・アイテム(スキーマ、カスタム・メタデータ、ワークフローなど)を含め、UserCSExportという別のテンプレートに、ユーザーに直接関連するオプション(セキュリティ・グループ、ロールなど)を含めることができます。

これらのテンプレートは、構成バンドルを作成するために使用されます。バンドルはテンプレートを使用して、エクスポートする内容を決定し、コンテンツ・サーバー・アイテムとともにエクスポートされる必要な定義ファイルを作成します。バンドル名は、インポートまたはエクスポートの最終結果を識別するために使用されます。バンドルされた情報はzipファイルに格納されます。これには、すべての必要な定義ファイルが含まれます。

24.2 構成移行の管理

移行では、移行テンプレートの作成、移行バンドルの作成、構成のエクスポートまたはインポートといったタスクを行います。

- 第24.2.1項「構成移行テンプレートの作成」

- 第24.2.2項「構成テンプレートの編集」

- 24.2.3「テンプレートのインポート」

- 第24.2.4項「1回限りのエクスポートの作成」

- 第24.2.5項「構成のエクスポート」

- 第24.2.6項「バンドルのアップロード」

- 第24.2.7項「バンドルのインポート」

- 第24.2.8項「バンドルのダウンロード」

- 第24.2.9項「アクションのステータスの表示」

- 第24.2.10項「アクションの履歴の表示」

24.2.1 構成移行テンプレートの作成

構成移行テンプレートを作成する手順は、次のとおりです。

1. 「管理」→「構成の移行管理」→「構成テンプレート」を選択します。

2. 「構成テンプレート」ページで、「アクション」メニューから「新規テンプレートの作成」を選択します。

3. 「構成の移行管理」ページで、「アクションのオプション」リストからエクスポートに対するアイテムを1つ選択します。

- エラーが発生してもエクスポート・プロセスを続行するエクスポート・テンプレートを作成するには、「エラー発生時に続行」を選択します。
エクスポートは続行されますが、エラーが「アクションの履歴」ページにレポートされます。

- エクスポートを開始したユーザーに電子メールを送信するには、「電子メールの結果」を選択します。
電子メールは、エクスポート・テンプレートの作成者ではなくエクスポートの実行者に送信されます。

- 既知の依存関係をエクスポート・バンドルまたはインポート・バンドルに追加するには、「依存関係の追加」オプションを選択したままにしておきます。
これを選択解除した場合、依存関係はチェックされてエラー・フラグとともにログ・ファイルに記録されますが、バンドル・アクションは続行されます。

- エクスポートまたはインポート中にすべての依存関係を無視するには、「依存関係の無視」を選択します。依存関係を無視すると、エクスポート・プロセス中にエラーは発生しなくても、インポートの完了時にエラーが発生することがあります。
コンテンツ・サーバー・インスタンス内にすべての必要なフィールドが存在することがわかっている場合は、「依存関係の追加」を選択解除し、「依存関係の無視」を選択して、依存関係を追加せずにフィールドをインポートできます。

4. このバンドルにカスタム名を作成できます。名前の競合が起きないように、カスタム名は慎重に使用する必要があります。カスタム名を選択しない場合、システムにより、テンプレートの保存時に指定したバンドル名に基づいて名前が作成されます。カスタム名に空白や特殊文字(#、$、%など)を含めることはできません。

5. 「Content Serverセクション」リストから、使用するコンテンツ・サーバーのセクションを1つ以上選択します。

- すべてのセクションを使用するには、ページの「アクション」メニューで「すべて選択」を選択します。

注意:
一部のコンテンツ・サーバー・セクションは表示されません。これは、すべてのセクションがコンテンツ・サーバーの全バージョンでサポートされているわけではなく、正常に移行できないセクションもあるためです。

- 特定のコンテンツ・サーバー・アイテムのみを使用するには、「Content Serverセクション」をクリックして、使用する個々のセクション名をクリックします。
そのセクション内のすべてのアイテムを含めるには、ページの「アクション」メニューで「すべて選択」を選択します。

セクション内のサブセットのみを使用するには、そのアイテムの行の選択ボックスを選択して、個々のアイテムを選択します。固有のアクション・オプションを持つセクションもあります。セクションのオプションを選択するには、選択ボックスをチェックします。

ヒント:
メタデータの大部分を使用する場合は、「すべて選択」メニュー・オプションを選択してから、使用しない個々のセクションをクリックします。

6. ページの「アクション」メニューから「プレビュー」を選択して、選択した内容をプレビューします。

7. 「プレビュー」ページで、ページの「アクション」メニューから「編集」を選択して、選択内容の編集と追加を続行します。
「プレビュー」をクリックして、変更を確認します。

8. テンプレートが完成したら、ページの「アクション」メニューから「保存」を選択します。

注意:
テンプレートを保存するように選択しないと、構成の変更内容は失われます。

9. 「エクスポート・ルールの編集」ページで、テンプレート名を入力します。名前には、空白や特殊文字(#、$、%など)を含めることはできません。エクスポートの日付の詳細を示す名前(Nov10FullExportなど)や、内容を説明する名前(FullExportNoDependenciesなど)にしたり、用途に適したわかりやすい名前を付けることができます。

名前を入力し終わったら、「保存」をクリックします。

10. 「構成の移行管理」ページが再度開いたら、次の手順を実行します。

- 現在のテンプレートを使用して別のテンプレートを作成するには、ページの「アクション」メニューから「別名保存」を選択します。
「エクスポート・ルールの編集」ウィンドウが再度表示されたら、そこで新しい名前を作成できます。

- エクスポートの選択内容を変更するには、変更を行った後、ページの「アクション」メニューから「保存」を選択して、選択内容を変更し、手順9で入力した名前をそのまま使用するか、またはページの「アクション」メニューから「別名保存」を選択して、「エクスポート・ルールの編集」画面で新しい名前を付けます。

- 構成をエクスポートするには、ページの「アクション」メニューから「エクスポート」を選択します。詳細は、第24.2.5項を参照してください。

構成を作成した後は、別のシステムで使用できるように、構成をエクスポートし、バンドルを作成できます。詳細は、第24.2.5項を参照してください。

24.2.2 構成テンプレートの編集

構成テンプレートを編集するには:

1. 「管理」→「構成の移行管理」→「構成テンプレート」を選択します。

2. 編集するテンプレートを選択します。次のいずれかの方法を使用して、「構成テンプレート」ページからテンプレートを選択します。

- テンプレート名を選択します。

- 個々のテンプレートの「アクション」メニューから「編集」を選択します。

3. 「構成の移行管理」ページで、第24.2.1項で説明されている手順に従って、変更したテンプレートに使用するアイテムを選択します。

- テンプレートに対して「アクションのオプション」のいずれかを選択します。

- 画面の「Content Serverセクション」から、使用するセクションを選択します。

4. ページの「アクション」メニューから「プレビュー」を選択して、選択した内容をプレビューします。

5. 「プレビュー」ページで、ページの「アクション」メニューから「編集」を選択して、選択内容の編集と追加を続行します。
「プレビュー」をクリックして、選択内容を確認します。

6. テンプレートが完成したら、ページの「アクション」メニューから「保存」を選択して、テンプレートを現在の名前で保存するか、「別名保存」を選択してテンプレートに新しい名前を付けます。

注意:
テンプレートの保存を選択しないと、構成の変更内容は失われます。

7. 「エクスポート・ルールの編集」ページで新しいテンプレート名を入力します。

24.2.3 テンプレートのインポート

テンプレートを現在のインスタンスで使用するために別のシステムからインポートする手順は、次のとおりです。

1. 「管理」→「構成の移行管理」→「アップロード・バンドル」を選択します。

2. 「構成のバンドルのアップロード」ページで、「参照」ボタンを使用して、使用するテンプレートが含まれているバンドルを検索します。

3. 「エクスポート・テンプレートの作成」を選択します。

4. 「アップロード」をクリックします。
バンドルが「構成のバンドル」ページに表示されます。そのバンドルに関連付けられたテンプレートを使用するには、第24.2.2項を参照してください。

エクスポートに使用するテンプレートをインポートするが、インポート側のシステムに同じメタデータ・フィールドがない場合、そのテンプレートをエクスポートに使用する前に、テンプレートをアップロードし、構成をインポートする必要があります。テンプレートをインポートしたシステムにメタデータ・フィールドがない場合、そのテンプレートをエクスポートには使用できません。

24.2.4 1回限りのエクスポートの作成

エクスポート・テンプレートを作成し、即時にコンテンツ・サーバー構成をエクスポートする手順は、次のとおりです。

1. 「管理」→「構成の移行管理」→「構成テンプレート」を選択します。

2. 「構成テンプレート」ページで、ページの「アクション」メニューから「新規テンプレートの作成」を選択します。

3. 「構成の移行管理」ページで、第24.2.1項で説明されている手順に従って、構成に使用するアイテムを選択します。

- 「アクションのオプション」のいずれかを選択します。

- 画面の「Content Serverセクション」から、使用するセクションを選択します。

4. ページの「アクション」メニューから「プレビュー」を選択して、選択した内容をプレビューします。

5. 「プレビュー」ページで、ページの「アクション」メニューから「編集」を選択して、選択内容の編集と追加を続行します。
「プレビュー」をクリックして、変更を確認します。

6. テンプレートが完成したら、ページの「アクション」メニューから「エクスポート」を選択します。
構成が即時にエクスポートされ、「最新のアクション」ページに、エクスポートされたバンドルの名前が次のような一意の識別子とともに表示されます。

bundle-idcm1-25-20131110T135912

名前の最初の部分(bundle-idcm1)は、デフォルトのバンドル名(bundle)とインスタンス名(idcm)を表しています。次の部分は、順序番号(25)を表しています。その後に日付(2013年11月11日を表す20131110)が続きます。最後に、エクスポートされたバンドルを識別する一意の管理番号が使用されます。

24.2.5 構成のエクスポート

構成をエクスポートする手順は、次のとおりです。

1. 「管理」→「構成の移行管理」→「構成テンプレート」を選択します。

2. 次のいずれかの方法を使用して、「構成テンプレート」ページからエクスポート構成テンプレートを選択します。

- 構成名をクリックします。

- エクスポートされるアイテムを確認する場合は、それぞれの「アクション」メニューから「プレビュー」を選択します。

3. 「プレビュー」ページで、ページの「アクション」メニューから「エクスポート」を選択します。
最初にバンドルをプレビューせずに「エクスポート」を選択した場合、エクスポートの実行を確認するプロンプトが表示されます。

「最新のアクション」ページは自動的にリフレッシュされて、最新のアクティビティおよびそのステータスが表示されます。

4. 移行アクションの詳細を表示するには、「ステータス」列のメッセージをクリックします。詳細は、第24.2.9項を参照してください。

エクスポート後、「構成のバンドル」にバンドル名が表示され、バンドルが完了したことが示されます。次の例に示すように、日時インジケータが構成名に追加されます。

Nov23Bundle-idcm-1-20131123T122436

名前の最初の部分は、元のバンドル名です。その後は、インスタンス名(idcm)、日付(2004年11月23日を表す20131123)、時刻(12:24:36を表す122436)の順に続きます。この「インポート」ページから、バンドルを新しい場所にダウンロードすると、バンドルを別のシステムにアップロードできるようになります。

元のテンプレート名(Nov23Bundle)は引き続き「構成テンプレート」ページに表示され、別の機会にこのページから再エクスポートできます。

24.2.6 バンドルのアップロード

構成をインポートするには、まず構成をアップロードする必要があります。

別のコンテンツ・サーバー・インスタンスからバンドルをアップロードする手順は、次のとおりです。

1. 「管理」→「構成の移行管理」→「アップロード・バンドル」を選択します。

2. 「構成のバンドルのアップロード」ページで、「参照」ボタンを使用して、使用するzipされたバンドル・ファイルを検索して選択します。

3. バンドルに付属のテンプレートを使用する場合は、「エクスポート・テンプレートの作成」を選択します。

4. 既存のコンテンツ・サーバー構成情報を新しいバンドル情報で上書きする場合は、「上書きの強制」を選択します。

5. 「アップロード」をクリックして、バンドルをロードします。

ヒント:
バンドルのコンテンツが明確でない場合は、バンドルをアップロードして構成のコンテンツをプレビューするほうが確実です。バンドル構成は、インポートするように選択するまではインポート側のシステムに適用されません。

24.2.7 バンドルのインポート

バンドルがアップロードされてインポート側のシステムに配置されると、バンドルを使用するためにインポートできるようになります。

バンドルをインポートする手順は、次のとおりです。

1. 「管理」→「構成の移行管理」→「構成のバンドル」を選択します。

2. 「構成のバンドル」ページで、「構成の移行管理ページ」または移行画面の上部のメニューから「構成のバンドル」を選択します。

3. インポートするバンドルの名前を選択します。
「構成の移行管理」ページが表示され、「カスタム名」フィールドの場所に「重複の上書き」が表示されます。このフィールドを選択すると、バンドルのインポートでは重複するフィールドの上書きが許可されます。これを選択しない場合、重複があるとエラーが発生してインポートが停止します。「エラー発生時に続行」が選択されていれば続行されますが、「最新のアクション」画面に「失敗」のステータスが表示されます。

4. ページの「アクション」メニューからアクションを選択します。

- インポート構成をプレビューするには、「プレビュー」をクリックします。
「プレビュー」ページで、ページの「アクション」メニューから「編集」を選択して構成オプションを編集することも、「インポート」を選択して現在の選択内容をそのままインポートすることもできます。

- プレビューせずに構成をインポートするには、「構成のバンドル」ページの「アクション」メニューから「インポート」を選択します。
バンドルをプレビューせずに構成をインポートするか確認するプロンプトが表示されます。

重要:
コンテンツ・サーバー・セクションの「サーバーの構成」の設定をインポートすることを確認する必要があります。これらの設定によって、使用されるWebサーバーのタイプ、メール・サーバー、その他のシステム固有アイテムなどの構成が決まります。新しいコンテンツ・サーバー・インスタンスには、これらの構成設定をインポートしないほうがよい場合もあります。

5. 「プレビュー」ページまたは「構成のバンドル」ページから「インポート」を選択すると、インポートのステータスを示す「最新のアクション」ページが表示されます。
このページは自動的にリフレッシュされて、最新の履歴およびステータスが表示されます。

6. アクションの詳細を表示するには、「最新のアクション」ページの「ステータス」列でメッセージをクリックします。詳細は、第24.2.9項を参照してください。

24.2.8 バンドルのダウンロード

バンドルをダウンロードして、他のコンテンツ・サーバー・インスタンスで使用できるようにアクセスしやすい場所に格納できます。

バンドルをダウンロードする手順は、次のとおりです。

1. 「管理」→「構成の移行管理」→「構成のバンドル」を選択します。

2. 「構成のバンドル」ページで、ダウンロードするバンドルの「アクション」メニューから、「ダウンロード」を選択します。
バンドルの場所についてのプロンプトが表示されます。

3. 適切なバンドルの場所を入力し、「保存」をクリックします。

24.2.9 アクションのステータスの表示

インポートまたはエクスポートのアクションのステータス情報を表示する手順は、次のとおりです。

1. 「管理」→「構成の移行管理」→「最新のアクション」を選択します。
「最新のアクション」ページが開き、アクションの時間、セクション、メッセージについての情報が表示されます。

2. 「ページのリフレッシュ(秒数)」メニューを使用して、リフレッシュに対して様々な秒数(5秒から300秒)を選択できます。

注意:
エクスポートまたはインポートが完了すると、「アクションの履歴」画面が自動的に表示されます。

24.2.10 アクションの履歴の表示

移行アクションの履歴を表示する手順は、次のとおりです。

1. 「管理」→「構成の移行管理」→「アクションの履歴」を選択します。

2. 「アクションの履歴」ページで、各アクションの名前、ソース、アクション、開始時間、およびステータスを表示できます。

3. 「アクション」メニューを使用して、特定のアクションの履歴を選択するか、またはアクションの履歴をクリアできます。

24.3 移行のヒント

移行で行われるのは、コンテンツ・サーバー・インスタンスに関する情報のバンドル化とコピーであることに注意する必要があります。コンテンツ・サーバー・インスタンス内の実際のコンテンツは移行されません。コンテンツをエクスポートするには、アーカイバ・ユーティリティを使用します。特定のコンテンツをアーカイブして、それを別のシステムにエクスポートする場合は、構成移行ユーティリティを使用すると、そのコンテンツのメタデータ情報も移行されることに注意してください。

コンテンツ・サーバー・インスタンス間で情報を移行する際に、情報のマージは行われません。移行は追加的なプロセスです。メタデータ情報のエクスポート側の構成バンドルが、インポート側のコンテンツ・サーバー・インスタンスに存在するメタデータに追加されます。インポート中に「上書きの強制」ルールを選択した場合は、インポートされるメタデータと一致するメタデータ情報が存在すると、重複するバンドルが置換されます。「上書きの強制」オプションの詳細は、第24.2.6項を参照してください。

構成移行の管理タスクは、クラスタの特定のノードを使用して実行する必要があります。アクションに割り当てられたジョブ番号は、そのアクションを開始したノードにしか認識されないため、特定のノードを使用しないと、エラーが発生する可能性があります。

バージョン6.2のコンテンツ・サーバー・インスタンスに構成をインポートすることはできません。バージョン6.2のコンテンツ・サーバー・インスタンスでは、「構成のバンドル」ページのバンドルのオプションに、「編集」、「プレビュー」および「履歴」オプションが表示されません。

別のコンテンツ・サーバー・インスタンス上で使用するテンプレートをインポートした場合、インポート側のシステムに同じメタデータ・フィールドがないと、後でそのテンプレートをエクスポートに使用できません。テンプレートをアップロードし、構成をインポートしてから、テンプレートをエクスポートに使用する必要があります。インポート・プロセスの詳細は、第24.2.3項を参照してください。

24.3.1 制限事項

構成移行ユーティリティを使用する際は、次の制限事項に注意してください。

- ワークフロー構成情報をエクスポートすると、ワークフロー定義のみがエクスポートされます。ワークフローの状態はエクスポートされません。

- ワークフローをインポートして既存のワークフローを上書きする場合は、各ワークフローのステップ名が同じであることを確認してください。

- ワークフローを新しいコンテンツ・サーバー・インスタンスにインポートすると、エクスポート側のコンテンツ・サーバー・インスタンスと同じ状態情報がワークフローに保持されません。このため、アクティブなワークフローのエクスポートは計画しないでください。

- このユーティリティではクローニングは行われません。情報が別のシステムと同期されることはありません。情報は、コピーされて移動されるのみです。

- このユーティリティを、自動移行を行うように設定することはできません。

- 前のバージョンのコンテンツ・サーバー・インスタンスからdocmeta情報を移行する際に、後のバージョンのコンテンツ・サーバー・インスタンスでスキーマが使用されていると、エラーが発生することがあります。

- アーカイバの制限事項により、バージョン6.2または7.0のコンテンツ・サーバーから上位のバージョンにユーザーをインポートすることはできません。

- config.cfgファイルを移行する際、安全上の理由で一部の値(IDC_Nameなど)が移行されず、エラーが発生することがあります。他の値(AutoNumberPrefixの値など)は移行されます。

- プリファレンスのプロンプト(FoldersやRMAなど)やデータベース表を移行できないために、コンポーネントの移行が困難になることがあります。

- コンポーネント内のバンドルにはサポートが提供されません。

24.3.2 移行ログ

移行トレース・ログを調べることで、移行イベント中のアクティビティを追跡できます。

コンテンツ・サーバーの移行トレース・ログを有効にするには、「管理」、「システム監査情報」の順に選択します。このページの「トレース・セクション情報」で、「アクティブなセクション」、「cmu」の順に選択します。構成移行ユーティリティのログは、実行中のトレース・ファイルに記録されます。

ログにアクセスするには、ページの「アクション」メニューから「サーバー出力の表示」をクリックします。構成移行ユーティリティのログ情報が、生成された他のトレース・ログとともに記録されています。

25 アーカイブ、コレクションおよびバッチ・ファイルの管理

この章では、アーカイバ・アプリケーションを使用して、Oracle WebCenter Content Serverコンテンツのアーカイブ、コレクション、およびバッチ・ファイルを管理する方法について説明します。

この章の内容は、次のとおりです。

- アーカイバの動作の理解

- アーカイブの管理

- コレクションの管理

- バッチ・ファイルの管理

25.1 アーカイバの動作の理解

コンテンツ・サーバーのコンテンツのアーカイブは、3つの要素(アーカイブ自体、コレクションおよびバッチ・ファイル)で構成されます。この項では、アーカイバ・アプリケーションの構造と、このアプリケーションでコレクションおよびターゲットがどのように使用されるかについて説明します。アーカイバの概要および他のアーカイブ・ツールとの違いについては、第23.1項を参照してください。

- 第25.1.1項「アーカイブの構造」

- 第25.1.2項「コレクション」

- 25.1.3項「バッチ・ファイル」

- 第25.1.4項「アーカイブのターゲット」

- 第25.1.5項「アーカイブ・ログの使用」

25.1.1 アーカイブの構造

アーカイブとは、エクスポートされたコンテンツ・ファイルおよびそれに関連付けられたバッチ・ファイルのセットです。アーカイブが属するコレクションには、そのアーカイブ独自のサブディレクトリがあります。

注意:
アーカイバにより作成されたファイルは編集しないでください。

図25-1 アーカイブ・ディレクトリの構造

アーカイブ・サブディレクトリには次のものが含まれます。

ファイルまたはディレクトリ

説明

バッチ・ファイル・ディレクトリ

アーカイブ内に、各バッチ・ファイルのサブディレクトリがあります。サブディレクトリ名はエクスポートの日時を反映しており、デフォルトの書式はyy-MMM-dd_HH.mm.ss_SSSです。たとえば、03-feb-04_15.04.14_174などです。

tempディレクトリ

転送されたZipファイルが含まれます。

archive.hdaファイル

アーカイブに関する情報(エクスポートとインポートの設定、エクスポート問合せ、フィールドと値のインポート時の変更設定、アーカイブ履歴など)が指定されています。

doctypes.hdaファイル

ソース・コンテンツ・サーバー・インスタンス内のコンテンツ・タイプ(DocTypesデータベース表)がリストされています。このファイルは、コンテンツ・タイプがエクスポートされた場合にのみ存在します。

exports.hdaファイル

アーカイブに含められるバッチ・ファイルが指定されています。

users.hdaファイル

ソース・コンテンツ・サーバー・インスタンス内のユーザー属性(Usersデータベース表)がリストされています。このファイルは、ユーザー属性がエクスポートされた場合にのみ存在します。

図25-2 アーカイブ・サブディレクトリの構造

25.1.2 コレクション

この項では、コレクションについて説明します。

サマリー

コレクションとは、特定のコンテンツ・サーバー・インスタンスに対する一連のアーカイブのことです。

- 各インスタンスには、IntradocDir/archives/ディレクトリ内にデフォルトのコレクションがあります。追加のコレクションを作成することもできますが、ほとんどの場合、その必要はありません。たとえば、コンテンツ・サーバーがインストールされていない別のシステムにアーカイブしてディスク領域を節約する場合などは、新しいコレクションを作成します。

- コレクションは、スタンドアロンのアーカイバ・アプリケーションでのみ作成できます。スタンドアロンのアーカイバの使用方法の詳細は、第25.2.5項を参照してください。

- コレクションはコンテンツ・サーバー・インスタンスから削除できますが、これは、そのコレクションをアーカイバから使用できなくしているだけです。アーカイブ・ファイルおよびバッチ・ファイルは、ファイル・システムから削除するまで維持されます。

ヒント:
アーカイバのコレクションは通常、異なるバージョンのコンテンツ・サーバー・インスタンス間でも互換性があります。ただし、バージョン3.0より前のコンテンツ・サーバー・インスタンスからアーカイブされたユーザー構成情報は例外になることがあります。Usersデータベース表のフォーマットはバージョン3.0で変更されたため、バージョン3.0より前のコンテンツ・サーバー・インスタンスとバージョン3.0以降のコンテンツ・サーバー・インスタンスの間ではこの情報に互換性がないことがあります。

構造

アーカイブ・コレクションには次のものが含まれます。

.gifで示されるコレクションの構造画面に表示される要素の追加情報が示されます。左列には要素、右列には対応する要素の説明が表示されます。" title="「コレクションの構造」画面の要素/説明の表。" width="100%">

ファイルまたはディレクトリ

説明

collection.hdaファイル

コレクションに含められるアーカイブが指定されています。

collection.mrkファイル

アーカイバにより使用される内部ファイルです。

アーカイブ・ディレクトリ

コレクション内に、各アーカイブのサブディレクトリがあります。

図25-3 コレクションの構造

25.1.3 バッチ・ファイル

この項では、バッチ・ファイルについて説明します。

サマリー

バッチ・ファイルとは、アーカイブされたコンテンツ・アイテムのファイル・レコードを含むテキスト・ファイルのことです。バッチ・ファイルには、エクスポートされた各リビジョンのメタデータが記述されています。

- アーカイブがエクスポートされるたびに、新しいバッチ・ファイル・サブディレクトリが作成されます。

- 各バッチ・ファイルには最大1000件のファイル・レコードが含まれます。エクスポートに含まれるリビジョンが1000個を超えると、新しいバッチ・ファイルが作成されます。

注意:
アーカイバのバッチ・ファイルは、バッチ・ローダー・アプリケーションで使用されるバッチ・ファイルとは異なります。

構造

バッチ・ファイル・サブディレクトリには次のものが含まれます。

ファイルまたはディレクトリ

説明

コンテンツ・ファイル

バッチ・ファイル・ディレクトリ内の1というサブディレクトリには、ソース・コンテンツ・サーバー・インスタンスからコピーされたボールト構造が含まれます。Web表示可能ファイルをアーカイブする場合、このサブディレクトリにはWebレイアウト構造も含まれます。

バッチ・ファイル

エクスポートされた各リビジョンのメタデータが指定されています。バッチ・ファイルはHDAファイルであり、アーカイバにより生成された一意の番号を含む名前が付けられています。たとえば、0335150414~1.hdaなどです。

docmetadefinition.hdaファイル

ソース・コンテンツ・サーバー・インスタンス(DocMetaDefinitionデータベース表)内のカスタム・メタデータ・フィールドがリストされています。このファイルは、アーカイバによりインポート・マップが作成されるときに使用されます。

図25-4 バッチ・ファイルの構造

25.1.4 アーカイブのターゲット

アーカイバを使用すると、次の内容をアーカイブできます。

- ネイティブ・ファイルおよび関連付けられた標準のメタデータ値

- Web表示可能ファイル(.pdf、.htmlなど)

- メタデータ・フィールドおよび変更

- ユーザー情報フィールド

- セキュリティ・グループ(ユーザー属性および設定)

- ユーザー更新

- サブスクリプション・タイプ

- ファイル形式

- ドキュメント・タイプ

- コンテンツ・タイプ

- ユーザー属性(ユーザー・ログイン、フル・ネーム、パスワード、電子メール・アドレスなど)

注意:
コンテンツ・タイプとユーザー属性は手動でエクスポートおよびインポートできますが、レプリケーションにより自動的に転送またはアーカイブすることはできません。ただし、ユーザー情報のレプリケートには表レプリケーションを使用できます。

注意:
アーカイバを使用して、同じコンテンツ・サーバー・インスタンス名(IDC_Name)を共有する2つのインスタンス間でデータを移動またはコピーすることはできません。これを行うと、ターゲット・システムのデータが破損します。

25.1.5 アーカイブ・ログの使用

アーカイバの問題が発生する場合は、アーカイバ・ログを参照して詳細情報を確認します。

サマリー

アーカイバ・ログは、日時別にリストされます。これらは、アーカイバの最初の情報ステータス、リカバリ不能なエラー、またはエラーが発生すると、1日に1回生成されます。

「管理」ページの「アーカイバ・ログ」リンクをクリックすると、インポート、エクスポートおよびレプリケーションの情報が表示されます。

対象のログ・ファイルに対して表示されているリンクをクリックします。各アクションのタイプ、日時および説明を示している表が表示されます。これには、アーカイブを作成したコンテンツ・サーバー・インスタンスの名前も含まれます。

図25-5 アーカイブ・ログ・ファイル

ログ・エントリ

次のアーカイバ・ログ・エントリのタイプが生成されます。

- 情報: 基本的なステータス情報を表示します。たとえば、エクスポートおよびインポートが開始および終了する際に、ステータス情報が記録されます。

- エラー: 発生してもソフトウェアの機能が停止しないユーザー/管理エラーを表示します。たとえば、エクスポートしようとするコンテンツ・アイテムのファイル情報がない場合、エラーが記録されます。

- 致命的: 発生するとソフトウェアの機能が停止するエラーを表示します。たとえば、コンテンツ・サーバー・インスタンスがデータベースにアクセスできない場合、リカバリ不能なエラーがログに記録されます。接続文字列、ユーザー名およびパスワードを確認します。

25.2 アーカイブの管理

作成したアーカイブは、コレクションに追加し、グループとして操作できるようになります。

- 第25.2.1項「新規アーカイブの作成」

- 第25.2.2項「既存のアーカイブのコピー」

- 第25.2.3項「コピーによる新規アーカイブの作成」

- 第25.2.4項「アーカイブの削除」

25.2.1 新規アーカイブの作成

新規の未定義のアーカイブを作成する手順は、次のとおりです。

1. スタンドアロン・モードまたはブラウザ・モードでアーカイバのメイン画面を表示します。
スタンドアロン・モードの使用方法は、第25.2.5項を参照してください。

2. 必要に応じて、新規アーカイブの作成先のコレクションを開きます。詳細は、第25.3.1項を参照してください。

3. 「編集」から「追加」を選択します。

4. 「アーカイブの追加」ウィンドウで、アーカイブ名および説明を入力します。アーカイブ名には空白を使用できません。

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

25.2.2 既存のアーカイブのコピー

既存のアーカイブを別のディレクトリ場所にコピーする手順は、次のとおりです。

注意:
この手順により、アーカイブ内のファイルがコピーされます。アーカイブのコピー先がコレクション・ディレクトリの場合に、新しいコレクションが作成されたりcollection.hdaファイルが更新されることはありません。

1. スタンドアロン・モードでアーカイバを表示します。
詳細は、25.2.5項を参照してください。

2. 必要に応じて、コピーするアーカイブが含まれるコレクションを開きます。詳細は、第25.3.1項を参照してください。

3. コピーするアーカイブを選択します。

4. 「編集」から「コピー先」を選択します。

5. 「アーカイブのコピー」ウィンドウで、元のアーカイブ名を受け入れるか、必要に応じて名前を変更します。

6. アーカイブをディレクトリにコピー・フィールドに、アーカイブをコピーするディレクトリのパスを入力します。

7. 「OK」をクリックします。
アーカイブ・ファイルが、指定したディレクトリにコピーされます。

25.2.3 コピーによる新規アーカイブの作成

スタンドアロン・バージョンのアーカイバを使用している場合は、システムからアーカイブを保存のためにコピーしたり、別のアーカイブからシステムにコピーすることができます。

既存のアーカイブをコピーして現在のコレクション内に新規アーカイブを作成する手順は、次のとおりです。

1. スタンドアロン・モードでアーカイバを表示します。
詳細は、25.2.5項を参照してください。

2. 必要に応じて、新規アーカイブの作成先のコレクションを開きます。第25.3.1項を参照してください。

3. 「編集」から「追加」を選択します。

4. 「アーカイブの追加」ウィンドウで、アーカイブ名および説明を入力します。アーカイブ名には空白を使用できません。

5. 「コピー元」を選択します。

6. 「参照」をクリックします。

7. 対象のアーカイブ・ファイル(archive.hda)に移動して選択します。

8. 「開く」をクリックします。

9. 「OK」をクリックします。
アーカイブ・ファイルが、ローカル・コンテンツ・サーバー・インスタンス内のデフォルト・アーカイブ・ディレクトリにコピーされます。

25.2.4 アーカイブの削除

アーカイブをコレクションから削除する手順は、次のとおりです。

1. アーカイブ・コレクションを開きます。

2. 現在のアーカイブ・リストで、削除するアーカイブを選択します。

3. 「編集」から「削除」を選択します。アクションを確認するプロンプトが表示されます。

4. 「OK」をクリックします。
アーカイブがコレクションから削除されます。

25.2.5 スタンドアロン・アプリケーションとしてのアーカイバの実行

ここでは、スタンドアロン・アプリケーションとしてアーカイバを実行する方法について説明します。これは、コレクションの作成に必要になります。

Windowsでアーカイバを実行する手順:

Windowsオペレーティング・システムでアーカイバを実行する手順は、次のとおりです。

1. 「スタート」メニューから「プログラム」、「コンテンツ・サーバー」、インスタンスの順に選択し、「アナライザ」を選択して、アプリケーションを選択します。ログイン・ウィンドウまたはアプリケーション・ウィンドウが開きます。

ヒント:
ログイン・ウィンドウまたはアプリケーション・ウィンドウが表示されるまでに数秒かかることがあります。また、ウィンドウが他のウィンドウの下に隠れることがあります。

2. 必要に応じて、管理者のログイン名とパスワードを入力し、「OK」をクリックします。アーカイバのメイン・ウィンドウが開きます。

UNIXでアーカイバを実行する手順:

UNIXオペレーティング・システムでアーカイバを実行する手順は、次のとおりです。

1. DomainHome/ucm/cs/bin/ディレクトリにナビゲートします。

2. ./archiveを入力します。

3. 必要に応じて、管理者のログイン名とパスワードを入力します。アーカイバのメイン・ウィンドウが開きます。

25.3 コレクションの管理

コレクションは一連のアーカイブであり、各種のアーカイブ機能に対してアーカイブをグループ化するために使用されます。

注意:
新規コレクションを作成する場合や、新規コレクションに接続するローカル・ファイル・システムを参照する場合は、スタンドアロン・モードのアーカイバ・アプリケーションが必要です。

- 第25.3.1項「コレクションを開く」

- 第25.3.2項「コレクションの作成」

- 第25.3.3項「コレクションの削除」

- 第25.3.4項「デフォルトのアーカイブ・コレクションの移動」

25.3.1 コレクションを開く

既存のアーカイブ・コレクションを開く手順は、次のとおりです。

1. スタンドアロン・モードでアーカイバを実行します。
詳細は、25.2.5項を参照してください。

2. 「オプション」から「アーカイブ・コレクションを開く」を選択します。

3. 「アーカイブ・コレクションを開く」ウィンドウ(デフォルトのコレクションおよび接続されているその他のコレクションが表示されます)の既存のコレクションのリストからコレクションを選択します。

4. 新しいコレクションを参照するには、次のいずれかの方法を使用します。
共有ファイル・システムの場所からコレクションを選択する手順は、次のとおりです(スタンドアロンのアーカイバのみ)。

1. 「ローカルに参照」をクリックします。

2. 「アーカイブ・コレクション定義ファイルの参照」ウィンドウで、コレクションHDAファイルに移動して選択します。

3. 「開く」をクリックします。
「アーカイバ・コレクションの参照」ウィンドウが開きます。

リモート・コンテンツ・サーバー・インスタンスからコレクションを選択する手順は、次のとおりです。

1. 「プロキシの参照」をクリックします。
「プロキシ・コレクションの参照」ウィンドウが開き、送信プロバイダが設定されているすべてのコンテンツ・サーバー・インスタンスを含むリストが表示されます。

2. 「プロキシ・サーバー」リストからコンテンツ・サーバー・インスタンスを選択します。

3. 「コレクション」リストからコレクションを選択します。

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

25.3.2 コレクションの作成

新規のアーカイブ・コレクションを作成する手順は、次のとおりです。

注意:
新規のコレクションは、スタンドアロンのアーカイバを使用してローカル・コンテンツ・サーバー・インスタンスにのみ作成できます。

1. スタンドアロン・モードでアーカイバを実行します。
詳細は、25.2.5項を参照してください。

2. 「オプション」から「アーカイブ・コレクションを開く」を選択します。

3. 「アーカイブ・コレクションを開く」ウィンドウで、「ローカルに参照」をクリックします。

4. 「アーカイブ・コレクション定義ファイルの参照」ウィンドウで、新規コレクションの作成先のディレクトリに移動して選択します。

5. 新規コレクションのファイル名を入力します(collection.hdaがデフォルトです)。

6. 「開く」をクリックします。
コレクション定義(HDA)ファイルを作成するよう要求されます。

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

8. 「アーカイバ・コレクションの参照」ウィンドウで、「名前」フィールドにコレクション名を入力します。

- コレクション名には空白を使用できません。

- ナビゲートしやすいように、コレクションとそのディレクトリは同じ名前にしてください。

9. 「Webディレクトリ」フィールドにWebレイアウト・ディレクトリのディレクトリ・パスを入力し、「ボールト・ディレクトリ」フィールドにボールト・ディレクトリのディレクトリ・パスを入力します。

- 「場所」フィールドに表示されているパス・スタイルを使用してください。

- ディレクトリ・パスを調べるには、「構成情報」ページを表示します。

10. 「OK」をクリックします。
「アーカイブ・コレクションを開く」ページに新規のコレクションが表示されます。

11. 「開く」をクリックして、新規コレクションを開きます。

25.3.3 コレクションの削除

アーカイブ・コレクションを削除する手順は、次のとおりです。

注意:
デフォルトのコレクションは削除できません。

1. 「オプション」から「アーカイブ・コレクションを開く」を選択します。

2. 「アーカイブ・コレクションを開く」ウィンドウで、削除するコレクションを選択します。

3. 「削除」をクリックします。
アクションを確認するプロンプトが表示されます。

4. 「OK」をクリックします。
コレクションがコンテンツ・サーバー・インスタンスから削除されます。(コレクション・ファイルおよびアーカイブ・ファイルはファイル・システムに残るため、手動で削除する必要があります)。

25.3.4 デフォルトのアーカイブ・コレクションの移動

デフォルトのアーカイブ・コレクションのファイル・システムの場所を変更するには、コレクションを移動し、コンテンツ・サーバー・インスタンスに新しい場所を指定します。たとえば、すべてのアーカイブ・データをプログラム・ファイルとは別のドライブに保管すると、バックアップや拡張が容易になります。

注意:
デフォルトのコレクションは、archives/ディレクトリにあります。

デフォルトのアーカイブ・コレクションを移動する手順は、次のとおりです。

1. データの安全を確保するため、スタンドアロン・アーカイバ・アプリケーションをすべて閉じて、コンテンツ・サーバー・インスタンスを停止します。

2. 次に示すように、CollectionLocation構成変数に新しい場所へのパスを指定して、DomainHome/ucm/cs/bin/intradoc.cfgファイルに追加します。

CollectionLocation=path

3. デフォルトのコレクションに対して以前に作成したアーカイブを保持するには、archives/ディレクトリのコンテンツをCollectionLocation設定で指定した新しい場所に移動します。コンテンツを移動しない場合、システムにより空のコレクションが作成されます。

4. コンテンツ・サーバー・インスタンスを起動します。

注意:
コンテンツ・サーバー・インスタンスは、再起動時にデフォルトのDomain_home/ucm/cs/archives/ディレクトリを再作成しますが、アーカイバはデフォルトで新しい場所のコレクションを使用します。

25.4 バッチ・ファイルの管理

バッチ・ファイルには、エクスポートされたリビジョンのメタデータが記述されています。アーカイバによりエクスポートが実行されるたびに、バッチ・ファイルが作成されます。

- 第25.4.1項「バッチ・ファイルからのリビジョンの削除」

- 第25.4.2項「バッチ・ファイルの削除」

25.4.1 バッチ・ファイルからのリビジョンの削除

バッチ・ファイルから個々のリビジョンを削除する手順は、次のとおりです。

1. アーカイブ・コレクションを開きます。
詳細は、25.3.1項を参照してください。

2. 現在のアーカイブ・リストからアーカイブを選択します。

3. アーカイバのメイン画面で、「バッチ・ファイルの表示」をクリックします。

4. 「バッチ・ファイルの表示」ウィンドウで、バッチ・ファイルを選択します。

5. 「編集」をクリックします。

6. 「エクスポート済コンテンツ・アイテムの表示」ウィンドウで、「フィルタ」要素およびナビゲーション・ボタンを使用して、削除するリビジョンを表示します。

7. 削除するリビジョンを選択します。

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

選択したリビジョンの「ステータス」が「削除済」に変わります。

9. 追加のリビジョンを削除する場合は、手順7および8を繰り返します。

10. 最後の削除を元に戻すには、「元に戻す」をクリックします。すべての削除済リビジョンを「アーカイブ済」ステータスに戻すには、「リフレッシュ」をクリックします。

11. 「適用」をクリックして、指定したリビジョンを削除します。

12. 「Close」をクリックします。

25.4.2 バッチ・ファイルの削除

バッチ・ファイルをアーカイブから削除する手順は、次のとおりです。

1. アーカイブ・コレクションを開きます。
詳細は、25.3.1項を参照してください。

2. 現在のアーカイブ・リストからアーカイブを選択します。

3. 「アーカイバ」ウィンドウの「一般」タブで、「バッチ・ファイルの表示」をクリックします。

4. 「バッチ・ファイルの表示」ウィンドウで、削除するバッチ・ファイルを選択します。

5. 「削除」をクリックします。
アクションを確認するプロンプトが表示されます。

6. 「OK」をクリックします。
バッチ・ファイルがアーカイブから削除されます。

7. エクスポート時に既存のバッチ・ファイルを置き換えるかどうかを指定します。

- 次のエクスポートの開始時に既存のバッチ・ファイルをすべて削除するには、「既存のエクスポート・ファイルを置換」を選択します。

- 次のエクスポートの開始時に既存のバッチ・ファイルを残すには、「既存のエクスポート・ファイルを置換」の選択を解除します。

8. エクスポートするファイルを指定します。

- ネイティブ・ファイル(vault)およびWeb表示可能ファイル(weblayout)をエクスポートするには、「Webコンテンツをコピー」を選択します。

- ネイティブ(vault)ファイルのみをエクスポートするには、「Webコンテンツをコピー」の選択を解除します。

9. 「OK」をクリックします。
「一般」タブの「エクスポート・オプション」セクションに、エクスポート・オプションが表示されます。

26 アーカイブのデータのエクスポート

この章では、データをバックアップ、保管、またはインポートするために、あるOracle WebCenter Content Serverインスタンスから別のインスタンスにデータをエクスポートする方法について説明します。

この章の内容は、次のとおりです。

- データのエクスポートの理解

- エクスポートの管理

26.1 データのエクスポートの理解

アーカイバ・ユーティリティのエクスポート機能は、コンテンツ・サーバー・インスタンスのネイティブ・ファイルやWeb表示可能ファイルをコピーして、別のコンテンツ・サーバー・インスタンスにバックアップ、格納またはインポートする場合に使用します。この機能はまた、コンテンツ・タイプおよびユーザー属性をエクスポートするためにも使用できます。エクスポートされるのは単なるコピーなので、元のコンテンツはそのまま残ることに注意してください。

エクスポートできるリビジョンは、ステータスが「リリース」、「完了」、「期限切れ」および「WWW生成」のものです。アクティブなワークフロー内のリビジョン(「レビュー」、「編集」または「保留」ステータス)や、「削除済」のリビジョンはエクスポートできません。

- 第26.1.1項「エクスポートの用途」

- 第26.1.2項「エクスポートの方法」

26.1.1 エクスポートの用途

エクスポート機能の一般的な用途は次のとおりです。

- イントラネットからファイルをコピーして、ベンダーや顧客がエクストラネットでファイルを表示できるようにします。

- コンテンツ・アイテムのアーカイブを作成し、異なるメタデータを使用して同じインスタンスにそれを再びインポートします。

- コンテンツ・サーバー・インスタンスからコンテンツを削除して、永続的または一時的に格納します。たとえば、領域が不足した場合や、パフォーマンスが低下した場合は、各ファイルの最新リビジョン以外をすべて削除します。

- 開発コンテンツ・サーバー・インスタンスからのファイル、コンテンツ・タイプおよびユーザー属性を、本番インスタンスで使用できるようにコピーします。

注意:
アーカイバを障害回復の主要な方法として使用しないでください。データベースおよびファイル・システムの標準的なバックアップ・システムを使用してください。

26.1.2 エクスポートの方法

エクスポート条件を設定した後は、次の方法でアーカイブをエクスポートできます。

- 手動: 管理者がアーカイバから1回限りのエクスポートを開始します。この場合、ローカル・コンテンツ・サーバー・インスタンスにアーカイブが作成されます。

- 自動(レプリケーション): エクスポート条件を満たすコンテンツ・アイテムに索引が付けられるたびに、ローカル・アーカイブへのエクスポートが自動的に開始されます。

これらのプロセスの詳細は、第26.2.1項および第29章を参照してください。

注意:
期限切れのリビジョンは手動ではエクスポートできますが、自動的にはエクスポートされません。

26.2 エクスポートの管理

この項では、エクスポートの管理に使用される標準的なタスクについて説明します。

- 第26.2.1項「手動でのエクスポート」

- 第26.2.2項「コンテンツ・アイテムのエクスポート問合せの作成」

- 第26.2.3項「構成情報のエクスポート」

- 第26.2.4項「アーカイブへの表の追加」

- 第26.2.5項「表のアーカイブ・プロパティの編集」

- 第26.2.6項「表のエクスポート問合せの作成」

- 第26.2.7項「エクスポート・オプションの設定」

- 第26.2.8項「エクスポートの開始」

26.2.1 手動でのエクスポート

手動でコンテンツをエクスポートする手順は、次のとおりです。

1. エクスポートされたコンテンツ・サーバー・データを格納するアーカイブを作成します。第25.2.1項を参照してください。

2. 現在のアーカイブ・リストからアーカイブを選択します。

3. エクスポート問合せを作成します。第26.2.2項を参照してください。

4. 構成情報のエクスポート・オプションを設定します。第26.2.3項を参照してください。

5. 一般的なエクスポート・オプションを設定します。第26.2.7項を参照してください。

6. エクスポートを開始します。第26.2.8項を参照してください。

26.2.2 コンテンツ・アイテムのエクスポート問合せの作成

エクスポート問合せは、エクスポートされるリビジョンを定義するものです。エクスポート問合せを作成する手順は、次のとおりです。

1. アーカイブ・コレクションを開きます。第25.3.1項を参照してください。

2. 現在のアーカイブ・リストからアーカイブを選択します。

3. アーカイバの「データのエクスポート」メイン画面をクリックします。

4. 「エクスポート問合せ」(コンテンツ)セクションで「編集」をクリックします。

5. 「エクスポート問合せの編集(コンテンツ)」ウィンドウで、「フィールド」リストからメタデータ・フィールドを選択します。

6. リストから「演算子」を選択します。

- 使用可能な演算子は、選択したフィールドによって異なります。

- 使用可能な演算子は、基本のSQL問合せ演算子にマップされます。他のSQL問合せ演算子を使用するには、基本式を作成してから、「カスタム問合せ式」ボックスでその式を編集します(手順10を参照)。

7. 「値」フィールドに条件を入力します。
「フィールド」リストで選択したオプションに応じて、テキストを直接入力するか、「選択」ボタンをクリックして使用可能な値から選択するか、あるいは使用可能な値のリストから直接選択することが可能になります。

8. 「追加」をクリックします。

問合せ式が「問合せ式」ボックスに追加され、その問合せ式のSQLバージョンが「カスタム問合せ式」ボックスに表示されます。

9. 問合せ式に追加するには、手順5から8までを繰り返します。デフォルトでは、式の各部分がAND演算子を使用して加算されます。
既存の問合せを更新するには、「問合せ式」ボックスで変更する行を選択し、必要に応じて「フィールド」フィールド、「演算子」フィールドおよび「値」フィールドを編集します。「更新」をクリックします。選択した行が、指定した問合せ式で置き換えられます。

問合せ式から行を削除するには、「問合せ式」ボックスで削除する行を選択します。「削除」をクリックします。選択した行が削除されます。

10. SQL式を直接編集する手順は、次のとおりです。

1. 「カスタム問合せ式」を選択します。

2. 「カスタム問合せ式」ボックス内のテキストを編集します。
問合せ式内ではIdocスクリプトを使用できます。たとえば、作成後1年を経過したコンテンツをアーカイブする場合は、「リリース日」の値として<$dateCurrent(-365)$を使用します。詳細は、『Oracle WebCenter Contentでの開発』を参照してください。

注意:
「カスタム問合せ式」チェック・ボックスの選択を解除すると、問合せ式は元の定義に戻り、変更内容はすべて失われます。

11. 最後のエクスポートの日付に基づいてリビジョンをエクスポートするかどうかを指定します。

- 最後のエクスポート以降にリリースされたリビジョンのみをエクスポートするには、「リリース日が最終エクスポートの日付よりも新しいリビジョンをエクスポートする。」を選択します。

- すべてのリビジョンをエクスポートするには、「リリース日が最終エクスポートの日付よりも新しいリビジョンをエクスポートする。」の選択を解除します。

12. Oracle Content Publisherによってコンテンツ・サーバー・インスタンスにパブリッシュされたリビジョンをエクスポートするかどうかを指定します。

- パブリッシュされたリビジョンをエクスポートするには、「パブリッシュ済のリビジョンのエクスポートを許可する」を選択します。

- パブリッシュされていないリビジョンのみをエクスポートするには、「パブリッシュ済のリビジョンのエクスポートを許可する」の選択を解除します。

13. エクスポートするリビジョンを指定します。

- 各コンテンツ・アイテムのすべてのリビジョンをエクスポートするには、「選択されたリビジョンすべて」オプションを選択します。

- 各コンテンツ・アイテムの最新リビジョンのみをエクスポートするには、「最新リビジョン」オプションを選択します。

- 最新リビジョンを除くすべてのリビジョンをエクスポートするには、「最新リビジョン以外」オプションを選択します。

- 問合せに一致する最新リビジョンをエクスポートするには、「単一リビジョンのレプリケーション」オプションを選択します。このオプションがレプリケーション・プロセスに与える影響の詳細は、第29.1.3項を参照してください。

注意:
「最新リビジョン」オプションと自動レプリケーションを組み合せて使用しないでください。これらのオプションを組み合せて使用すると、アーカイブが予期しない動作をすることがあります。自動レプリケーションの詳細は、第29章を参照してください。

14. 「OK」をクリックします。「コンテンツ」タブの「エクスポート問合せ」ボックスにエクスポート問合せが表示されます。

15. エクスポートに含められるリビジョンのリストを表示するには、「プレビュー」をクリックします。

注意:
エクスポートできるリビジョンの数に制限はありませんが、「エクスポート問合せの条件を満たすコンテンツ」ページに表示できるリビジョンは100個までです。「フィルタ」機能および「リリース日以降」機能を使用して、必要に応じてリストのサブセットを表示します。

16. 「エクスポート問合せのプレビュー(コンテンツ)」ウィンドウのリストをレビューして、エクスポートに対象のリビジョンが含まれていることを確認します。

17. 「Close」をクリックします。

26.2.3 構成情報のエクスポート

コンテンツ・タイプおよびユーザー属性をエクスポートする手順は、次のとおりです。

1. アーカイブ・コレクションを開きます。第25.3.1項を参照してください。

2. 現在のアーカイブ・リストからアーカイブを選択します。

3. アーカイバの「データのエクスポート」メイン画面をクリックします。

4. 「追加データ」セクションで「編集」をクリックします。
「追加データの編集」ページが表示されます。

5. コンテンツ・タイプをエクスポートするには、「コンテンツ構成情報のエクスポート」を選択します。

6. ユーザー・データをエクスポートするには、「ユーザー構成情報のエクスポート」を選択します。

7. 「OK」をクリックします。
「データのエクスポート」タブの「追加データ」セクションに構成情報オプションが表示されます。

26.2.4 アーカイブへの表の追加

アーカイブに表を追加する手順は、次のとおりです。

1. アーカイブ・コレクションを開きます。第25.3.1項を参照してください。

2. 現在のアーカイブ・リストからアーカイブを選択します。

3. アーカイバ・エクスポートのメイン画面(表)をクリックします。

4. 現在のアーカイブ・リストからアーカイブを選択します。

5. 「追加」をクリックします。

6. 必要に応じて「新規表の追加」ウィンドウの残りのフィールドに入力します。これらのフィールドは、スキーマで使用される表内の親/子関係をエクスポートするために使用されます。

7. 「OK」をクリックします。
表が「表」タブの「表」リストに追加されます。

注意:
2つの表の間に関係を作成する場合、表をエクスポートする際に、列の名前が同じであることを確認してください。関係を割り当てずに各表を個別にインポートする場合、列名を一致させる必要はありません。しかし、各表を関係付けてインポートする場合は、列名を同じにする必要があります。

26.2.5 表のアーカイブ・プロパティの編集

表のアーカイブ・プロパティを編集する手順は、次のとおりです。

1. アーカイブ・コレクションを開きます。第25.3.1項を参照してください。

2. 現在のアーカイブ・リストからアーカイブを選択します。

3. アーカイバ・エクスポートのメイン画面(表)をクリックします。

4. 現在のアーカイブ・リストからアーカイブを選択します。

5. 「表」リストから表を選択します。

6. 「編集」をクリックします。

7. 必要に応じて「表の編集」ウィンドウの残りのフィールドに入力します。

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

26.2.6 表のエクスポート問合せの作成

エクスポートされる表を定義する問合せを作成する手順は、次のとおりです。

1. アーカイブ・コレクションを開きます。第25.3.1項を参照してください。

2. 現在のアーカイブ・リストからアーカイブを選択します。

3. アーカイバ・エクスポートのメイン画面(表)をクリックします。

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

5. 「エクスポート問合せ」セクションで「編集」をクリックします。

6. 「エクスポート問合せの編集」(表)ウィンドウで、「フィールド」リストからメタデータ・フィールドを選択します。

7. リストから「演算子」を選択します。

- 使用可能な演算子は、選択したフィールドによって異なります。

- 使用可能な演算子は、基本のSQL問合せ演算子にマップされます。他のSQL問合せ演算子を使用するには、基本式を作成してから、「カスタム問合せ式」ボックスでその式を編集します(手順10を参照)。

8. 「値」フィールドに条件を入力します。

9. 「追加」をクリックします。

問合せ式が「問合せ式」ボックスに追加され、その問合せ式のSQLバージョンが「カスタム問合せ式」ボックスに表示されます。

10. 問合せ式に追加するには、手順6から9までを繰り返します。デフォルトでは、式の各部分がAND演算子を使用して加算されます。

11. 既存の問合せを更新する手順は、次のとおりです。

1. 「問合せ式」ボックスで、変更する行を選択します。

2. 必要に応じて「フィールド」フィールド、「演算子」フィールドおよび「値」フィールドを編集します。

3. 「更新」をクリックします。選択した行が、指定した問合せ式で置き換えられます。

12. 問合せ式から行を削除する手順は、次のとおりです。

1. 「問合せ式」ボックスで、削除する行を選択します。

2. 「削除」をクリックします。選択した行が削除されます。

13. SQL式を直接編集する手順は、次のとおりです。

1. 「カスタム問合せ式」を選択します。

2. 「カスタム問合せ式」ボックス内のテキストを編集します。問合せ式内ではIdocスクリプトを使用できます。詳細は、『Oracle WebCenter Contentでの開発』を参照してください。

注意:
「カスタム問合せ式」チェック・ボックスの選択を解除すると、問合せ式は元の定義に戻り、変更内容はすべて失われます。

14. 「OK」をクリックします。
「表」タブの「エクスポート問合せ」ボックスに、エクスポート問合せが表示されます。

15. エクスポートに含められる表のリストを表示するには、「プレビュー」をクリックします。

注意:
エクスポートできる表の数に制限はありませんが、「エクスポート問合せの条件を満たすコンテンツ」ページに表示できる表は100個までです。「フィルタ」機能および「リリース日以降」機能を使用して、必要に応じてリストのサブセットを表示します。

16. 「エクスポート問合せのプレビュー(コンテンツ)」ウィンドウのリストをレビューして、エクスポートに対象のリビジョンが含まれていることを確認します。

17. 「Close」をクリックします。

26.2.7 エクスポート・オプションの設定

一般的なエクスポート・オプションを設定する手順は、次のとおりです。

1. アーカイブ・コレクションを開きます。第25.3.1項を参照してください。

2. 現在のアーカイブ・リストからアーカイブを選択します。

3. アーカイバのメイン・ウィンドウをクリックします。

4. 「エクスポート・オプション」セクションで「編集」をクリックします。

5. 「エクスポート・オプションの編集」ウィンドウで、エクスポート時に既存のバッチ・ファイルを置き換えるかどうかを指定します。

- 次のエクスポートの開始時に既存のバッチ・ファイルをすべて削除するには、「既存のエクスポート・ファイルを置換」を選択します。

- 次のエクスポートの開始時に既存のバッチ・ファイルを残すには、「既存のエクスポート・ファイルを置換」の選択を解除します。

6. エクスポートするファイルを指定します。

- ネイティブ・ファイル(vault)およびWeb表示可能ファイル(weblayout)をエクスポートするには、「Webコンテンツをコピー」を選択します。

- ネイティブ(vault)ファイルのみをエクスポートするには、「Webコンテンツをコピー」の選択を解除します。

7. コンテンツをエクスポートするかどうかを指定します。

- 表のみをエクスポートするには、「表のみエクスポート」を選択します。

- コンテンツ・アイテムをエクスポートするには、「表のみエクスポート」の選択を解除します。

8. 「OK」をクリックします。
「一般」タブの「エクスポート・オプション」セクションに、エクスポート・オプションが表示されます。

26.2.8 エクスポートの開始

コンテンツおよび構成情報を手動でエクスポートする手順は、次のとおりです。

1. エクスポートするファイルが含まれるコンテンツ・サーバー・インスタンスに対してアーカイバを開きます。

2. アーカイブ・コレクションを開きます。第25.3.1項を参照してください。

3. 現在のアーカイブ・リストで、エクスポートするアーカイブを選択します。

4. 「アクション」から、「エクスポート」を選択します。

注意:
「エクスポート」オプションが無効にされていると、アーカイブは自動的にエクスポートされます。手動でエクスポートを実行するには、自動レプリケーションを無効にする必要があります。詳細は第29章を参照してください

5. 「エクスポート・アーカイバ」ウィンドウで、エクスポートが正常に完了した後にコンテンツ・サーバー・インスタンスからリビジョンを削除するかどうかを指定します。

- エクスポート後にリビジョンを削除するには、「アーカイブの正常終了後リビジョンを削除」を選択します。

- エクスポート後もリビジョンをコンテンツ・サーバー・インスタンス内に残すには、「アーカイブの正常終了後リビジョンを削除」の選択を解除します。

6. 「OK」をクリックします。
エクスポート・プロセスが開始され、アーカイバ画面の下部にあるステータス・バーに進捗メッセージが表示されます。

27 アーカイブからのデータのインポート

この章では、アーカイバ・アプリケーションのインポート機能を使用して、Oracle WebCenter Content Serverのファイルと情報をエクスポート済のコンテンツ・サーバー・アーカイブから取得する方法について説明します。一般的にインポートは、別のコンテンツ・サーバー・インスタンスからコンテンツのコピーを取得する場合や、格納されているデータをリストアする場合に使用します。

この章の内容は、次のとおりです。

- ファイルのインポートの理解

- インポート・ルールについて

- データのインポート

27.1 ファイルのインポートの理解

アーカイバのインポート機能を使用すると、指定したルールに従って、指定した時刻にアーカイブをコンテンツ・サーバー・リポジトリに移動できます。ファイル内のデータを受取り側のコンテンツ・サーバー・インスタンス内のフィールドにマップできますが、インポート中に適切なルールが適用されるように注意する必要があります。

インポート先のコンテンツ・サーバー・インスタンスは、アーカイブのエクスポート元のインスタンスと同じメタデータ・フィールド、セキュリティ・グループおよびアカウントを持つ必要があります。不一致があるとエラーが発生する場合があります。

注意:
アーカイバを障害回復の主要な方法として使用しないでください。そのかわりに、データベースおよびファイル・システムの標準的なバックアップ・システムを使用してください。

注意:
インポートされるリビジョンは、アクティブなワークフローの条件を満たしていても、インポート時にワークフローに入りません。

インポート・プロセスを開始する前に、次の点について考慮してください。

- 使用する方法(手動または自動)を決定します。

- 更新に使用されるルールを決定します。

- マッピングおよびインポートのオプションを決定します。

- 選択したリビジョンをインポートして、プロセスをテストします。

この項の項目は次のとおりです。

- 第27.1.1項「インポートの用途」

- 第27.1.2項「インポートの方法」

27.1.1 インポートの用途

インポート機能の一般的な用途は次のとおりです。

- イントラネットからアーカイブされたデータを、ベンダーや顧客が表示できるようにエクストラネットに配置します。

- 多数のコンテンツ・アイテムのメタデータを変更します。たとえば、従業員が組織を退社する場合、その従業員のコンテンツ・アイテムすべてをエクスポートし、作成者として指定された別のユーザーを使用してそれをインポートします。

- 誤って削除したコンテンツや、誤って変更した構成情報をリストアします。

- 開発コンテンツ・サーバー・アーカイブからのファイル、コンテンツ・タイプおよびユーザー属性を本番インスタンスにコピーします。

27.1.2 インポートの方法

アーカイブをインポートするには、次の方法があります。

- 手動: 管理者がアーカイバから1回限りのインポートを開始します。

- 自動(レプリケーション): 約1分間に1回、ローカル・アーカイブからのインポートが自動的に開始されます。

詳細は、第27.3項および第29章を参照してください。

27.2 インポート・ルールについて

インポート・ルールとは、インポート中にリビジョンをどのように追加、置換または削除するかを定義したものです。

- インポート中、アーカイバによって、インポートされる各リビジョンがインポート側のコンテンツ・サーバー・インスタンス内の既存のリビジョンと比較されます。インポート・ルールは、次の情報の比較に基づいて、実行する処理(追加、置換、削除または無視)を指定します。

- コンテンツID

- 元のコンテンツ・サーバー

- リビジョン番号

- リリース日

- アーカイブのインポート1回につき、1つのみのインポート・ルールを選択できます。

この項の項目は次のとおりです。

- 第27.2.1項「インポート・ルール「更新」」

- 第27.2.2項「インポート・ルール「リビジョン挿入」」

- 第27.2.3項「インポート・ルール「作成挿入」」

- 第27.2.4項「インポート・ルール「リビジョンの削除」」

- 第27.2.5項「インポート・ルール「すべてのリビジョンを削除する」」

27.2.1 インポート・ルール「更新」

既存のリビジョンを置換して新しいリビジョンを挿入する場合は、インポート・ルール「更新」を使用します。

注意:
インポート・ルール 「更新」 を適用すると、既存のリビジョンが既存のファイルに保存されずに置き換えられます。保持するコンテンツを誤って置き換えないように、インポート時には十分に注意してください。

- インポートされるリビジョンのコンテンツID (dDocName)が既存のリビジョンと異なる場合、インポートされるリビジョンは新しいリビジョンとして挿入されます。

- インポートされるリビジョンのコンテンツID (dDocName)が既存のリビジョンと同じである場合、インポートされるリビジョンは挿入されるか、無視されるか、あるいは最新の既存リビジョンを置き換えます。

図27-1 インポート・ルール: 更新

27.2.2 インポート・ルール「リビジョン挿入」

インポート・ルール「リビジョン挿入」では、最新のリビジョン番号と最新のリリース日の両方を持つリビジョンのみがインポートされます。

- インポートされるリビジョンのコンテンツID (dDocName)が既存のリビジョンと異なる場合、インポートされるリビジョンは新しいリビジョンとして挿入されます。

- インポートされるリビジョンのコンテンツID (dDocName)は既存のリビジョンと同じであるが、リビジョンID (dRevisionID)が既存のリビジョンとは異なり、かつリリース日(dInDate)が最新の既存リビジョンよりも新しい場合、インポートされるリビジョンは新しいリビジョン・ラベルを持つ新しいリビジョンとして挿入されます。

図27-2 インポート・ルール: リビジョン挿入

27.2.3 インポート・ルール「作成挿入」

インポート・ルール「作成挿入」では、リビジョン番号にかかわらず、最新のリリース日を持つリビジョンのみがインポートされます。

- インポートされるリビジョンのコンテンツID (dDocName)が既存のリビジョンと異なる場合、インポートされるリビジョンは新しいリビジョンとして挿入されます。

- インポートされるリビジョンのコンテンツID (dDocName)は既存のリビジョンと同じであるが、インポートされるリビジョンのリリース日(dInDate)が最新の既存リビジョンのリリース日とは異なる場合、インポートされるリビジョンは新しいリビジョン・ラベルを持つ新しいリビジョンとして挿入されます。

注意:
手動インポートのかわりに自動インポートが実行された場合、インポート・ルールはupdateまたはdeleteRevのどちらかになります。deleteRevオプションは自動エクスポートの削除の際に考慮されます。その他のすべての場合は、インポート・ルールはupdateになります。インポート・ルールが「作成挿入」に設定されており、自動インポートが使用された場合、ルールは考慮されません。

図27-3 インポート・ルール: 作成挿入

27.2.4 インポート・ルール「リビジョンの削除」

個々のリビジョンを削除する場合は、インポート・ルール「リビジョンの削除」を使用します。

- インポートされるリビジョンのコンテンツID (dDocName)とリビジョンID (dRevisionID)が既存のリビジョンと同じである場合、既存のリビジョンは削除されます。

図27-4 インポート・ルール: リビジョンの削除

27.2.5 インポート・ルール「すべてのリビジョンを削除する」

コンテンツ・アイテムのすべてのリビジョンを削除する場合は、インポート・ルール「すべてのリビジョンを削除する」を使用します。

- インポートされるリビジョンのコンテンツID (dDocName)が既存のリビジョンと同じである場合、そのコンテンツIDを持つすべての既存リビジョンが削除されます。

図27-5 インポート・ルール: すべてのリビジョンを削除する

27.3 データのインポート

この項では、インポート・プロセスおよびタスクについて説明します。

ヒント:
取得対象のデータが含まれるアーカイブを判別するために、Webレイアウト・エディタを使用して「アーカイブ履歴」レポートを準備できます。
アーカイブにより生成されたファイルをファイル・システム・レベルで調べることもできますが、アーカイブされたデータを頻繁に調べる必要がある場合は、レポートを準備するほうが効率的です。

重要:
Sybaseを使用している場合、アーカイブをインポートするには、次のタスクを実行する必要があります。

1. 管理者としてコンテンツ・サーバー・インスタンスにログインしていることを確認します。

2. 「管理」→「管理アプレット」→「リポジトリ・マネージャ」を選択します。

3. 「インデクサ」タブをクリックします。

4. 「自動更新サイクル」セクションで「構成」をクリックします。

5. 「インデクサの自動更新」の選択が解除されていることを確認します。

6. 「リポジトリ・マネージャ」を閉じます。

7. アーカイバを使用して、アーカイブをインポートします。

8. 「リポジトリ・マネージャ」を開いて、「インデクサの自動更新」を再び選択します。

この項の項目は次のとおりです。

- 第27.3.1項「アーカイブ済データの手動でのインポート」

- 第27.3.2項「フィールドの変更の設定」

- 第27.3.3項「値の変更の設定」

- 第27.3.4項「インポート・オプションの設定」

- 第27.3.5項「個々のリビジョンのインポート」

- 第27.3.6項「インポートの開始」

27.3.1 アーカイブ済データの手動でのインポート

アーカイブされたデータを手動でインポートする手順は、次のとおりです。

1. アーカイブ・コレクションを開きます。第25.3.1項を参照してください。

2. 現在のアーカイブ・リストで、データの取得元のアーカイブを選択します。

3. アーカイブ内のバッチ・ファイルをレビューします。必要に応じて、バッチ・ファイルからリビジョンを削除します。第25.4.1項を参照してください。

4. インポート時にメタデータ・フィールドまたは値を変更する場合は、フィールドおよび値のマッピングを設定します。第27.3.2項および第27.3.3項を参照してください。

5. 一般的なインポート・オプションを設定します。第27.3.4項を参照してください。

6. いくつかの個別リビジョンに対してインポート・マッピングおよびインポート・ルールをテストします。第27.3.5項を参照してください。

7. インポートを開始します。第27.3.6項を参照してください。

27.3.2 フィールドの変更の設定

フィールドの変更は、インポート中にメタデータ・フィールド間でフィールドおよび値をどのようにコピーするかを指定したものです。メタデータ値をコピーしない場合は、フィールドの変更を指定しないでください。

フィールドの変更を設定する手順は、次のとおりです。

1. アーカイブ・コレクションを開きます。第25.3.1項を参照してください。

2. 現在のアーカイブ・リストからアーカイブを選択します。

3. 「インポート・マッピング」メイン・ウィンドウをクリックします

4. 「フィールドの変更」セクションで「編集」をクリックします。

5. 「フィールドの編集」/「値の変更」ウィンドウで、「フィールドの参照」をクリックします。

6. 「フィールドの参照」/「値の参照」ウィンドウで、使用可能なメタデータ・フィールドのリストのソースを選択します。

- ローカル・コンテンツ・サーバー・インスタンスからメタデータ・フィールドを取得するには、「ローカル・システム」を選択します。

- バッチ・ファイルからメタデータ・フィールドを取得するには、「バッチ」を選択し、リストからバッチ・ファイルを選択します。

7. 「OK」をクリックします。
「エクスポート・フィールド」リストには、コンテンツ・サーバー・インスタンスまたは選択したバッチ・ファイルに関連付けられたメタデータ・フィールドが移入されます。

8. 「エクスポート・フィールド」リストで、メタデータのコピー元のメタデータ・フィールドを選択します。

選択したメタデータ・フィールドが「エクスポート・フィールド」に表示されます。(このフィールドを直接編集することもできます。必ず、dDocAuthorやxCommentsなどの内部フィールド名を使用してください。)

9. 「ターゲット・フィールド」リストで、エクスポート・メタデータのコピー元のメタデータ・フィールドを選択します。

10. 「追加」をクリックします。

マッピング式が「フィールドの変更」ボックスに追加されます。

11. マッピング式に追加するには、手順8から10までを繰り返します。

12. 既存のマッピング式を更新する手順は、次のとおりです。

1. 「フィールドの変更」ボックスで、変更する行を選択します。

2. 必要に応じて「エクスポート・フィールド」および「ターゲット・フィールド」を編集します。

3. 「更新」をクリックします。
選択した行が、指定したマッピングで置き換えられます。

13. マッピング式から行を削除する手順は、次のとおりです。

1. 「フィールドの変更」ボックスで、削除する行を選択します。

2. 「削除」をクリックします。
選択した行が削除されます。

14. 「OK」をクリックします。
インポート中、「エクスポート・フィールド」からの値が「ターゲット・フィールド」内の既存の値を置き換えます。

15. フィールドの変更の結果をテストするには、アーカイブから個々のリビジョンをいくつかインポートします。第27.3.5項を参照してください。

27.3.3 値の変更の設定

値の変更は、インポート中に特定のメタデータ値をどのように変更するかを指定したものです。メタデータ値を変更しない場合は、値の変更を指定しないでください。

値の変更を設定する手順は、次のとおりです。

1. アーカイブ・コレクションを開きます。第25.3.1項を参照してください。

2. 現在のアーカイブ・リストからアーカイブを選択します。

3. 「インポート・マッピング」メイン・ウィンドウをクリックします

4. 「値の変更」セクションで「編集」をクリックします。

- 「フィールドの編集」/「値の変更」ウィンドウで、特定のフィールドに対するすべてのメタデータ値を変更するには、「すべて」を選択します。手順11に進みます。

- 特定のメタデータ値を変更するには、「値の参照」をクリックします。

5. 「フィールドの参照」/「値の参照」ウィンドウで、「バッチ・ファイルから」リストからバッチ・ファイルを選択します。

6. 「次のフィールドから」リストからメタデータ・フィールドを選択します。

7. 「OK」をクリックします。
「入力値」リストには、選択したバッチ・ファイル内の選択したメタデータ・フィールドに関連付けられた値が移入されます。

8. 「入力値」リストで、変更するメタデータ値を選択します。

9. 「フィールド」リストで、変更するメタデータ・フィールドを選択します。

10. 「出力値」フィールドに新しいメタデータ値を入力します。

- 出力値にはIdocスクリプトを使用できます。たとえば、すべてのインポート済リビジョンの有効期限をこの先1週間に設定する場合は、<dateCurrent(7)$を使用できます。詳細は、『Oracle WebCenter Contentでの開発』を参照してください。

- 入力メタデータ・フィールドからすべての値を削除するには、出力値を空白のままにしておきます。

11. 「追加」をクリックします。

マッピング式が「値の変更」ボックスに追加されます。

12. マッピング式に追加するには、手順5から11までを繰り返します。

13. 既存のマッピング式を更新する手順は、次のとおりです。

1. 「値の変更」ボックスで、変更する行を選択します。

2. 必要に応じて「入力値」、「フィールド」および「ターゲット値」を編集します。

3. 「更新」をクリックします。
選択した行が、指定したマッピングで置き換えられます。

14. マッピング式から行を削除する手順は、次のとおりです。

1. 「値の変更」ボックスで、削除する行を選択します。

2. 「削除」をクリックします。
選択した行が削除されます。

15. 「OK」をクリックします。
インポート中、指定したメタデータ・フィールド内の指定した「入力値」が「ターゲット値」で置き換えられます。

16. 値の変更の結果をテストするには、アーカイブから個々のリビジョンをいくつかインポートします。第27.3.5項を参照してください。

27.3.4 インポート・オプションの設定

一般的なインポート・オプションを設定する手順は、次のとおりです。

1. アーカイブ・コレクションを開きます。第25.3.1項を参照してください。

2. 現在のアーカイブ・リストからアーカイブを選択します。

3. 「アーカイバ」ウィンドウの「一般」タブで、「インポート・オプション」セクションにある「編集」をクリックします。

4. 「インポート・オプションの編集(オプションの選択)」ウィンドウで、「インポート・ルールのオーバーライド」リストでオプションを選択して、インポート中に既存のリビジョンをどのように追加、置換または削除するかを指定します。詳細は、第27.2項を参照してください。

注意:
インポート・ルール「更新」を適用すると、既存のリビジョンが既存のファイルに保存されずに置き換えられます。保持するコンテンツを誤って置き換えないように、インポート時には十分に注意してください。

5. インポート時にオプション・リストの値を検証するかどうかを指定します。

- 有効なオプション・リスト値を持つリビジョンのみ(検証されたオプション・リストのみ)をインポートするには、「有効なオプション・リストの値を持つリビジョンのみをインポート」を選択します。

- オプション・リストの検証をスキップするには、「有効なオプション・リストの値を持つリビジョンのみをインポート」の選択を解除します。

ヒント:
「有効なオプション・リストの値を持つリビジョンのみをインポート」チェック・ボックスは、検証されたすべてのオプション・リストに適用されます。一部のオプション・リスト・フィールドのみを検証する場合は、構成マネージャで「オプション・リスト・タイプ」を変更できます。検証するオプション・リストには「Vタイプの選択リスト」を使用し、検証しないオプション・リストには「NVタイプの選択リスト」を使用します。

6. ターゲット・コンテンツ・サーバー・インスタンスのタイムゾーンを反映するようにメタデータ日付フィールド内の時刻を再計算するかどうかを指定します。

- 時刻を再計算するには、「日付をシステムの現在のタイムゾーンに変換」を選択します。
たとえば、ソース(エクスポート)コンテンツ・サーバー・インスタンスのタイムゾーンが中央標準時間であり、ターゲット(インポート)コンテンツ・サーバー・インスタンスのタイムゾーンが東部標準時間の場合、リリース時刻、作成時刻、有効期限およびカスタム時刻は1時間後に変更されます。

- 時刻を変更しない場合は、「日付をシステムの現在のタイムゾーンに変換」の選択を解除します。

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

8. インポート・オプションの結果をテストするには、アーカイブから個々のリビジョンをいくつかインポートします。第27.3.5項を参照してください。

27.3.5 個々のリビジョンのインポート

特定のリビジョンをインポートする手順は、次のとおりです。

ヒント:
バッチ・ファイル全部をインポートする前に、この手順を使用して個々のリビジョンをいくつかインポートし、インポート・マップおよびルールの結果をテストします。

1. アーカイブ・コレクションを開きます。第25.3.1項を参照してください。

2. 現在のアーカイブ・リストからアーカイブを選択します。

3. 「アーカイバ」ウィンドウの「一般」タブで、「バッチ・ファイルの表示」をクリックします。

4. 「バッチ・ファイルからのリビジョンの削除」ウィンドウで、インポートするファイルを含むバッチ・ファイルを選択します。

5. 「編集」をクリックします。

6. 「エクスポート済コンテンツ・アイテムの表示」ウィンドウで、「フィルタ」機能およびナビゲーション・ボタンを使用して、インポートするリビジョンを表示します。

7. リビジョンを選択します。

8. 「インポート」をクリックします。
リビジョンが正常にインポートされると、確認メッセージが表示されます。

27.3.6 インポートの開始

コンテンツおよび構成情報のインポートを開始する手順は、次のとおりです。

1. 情報をインポートするコンテンツ・サーバー・インスタンスのアーカイバを開きます。

2. 情報のインポート元のアーカイブ・コレクションを開きます。(ファイル・システム経由でこのコレクションにアクセスできることが必要です。)第25.3.1項を参照してください。

3. 現在のアーカイブ・リストからアーカイブを選択します。

4. 「アクション」メニューから、「インポート」を選択します。

5. 「インポート・アーカイバ」ウィンドウで、インポートする情報を指定します。

- コンテンツをインポートするには、「バッチ化したリビジョンをインポート」を選択します。

- コンテンツおよび表をインポートするには、「表のインポート」を選択します。

注意:
「ユーザー構成情報」オプションと「コンテンツ構成情報」オプションは、この情報(users.hdaまたはdoctypes.hdaファイル)が選択したアーカイブに含まれている場合にのみ使用可能になります。

6. 「OK」をクリックします。
インポート・プロセスが開始され、アーカイバ・ページの下部にあるステータス・バーに進捗メッセージが表示されます。

28 ファイルの転送

この章では、アーカイバ・ユーティリティの転送機能を使用して、Oracle WebCenter Content Serverインスタンス間でのソケットを通じたコンテンツの移動またはコピーについて説明します。

この章の内容は、次のとおりです。

- ファイルの転送の概要

- 転送タイプの理解

- バッチ・ファイルの転送の動作

- 転送の管理

28.1 ファイルの転送の概要

転送機能を使用して、共有ファイル・システム上のコンテンツ・サーバー・インスタンス間でファイルを転送できますが、転送に共有ファイル・システムは必要ありません。非共有ファイル・システム間でファイルを転送するには、ソース・コンテンツ・サーバー・インスタンス上に送信プロバイダが必要です。

転送は、バージョン4.5以上のコンテンツ・サーバー・システム間でのみ正常に行われます。

注意:
アーカイバを使用して、同じコンテンツ・サーバー・インスタンス名(IDC_Name)を共有する2つのインスタンス間でデータを移動またはコピーすることはできません。これを行うと、ターゲット・システムのデータが破損します。

この項の項目は次のとおりです。

- 第28.1.1項「転送の用途」

- 第28.1.2項「転送の方法」

- 第28.1.3項「転送の用語」

28.1.1 転送の用途

転送機能の一般的な用途は次のとおりです。

- ファイアウォールを経由するコンテンツのエクスポートおよびインポートを実行します。

注意:
ファイアウォールを経由して転送するには、送信プロバイダのソケットがファイアウォールを通過できるようにファイアウォールを構成する必要があることがあります。

- 物理的に異なる場所(建物、都市または国)にあるコンテンツ・サーバー・インスタンス間でコンテンツを転送します。

- 共有ドライブを使用してコンテンツ・サーバー・インスタンス間でコンテンツを転送します。(サイズの大きいアーカイブを処理する場合、ソケット転送よりもファイル・システム共有による転送のほうが適しています。)

- 異なるファイル・システム間でファイルを移動するためにFTPまたはHTTPインタフェースを構築する必要をなくします。

- 2つのアーカイブからのバッチ・ファイルを1つのアーカイブに結合します。

28.1.2 転送の方法

ファイルを転送するには、次の方法があります。

- 手動転送: 管理者がアーカイバから1回限りの転送を開始します。この場合、アーカイブが別のアーカイブにコピーされます。

- 自動転送: ソース・アーカイブが更新されるたびに、アーカイブ・ファイルの別のアーカイブへの移動が開始されます。

28.1.3 転送の用語

次の用語は、転送機能に関連するものです。

- ローカル・アーカイブ: ローカル・コレクションに属するアーカイブ。

- ローカル・コレクション: コンテンツ・サーバー・インスタンスが、マップまたはマウントされたネットワーク共有を使用してファイル・アクセスによりアクセスできるコレクション。

- ローカル転送: ローカル・アーカイブ間の転送。ソース・アーカイブとターゲット・アーカイブの両方がローカル・コレクション内にあります。

- プロキシ: アーカイバの場合、プロキシという用語は、ローカル・コンテンツ・サーバー・インスタンスが送信プロバイダ経由で接続されるコンテンツ・サーバー・インスタンスを指します。

- プロキシ・アーカイブ: プロキシ・コレクションに属するアーカイブ。

- プロキシ・コレクション: ローカル・コンテンツ・サーバー・インスタンスが送信プロバイダ経由で接続できる別のコンテンツ・サーバー・インスタンス上のコレクション。

- プル転送: プロキシ(リモート)コンテンツ・サーバー・インスタンスが所有する、送信プロバイダを経由する転送。

- プッシュ転送: ローカル・コンテンツ・サーバー・インスタンスが所有する、送信プロバイダを経由する転送。

- ソース・アーカイブ: 転送するバッチ・ファイルが含まれるアーカイブ。

- ターゲット・アーカイブ: 転送されたバッチ・ファイルを受け取るアーカイブ。

- 転送先になれるアーカイブ: ターゲット・アーカイブにすることができるアーカイブ。

- 転送: 異なるアーカイブ間でバッチ・ファイルおよびそれに関連付けられたコンテンツ・ファイルをコピーまたは移動するプロセス。3つのタイプの転送(ローカル、プッシュおよびプル)があります。

- 転送オーナー: 転送を実行して監視するコンテンツ・サーバー・インスタンス。

- 転送ソース: 「ソース・アーカイブ」を参照してください。

- 転送ターゲット: 「ターゲット・アーカイブ」を参照してください。

28.2 転送タイプの理解

この項では、各種の転送タイプについて説明します。最初のタイプが最も単純で、最後のタイプが最も複雑です。

- 第28.2.1項「ローカル転送」

- 第28.2.2項「プル転送」

- 第28.2.3項「プッシュ転送」

28.2.1 ローカル転送

ローカル転送とは、ソース・コンテンツ・サーバー・インスタンスとターゲット・コンテンツ・サーバー・インスタンスの両方がマップまたはマウントされたドライブを使用してアクセスできるコレクションに属するローカル・アーカイブ間で行われる転送のことです。送信プロバイダは必要ありません。このタイプの転送は通常、2つのアーカイブのバッチ・ファイルを結合するために使用します。

注意:
共有ファイル・システム上のコンテンツ・サーバー・インスタンス間で転送を行う場合、マップまたはマウントされたドライブが両方のコンテンツ・サーバー・インスタンスで使用可能になっている必要があります。これらのコンピュータが稼働中であり、どちらのコンテンツ・サーバー・インスタンスにもシステム・アクセスできるユーザーとしてログインしている必要があります。

図28-1 ローカル転送

28.2.2 プル転送

プル転送とは、プロキシ(リモート)コンテンツ・サーバー・インスタンス(送信プロバイダのターゲットであるインスタンス)が所有する転送のことです。

- 複数のプル転送を同時に行うことができます。

- ファイアウォールを経由するプル転送を実行する場合、送信プロバイダのソケットがファイアウォールを通過できるようにファイアウォールを構成する必要があることがあります。

注意:
アーカイバの場合、プロキシという用語はローカル・インスタンスが送信プロバイダ経由で接続されるコンテンツ・サーバー・インスタンスを指します。

図28-2 プル転送

28.2.3 プッシュ転送

プッシュ転送とは、ローカル・コンテンツ・サーバー・インスタンス(送信プロバイダが設定されているインスタンス)が所有する転送のことです。

- プッシュ転送のパフォーマンスを監視するために、ターゲット(プロキシ)コンテンツ・サーバー・インスタンスからソース(ローカル)コンテンツ・サーバー・インスタンスに戻る送信プロバイダも設定する必要があります。これにより、このトークバック・プロバイダは各転送の完了時にソース・コンテンツ・サーバー・インスタンスに通知できます。プッシュ転送は、トークバック・プロバイダがなくても機能しますが、その場合はソース・コンテンツ・サーバー・インスタンスが転送の完了や問題を認識できません。

- プッシュ転送は一度に1つのみ実行できます。

- ファイアウォールを経由するプッシュ転送を実行する場合、両方のプロバイダのソケットがファイアウォールを通過できるようにファイアウォールを構成する必要があることがあります。

図28-3 プッシュ転送

28.3 バッチ・ファイルの転送の動作

この項では、バッチ・ファイルの転送動作について説明します。

28.3.1 転送プロセスのアクション

転送が開始されると、次の処理が行われます。

1. アーカイブ内の各バッチ・ファイルが、関連付けられたコンテンツ・ファイルとともに圧縮されます。

2. Zipファイルが、ローカル・ファイル・システムの移動(ローカル転送)または送信プロバイダ(プッシュ転送またはプル転送)により、ターゲット・コンテンツ・サーバー・インスタンスに転送されます。

3. Zipファイルが解凍されて、適切なファイル・システムの場所に配置されます。

4. 自動転送の場合、バッチ・ファイルおよび関連付けられたコンテンツ・ファイルは、ソース・コンテンツ・サーバー・インスタンスから削除されます。手動転送の場合、バッチ・ファイルおよび関連付けられたコンテンツ・ファイルは、ソース・コンテンツ・サーバー・インスタンス内に残ります。
転送されたアーカイブは、ターゲット・コンテンツ・サーバー・インスタンスのアーカイバを介してインポートできるようになります。

図28-4 転送プロセス

28.3.2 転送ルール

次に示す転送ルールが適用されます。

- 共有ファイル・システム上のコンテンツ・サーバー・インスタンス間で転送を行う場合、マップまたはマウントされたドライブが両方のコンテンツ・サーバー・インスタンスで使用可能になっている必要があります。これらのコンピュータが稼働中であり、どちらのコンテンツ・サーバー・インスタンスにもシステム・アクセスできるユーザーとしてログインしている必要があります。

- 送信プロバイダが設定されているコンテンツ・サーバー・インスタンスはローカル・サーバーとみなされ、送信プロバイダのターゲット・コンテンツ・サーバー・インスタンスはプロキシ・サーバーとみなされます。ファイルは常に、送信プロバイダの方向、つまりローカル(ソース)インスタンスからプロキシ(ターゲット)インスタンスに転送されます。

- コンテンツ・サーバー・インスタンスから複数のアーカイブを転送するには、ターゲット・インスタンスごとにローカル・インスタンスから個別の送信プロバイダを設定する必要があります。

- 転送先になれると識別されたアーカイブのみに、ターゲットを転送できます。転送ターゲットを選択する際は、「転送先になれる」属性によりターゲット・アーカイブをすばやく見つけることができます。

- 転送に関わる少なくとも1つのアーカイブが転送オーナーに対してローカルである必要があります。たとえば、第3のコンテンツ・サーバー・インスタンスが所有する2つのコンテンツ・サーバー・インスタンス間で転送を設定することはできません。

- 1つのアーカイブには各バッチ・ファイルのコピー1つのみを含めることができます。このため、転送されるバッチ・ファイルがターゲット・アーカイブ内にすでに存在する場合、そのバッチ・ファイルおよび関連付けられたコンテンツ・ファイルは無視されます。

28.4 転送の管理

この項では、転送を管理するためのタスクについて説明します。

- 第28.4.1項「コンテンツの転送」

- 第28.4.2項「アーカイブを転送先として設定」

- 第28.4.3項「送信転送プロバイダの定義」

- 第28.4.4項「転送先(ターゲット)の設定」

- 第28.4.5項「手動転送の開始」

- 第28.4.6項「転送の削除」

28.4.1 コンテンツの転送

コンテンツ・サーバー・インスタンス間でコンテンツを転送する手順は、次のとおりです。

1. ソース・コンテンツ・サーバー・インスタンスで、転送するアーカイブを作成し、このアーカイブへのエクスポートを設定します。第26.2.1項を参照してください。

2. ターゲット・コンテンツ・サーバー・インスタンスで、転送されたコンテンツを受け取るアーカイブを作成し、それを転送先になれるターゲット・アーカイブとして設定します。第28.4.2項を参照してください。

3. コンテンツ・サーバー・インスタンス間の通信を設定します。

- ソース・アーカイブとターゲット・アーカイブが共有ファイル・システム上にある場合、両方のコンピュータが稼働中で、どちらのコンテンツ・サーバー・インスタンスにもシステム・アクセスできるユーザーとしてログインしている必要があります。

- ソース・アーカイブとターゲット・アーカイブが共有ファイル・システム上にない場合は、ソース・コンテンツ・サーバー・インスタンスからターゲット・コンテンツ・サーバー・インスタンスへの送信プロバイダを作成します。第28.4.3項を参照してください。

4. ソース・アーカイブから、ターゲット・アーカイブを指定します。第28.4.4項を参照してください。

5. 転送を開始します。第28.4.5項を参照してください。
バッチ・ファイルおよびコンテンツ・ファイルがターゲット・アーカイブにコピーされます。

28.4.2 アーカイブを転送先として設定

アーカイブが他のアーカイブからの転送を受け入れられることを示す(転送先になれるようにする)には:

1. ターゲット・アーカイブが含まれるアーカイブ・コレクションを開きます。第25.3.1項を参照してください。

2. 現在のアーカイブ・リストでターゲット・アーカイブを選択します。

3. アーカイバ転送のメイン画面をクリックします。

4. 「転送オプション」セクションで「編集」をクリックします。

5. 「転送オプション」ウィンドウで、「ターゲット可能」を選択します。

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

28.4.3 送信転送プロバイダの定義

転送に使用する送信プロバイダを作成する手順は、次のとおりです。

1. ソース・コンテンツ・サーバー・インスタンスで、送信プロバイダを作成します。次の情報を入力します。

要素

説明

プロバイダ名

名前を入力します。これは、DomainHome/ucm/cs/data/providers/ディレクトリのサブディレクトリになります。

プロバイダの説明

わかりやすい説明を入力します。たとえば、転送プロバイダなどです。

サーバー・ホスト名

ターゲット・コンテンツ・サーバー・インスタンスのサーバー・ホスト名を入力します。たとえば、extranet_serverなどです。

サーバー・ポート

プロバイダがターゲット・コンテンツ・サーバー・インスタンスとの通信に使用する一意のポート番号を入力します。

インスタンス名

ターゲット・コンテンツ・サーバー・インスタンスの名前を入力します。たとえば、instance_on_extranetなどです。

相対Webルート

ターゲット・コンテンツ・サーバー・インスタンスの相対Webルートを入力します。例: /company_name/。

2. ターゲット・コンテンツ・サーバー・インスタンスのシステム・プロパティ・ユーティリティを使用して、「IPアドレス・フィルタ」または「ホスト名フィルタ」をソース・コンテンツ・サーバー・インスタンスのIPアドレスまたはホスト名に設定します。(「IPアドレス・フィルタ」を設定することをお薦めします。)

3. プッシュ転送(ローカル・コンテンツ・サーバー・インスタンスが所有する転送)を設定する場合は、ターゲット・コンテンツ・サーバー・インスタンスからソース・コンテンツ・サーバー・インスタンスに戻るトークバック送信プロバイダを設定することを考慮してください。

4. ファイアウォールを経由する転送を行う場合は、送信プロバイダのソケットがファイアウォールを通過できるようにファイアウォールを構成します。

28.4.4 転送先(ターゲット)の設定

ターゲット・アーカイバが転送されたコンテンツを受け取るように指定する手順は、次のとおりです。

1. 転送を所有するコンテンツ・サーバー・インスタンスからアーカイバを開きます。

- プル転送の場合、転送オーナーはターゲット(プロキシ)コンテンツ・サーバー・インスタンスです。

- プッシュ転送の場合、転送オーナーはソース(ローカル)コンテンツ・サーバー・インスタンスです。

2. ソース・アーカイブが含まれるアーカイブ・コレクションを開きます。第25.3.1項を参照してください。

3. 現在のアーカイブ・リストでソース・アーカイブを選択します。

4. アーカイバ転送のメイン画面をクリックします。

5. 「転送先」セクションで「編集」をクリックします。

6. 「アーカイブ・コレクション」ウィンドウで、ターゲット・アーカイブが含まれるアーカイブ・コレクションを選択します。

7. ターゲット・アーカイブを選択します。

注意:
ターゲット・アーカイブはターゲット可能として指定されている必要があります。第28.4.2項を参照してください。

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

28.4.5 手動転送の開始

手動でコンテンツを転送する手順は、次のとおりです。

1. ソース・コンテンツ・サーバー・インスタンスでアーカイバを開きます。

2. ソース・アーカイブが含まれるアーカイブ・コレクションを開きます。第25.3.1項を参照してください。

3. 現在のアーカイブ・リストでソース・アーカイブを選択します。

4. 「アクション」を選択し、「転送」をクリックします。
転送プロセスが開始され、アーカイバ・ページの下部にあるステータス・バーに進捗メッセージが表示されます。

28.4.6 転送の削除

この項では、転送を削除する手順について説明します。

28.4.6.1 転送の削除

「転送先」タブから転送を削除するには:

1. ソース・アーカイブが含まれるアーカイブ・コレクションを開きます。第25.3.1項を参照してください。

2. 現在のアーカイブ・リストでソース・アーカイブを選択します。

3. アーカイバ転送のメイン画面をクリックします。

4. 「転送先」セクションで「削除」をクリックします。

5. アクションの確認を要求されたら、「はい」をクリックします。

28.4.6.2 自動転送の削除

「インスタンスの自動化の詳細」ページから自動転送を削除するには:

1. アーカイブ・コレクションを開きます。第25.3.1項を参照してください。

2. 「オプション」を選択し、「インスタンスの自動化の詳細を表示する」を選択します。

3. 「自動化」ウィンドウで、「転送」をタブをクリックします。

4. 削除する自動転送を選択します。

5. 「削除」をクリックします。
自動転送がリストから削除されます。

29 ファイルのレプリケート

この章では、Oracle WebCenter Contentのアーカイバ・ユーティリティのレプリケーション機能を使用して、コンテンツ・ファイルのエクスポート、インポート、および転送を自動化する方法について説明します。

この章の内容は、次のとおりです。

- レプリケーションの理解

- レプリケーションの管理

29.1 レプリケーションの理解

レプリケーションを使用してWebCenter Contentのファイルのインポートを自動化していると、自動インポートの完了直後に各バッチ・ファイルは削除されます。Webレイアウト・エディタを使用して、「アーカイブ履歴」レポートを準備することで、アーカイブ結果を確認できます。エディタの詳細は、『Oracle WebCenter Contentでの開発』を参照してください。

ファイルをコントリビューション・サーバーにレプリケートする場合は、ユーザーがインポート済ファイルに対する読取り権限のみを持つように、「セキュリティ・グループ」フィールドまたは「アカウント」フィールド(あるいはその両方)を変更する必要があります。そうしない場合、以降のレプリケーション・サイクルで、インポート側インスタンス内の変更されたファイルが、エクスポートされたファイルによって上書きされることがあります。

パフォーマンス上の理由で、レプリケーションはアーカイブが大きい場合(約20,000ファイル以上)にはお薦めできません。大きいアーカイブのエクスポートとインポートは、できる限りピーク以外の時間帯に手動で実行してください。

注意:
アーカイバ・ユーティリティを使用して、同じコンテンツ・サーバー・インスタンス名(IDC_Name)を共有する2つのインスタンス間でのデータの移動またはコピーはできません。これを行うと、ターゲット・システムのデータが破損します。

WebCenter Contentのインスタンス間でアーカイバの自動レプリケーションを構成すると、環境間でチェックイン、更新および削除のすべてのアクションがレプリケートされます。アーカイバに削除アクションをレプリケートさせない方法の詳細は、"アーカイバで削除をレプリケートさせない方法に関するブログを参照してください。

この項の項目は次のとおりです。

- 第29.1.1項「レプリケーションの用途」

- 第29.1.2項「レプリケーションの方法」

- 第29.1.3項「単一リビジョンのレプリケーション」

29.1.1 レプリケーションの用途

レプリケーション機能の一般的な用途は次のとおりです。

- コンテンツ・サーバー・インスタンスからコンテンツをエクスポートして、そのコンテンツを別のコンテンツ・サーバー・インスタンスに自動的にインポートして、2つのWebサイトを同期化します。

- 2つのコントリビューション・サーバーおよびコンサンプション・サーバーの間で自動的にコンテンツをコピーします。

- コントリビューション・サーバーからの特定のドキュメントを、よりセキュリティの強いコンテンツ・サーバー・インスタンスに自動的に移動します。

- 古いコンテンツをストレージ・ロケーションに自動的に移動します。

注意:
レプリケーション機能では、コンテンツ・タイプおよびユーザー属性はインポートされません。

29.1.2 レプリケーションの方法

アーカイバの機能を自動化するには、次の方法があります。

- 自動エクスポート: エクスポート条件を満たすコンテンツ・アイテムに索引が付けられるたびに、ローカル・アーカイブへのエクスポートが自動的に開始されます。

- 自動インポート: 約1分間に1回、ローカル・アーカイブからのインポートが自動的に開始されます。

- 自動転送: ソース・アーカイブが更新されるたびに、アーカイブ・ファイルが別のコンテンツ・サーバー・インスタンスにソケット経由で移動されます。

注意:
期限切れのリビジョンは手動ではエクスポートできますが、自動的にはエクスポートされません。

29.1.3 単一リビジョンのレプリケーション

「エクスポート問合せの編集」(コンテンツ)ウィンドウで「単一リビジョンのレプリケーション」オプションを使用する際には、次の考慮事項に注意してください。

- 新規のドキュメントは、チェックイン時にアーカイバ問合せに一致するとアーカイブされます。問合せに一致しなければ、何も行われません。

- ドキュメントに複数のリビジョンがあり、最新の一致りビジョンが削除または更新されたために問合せに一致しなくなった場合、そのドキュメントの2番目に新しい一致リビジョンがレプリケートされます。問合せに一致するリビジョンがない場合、そのドキュメントはレプリケーションで削除されます。

- システム(A)をシステム(B)にレプリケートする場合に「単一リビジョンのレプリケーション」オプションを使用すると、常にシステムBには各ドキュメントのリビジョンが1つのみ存在することになります。レプリケートされたドキュメントのrevLabelに関係なく、各リビジョンのrevLabelは1になります。

このアーカイブ・オプションを使用すると、管理者はステージング・システムおよび本番システムを作成できます。ステージング・システムは、特定のメタデータ・フィールドが1に設定されているすべてのドキュメントをアーカイブできます。本番システムには常に、このメタデータ・フラグが設定された各ドキュメントの最新リビジョンが存在します。ステージング・システムでこのフラグを0に設定すると、本番システムからこのフラグが削除され、そのメタデータ・フィールドが1に設定された2番目に新しいリビジョンにロールバックされます。

29.2 レプリケーションの管理

レプリケーション・プロセスの管理には、自動エクスポート、自動インポートおよび自動転送の設定を含むいくつかのタスクが関連します。この項では、レプリケーション・タスクについて説明します。

- 第29.2.1項「自動エクスポートの設定」

- 第29.2.2項「自動インポートの設定」

- 第29.2.3項「自動転送の設定」

- 第29.2.4項「自動インポートの無効化」

- 第29.2.5項「自動エクスポートの無効化」

- 第29.2.6項「自動転送の無効化」

- 第29.2.7項「登録済のエクスポータの削除」

29.2.1 自動エクスポートの設定

自動エクスポートを設定する手順は、次のとおりです。

1. エクスポートを設定し、手動エクスポートを実行します。第26.2.1項を参照してください。

2. コンテンツのエクスポート元のコンテンツ・サーバー・インスタンスでアーカイバを開きます。

3. アーカイブ・コレクションを開きます。

4. 現在のアーカイブ・リストで、自動的にエクスポートするアーカイブを選択します。

5. 「レプリケーション」タブをクリックします。

6. 「編集」をクリックします。

7. 「登録済のエクスポータ」ウィンドウで、「自動エクスポートを有効にする」を選択します。

8. 「登録」をクリックします。
現在のコレクションが「登録済のエクスポータ」ボックスに追加されます。

9. 「OK」をクリックします。
エクスポート条件を満たす各リビジョンが索引付けられると、このアーカイブにエクスポートされます。各エクスポートが完了した時点で、バッチ・ファイルは削除されます。

注意:
期限切れのリビジョンは手動ではエクスポートできますが、自動的にはエクスポートされません。

29.2.2 自動インポートの設定

自動インポートを設定する手順は、次のとおりです。

1. インポートを設定し、手動インポートを実行します。第27.3項を参照してください。

2. アーカイブのインポート先のコンテンツ・サーバー・インスタンスでアーカイバを開きます。

3. アーカイブ・コレクションを開きます。

4. 現在のアーカイブ・リストで、自動的にインポートするアーカイブを選択します。

5. 「レプリケーション」タブをクリックします。

6. 「現在のインスタンスを登録」をクリックします。

7. アクションの確認を要求されたら、「OK」をクリックします。
約1分間に1回、選択したアーカイブが自動的にインポートされます。各インポートが完了した時点で、すべてのソース・バッチ・ファイルは削除されます。

注意:
レプリケーション機能では、コンテンツ・タイプおよびユーザー属性はインポートされません。

29.2.3 自動転送の設定

自動転送を設定する手順は、次のとおりです。

1. 転送を設定し、手動転送を実行します。第28.1項を参照してください。

2. ソース・コンテンツ・サーバー・インスタンスでアーカイバを開きます。

3. アーカイブ・コレクションを開きます。

4. 現在のアーカイブ・リストでソース・アーカイブを選択します。

5. 「転送先」タブをクリックします。

6. 「編集」をクリックします。

7. 「転送オプション」ウィンドウで、「転送を自動化」を選択します。

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

9. 自動転送をテストします。

1. ソース・コンテンツ・サーバー・インスタンスで、エクスポート基準を満たす新規ドキュメントをチェックインします。

2. エクスポートを自動化した場合は、索引作成後に自動エクスポートが開始されるのを待ちます。そうでない場合は、ソース・アーカイブを手動でエクスポートします。アーカイブは数分でターゲット・コンテンツ・サーバー・インスタンスに転送されます。

注意:
レプリケーション機能では、コンテンツ・タイプおよびユーザー属性はインポートされません。

29.2.4 自動インポートの無効化

この項では、自動インポートを無効にする方法について説明します。

29.2.4.1 「レプリケーション」タブからのインポータの登録解除

1. アーカイブ・コレクションを開きます。第25.3.1項を参照してください。

2. 現在のアーカイブ・リストからアーカイブを選択します。

3. 「レプリケーション」タブをクリックします。

4. 「登録解除」をクリックします。
選択したアーカイブからの自動インポートが無効になります。

29.2.4.2 「インスタンスの自動化の詳細」ページからの登録済インポータの無効化

1. アーカイブ・コレクションを開きます。第25.3.1項を参照してください。

2. 「オプション」から「インスタンスの自動化の詳細を表示する」を選択します。

3. 「インスタンスの自動化の詳細」ページで、「インポータ」タブを開きます。

4. 削除する登録済インポータを選択します。

5. 「削除」をクリックします。
登録済インポータがリストから削除されます。

29.2.5 自動エクスポートの無効化

自動エクスポートを無効にする手順は、次のとおりです。

1. アーカイブ・コレクションを開きます。第25.3.1項を参照してください。

2. 現在のアーカイブ・リストからアーカイブを選択します。

3. 「レプリケーション」タブをクリックします。

4. 「編集」をクリックします。

5. 「登録済のエクスポータ」ウィンドウで、「自動エクスポートを有効にする」を選択解除します。

6. 「OK」をクリックします。
選択したアーカイブの自動エクスポートが無効になります。

29.2.6 自動転送の無効化

自動転送を無効にする手順は、次のとおりです。

1. ソース・コンテンツ・サーバー・インスタンスでアーカイバを開きます。

2. ソース・アーカイブ・コレクションを開きます。第25.3.1項を参照してください。

3. 現在のアーカイブ・リストでソース・アーカイブを選択します。

4. 「転送先」タブをクリックします。

5. 「編集」をクリックします。

6. 「転送オプション」ウィンドウで、「転送を自動化」を選択解除します。

7. 「OK」をクリックします。
選択したアーカイブの自動転送が無効になります。

29.2.7 登録済エクスポータの削除

この項では、登録済エクスポータを削除する方法について説明します。

29.2.7.1 「レプリケーション」タブからの登録済エクスポータの削除

1. アーカイブ・コレクションを開きます。第25.3.1項を参照してください。

2. 現在のアーカイブ・リストからアーカイブを選択します。

3. 「レプリケーション」タブをクリックします。

4. 「編集」をクリックします。

5. 「登録済のエクスポータ」ウィンドウで、「自動エクスポートを有効にする」を選択します。

6. 「登録済のエクスポータ」リストから、削除するコンテンツ・サーバー・インスタンスを選択します。

7. 「削除」をクリックします。
登録済エクスポータがリストから削除されます。

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

29.2.7.2 「インスタンスの自動化の詳細」ウィンドウからの登録済エクスポータの削除

1. アーカイブ・コレクションを開きます。第25.3.1項を参照してください。

2. 「オプション」から「インスタンスの自動化の詳細を表示する」を選択します。

3. 「インスタンスの自動化の詳細」ウィンドウで、削除する登録済エクスポータを選択します。

4. 「削除」をクリックします。
登録済エクスポータがリストから削除されます。

30 コントリビューション・フォルダのアーカイブ

この章では、Oracle WebCenter Contentシステムにおけるコントリビューション・フォルダ構造のバックアップとリカバリについての情報を提供します。

この章の内容は、次のとおりです。

- フォルダ・アーカイブ機能について

- アーカイブ済フォルダ構造のエクスポート

- アーカイブ済フォルダ構造のインポート

30.1 フォルダ・アーカイブ機能について

コントリビューション・フォルダは、Folders_gコンポーネントによりサポートされるオプション機能です。「コントリビューション・フォルダ」を有効にすると、コントリビューション・フォルダ(階層フォルダとも呼ばれます)の形式で階層フォルダ・インタフェースが提供され、マルチレベル・フォルダ構造を作成できます。

注意:
Oracle WebCenter Content 11gリリース1 (11.1.1)以降の「コントリビューション・フォルダ」は、FrameworkFoldersコンポーネントによりサポートされる「フォルダ」に置き換えられています。

フォルダ・アーカイブ機能を使用すると、コントリビューション・フォルダ構造をバックアップおよびリカバリできます。この機能は、Folders_gコンポーネントの一部であり、次に示す機能があります。

- フォルダ階層のエクスポート: エクスポートしたアーカイブ・ファイルにファイル名を割り当て、そのファイルを指定した場所に保存するために使用します。

- フォルダ階層のインポート: インポートするアーカイブのファイル名を指定するために使用します。インポートされたフォルダ構造では、現在のフォルダがすべて削除されて、フォルダ階層に置き換えられます。

「仮想フォルダの管理構成」ページを使用して、フォルダのインポートとエクスポートのタスクを実行します。

図30-1 「仮想フォルダの管理構成」ページ

30.2 アーカイブ済フォルダ構造のエクスポート

フォルダ階層をアーカイブ・ファイルとしてエクスポートする手順は、次のとおりです。

1. コンテンツ・サーバー・インスタンスに管理者としてログインします。

2. 「管理」→「フォルダ構成」を選択します。

3. 「アーカイブのエクスポート」をクリックします。

4. 「ファイルのダウンロード」ウィンドウで「保存」をクリックします。

5. フォルダのアーカイブ・ファイルを保存するディレクトリに移動します。

6. アーカイブ・ファイルを容易に識別できるように新しいファイル名を指定します(例: 041127_CollectionArchive)。

注意:
Windowsオペレーティング・システムでは、ファイル・タイプを「テキスト・ドキュメント」のままにした場合、.txt拡張子がファイル名に追加されます(CollectionArchive.hda.txt)。単に.hda拡張子でファイルを保存するには、「すべてのファイル」ファイル・タイプを選択します。

7. 「Save」をクリックします。
指定したファイルにフォルダ階層がエクスポートされます。

注意:
アーカイブ・ファイルとしてエクスポートされるフォルダ階層のサイズによっては、JVMのデフォルトのヒープ・サイズの値が十分でない場合があります。エクスポート手順の実行中にメモリー・エラーが発生した場合は、ヒープ・サイズを増やす必要があります。

30.3 アーカイブ済フォルダ構造のインポート

アーカイブ済フォルダをインポートする手順は、次のとおりです。

注意:
この手順では、現在のフォルダがすべて削除されて、インポートされたフォルダ階層に置き換えられます。通常、この手順はリポジトリ内にコンテンツ・アイテムがないコンテンツ・サーバー・インスタンスでのみ実行します。

1. コンテンツ・サーバー・インスタンスに管理者としてログインします。

2. 「管理」→「フォルダ構成」を選択します。

3. 「参照」をクリックし、インポートするアーカイブ・ファイルに移動します。

4. 「開く」をクリックします。
パスとファイル名がフィールドに表示されます。

5. 「アーカイブのインポート」をクリックします。

6. 「OK」をクリックします。
アーカイブ済フォルダがインポートされて、再作成されます。

フォルダのエクスポートおよびインポートの詳細は、『Oracle WebCenter Contentのマネージング』を参照してください。

31 コントリビューション・フォルダ構造のアーカイブ

この章では、フォルダ構造アーカイブ機能を使用して、コントリビューション・フォルダ構造と関連コンテンツをアーカイブする方法について説明します。

この章の内容は、次のとおりです。

- フォルダ構造アーカイブの理解

- 実装に関する重要な考慮事項

- アーカイブ機能間の相違点

- フォルダ構造アーカイブの管理

31.1 フォルダ構造アーカイブの理解

コントリビューション・フォルダは、Folders_gコンポーネントによりサポートされるオプション機能です。「コントリビューション・フォルダ」を有効にすると、コントリビューション・フォルダ(階層フォルダとも呼ばれます)の形式で階層フォルダ・インタフェースが提供され、マルチレベル・フォルダ構造を作成できます。

フォルダ構造アーカイブ機能は、FolderStructureArchiveコンポーネントによりサポートされます。この機能を使用して、フォルダ構造をアーカイブできます。また、そのフォルダ構造に関連するコントリビューション・フォルダのコンテンツをアーカイブすることもできます(オプション)。フォルダの構造は、データベース表レプリケーションによってアーカイブされます。アーカイブするフォルダ(およびすべてのサブフォルダ)を構成できます。アーカイバ・ユーティリティを使用してフォルダ・アーカイブにアクセスして、後続の処理(レプリケーションや、別のコンテンツ・サーバー・インスタンスへの転送など)を行うことができます。

注意:
フォルダ構造アーカイブは、コントリビューション・フォルダのみをサポートし、フォルダをサポートしません。フォルダは、コントリビューション・フォルダのかわりになる新しい機能です。アーカイバ・ユーティリティを使用すると、フォルダ構造およびコンテンツを移動できます。詳細は第32章を参照してください

FolderStructureArchiveコンポーネントは、デフォルトでコンテンツ・サーバー・インスタンスと同時にインストールされますが、無効化されています。このコンポーネントを使用するには、コンポーネント・マネージャで有効化する必要があります(第9.2.2項を参照)。

フォルダ構造のアーカイブは次のような目的で使用できます。

- バックアップ・ツールとしての使用: フォルダ構造を(必要に応じてフォルダのコンテンツも含めて)バックアップして、サーバーの誤動作やその他の災害の際にリストアできる安全な場所に格納できます。

- 複製ツールとしての使用: フォルダ構造を(必要に応じてフォルダのコンテンツも含めて)コピーし、別のコンピュータ上にそのコピーを作成すると、複数サーバーの設定を簡素化できます。

- 同期ツールとしての使用: 2つのシステム(開発システムと本番システム、2つの同一の冗長システムなど)の間でフォルダ環境の同期を保つことができます。このコンポーネントを使用して作成したコントリビューション・フォルダのアーカイブは、別のシステムに転送またはレプリケートできます。

重要:
フォルダ構造アーカイブを使用する前に、必ず第31.2項を読んでください。

31.2 実装に関する重要な考慮事項

実装に関する次の重要な考慮事項に注意してください。

- フォルダ構造アーカイブは、Site Studio Webサイトをレプリケートするためには使用できません。「フォルダ・アーカイブの構成」ページのフォルダ・ツリーには、すべてのSite Studio Webサイト・フォルダが表示されます。これらのフォルダをアーカイブして別のシステムにレプリケートできます。ただし、レプリケートされたWebサイトはターゲット・システムで適切に機能しない可能性があります。Site Studio Webサイトをレプリケートする場合は、Site Studioの組込みレプリケーション機能を使用してください。

- フォルダ構造アーカイブを2つのシステム間の複製ツールまたは同期ツールとして使用する場合は、Folders_gコンポーネントのインストール時に、ソース・システムとターゲット・システムに異なる初期コレクションID (InitialColID設定)を選択することをお薦めします。初期コレクションIDが同じであると、ユーザーにターゲット・システムのフォルダの操作が許可されている場合、複製プロセスまたは同期プロセス中にコレクションIDの競合エラーが発生する可能性があります。

- 「フォルダ・アーカイブの構成」ページでは、ツリーで親フォルダを選択しなくてもフォルダを選択できます。これがフォルダの仮想フォルダ・パスに影響を与えることはありません。つまり、仮想パスは、[Parent_Folder]が選択されていなくても[Parent_Folder]/[Folder]のままです。アーカイブを別のコンテンツ・サーバー・インスタンスに転送またはレプリケートすると、そのサーバー上に親フォルダが存在しない場合、親フォルダが自動的に作成されますが、ソース・サーバー上の対応するフォルダのメタデータは作成されません。

- 2つのコンテンツ・サーバー・インスタンス間でフォルダ構造アーカイブを転送またはレプリケートする場合、ターゲット・システム上に手動でフォルダ構造を作成することはお薦めしません。ターゲット・システムに存在しないフォルダは、転送プロセスまたはレプリケーション・プロセス中に自動的に作成されます。手動でフォルダを作成してしまうと、フォルダ名は一致しているのに、その基礎となる一意の識別子(xCollectionID)が一致しないために、プロセス中に同期していないエラーが発生する可能性があります。フォルダの不一致の問題を回避するために、CollectionIsConsumptionOnly構成変数を使用して、ターゲット・システムのフォルダ環境をロックできます。

- フォルダ構造アーカイブを使用して2つのシステム間のレプリケーションを設定した場合、ソース・システムに作成または移動されたフォルダは、コンテンツがソース・フォルダに追加された時点でターゲット・システムに自動的に作成または移動されます。また、ソース・システムでフォルダのメタデータを変更した場合、これらの変更は(コンテンツがターゲット・フォルダに追加された時点で)ターゲット・システムにも自動的に反映されます。ソース・システムで削除されたフォルダはすべて、ターゲット・システムで自動的に削除されます。フォルダが削除されると、その情報はすべて失われます。
ただし、フォルダ・アーカイブ構造がない場合、ソース・システム上で削除されたフォルダは、ターゲット・システムで自動的には削除されません(つまり、2つのシステムが非同期になります)。これは、Folders_gコンポーネントでは削除されたフォルダを追跡しないためです。フォルダが削除されると、その情報はすべて失われます。アーカイバ・ユーティリティでは、レプリケーション・プロセスを開始するときには、ターゲット・システムから削除するフォルダを把握していません。

同様に、フォルダの移動によってそのフォルダがアーカイブ済フォルダ内に存在しなくなった場合、このフォルダのアーカイブおよびレプリケートは行われなくなります。たとえば、/FolderA、/FolderA/SubfolderA、/FolderBおよび/FolderB/SubfolderBというフォルダが存在するシステムについて考えてみます。/FolderAはアーカイブされるよう設定されているが、/FolderBはそうでない場合、SubfolderAを/FolderBに移動すると、レプリケートされなくなります。しかし、/FolderAと/FolderBが両方ともアーカイブされる場合、SubfolderAを移動してもレプリケートされます。

- フォルダ構造アーカイブを使用してフォルダおよびコンテンツ・アイテムのアーカイブまたはレプリケーションを設定した場合、フォルダおよびコンテンツ・アイテムのショートカットのアーカイブまたはレプリケートは行われません。

- フォルダ構造アーカイブ・コンポーネントとともに文書フォルダ・アーカイブ・コンポーネントを使用することをお薦めします。アーカイブ時にコンテンツのフォルダ構造の保持を選択すると、このコンポーネントは、コントリビューション・フォルダのインストール中にコントリビューション・フォルダ・アドオンとともにインストールされます。フォルダに属するコンテンツ・アイテムをインポートする際にターゲット・システムにフォルダ構造が存在しない場合、このコンポーネントによりそのシステム上にフォルダ構造が作成されます。ターゲット・システム上に(同じまたは異なるxCollectionIDを持つ)同一のフォルダ構造が存在する場合は、ターゲット・システムにインポートされるコンテンツ・アイテムのxCollectionIDが、ターゲット・システム上の既存フォルダのものと一致するようになります。
フォルダ内にあるソース・システムのコンテンツ・アイテムについて検討します。そのコンテンツ・アイテムのxCollectionIDは8であり、フォルダの名前はFolderAです。ここで、DocFolderArchivingコンポーネントを使用して、ターゲット・システムにそのコンテンツ・アイテムをアーカイブすると仮定します。FolderAがターゲット・システムの同じレベルに存在しない場合、DocFolderArchivingによりターゲット・システムにFolderAが作成され、そのフォルダにコンテンツ・アイテムがインポートされます。通常、FolderAのxCollectionIDは、ソース・システムのFolderAのものとは異なります。FolderAがターゲット・システムの同じレベルにすでに存在するが、xCollectionIDが異なる(たとえば7)場合、DocFolderArchivingはそのフォルダを削除しません。フォルダを保持しながら、転送されるコンテンツ・アイテムのxCollectionIDを8から7に変更して、コンテンツ・アイテムが正しいフォルダに属するようにします。

31.3 アーカイブ機能間の相違点

フォルダ構造アーカイブには独自の組込みアーカイブ機能が備わっています。この機能には、「コントリビューション・フォルダの管理構成」ページを使用してアクセスします。

- 第31.3.1項「機能の相違点」

- 第31.3.2項「処理の相違点」

31.3.1 機能の相違点

フォルダ構造アーカイブは組込みのアーカイブ機能とともに使用できますが、その機能にはいくつかの重要な違いがあります。

- アプリケーションではフォルダ構造の一部を選択してエクスポートできますが、組込みのコントリビューション・フォルダ・アーカイブ機能ではフォルダ構造全部をエクスポートできるのみです。

- アプリケーションでは増分アーカイブ(前のバージョンと比較して変更のあったフォルダのみが含まれるアーカイブ)を作成できますが、組込みのコントリビューション・フォルダ・アーカイブ機能では、変更されていないアイテムがあってもすべてのアイテムが含まれるアーカイブしか作成できません。

- アプリケーションでは(フォルダ構造アーカイブの変数の値に応じて)フォルダ構造とフォルダ・コンテンツの両方をアーカイブに含めることができますが、組込みのコントリビューション・フォルダ・アーカイブ機能ではフォルダ構造しかエクスポートできず、フォルダ内のコンテンツはエクスポートできません。

- 組込みのコントリビューション・フォルダ・アーカイブ機能とは異なり、フォルダ構造アーカイブでは複数のソース・フォルダ・アーカイブを作成できます。これらはすべて、アーカイバ・ユーティリティを使用して、同じターゲット・コンテンツ・サーバー・インスタンスにインポート、転送またはレプリケートできます。

31.3.2 処理の相違点

組込みのコントリビューション・フォルダ・アーカイブ機能を使用してフォルダ構造全体をエクスポートし、(コントリビューション・フォルダ・インタフェースを使用して)それを別のコンテンツ・サーバー・インスタンスにインポートした場合、そのサーバーの既存のフォルダ構造はすべて削除されて、インポートされた構造に置き換わります。

フォルダ構造アーカイブを使用してアーカイブを作成し、(アーカイバ・ユーティリティを使用して)それを別のコンテンツ・サーバー・インスタンスにインポート、転送またはレプリケートした場合、既存のフォルダ構造が削除されることはなく、アーカイブされた構造は既存の構造にマージされます。

注意:
Folders_gコンポーネントの組込みのアーカイブ機能の詳細は、『Oracle WebCenter Contentのマネージング』を参照してください。

31.4 フォルダ構造アーカイブの管理

この項では、フォルダ構造アーカイブの操作について説明します。

- 第31.4.1項「フォルダ構造アーカイブの作成」

- 第31.4.2項「フォルダ構造アーカイブの更新」

- 第31.4.3項「フォルダ構造アーカイブの使用」

- 第31.4.4項「構成変数」

31.4.1 フォルダ構造アーカイブの作成

新規のフォルダ構造アーカイブを作成する手順は、次のとおりです。

1. コンテンツ・サーバー・インスタンスに管理者としてログインします。

2. 「管理」→「フォルダ・アーカイブの構成」を選択します。

3. 「フォルダ・アーカイブの構成」ページの「コレクション名」リストで、新規のフォルダ構造アーカイブが属するアーカイブ・コレクションを選択します。

4. 「アーカイブ名」フィールドで、新規のフォルダ構造アーカイブの名前を指定します。

重要:
アーカイブに含まれるフォルダを選択する前にアーカイブ名を指定してください。フォルダを選択してからアーカイブ名を指定すると、「追加」をクリックしても何も行われません(フォルダ・ツリーは完全に閉じて、フォルダ選択は失われます)。

5. 影付きの領域で、フォルダ構造アーカイブに含めるすべてのフォルダを選択します。
親フォルダのチェック・ボックスをクリックすると、その子フォルダもすべて自動的に選択されます。子フォルダを個別に選択および選択解除することもできます。親フォルダは、サブフォルダもすべて選択された場合にのみ選択されます。子フォルダのいずれかの選択を解除すると、その親フォルダの選択も自動的に解除されます。これは、子フォルダの仮想フォルダ・パスのプロパティには影響しません。

6. 「追加」をクリックします。
フォルダ・アーカイブが正常に追加されたことを示すメッセージが表示されます。アーカイブが「アーカイブ名」リストと、コンテンツ・サーバー・インスタンスの現在のアーカイブのリストに追加されます。第31.4.3項を参照してください。

31.4.2 フォルダ構造アーカイブの更新

既存のフォルダ構造アーカイブの定義を使用してそれを変更し、更新したアーカイブを作成できます。フォルダ構造アーカイブを更新する手順は、次のとおりです。

1. コンテンツ・サーバー・インスタンスに管理者としてログインします。

2. 「管理」→「フォルダ・アーカイブの構成」を選択します。

3. 必要に応じて、「フォルダ・アーカイブの構成」ページで、アーカイブを「コレクション名」リスト内の別のコレクションに割り当てます。

4. 「アーカイブ名」リストで、更新するフォルダ構造アーカイブの名前を選択します。
影付きの領域内のフォルダ・アーカイブ・ツリーが、アーカイブの現在の選択内容を反映するように更新されます。

注意:
選択したアーカイブを別の名前で保存することはできません。「アーカイブ名」フィールド内の名前を変更して「追加」をクリックする場合、そのアーカイブは新規アーカイブとみなされるため、フォルダを再び選択してから「追加」をクリックする必要があります。

5. 「フォルダ・アーカイブの構成」ページでフォルダ構造アーカイブを定義する際は、親フォルダを選択しなくてもフォルダを選択できます。
親フォルダのチェック・ボックスをクリックすると、その子フォルダもすべて自動的に選択されます。子フォルダを個別に選択および選択解除することもできます。親フォルダは、サブフォルダもすべて選択された場合にのみ選択されます。子フォルダのいずれかの選択を解除すると、その親フォルダの選択も自動的に解除されます。これは、子フォルダの仮想フォルダ・パスのプロパティには影響しません。

注意:
デフォルトでは、親フォルダが選択されていない場合、そのソース・コレクションIDはその子フォルダに渡されません。親フォルダを選択していなくてもフォルダのソース・コレクションIDが保持されるようにするには、AllowMigrationOfParentFoldersMeta変数をtrueに設定します(これはデフォルトではありません)。詳細は、第31.4.4項を参照してください。

6. 「更新」をクリックします。
フォルダ・アーカイブが正常に更新されたことを示すメッセージが表示されます。このアーカイブをさらに処理するには、第31.4.3項を参照してください。

31.4.3 フォルダ構造アーカイブの使用

新規のフォルダ構造アーカイブを作成すると、そのファイルがIntradoc_Dir/archives/Archive_Nameディレクトリに格納され、アーカイバ・ユーティリティ内のコンテンツ・サーバー・インスタンスの現在のアーカイブのリストに追加されます。図31-1に示す例を参照してください。

図31-1 アーカイバ・ユーティリティのフォルダ構造アーカイブ

「アーカイバ」ウィンドウの「名前」列に、アーカイブの作成時にアーカイブに指定した名前が一覧表示されます(第31.4.1項を参照)。「説明」列には常に、アーカイブの目的を示すために「フォルダ構造を持つアーカイブ。」と表示されます。

これで、フォルダ構造アーカイブをさらに処理できるようになります。標準のアーカイバ機能はすべて使用できます。たとえば、アーカイブを別のコンテンツ・サーバー・インスタンスに転送またはレプリケートできます。

注意:
フォルダ構造アーカイブ・コンポーネントを実装する際には、いくつかの重要な考慮事項について検討する必要があります。詳細は、第31.2項を参照してください。

31.4.4 構成変数

いくつかの構成変数を使用して、フォルダ構造アーカイブの動作を変更できます。この項では、このような変数のタイプについて説明します。

31.4.4.1 フォルダ構造アーカイブの変数

フォルダ構造アーカイブの変数は、IdcHomeDir/components/FolderStructureArchive/folderstructurearchive_environment.cfgファイルで設定されています。これは読取り専用ファイルであるため、設定を変更する場合は、「管理」→「管理サーバー」→「一般構成」を選択し、追加構成の設定フィールドに設定値を入力します。

次の構成パラメータがサポートされています。

- ArchiveFolderStructureOnly=true|false: この変数がtrueに設定されている場合、アーカイブにはフォルダ構造のみが含められ、構造内のコンテンツ・アイテムは含められません。この変数を使用すると、バックアップや同一の複数サーバー設定を行う目的で、フォルダ構造のコピーを作成できます。デフォルトはfalseです。つまり、コンテンツ・アイテムがフォルダ・アーカイブに含められます。

- AllowArchiveNoneFolderItem=true|false: この変数がtrueに設定されている場合、フォルダ構造内にないコンテンツ・アイテムもアーカイブに含められます。どのフォルダにも属していないコンテンツがフォルダ構造アーカイブに含められます。この変数が、falseに設定されている場合、フォルダ構造内のコンテンツ・アイテムのみがエクスポートされます。この構成変数を使用すると、フォルダとコンテンツのレプリケーションを同時に設定できます。そうしない場合は、フォルダおよび標準のコンテンツに対する追加のレプリケーションが必要となります。デフォルトはtrueです。つまり、フォルダ構造内にないコンテンツもフォルダ・アーカイブに含められます。

- AllowMigrationOfParentFoldersMeta=true|false: この変数がtrueに設定されている場合、「フォルダ・アーカイブの構成」ページで親フォルダが選択されていなくても、フォルダのソース・コレクションIDが保持されます(親フォルダから移行されます)。デフォルトはfalseです。つまり、親フォルダを具体的に選択していないときには、親フォルダのメタデータは渡されません。

重要:
構成パラメータ値を変更した後は、必ずコンテンツ・サーバー・インスタンスを再起動してください。

31.4.4.2 Folders_gコンポーネントの変数

Folders_gコンポーネントの変数は、IdcHomeDir/components/Folders_g/folders_environment.cfgファイルで設定されています。これは読取り専用ファイルであるため、設定を変更する場合は、「管理」→「管理サーバー」→「一般構成」を選択し、追加構成の設定フィールドに設定値を入力します。

フォルダ構造アーカイブとともに使用できるFolders_g構成変数は、次のとおりです。

- CollectionIsConsumptionOnly=true|false: この変数がtrueに設定されている場合、コンテンツ・サーバー・インスタンスのフォルダ環境はロックされます。つまり、サーバーはフォルダ・データのみを受け取るように設定されます(消費)。RWD権限(読取り/書込み/削除)を持つユーザーは、フォルダを作成、移動、変更または削除できません。管理者権限を持つユーザーは、フォルダの作成はできませんが、フォルダの移動、変更および削除はできます。
一般に、この設定はアーカイブの転送またはレプリケーションのターゲットのコンテンツ・サーバー・インスタンスに対して設定する必要があります。これにより、ターゲット・サーバーのフォルダを手動で操作した場合にソース・サーバーとターゲット・サーバーが同期しなくなるエラーを回避できます。

デフォルトの設定はfalseです。つまり、コンテンツ・サーバー・インスタンスのフォルダ環境はロックされません。

レプリケーション設定において、ソース・システムで削除されたフォルダがターゲット・システムで自動的に削除されることはありません。ターゲット・システムをコンサンプション専用モードで使用している場合でも、システム管理者は、ターゲット・システム上の影響を受けるフォルダを手動で削除できます。(フォルダの作成はできませんので注意してください。)

注意:
ユーザーがターゲット・サーバーのフォルダを操作できる場合は、Folders_gコンポーネントのインストール時にソース・サーバーに選択した初期コレクションID (InitialColID設定)とは別の設定をターゲット・サーバーに選択していることを確認してください。そうしない場合、コレクションIDの競合エラーが発生することがあります。

重要:
構成パラメータ値を変更した後は、必ずコンテンツ・サーバー・インスタンスを再起動してください。

32 FoldersへのFolders_gの移行

この章では、フォルダ移行ユーティリティを使用して、コンテンツ・サーバーのフォルダ・コンテンツとフォルダ構造をコントリビューション・フォルダからフォルダに移行する方法について説明します。

この章の内容は、次のとおりです。

- FoldersへのFolders_gの移行の理解

- フォルダの移行の準備

- Foldersへの移行

- フォルダの移行の完了後

32.1 FoldersへのFolders_gの移行の理解

フォルダ移行ユーティリティを使用すると、コントリビューション・フォルダ(Folders_gコンポーネントで提供)からフォルダ(FrameworkFoldersコンポーネントで提供)に、フォルダのコンテンツと構造を移行できます。このユーティリティは、コントリビューション・フォルダに関連付けられている表がデータベース・スキーマ内に存在し、FrameworkFoldersコンポーネントが有効になっている場合に使用できます。フォルダおよびFrameworkFoldersコンポーネントの詳細は、『Oracle WebCenter Contentのマネージング』を参照してください。

注意:
FrameworkFoldersは、以前のFolders_gコンポーネントに置き換わるコンポーネントの名前です。以前のフォルダ・インタフェースはコントリビューション・フォルダと呼ばれるようになりました。FrameworkFoldersコンポーネントによりサポートされるインタフェースはFoldersと呼ばれます。

注意:
WebCenter Portal 11.1.1.8.0およびそれ以前では、Folders_gコンポーネントのみがサポートされています。WebCenter Portalによるコンテンツ・サーバーの構成の詳細は、『Oracle WebCenter Portalの管理』を参照してください。

FrameworkFoldersコンポーネントはデフォルトでWebCenter Contentの新規インストールとともにインストールされ、無効化されます。Folders_gコンポーネントを使用する以前のバージョンから更新されたWebCenter Contentシステムでは、そのコンポーネントを引き続き使用することも、FrameworkFoldersコンポーネントを使用するように移行することも選択できます。Folders_gフォルダ構造およびフォルダ・コンテンツの両方をFoldersに移行できます。

重要:
Folders_gおよびFrameworkFoldersコンポーネントの両方を、本番システムで同時に有効化して実行しないでください。両方のコンポーネントを同時に有効にすると、Webインタフェースにアラートが表示され、WebDAVなどの特定の機能が予期されたとおりに動作しません。
技術的には、両方のコンポーネントを同時に有効にする必要はありません。ただし、Folders_gデータを調整する必要があり、移行プロセス中に両方のコンポーネントを有効にしても問題がない場合は、このプロセス中に両方のコンポーネントを有効にすると便利なことがあります。

注意:
移行操作は複数回実行できます。これにより、移行が完了した後に、移行されたデータが適切な形式になっていることを検証し、そうでない場合は構成を変更するかソース・データを変更して移行を再試行できます。
主な懸念事項は、移行が行われる前に、Folders_gから新しいFolders構造に手動で移動されたコンテンツがないかどうかです。このような場合、移行により、新しいFolders構造に手動で設定されたそのアイテムの場所が失われる可能性があります。この問題を防ぐには、新しいFolders構造に移動されたすべてのアイテムを移行の前にFolders_gから削除するか、そのxCollectionIDフィールドを0 (ゼロ)に設定します。

32.2 フォルダの移行の準備

コンテンツ・サーバーのconfig.cfgファイルでいくつかの移行変数を設定して、移行操作を変更できます。

- FolderMigrateExcludeList: 移行から除外するフォルダのリストを指定します。このリストには、フォルダIDおよびフォルダ・マークを含めることができます。大文字を使用し、アイテムをカンマで区切ります。この変数を適切に変更するには、「フォルダ移行」ページの「除外されたフォルダの変更」ダイアログを使用します。この変数が設定されない場合、TRASHフォルダのみが除外されます。

- FldMigrateDefaultSecurityGroup: セキュリティ・グループがフォルダに関連付けられていない場合に、移行されたフォルダに割り当てるデフォルトのセキュリティ・グループを指定します。この変数が設定されない場合のデフォルト値はPublicです。Folders_g内のフォルダにはセキュリティ・グループ設定は必要なく、設定しなくても構いません。移行されたフォルダにはセキュリティ・グループの設定が必要です。

- FldMigrateRootBaseName: 移行の実行時にFoldersに作成されるルート・フォルダのベース名を指定します。ルート・フォルダの形式は、<$FldMigrateRootBaseName$>_<$date$>_#<$run_index$>です。この変数が設定されない場合のデフォルト値はMigrateです。

- ShowFolderMigrationMenu: 「フォルダ移行」オプションを「管理」メニューに表示するかどうかを指定します。移行が可能(Folders_g表がデータベース・スキーマで使用可能)であり、この変数が指定されない場合のデフォルトは1(オプションを表示する)です。「管理」メニューにオプションを表示しないようにするには、この変数を0(ゼロ)に設定します。

32.3 Foldersへの移行

Folders_gフォルダ構造およびフォルダ・コンテンツをFoldersに移行するには、次の手順を実行します。

1. Webブラウザを使用して、コンテンツ・サーバーに管理者としてログインします。

2. FrameworkFoldersコンポーネントを有効化していない場合は、有効化します。詳細は、第9.2.2項を参照してください。

注意:
技術的には、両方のコンポーネントを同時に有効にする必要はありません。ただし、Folders_gデータを調整する必要があり、移行プロセス中に両方のコンポーネントを有効にしても問題がない場合は、このプロセス中に両方のコンポーネントを有効にすると便利なことがあります。

3. 「管理」→「フォルダ移行」を選択します。

図32-1 「フォルダ移行」ページ

4. 「フォルダ移行」ページの「移行の実行」セクションに、次の移行前の情報が表示されます。

- 移行オプションから除外されるフォルダ・サブツリー(デフォルトではTRASH)

- 移行するフォルダ数

- 移行するフォルダ内のコンテンツ・アイテムの数

- 移行するショートカットの数

- 移行から除外するフォルダ数

移行から除外するフォルダを追加するには、「除外されたフォルダの変更」をクリックします。これにより、「フォルダ移行: 除外されたフォルダ」ダイアログが表示されます。「レガシー・フォルダの参照」ツリーから1つ以上のフォルダを選択すると、それらが自動的に「移行から除外されるレガシー・フォルダ」ペインに移動されます。

5. 「拡張移行オプションの表示」リンクが表示されている場合は、このリンクをクリックして、移行中にコンテンツ・アイテムとフォルダ間にリンクを作成するためのオプションを表示できます。所有者リンクは、Folders内のコンテンツ・アイテムとフォルダ間の主要なアソシエーションです。1つのコンテンツ・アイテムに作成できる所有者リンクは1つのみです(一方、セカンダリ・ショートカットは無制限に作成できます)。所有者リンク・オプションでは、以前の移行により作成されたか、先に手動で割り当てられた既存の所有者リンクを持つコンテンツ・アイテムに対し、移行プロセスで所有者リンクの作成が試みられた場合に、この状況を処理する方法を指定します。
「既存の所有者リンクのオプション」セクションには、次の3つのオプションがリストされます。

- 既存の所有者リンクを削除します。移行により新規所有者リンクが作成されます。
このオプションはデフォルトで選択された状態になっています。これは一般的に、移入済のFolders_g階層から完全に空のFolders階層にフォルダとコンテンツを移行する際に管理者により使用されます。

- 既存の所有者リンクをショートカットに変換します。移行により新規所有者リンクが作成されます。
フォルダの移行プロセスが開始する前にFolders階層へのフォルダおよびコンテンツの移入が開始された場合、レガシーFolders_g階層および新しいFolders階層の両方にコンテンツ・アイテムが存在する可能性があります。ユーザーは、コンテンツ・アイテムがFolders_gフォルダ内に存在している場合でも、Foldersフォルダにコンテンツ・アイテムを追加できます。移行が行われると、移行プロセスはFolders_gにあるそのコンテンツ・アイテムを取り出し、Folders_gフォルダに対応する、新しく作成および移行されたFoldersフォルダにそのコンテンツ・アイテムを入れようとします。ただし、コンテンツ・アイテムに作成できる所有者リンクは1つだけであるため、そのコンテンツ・アイテムがすでに入れられているFoldersフォルダへのリンクを削除しないかぎり、新しいFoldersフォルダに同じコンテンツ・アイテムを入れることはできません。リンクを削除しないで情報を保持する場合は、このオプションによりFolders_g所有者リンクをFoldersショートカットに変更します。

- 既存の所有者リンクを残します。移行されたリンクをショートカットに変更します。
フォルダの移行プロセスが開始する前にFolders階層へのフォルダおよびコンテンツの移入が開始された場合、レガシーFolders_g階層および新しいFolders階層の両方にコンテンツ・アイテムが存在する可能性があります。ユーザーは、コンテンツ・アイテムがFolders_gフォルダ内に存在している場合でも、Foldersフォルダにコンテンツ・アイテムを追加できます。移行が行われると、移行プロセスはFolders_gにあるそのコンテンツ・アイテムを取り出し、Folders_gフォルダに対応する、新しく作成および移行されたFoldersフォルダにそのコンテンツ・アイテムを入れようとします。ただし、コンテンツ・アイテムに作成できる所有者リンクは1つだけであるため、そのコンテンツ・アイテムがすでに入れられているFoldersフォルダへのリンクを削除しないかぎり、新しいFoldersフォルダに同じコンテンツ・アイテムを入れることはできません。移行前のFoldersフォルダにコンテンツ・アイテムへの単一の所有者リンクを含める場合は、このオプションを使用して、移行後のフォルダがそのアイテムへのショートカットを持つようにすることができます。

6. 「フォルダ・データの移行」をクリックします。ステータス・バーおよびメッセージに、移行の進行状況が表示されます。
移行が完了すると、次の移行後のステータス情報が表で表示されます。

- 移行の実行番号

- 移行が開始した日時

- 移行が終了した日時

- 移行を実行したユーザーのユーザーID

- 正常に移行されたフォルダの数

- 移行されたコンテンツ・アソシエーションの数

- 移行されたショートカットの数

7. 特定の移行の実行に関する詳細を表示するには、実行番号の隣にある「情報」アイコンをクリックします。
「フォルダ移行情報」ページに、GUID、レガシー・フォルダID、名前および移行された各フォルダのタイプに関する情報が表示されます。

特定の移行のデータが不要になった場合は、「フォルダ移行情報」ページで移行データの削除をクリックします。

8. データが削除されている可能性がある移行の実行に関する情報は、「追加の移行データの表示」をクリックします。これにより、移行後ステータス情報と同じ列を持つ表が表示されますが、この表にはデータが削除されている実行に関する情報が含まれます。列が空の場合、データが削除された実行はありません。
この表示をブロックするには、「追加の移行データの非表示」をクリックします。

9. 完了した移行に問題がなく、Folders_gコンポーネントが有効になっている場合は、これを無効化します。

32.4 フォルダの移行の完了後

フォルダの移行プロセスが完了し、Folders構造にデータが正常に転送されたことを確認したら、通常は再度移行を行う必要はありません。以後、故意の不要な移行が行われないようにするために、コンテンツ・サーバーのconfig.cfgファイルで変数ShowFolderMigrationMenu=0を設定することをお薦めします。この変数を設定することにより、「管理」メニューに「フォルダ移行」オプションが表示されなくなります。

33 Folders構造の移行

この章では、アーカイバ・ユーティリティを使用して、Oracle WebCenter Content ServerのFolders構造データ(コンテンツ・ファイルではなく)を移行する方法について説明します。Folders機能は、FrameworkFoldersコンポーネントによってサポートされています。

この章の項目は次のとおりです。

- 第33.1項「Folders構造の移行について」

- 第33.2項「Folders構造データのエクスポート」

- 第33.3項「Folders構造データのインポート」

33.1 Folders構造の移行について

コンテンツ・サーバー・インスタンスのFolders構造は、アーカイバ・ユーティリティを使用して移行(エクスポートまたはインポート)できます。

アーカイバの動作方法の詳細は、第25章を参照してください。

33.2 Folders構造データのエクスポート

この項では、バックアップ、格納、または別のインスタンスへのインポートの目的で、コンテンツ・サーバー・インスタンスのデータを手動でエクスポートするためのプロセスおよびタスクについて説明します。アーカイバ・ユーティリティのエクスポート機能を使用して、Folders構造データをエクスポートできます。エクスポートされるのは単なるコピーであるため、元のデータはそのまま残ることに注意してください。

手動エクスポートでは、管理者がアーカイバから1回限りのエクスポートを開始します。この場合、ローカル・コンテンツ・サーバー・インスタンスにアーカイブが作成されます。

注意:
アーカイバを障害回復の主要な方法として使用しないでください。データベースおよびファイル・システムの標準的なバックアップ・システムを使用してください。バックアップ・システムの詳細は、『管理者ガイド』を参照してください。

Folders構造データを手動でエクスポートするには、次のプロセスを実行します。

1. エクスポートされたコンテンツ・サーバー・データを格納するアーカイブを作成します。詳細は、第25.2.1項を参照してください。

2. 現在のアーカイブ・リストからアーカイブを選択します。

3. 表をアーカイブに追加します。詳細は、第26.2.4項を参照してください。
次の表をアーカイブに追加する必要があります。

- FoldersFolders

- FolderMetaDefaults

4. エクスポートを開始します。詳細は、第26.2.8項を参照してください。

アーカイバ・ユーティリティを使用したエクスポートの管理方法の詳細は、第26章を参照してください。

33.3 Folders構造データのインポート

この項では、エクスポートされたアーカイブのデータを手動で取得するためのプロセスおよびタスクについて説明します。一般的にインポートは、別のコンテンツ・サーバー・インスタンスからデータのコピーを取得する場合や、格納されているデータをリストアする場合に使用します。アーカイバ・ユーティリティのインポート機能を使用して、Folders構造データをインポートできます。

インポート先のコンテンツ・サーバー・インスタンスは、アーカイブのエクスポート元のインスタンスと同じメタデータ・フィールド、セキュリティ・グループおよびアカウントを持つ必要があります。不一致があるとエラーが発生する場合があります。

Folders構造データを手動でインポートするには、次のプロセスを実行します。

1. 現在のアーカイブ・リストでアーカイバを使用して、データの取得元のアーカイブを選択します。

2. インポートを開始します。詳細は、第27.3.6項を参照してください。

アーカイバ・ユーティリティを使用したインポートの管理方法の詳細は、第27章を参照してください。

34 アーカイブおよび移行の戦略

この章では、Oracle WebCenter Content Serverのアーカイブおよび移行の一般的な戦略について説明します。

注意:
この項で説明するシナリオはすべて、手動でも(レプリケーションによる)自動でも実行できます。

この章の内容は、次のとおりです。

- エクスポート

- インポート

- 自己エクスポート/インポート

- 1対1のアーカイブ

- 1対多のアーカイブ

- 多対1のアーカイブ

- アーカイバの例

- 構成移行のヒント

34.1 エクスポート

この項では、エクスポートの戦略について説明します。

サマリー

簡単なエクスポートの一般的な用途は、次のとおりです。

- コンテンツをファイル・システムに格納し、後から古くなったコンテンツを削除します。

- コンテンツを後で取得するためにファイル・システムに格納します。

- 特定日時におけるコンテンツ・サーバー・インスタンスのスナップショットを保持します。

構成

以降に、可能なエクスポートのみ構成を一般的なものから順に示します。

- 外部ファイル・システムのコレクションにエクスポートします。

図34-1 外部ファイル・システムへのエクスポート

- コンテンツ・サーバー・インスタンス独自のコレクションの1つにエクスポートします。

図34-2 独自のコレクションへのエクスポート

34.2 インポート

この項では、インポートについて説明します。

サマリー

簡単なインポートの一般的な用途は、次のとおりです。

- 誤って削除したコンテンツをストレージから取得します。

- コンテンツ・サーバー・インスタンスのアーカイブ済スナップショットからコンテンツをリストアします。

構成

以降に、可能なインポートのみ構成を一般的なものから順に示します。

- 外部ファイル・システムのコレクションからインポートします。

図34-3 外部ファイル・システムからのインポート

- コンテンツ・サーバー・インスタンス独自のコレクションの1つからインポートします。

図34-4 独自のコレクションからのインポート

34.3 自己エクスポート/インポート

この項では、自己エクスポートについて説明します。

サマリー

一般的に自己エクスポート/インポートは、コンテンツ・メタデータを新しい値に変更するために使用します。

構成

以降に、可能な自己エクスポート/インポート構成を一般的なものから順に示します。

- コンテンツ・サーバー・インスタンス独自のコレクションの1つにエクスポートし、そのコレクションからインポートします。

図34-5 独自のコレクションからの自己エクスポート/インポート

- 外部ファイル・システムのコレクションにエクスポートし、そのコレクションからインポートします。

図34-6 外部ファイル・システムからの自己エクスポート/インポート

34.4 1対1のアーカイブ

この項では、1対1のアーカイブについて説明します。

サマリー

1対1のアーカイブは、異なるコンテンツ・サーバー・インスタンス間でコンテンツをコピーまたは移動するために使用します。

構成

以降に、可能な1対1のアーカイブ構成を一般的なものから順に示します。

- ソケット経由でエクスポート、転送およびインポートを行います。

図34-7 1対1のアーカイブ: ソケット経由

- 共有ファイル・システムでエクスポート、転送およびインポートを行います。

図34-8 1対1のアーカイブ: 共有ファイル・システム上

- 共有外部ファイル・システムのコレクションにエクスポートし、そのコレクションからインポートします。

図34-9 1対1のアーカイブ: 共有外部ファイル・システム上

- ソース・コンテンツ・サーバー・コレクションにエクスポートし、共有ファイル・システムでそのコレクションから直接インポートします。

図34-10 1対1のアーカイブ: 共有ファイル・システムでのコレクションへのエクスポートおよびコレクションからのインポート

- ソース・コンテンツ・サーバー・インスタンスから直接ターゲット・コンテンツ・サーバー・インスタンス上のコレクションにエクスポートし、共有ファイル・システムでそのコレクションからインポートします。

図34-11 1対1のアーカイブ: 共有ファイル・システムでのソースからコレクションへのエクスポートおよびコレクションからのインポート

34.5 1対多のアーカイブ

この項では、1対多のアーカイブについて説明します。

サマリー

1対多のアーカイブは通常、コントリビューション・サーバーからコンサンプション・サーバーにコンテンツをコピーまたは移動する場合に使用します。

構成

以降に、可能な1対多のアーカイブ構成を一般的なものから順に示します。

- ソケット経由でエクスポート、転送およびインポートを行います。
レプリケーションを使用してこの構成を自動化した場合は、転送時にソース・ファイルが削除されるため、ターゲット・サーバーごとに個別のエクスポート・アーカイブが必要です。ただし、手動で転送する場合は、1つのアーカイブを複数のターゲットに転送できます。

図34-12 1対多のアーカイブ: ソケット経由

- 共有ファイル・システムでエクスポート、転送およびインポートを行います。
レプリケーションを使用してこの構成を自動化した場合は、転送時にソース・ファイルが削除されるため、ターゲット・サーバーごとに個別のエクスポート・アーカイブが必要です。ただし、手動で転送する場合は、1つのアーカイブを複数のターゲットに転送できます。

図34-13 1対多のアーカイブ: 共有ファイル・システム上

- 共有外部ファイル・システムのコレクションにエクスポートし、そのコレクションからインポートします。
レプリケーションを使用してこの構成を自動化した場合は、インポート時にソース・ファイルが削除されるため、ターゲット・サーバーごとに個別のエクスポート・アーカイブが必要です。ただし、手動で転送する場合は、複数のターゲットから1つのアーカイブをインポートできます。

図34-14 1対多のアーカイブ: 共有外部ファイル・システム上

- ソース・コンテンツ・サーバー・コレクションにエクスポートし、共有ファイル・システムでそのコレクションから直接インポートします。
レプリケーションを使用してこの構成を自動化した場合は、インポート時にソース・ファイルが削除されるため、ターゲット・サーバーごとに個別のエクスポート・アーカイブが必要です。ただし、手動で転送する場合は、複数のターゲットから1つのアーカイブをインポートできます。

図34-15 1対多のアーカイブ: 共有ファイル・システムでのコレクションへのエクスポートおよびコレクションからのインポート

- ソース・コンテンツ・サーバー・インスタンスからターゲット・コンテンツ・サーバー・インスタンスの複数のコレクションに直接エクスポートし、共有ファイル・システムでそれらのコレクションからインポートします。

図34-16 1対多のアーカイブ: 共有ファイル・システムでのソースからコレクションへのエクスポートおよびコレクションからのインポート

34.6 多対1のアーカイブ

この項では、多対1のアーカイブについて説明します。

サマリー

多対1のアーカイブの一般的な用途は、次のとおりです。

- 複数のコントリビューション・サーバーから1つのコンサンプション・サーバーにコンテンツをコピーまたは移動します。

- 複数のコントリビューション・サーバーからよりセキュアな1つのコントリビューション・サーバーに機密的なコンテンツを移動します。

構成

以降に、可能な多対1のアーカイブ構成を一般的なものから順に示します。

- ソケット経由でエクスポート、転送およびインポートを行います。

図34-17 多対1のアーカイブ: ソケット経由

- 共有ファイル・システムでエクスポート、転送およびインポートを行います。

図34-18 多対1のアーカイブ: 共有ファイル・システム上

- 共有外部ファイル・システムのコレクションにエクスポートし、そのコレクションからインポートします。

図34-19 多対1のアーカイブ: 共有外部ファイル・システム上

- ソース・コンテンツ・サーバー・インスタンスの複数のコレクションにエクスポートし、共有ファイル・システムでそれらのコレクションから直接インポートします。

図34-20 多対1のアーカイブ: 共有ファイル・システムでのコレクションへのエクスポートおよびコレクションからのインポート

- ソース・コンテンツ・サーバー・インスタンスから直接ターゲット・コンテンツ・サーバー・インスタンス上のコレクションにエクスポートし、共有ファイル・システムでそのコレクションからインポートします。

図34-21 多対1のアーカイブ: 共有ファイル・システムでのソースからコレクションへのエクスポートおよびコレクションからのインポート

34.7 アーカイバの例

この項では例をあげ、アーカイバを使用して一般的なビジネス問題を解決する方法について説明します。

- 34.7.1項「ラップトップへのコンテンツ・サーバー・インスタンスのコピー」

- 34.7.2項「「コンテンツ・タイプ」および「作成者」による転送」

- 34.7.3項「メタデータ・フィールドの変更」

- 34.7.4項「コンテンツIDの接頭辞の追加」

- 34.7.5項「リリース日の変更」

34.7.1 ラップトップへのコンテンツ・サーバー・インスタンスのコピー

この例では、出張する同僚のために、コンテンツ・サーバー・インスタンスのコピーを使用してラップトップ・コンピュータを設定する必要があります。

この手順では、ソース・コンテンツ・サーバー・インスタンスとラップトップ・コンピュータが同じファイル・システムにアクセスできること、さらにラップトップ・コンピュータにコンテンツ・サーバー・ソフトウェアがインストールされていることを前提としています。

1. ソース・コンテンツ・サーバー・インスタンスでアーカイバを開きます。

2. 新しいアーカイブを作成します。

3. すべてのコンテンツをエクスポートするので、エクスポート問合せを作成する必要はありません。

4. アーカイブのファイル・サイズを制限するには、「エクスポート問合せの編集」ページで「最新リビジョン」オプションを選択します。

5. コンテンツ・タイプとユーザー属性をラップトップ・システムにコピーする必要がある場合は、「データのエクスポート」タブで「コンテンツ構成情報」および「ユーザー構成情報」を選択します。

6. 「一般」タブからエクスポート・オプションを設定します。

- ローカル・システムの領域を節約するには、「既存のエクスポート・ファイルを置換」を選択します。

- 同僚にWeb表示可能ファイルが必要であれば、「Webコンテンツをコピー」を選択します。

7. 手動でエクスポートを開始します。

8. ラップトップのコンテンツ・サーバー・インスタンスでアーカイバを開きます。

9. ソース・コレクションを開いて、インポートするアーカイブを選択します。

10. コンテンツ・タイプとユーザー属性がエクスポートされた場合、「アーカイブのインポート」ページでこれらのオプションを選択します。

11. 手動でインポートを開始します。

34.7.2 「コンテンツ・タイプ」および「作成者」による転送

この例では、ユーザーがコンテンツを送信する宛先はコントリビューション・コンテンツ・サーバー・インスタンスです。JChangによりコントリビュートされたアーカイブHRコンテンツを、人事ポータルとして機能する別の建物にあるコンテンツ・サーバー・インスタンスに自動的にアーカイブします。

この手順では、2つのコンテンツ・サーバー・インスタンスが共有ファイル・システムにアクセスできないこと、さらに人事ポータル・サーバーに各コンテンツ・アイテムの最新リビジョンのみが含まれる必要があることを前提としています。

コントリビューション・コンテンツ・サーバー・インスタンスでの自動エクスポートの設定:

1. アーカイブを作成します。

2. アーカイブに次のエクスポート問合せを設定します。

フィールド

演算子

値

コンテンツ・タイプ

次の値に等しい

HR

作成者

次の値に等しい

JChang

3. 「エクスポート問合せの編集」ページで、次を実行します。

- 「リリース日が最終エクスポートの日付よりも新しいリビジョンをエクスポートする。」を選択します。

- 「最新リビジョン」オプションを選択します。

4. 「一般」タブからエクスポート・オプションを設定します。

- ローカル・システムの領域を節約するには、「既存のエクスポート・ファイルを置換」を選択します。

- Web表示可能ファイルをアーカイブに含めるには、「Webコンテンツをコピー」を選択します。

5. 手動でアーカイブをエクスポートします。

6. 「レプリケーション」タブで、アーカイブを自動エクスポータとして登録します。

HRポータルのコンテンツ・サーバー・インスタンスでの自動エクスポートの設定:

1. ターゲット・アーカイブを作成します。

2. ターゲット・アーカイブを選択し、「一般」タブで「アクションのオーバーライド」として「更新」が設定されていることを確認します。

3. 手動でターゲット・アーカイブをインポートします。

4. 「レプリケーション」タブで、アーカイブを自動インポータとして登録します。

コントリビューション・サーバーからHRポータル・サーバーへの自動プル転送の設定:

1. コントリビューション・コンテンツ・サーバー・インスタンスで、HRポータルのコンテンツ・サーバー・インスタンスへの送信プロバイダを作成します。

2. HRポータルのコンテンツ・サーバー・インスタンスでアーカイバを開きます。

3. ターゲット・コレクションを開いて、ターゲット・アーカイブを転送先になれるように設定します。

4. ソース・コレクションを開いて、ソース・アーカイブを選択します。

5. 「転送先」タブで、ターゲット・アーカイブをターゲットの宛先として選択します。

6. 手動転送を実行します。

7. 転送を自動に設定します。

34.7.3 メタデータ・フィールドの変更

この例では、あるコンテンツ・サーバー・インスタンスで使用されたApprovedByというカスタム・メタデータ・フィールドを、他のコンテンツ・サーバー・インスタンスとの整合性を保つためにSponsorという名前に変更する必要があります。

1. 新規のSponsorメタデータ・フィールドを作成します。

2. アーカイブを作成します。

3. 手動ですべてのコンテンツをアーカイブにエクスポートします。(エクスポート問合せを作成する必要はありません。)

4. アーカイブに次のインポート・フィールドの変更を設定します。

エクスポート・フィールド

ターゲット・フィールド

xApprovedBy

Sponsor

5. 「一般」タブから、「アクションのオーバーライド」として「更新」を選択します。

6. 手動でインポートを開始します。

7. コンテンツ・サーバー・インスタンスからApprovedByフィールドを削除します。

34.7.4 コンテンツIDの接頭辞の追加

この例では、コントリビューション・サーバーとして使用される2つのコンテンツ・サーバー・インスタンスがあるが、両方のサーバーからすべてのコンテンツを消費できるようにします。両方の方向に自動転送を設定できます。しかし、どちらのコンテンツ・サーバー・インスタンスでも同じような採番スキームを持つ自動コンテンツID生成が使用されるため、ターゲット・コンテンツ・サーバー・インスタンスにすでに存在するコンテンツIDを持つファイルをインポートすると、エラーが発生したり、リビジョンが上書きされることがあります。

- 競合を回避するには、両方のコンテンツ・サーバー・インスタンスで「自動採番接頭辞」システム・プロパティに一意の接頭辞を追加する方法があります。

- また、インポート・プロセス中に一意の接頭辞を追加しても同じことを達成できます。

コンテンツIDの接頭辞を追加する手順は、次のとおりです。

1. 最初のコンテンツ・サーバー・インスタンスのインポート・アーカイブで、次の値の変更を設定します。

入力値

フィールド

出力値

「すべて」チェック・ボックス

コンテンツID

server2_<$dDocName$>

2. 2つ目のコンテンツ・サーバー・インスタンスのインポート・アーカイブで、次の値の変更を設定します。

入力値

フィールド

出力値

「すべて」チェック・ボックス

コンテンツID

server1_<$dDocName$>

34.7.5 リリース日の変更

この例では、レプリケーションまたは転送を使用してアーカイブを他のコンテンツ・サーバー・インスタンスにコピーしますが、ターゲット・コンテンツ・サーバー・インスタンスのリリース日を、コンテンツ・アイテムがコピーされた日付にするとします。

1. エクスポートおよびインポートをレプリケーションまたは転送のために設定します。

2. ターゲット・コンテンツ・サーバー・インスタンスにインポートするアーカイブを選択します。

3. アーカイブに次のインポート値の変更を設定します。

入力値

フィールド

出力値

「すべて」チェック・ボックス

リリース日

<$dateCurrent()$>

リリース日は、ターゲット・コンテンツ・サーバー・インスタンスのローカルな日時を反映します。

34.8 構成移行のヒント

構成移行ユーティリティを使用する際には、注意が必要な点があります。

- ターゲット・システムで標準のコンテンツ・サーバー・インストール・ディレクトリとは異なるディレクトリ場所を使用する場合は、構成移行を使用できないため、関連するディレクトリを手動でコピーする必要があります。
たとえば、パーティション化されたファイル・システムを使用している場合に、コンテンツ・サーバー・ストレージを複数のパーティションに分割するには、DomainHome/ucm/cs/bin/intradoc.cfgファイルに構成変数を追加して、他の場所に格納されているディレクトリの正しい場所を指すように指定する必要があります。

- ソース・システムとターゲット・システムに異なるWebサーバーを使用している場合は、構成移行を使用してエクスポートを準備する際に、必ずWebサーバー情報を除外してください。

- 構成移行ユーティリティを使用してすべてのコンポーネントをエクスポートできるわけではありません。たとえば、インタラクティブ・インストールが必要なコンポーネントはエクスポートできません。これらはターゲット・システムに個別にインストールする必要があります。

- 構成移行ユーティリティでは、Dynamic Converterルールは転送されません。これらは、ソース・システムの/data/conversion/cvtemplates.hdaファイルをターゲット・システムにコピーすることにより、手動でターゲット・システムに追加する必要があります。さらに、Dynamic Converterテンプレートのアーカイブを作成して、他のコンテンツより先にターゲット・システムに転送する必要があります。そうしない場合、動的変換が可能なドキュメントをインポートすると、エラーが発生します。

- 構成移行ユーティリティは、インスタンスの一部を別のインスタンスに伝播する場合に特に有用です。たとえば、一部のカスタマイズ(ワークフローやコンテンツ・プロファイルなど)は、開発インスタンスで設計してテストするのが最も適しています。テスト後は、これらを本番システムに移行できます。他の開発作業(コンポーネント開発など)のテストおよびデプロイには、コンポーネント・ウィザードやコンポーネント・マネージャを使用するのが最も適しています。

- 必須フィールドおよび検証済オプション・リストが考慮されない場合、アーカイブのインポート時に問題が発生することがあります。メタデータ・フィールドが必須フィールドに変更された場合や、ある移行から次の移行でオプション・リストが変更された場合、これらの同じメタデータ・フィールド定義を持つ別のシステムにコンテンツをインポートすることが困難になります。この問題を回避するには、ターゲット・システムにデータをインポートする前に、一時的に必須フィールドを必須でないフィールドに変更し、オプション・リストを未検証リストに変更します。

- 構成移行ユーティリティをアーカイバと組み合せて使用して、インスタンスの標準のスナップショットを作成できます。また、システム全体の同期を保つために、必ずデータベースの適切なバックアップも同時に作成する必要があります。

- インポート側のコンテンツ・サーバー・インスタンスで適切なメタデータ情報を使用できるように、アーカイブ・パッケージの作成前に構成移行パッケージを作成する必要があります。

- 移行は追加的なプロセスであることに注意してください。メタデータ情報のエクスポート側の構成バンドルが、インポート側のコンテンツ・サーバー・インスタンスに存在するメタデータに追加されます。インポート中に「上書きの強制」ルールを選択した場合は、インポートされるメタデータと一致するメタデータ情報が存在すると、インポート側のコンテンツ・サーバー・インスタンス上のメタデータは、エクスポートされたバンドルからのメタデータで上書きされます。

35 アーカイバ・レプリケーションの例外の使用

この章では、アーカイバ・レプリケーションの例外機能を使用して、アーカイバのインポート失敗によるコンテンツ・サーバー・インスタンスでのレプリケーション停止を防止する方法について説明します。

この章の内容は、次のとおりです。

- アーカイバ・レプリケーションの例外の理解

- アーカイバ・レプリケーションの例外の管理および使用

35.1 アーカイバ・レプリケーションの例外の理解

アーカイバ・レプリケーションの例外を使用すると、管理者はインポートが失敗してもレプリケーションを続行できます。この処理では、このような失敗したインポートが取得されて例外アーカイブに挿入され、このような失敗したインポートが発生したことを示す電子メールが管理者に送信されます。

ArchiverReplicationExceptionsコンポーネントは、デフォルトではコンテンツ・サーバー・インスタンスによりインストールおよび有効化されます。

- 35.1.1項「アーカイバ・レプリケーションの例外の動作」

- 第35.1.2項「シナリオ1」

- 第35.1.3項「シナリオ2」

35.1.1 アーカイバ・レプリケーションの例外の動作

アーカイバ・レプリケーションの例外をサポートするには、いくつかの構成エントリをIntradocDir/config/config.cfgファイルに手動で追加する必要があります。構成エントリは様々な条件を定義するもので、これに基づいてエラー・レポートのレベルを判別したり、失敗したインポートを例外ディレクトリに送信したり、システム・エラーが検出されたときに失敗した複数のインポートを無視および処理します。自動インポートと手動インポートの両方に対するパラメータが用意されています。

35.1.2 シナリオ1

このシナリオでは、インポート側のサーバーにコンテンツ・タイプDOCが存在しないために、ドキュメントのインポートが失敗しました。エラー・レポート・レベル(ArchiverEmailErrorLevel)はcollision、standard、severeに設定されており、ArchiverErrorNotifyUserはsysadminに設定されていました。アーカイバのインポートの失敗を示す電子メール通知の例を次に示します。

Archiver Import Failure
There was a serious error during the import of a document which may prevent that
document from being properly synchronized in state with the exporting content
server. Content item 'test1' was not successfully checked in. The content
type 'DOC' is not defined in the system.
Revision Being Imported
Collection:  idc
Archive Name:  ar1
Source Instance:  idc
Batch Name:  07-sep-24_15.15.41_766/07267151541~1.hda
Content ID:  test1
Title:  test1
Author:  sysadmin
Revision:  1
Release Date:  9/24/07 3:13 PM
Create Date:  9/24/07 3:14 PM

The Document Has Been Copied To An Exceptions Archive

Collection:  idc
Archive Name:  ImportExceptions
Batch Name:  07-sep-24_15.15.41_766/07267151541~1.hda
Total Captured In Archive:  1

35.1.3 シナリオ2

このシナリオでは、インポートを試行していますが、何度も失敗します。システム管理者は、インポート中に問題がある可能性に気付いていますが、失敗のたびに電子メールを通知する必要はないと考えています。ArchiverMaxConsecutiveImportErrors(デフォルトは10)を設定することにより、システム管理者は電子メール通知が中止されるまでの失敗数を設定できます。電子メールは、エラーがこの数に達するまで送信されます。設定した数に達する前にエクスポータからのインポートが成功した場合、あるいはコンテンツ・サーバー・インスタンスが再起動された場合、カウンタは0にリセットされます。エラーが最大数に達すると、アーカイブの自動インポートは中断されることに注意してください。

35.2 アーカイバ・レプリケーションの例外の管理および使用

アーカイバ・レプリケーションの例外機能の主な目的は、失敗したインポートをフィルタリングできるようにして、そのような失敗の処理と通知を最適化することです。アーカイバ・レプリケーションの例外でコンテンツ・アイテムを処理するためには、管理者が手動でIntradocDir/config/config.cfgファイルに構成エントリを設定する必要があります。構成変数により、特定の状況を許可したり、構成済の基準に基づいてエラー・レポートを配布するために、インポート側のコンテンツ・サーバー・インスタンスの動作をカスタマイズします。

次の構成変数を使用して、動作をカスタマイズできます。これらの値は、 IntradocDir/config/config.cfgファイル内の#Additional Variablesの下に設定する必要があります。

構成エントリの前にアーカイブ名を追加してコロン(:)で区切ると、その構成エントリはそのアーカイブにのみ適用されます。たとえば、アーカイブMyRemoteImportArchiveに対して例外の取得を有効にするには、config.cfgファイル内に次のエントリを使用します。

MyRemoteImportArchive:IsArchiverCapturingExceptions=true

アーカイブ名の接頭辞が適用されない場合、値セットはすべてのアーカイブのグローバル・デフォルトとなります。

- IsArchiverCapturingExceptions: この構成エントリがオンになっていない場合、このコンポーネントの主要な機能は有効になりません。
デフォルト値はfalseです。

- ArchiverImportExceptionsArchiveName: 失敗したインポートを格納するアーカイブの名前。アーカイブは、インポートに失敗したドキュメントが含まれていたアーカイブと同じアーカイブ・コレクション内に作成されます。
デフォルト値はImportExceptionsです。

- ArchiverMaxConsecutiveImportErrors: アーカイブのインポートが中止されるまでの連続するインポート・エラーの最大数。
デフォルト値は10です。

- ArchiverErrorNotifyUser: インポートが失敗したときに通知を受けるユーザー。デフォルトはsysadminです。電子メールは、電子メールを生成するように構成されたレベルのインポート・エラーが発生した場合にのみ生成されます。
エントリはユーザー名のカンマ区切りリストにできますが、すべてのユーザー名はコンテンツ・サーバー・インスタンスで定義されていて、電子メール・アドレスが関連付けられている必要があります。

- ArchiverEmailErrorLevels: 自動インポート中に発生すると電子メールが生成されるエラー・レベル。設定可能なレベルは次のとおりです。

- collision: インポートは、ドキュメントの既存リビジョンによりブロックされたために失敗しました。これは通常、インポートするリビジョンのリリース日(または作成日(構成によって異なる))が既存ドキュメントの最新リビジョンの日付よりも前である場合に発生します。

- standard: インポートは標準のエラーにより失敗しました。このようなエラーとして一般的なのは、無効な値を持つメタデータ・フィールドです。

- severe: インポートは、コンテンツ・サーバー・インスタンスで予期しない重大なエラーが発生したために失敗しました。この原因として一般的なのは、ファイル・システムまたはデータベースに対するネットワーク障害です。

構成エントリは、前述の値をカンマで区切ったリストとして設定します。自動インポートのエラーが発生すると、前述のいずれかのレベルに分類され、そのレベルがこのパラメータに構成されたリスト内にあれば、そのエラーに対する電子メールが生成されます。

デフォルト値はcollision,standard,severeです(つまり全部です)。

- ArchiverManualImportEmailErrorLevels: これはArchiverEmailErrorLevelsと似ていますが、手動アーカイブ・インポートに適用されます。手動インポートとは、エンド・ユーザーまたは管理者が直接開始する、登録済の自動インポータにより実行されないインポートのことです。
デフォルト値は空です(つまりnoneです)。

- ArchiverCaptureExceptionErrorLevels: 発生するとドキュメントのコピーが取得されて例外アーカイブに挿入されるようなエラー・レベルのリスト(「ArchiverImportExceptionsArchiveName」を参照)。ドキュメントが取得された後は、そのエラーにより自動インポートが停止されることはありません。自動インポートでは、ドキュメントを含むバッチ・ファイルのインポートが完了すると、そのドキュメントがアーカイブから削除されます。エラー・レベルのリストおよびエントリの構成方法については、「ArchiverEmailErrorLevels」を参照してください。
デフォルト値はcollision,standardです。

- ArchiverManualImportCaptureExceptionErrorLevels: これはArchiverCaptureExceptionErrorLevelsパラメータと似ていますが、手動アーカイブ・インポートに適用されます(手動インポートの詳細は、「ArchiverManualImportEmailErrorLevels」を参照してください)。インポート・エラーは取得されると例外アーカイブ内にコピーされますが、元のアーカイブから削除されることはありません。エラーが取得されると、手動インポート中に許可された最大エラー数としてカウントされることはありません(標準のコンテンツ・サーバー構成エントリMaxArchiveErrorsAllowed(デフォルトは50)を参照してください)。
デフォルト値は空です(つまりnoneです)。

- ArchiveExceptionsMaxNumberDocuments: 例外アーカイブに格納できるドキュメントの最大数。
この数に達すると、インポート失敗時の自動インポート続行が再び禁止されます。ただし、インポートが失敗したことと、例外アーカイブがいっぱいになったことを示す電子メールがArchiverErrorNotifyUserに送信されます。他の構成エントリとは異なり、アーカイブの接頭辞を(コロンで区切って)使用して構成エントリを特定のアーカイブに制限する場合、アーカイブ名は、インポートされる元のドキュメントが含まれるアーカイブではなく例外アーカイブの名前にする必要があります。

デフォルト値は50です。

パラメータArchiverMaxConsecutiveImportErrorsは、システムの問題(エクスポート時にすべてのドキュメントに同一の不正なメタデータ・フィールドが含まれていたなど)によりエラーが発生した場合に、エラーをスキップしてエラーに関する電子メール通知を送信するという問題を解決するものです。この場合、非常に多くのドキュメントが不必要に取得され、それに伴って大量の不要な電子メールが生成されます。この構成エントリは、このような状況を発見するのに役立ちます。自動インポート中に非常に多数の連続するインポート・エラーが検出されると、現在のアーカイブ・インポートが中断されます。手動インポートは最大エラーに対する標準的なルールに従います(「MaxarchiveErrorsAllowed」を参照)。(任意のアーカイブからの)インポートが成功した場合は、連続するインポート失敗カウントが0にリセットされます。

同一ドキュメントのインポートが(2回以上)連続して失敗した場合、最初の失敗についてのみ電子メールが送信されます。同一のドキュメントのインポートに失敗したが、それぞれ異なるバッチ・ロード・ファイルから行われた場合、直前のエラーに関するドキュメントの電子メールがすでに送信されていれば、次の電子メールは抑制されます。

第VII部

付録

この部では、Oracle WebCenter Contentのいくつかのオプションのソフトウェア・コンポーネントを統合および管理する方法についての情報を提供します。

第VII部は、次の付録で構成されています。

- 付録A「コンテンツ・サーバー用Oracle Fusion Middleware BPELコンポーネントの管理」

- 付録B「Need to Knowコンポーネントの管理」

- 付録C「Oracle WebCenter Content用Kofax Capture Export Connectorの管理」

- 付録D「Oracle WebCenter Contentのトラブルシューティング」

A コンテンツ・サーバー用Oracle Fusion Middleware BPELコンポーネントの管理

この付録では、Oracle WebCenter Content用にBpelIntegrationコンポーネントをインストールして構成する方法と、Business Process Execution Language (BPEL)サーバー上でデプロイされたプロセスを開始するようにOracle WebCenter Content Serverのワークフローを構成する方法について説明します。

ここで説明する項目は、次のとおりです。

- はじめに

- インストール

- 統合コンポーネントの構成

- コンテンツ・サーバーでのワークフローの構成

A.1 概要

BpelIntegrationコンポーネントは、コンテンツ・サーバー・ワークフロー内からBusiness Process Execution Language (BPEL)プロセス・マネージャと対話する機能を追加します。管理者として、BPELサーバー上にデプロイされたプロセスを開始するようにコンテンツ・サーバー・ワークフローを構成できます。

この項では、次のトピックについて説明します。

- 付録A項「ハードウェア要件」

- 付録A「ソフトウェア要件」

- 付録A「ソフトウェアの配布」

A.1.1 ハードウェア要件

BpelIntegrationコンポーネントの最低限のハードウェア要件は、コンテンツ・サーバーおよびOracle BPEL Process Managerの要件と同じです。

A.1.2 ソフトウェア要件

この項では、コンテンツ・サーバーおよびBPEL Process Managerの要件を指定します。

Oracle Content Server: コンテンツ・サーバーのリリース11g以上が、ターゲット・コンピュータで正しくインストールされて実行されている必要があります。

Oracle BPEL Process Manager: Oracle Service-Oriented Architecture (SOA) Suiteのリリース11g以上が、ターゲット・コンピュータで正しくインストールされて実行されている必要があります。

A.1.3 ソフトウェアの配布

BpelIntegrationコンポーネントは、WebCenter Contentリリース11gに付属しています。

A.2 インストール

次の手順では、リリース・バージョンのOracle SOA Suiteがすでにインストールされていることを前提としています。

この項では、次の手順について説明します。

- 付録A「統合の手順」

- 付録A「統合コンポーネントの有効化」

A.2.1 統合手順

Oracle SOA Suiteとの統合を有効化するようコンテンツ・サーバーを設定するには、現在次の2つの方法があります。

- シナリオ1では、Oracle SOA Suiteによって拡張されたドメインにWebCenter Contentをインストールします。この場合、すべての部分を1つのドメインに特定の順序でインストールします。Oracle SOA Suiteライブラリはすべてに対して使用可能で、クラス・パスはOracle SOA Suiteライブラリを含むよう拡張されています。

- シナリオ2では、Oracle SOA Suiteで使用される必要なライブラリを手動でコピーして、Oracle WebLogic Server内部のWebCenter Contentを起動するために使用するクラスパスを追加します。

2つのシナリオの相違点は、Oracle SOA Suiteのインストールによってクラスパスが自動的に追加されますが、シナリオ2ではこの処理を手動で行う点です。将来、WebCenter Contentには適切なOracle SOA Suiteライブラリが同梱される予定です。

A.2.1.1 シナリオ1

Oracle SOA Suiteによって拡張されたドメインにWebCenter Contentをインストールする手順は次のとおりです。

1. Oracle SOA Suite用の新規ドメインを作成します。

2. Oracle Business Activity Monitoring (BAM)およびOracle Enterprise Management (EM)で、Oracle SOA Suiteドメインを拡張します。

3. WebCenter ContentでOracle SOA Suiteを拡張します。

setDomainEnv変数にOracle SOA Suite固有のライブラリが移入されていることを確認できます。特に、クラスパスにsoa-infra-mgmt.jarが指定されていることを確認します。

A.2.1.2 シナリオ2

Oracle SOA Suiteによって拡張されていないWebCenter Contentドメインを更新する手順は次のとおりです。

1. /soaディレクトリを、Oracle SOA SuiteのOracleホームからWebCenter ContentのOracleホームにコピーします。
WebCenter Contentを介して接続しているOracle SOA SuiteサーバーのOracle SOA Suite 11gホーム・ディレクトリを見つけます。soaという名前のディレクトリがあります。このディレクトリをWebCenter Contentホーム・ディレクトリにコピーして、最上位ディレクトリに配置します(つまり、SOA_ORACLE_HOME/soaをWC_CONTENT_ORACLE_HOME/soaにコピーします)。

2. オペレーティング・システムに応じて、setDomanEnv.cmdファイルまたはsetDomainEnv.shファイルを編集し、WebCenter Contentドメインのクラスパスを追加します。

set POST_CLASSPATH=%ORACLE_HOME%\soa\modules\oracle.soa.mgmt_11.1.1\soa-infra-mgmt.jar;%POST_CLASSPATH%

A.2.1.3 最終手順

両方のシナリオの最終手順は、BpelIntegrationコンポーネントを有効化してサーバーを起動することです。

Oracle SOA SuiteインスタンスがWebCenter Content以外の別のサーバーで実行中の場合は、次のセキュリティ・エラーが表示されることがあります。

vax.xml.ws.WebServiceException: java.lang.SecurityException: [Security:090398]Invalid Subject: principals=[weblogic, Administrators]
at com.sun.xml.ws.client.dispatch.DispatchImpl.doInvoke(DispatchImpl.java:209)
at com.sun.xml.ws.client.dispatch.DispatchImpl.invoke(DispatchImpl.java:216)

このエラーが発生した場合は、両方のサーバーに対するドメイン間のセキュリティを有効にする必要があります。次の指示に従ってください。

User will need to setup Trusted Domain on both WLS domain.
Goto WLS Console->Respected Domainssoainfra or bam ->Security
1. Make sure "Cross Domain Security Enabled"
2. Click on Save
3. Expand Advanced part of setting
4. Make sure you supplement the Credential and Confirm Credential fields.
5. Click on Save
Repeat for the same for the other WLS domain.
Finally, Restart both WLS Servers.

A.2.2 統合コンポーネントの有効化

統合コンポーネントを有効化する手順は次のとおりです。

1. コンテンツ・サーバー・インスタンスにシステム管理者としてログインします。

2. 「管理」→「管理サーバー」→「コンポーネント・マネージャ」を選択します。

3. ページ上部の段落で、「拡張コンポーネント・マネージャ」リンクをクリックします。

4. 「有効なコンポーネント」と「無効なコンポーネント」の2つのリストが表示されます。「無効なコンポーネント」リストの下位にある「BpelIntegration」を選択します。

5. 「有効化」をクリックして、リスト下位から上位にこの項目を移動します。

6. ページの下部で、「更新」をクリックします。

7. Oracle WebLogic Server管理コンソールにログインします。

8. コンソールの左側で、「ドメイン構造」、「環境」、「サーバー」の順にクリックします。「サーバーのサマリー」ページが表示されます。

9. 「制御」タブからサーバーを選択して、「SSLの再起動」をクリックします。

A.3 統合コンポーネントの構成

この項では、次のトピックについて説明します。

- 付録A「アーキテクチャ」

- 付録A「プロセス構成」

A.3.1 アーキテクチャ

統合では、BPELクライアント・ライブラリを使用してOracle BPEL Process Managerと通信します。プロセス構成では、接続パラメータ、BPELプロセスおよびBPEL操作を識別する必要があります。また、プロセス構成では、ドキュメント・メタデータ・フィールド、およびBPEL操作に渡されるパラメータに割り当てられたリテラル値も識別されます。

A.3.1.1 接続構成

プロセス構成は、data/orabpelディレクトリに配置されるファイル内に存在しています。これらのファイルは手動で編集できます。ただし、BpelIntegrationコンポーネントでは、この作業を簡単に行うためのページが提供されています。最初のページは「接続の構成」ページです。「接続の構成」ページから、定義済の接続構成を表示したり、接続構成を追加または削除できます。

図A-1 「接続の構成」ページ

「接続の構成」ページにアクセスするには、「管理」→「Oracle BPEL管理」を選択します。「接続の構成」をクリックします。

このページの右上には「接続」メニューがあります。このメニューを使用して新規接続を追加します。各接続には「アクション」メニューがあり、次の選択肢が示されます。

要素

説明

構成情報

接続情報の詳細を表示できます。

構成のテスト

接続構成のJNDIプロパティをテストできます。

構成の削除

接続構成を削除できます。

A.3.1.1.1 接続構成の追加

接続構成を追加するには、「接続の構成」ページの右上にある「接続」メニューから「接続の追加」を選択します。「構成の追加」ページが開きます。

次の表では、このページのフィールドが定義されています。

要素

説明

構成ID

接続構成を識別するために使用します。一意である必要があります。

説明

接続構成について説明するために使用します。

ドメイン

BPELプロセス・ドメイン識別子。

初期コンテキスト・ファクトリ

BPEL Process Managerに接続するために使用する初期コンテキスト・ファクトリ。この値は、初期コンテキストを作成するファクトリ・クラスの完全修飾クラス名である必要があります(たとえば、BPELを実行中のOracle Application Serverに接続する場合は、com.evermind.server.ApplicationClientInitialContextFactory)。

プロバイダURL

BPEL Process Managerの場所。この値にはURL文字列が含まれている必要があります(たとえば、BPELを実行中のOracle Application Serverに接続する場合は、opmn:ormi://servername:6003:home/orabpel)。

セキュリティ・プリンシパル

BPEL Process Managerの呼出し側を認証するためのプリンシパルの識別情報。この値には、BPEL Process Managerで登録されているユーザーのユーザー識別子が含まれている必要があります。

セキュリティ資格証明

BPEL Process Managerの呼出し側を認証するためのプリンシパルの資格証明。この値には、セキュリティ・プリンシパルとして入力されているユーザー識別子のパスワードが含まれている必要があります。

セキュリティ資格証明の確認

セキュリティ資格証明パスワードを確認するために使用されます。

A.3.1.1.2 接続構成の情報

特定の接続構成に関する詳細情報を表示するには、構成ページ内の特定のアダプタの「アクション」メニューから「構成情報」を選択します。「構成情報」ページが開きます。

ページの上部にある「アクション」メニューから、次のアクションを選択できます。

要素

説明

接続の更新

接続構成を編集できます。

接続の削除

接続構成を削除できます。

接続のテスト

接続構成のJNDIプロパティをテストできます。

A.3.2 プロセス構成

接続の構成を完了すると、「プロセスの構成」ページでプロセスを定義して構成できます。プロセス構成を変更するには、「アクション」メニューを使用します。

注意:
Oracle WebCenter Contentは、BPELプロセスと統合したWebCenter Contentに対するSOAPリクエストで単一のネームスペースのみをサポートします。

図A-2 「プロセスの構成」ページ

「プロセスの構成」ページにアクセスするには、「管理」→「Oracle BPEL管理」を選択します。「プロセスの構成」をクリックします。

要素

説明

プロセスの追加

さらにプロセス構成を追加できます。

構成情報

プロセス構成の「構成情報」ページを開きます。

プロセスの更新

BPELプロセスおよび操作を編集できます。

ペイロードの更新

コンテンツ・アイテム・フィールドからペイロード・プロパティへのマッピングを編集できます。

構成の削除

プロセス構成を削除できます。

接続のテスト

接続構成のJNDIプロパティをテストできます。

プロセス構成を作成した後、プロセスのプロパティとペイロード・マッピングを定義する必要があります。プロセス・プロパティの編集方法の詳細は、「プロセスのプロパティ」を参照してください。フィールド・マッピングの編集方法の詳細は、「ペイロード・マッピング」を参照してください。

A.3.2.1 プロセスのプロパティ

プロセスのプロパティでは、新規プロセスを開始するために使用されるBPELプロセスとBPEL操作が識別されます。これらのプロパティは「BPELプロセスの更新」ページで編集できます。

図A-3 「BPELプロセスの更新」ページ

プロセスのプロパティを編集するには、「アクション」メニューから「プロセスの更新…」を選択します。

要素

説明

BPELプロセス

デプロイされたアクティブなBPELプロセスのプロセス識別子。各アクティブ・プロセスは、プロセス名とプロセス・リビジョンとともにリストされます。各プロセスのデフォルトのリビジョンは、アスタリスク(*)で識別されます。

BPEL操作

プロセスを開始する操作の名前。

A.3.2.2 ペイロード・マッピング

ペイロード・マッピングでは、プロセスを開始するためにコンテンツ・サーバーのフィールドとリテラル値をペイロード・プロパティにマッピングする方法を定義します。

ペイロード・マッピングを編集するには、「アクション」メニューから「ペイロードの更新」をクリックします。

「BPELプロセスの更新: ペイロード・マッピング」ページに3つの列を持つフォームが表示されます。次の表では、各列が定義されています。

要素

説明

フィールド

値がマップされるペイロード要素の名前。

タイプ

ペイロード要素のタイプ。これは、値オプションのリストに表示されるオプションをフィルタするために使用されます。複合タイプには他のタイプが含まれます。タイプが要素の配列である場合、値マッピングはコンポーネントによって解析されるカンマ区切りリストである可能性があります。

マッピング

コンテンツ・サーバー・フィールドの名前を識別するために使用します。これらのフィールドは、標準のコンテンツ・アイテム・フィールド(dID、dDocName、dDocTitleなど)、カスタム情報フィールドおよび一部の特別なシステム・フィールドです。考えられる特別なフィールドは、次のとおりです。

- HttpAbsoluteCgiPath: コンテンツ・サーバーへの絶対CGIパス。

- HttpAbsoluteWebRoot: コンテンツ・サーバーのWebルートへの絶対パス。

- idcReference: 値socket:<HttpServerAddress>:<HttpServerPort>を含む文字列を作成します。

- ドキュメントURL: Web表示可能ファイルへの計算されたURL。

- ContentViewLink: コンテンツ表示ページへの計算されたURLであり、コンテンツのビューやコンテンツ情報へのリンクを表示します。

- @Literal: リテラル値を割り当てることができます。このオプションを選択すると、値を指定する追加のテキスト入力フィールドが表示されます。カンマ区切り表記法を使用して、配列値を入力できます。

図A-4に、フィールド・マッピングの例を示します。

図A-4 「ペイロード・マッピング」ページ: フィールド・マッピングの例

このページでは、次のマッピングを行うことができます。

- taskIdペイロード・フィールドには、コンテンツのdIDの値が割り当てられています。

- 「タイトル」ペイロード・フィールドには、コンテンツのタイトルの値が割り当てられています。

- 「作成者」ペイロード・フィールドには、sysadminのリテラル値が割り当てられています。

A.3.2.3 WebCenter Contentの統合のためのBPELコンポジットの準備

WebCenter ContentとBPELを統合するには、BPELコンポジットのサービスにbinding.adfエントリが存在している必要があります。このバインディングを使用すると、WebCenter ContentでBPELをサービスとして起動し、後からOracle SOA Suiteにステータスを問い合せるための対話IDをBPELに設定できます。

したがって、BPELコンポジットを作成してWebCenter Contentで使用できるようにする場合、次の手順を実行する必要があります。

1. JDeveloperでコンポジットを開きます。

2. composite.xmlファイルをソース・モードで開きます。

3. サービス定義を検索します。

4. サービス定義に次の行を追加します(serviceNameは意味のわかる名前にして、registryNameは空にする必要があります)。

<binding.adf serviceName="YourUniqueServiceName" registryName=""/>

考えられるコンポジット例は次のようになります。

<service name="receive" ui:wsdlLocation="receive.wsdl">
<interface.wsdl interface="http://example.com/sca/soapservice/aug11_app_2/myThirdComposite/receive#wsdl.interface(execute_ptt)"/>
<binding.ws port="http://example.com/sca/soapservice/aug11_app_2/myThirdComposite/receive#wsdl.endpoint(receive/execute_pt)"/>
<binding.adf registryName="" serviceName="my3rdBPELService"/>
</service>

これは、JDeveloperウィジェットを使用して行うこともできますが、この場合、空でないregistryNameが必要になります。ADFを含まないコンポジットのregistryNameは空であり、ここで指定されているコンポジット例では、レジストリ名は空である必要があります。空でない場合は、標準のOracle SOA Suiteを使用してコンポジットを起動した後、APIコールが正しく機能しません。

A.4 コンテンツ・サーバーでのワークフローの構成

この項では、次のトピックについて説明します。

- 付録A「ワークフローの構成」

- 付録A「BPELプロセスの情報」

A.4.1 ワークフローの構成

BPEL Process Managerと統合するには、最初に、コンテンツ・サーバー・ワークフローを構成する必要があります。ワークフローを構成するには、数多くの方法が考えられます。次のタスクを実行して、BPEL Process Managerと統合する最も基本的なタイプのワークフローを構成します。

注意:
Oracle WebCenter Contentは、BPELプロセスと統合したWebCenter Contentに対するSOAPリクエストで単一のネームスペースのみをサポートします。

1. ワークフロー管理アプレットを開始します。

2. 新しい基準ワークフローを追加します。この例では、ワークフロー名はorabpeltestです。

3. ワークフローにステップを追加します。この例では、ステップ名としてinitiateprocessを使用します。

4. ステップ・ユーザーを追加します。

図A-5 「新しいステップの追加」ダイアログ

5. 「終了条件」タブを選択して、少なくとも1人のレビューアを選択します。(この設定は任意ですが、このインスタンスでは、BPELプロセスの開始後、この設定によりコンテンツ・アイテムはこのワークフロー・ステップ内に残されます。)

図A-6 「新しいステップの追加」ダイアログ、「終了条件」タブ

6. 終了条件を追加するには、「追加終了条件を使用」チェック・ボックスを選択して、「編集…」をクリックします。

7. 「追加終了条件の編集」ダイアログで、「カスタム条件の式」を選択して、次のスクリプトを追加します。

wfGet("conversationId") and
obIsInstanceClosed("process_3", wfGet("conversationId"))

図A-7 「追加終了条件」ダイアログ

注意:
Idocスクリプト関数obIsInstanceClosedにより、指定された対話IDを含むBPELインスタンスがまだ開いているかどうかがテストされます。対話IDは、プロセスが起動されるとワークフローのコンパニオン・データに格納されます。

8. 「イベント」タブで、「開始時」イベントに対する「編集…」をクリックします。

図A-8 「新しいステップの追加」ダイアログ、「イベント」タブ

9. 「スクリプトの編集」ダイアログで、「カスタム」タブをクリックします。

10. 「カスタム・スクリプトの式」チェック・ボックスをクリックして、スクリプト・ウィンドウを有効にします。

11. スクリプト・ウィンドウに次の行を入力します。

<$if not conversationId$>
<$obConfigID="process_3"$>
<$obInvokeProcess(obConfigID)$>
<$endif$>

図A-9 「スクリプトの編集」ダイアログ

注意:
コンポーネントにより、起動されたプロセスの状態を開始および判別するために使用できるIdocスクリプト関数が定義されます。obInvokeProcess Idoc関数では、プロセス構成IDの名前がその引数の1つとして使用されます。また、ORABPEL_INVOKE_BPELサービスを使用することもできます。このサービスでは、obConfigID変数がプロセス構成の名前に設定されている必要があります。このサービスによりプロセス構成が読み取られ、このプロセス構成を使用してBPEL Process Managerへの接続方法が決定されます。

12. 「OK」をクリックして、スクリプトの編集を終了します。

13. 「OK」をクリックして、ワークフロー・ステップの編集を終了します。

14. ワークフローを有効化します。

A.4.2 BPELプロセスの情報

コンテンツ・アイテムによりワークフローが入力され、BPELプロセスが開始されると、関連するBPELプロセスを識別するために識別子が作成されてコンパニオン・データ・ファイルに格納されます。この識別子はキーconversationIdとともに格納され、ワークフロー・ステップのイベントのカスタムIdocスクリプトを使用してコンパニオン・データから取得できます。

Idocスクリプト関数

obInvokeProcess[obConfigID]: この関数は、プロセス構成での定義に従ってプロセスを起動します。

obIsInstanceClosed[obConfigID, conversationId]: この関数は、指定された対話IDのプロセスが指定された構成に従ってクローズすると、trueを返します。クローズには、完了と取消しが含まれます。

obIsInstanceOpen[obConfigID, conversationId]: この関数は、指定された対話IDのプロセスが指定された構成に従ってオープンすると、trueを返します。

obRetrieveStatus[obConfigID, conversationId]: この関数は、プロセスに関する情報が正常に取得されるとtrueを返します。データ・バインダにはインスタンス・タイトル、監査証跡、トレースおよびメタデータに加えて、プロセス・インスタンスIDやリビジョン・タグに関する情報が含まれます。

B Need to Knowコンポーネントの管理

この付録では、コンテンツ・サーバーでNeed to Know (NTKまたはNtkDocDisclosure)コンポーネントをインストールおよび構成する方法について説明します。また、このコンポーネントを使用してコンテンツ・サーバーのセキュリティ分野(コンテンツへのユーザー・アクセス、検索結果、ユーザー資格情報、メタデータ変更の動作、および検索でのWHERE句の使用など)をカスタマイズする方法についても説明します。

ここで説明する項目は、次のとおりです。

- はじめに

- Need to Knowコンポーネントのインストール

- Need to Knowコンポーネントの構成

- Need to Knowコンポーネントの使用

- 管理インタフェース

- セキュリティ・カスタマイズのサンプル

B.1 概要

Need to Know (NtkDocDisclosureまたはNTK)コンポーネントでは、次のコンテンツ・サーバー・セキュリティ分野のカスタマイズをサポートしています。

- コンテンツ・セキュリティ: コンテンツ・アイテムへのユーザー・アクセスの変更。

- 検索結果: 検索結果の表示の変更。

- ヒット・リスト・ロール: 問合せおよびチェックイン・ページのユーザー資格証明の変更。

- コンテンツ・メタデータ・セキュリティ: コンテンツ・アイテムに対するメタデータの変更動作の変更。

- WHERE句の導出: 検索でのWHERE句の使用の変更。

たとえば、標準セキュリティでは、ユーザーが表示できるのは最低でも読取り権限を持つコンテンツのみです。Need to Knowコンポーネントでは、これを次の2通りの方法で変更できます。

- すべてのユーザーは、メタデータまたはドキュメント自体を参照できない場合でも、指定したセキュリティ・グループからのコンテンツ・アイテムを検索結果リストに表示できます。

- コンテンツ・メタデータおよびユーザー属性に対する問合せを使用して、読取り権限および書込み権限を、指定されたセキュリティ・グループ内で拡張または制限できます。

Need to Knowコンポーネントには、HTML管理インタフェースが用意されており、セキュリティ構成ステータス情報の表示、セキュリティ構成値の編集、およびセキュリティ構成値に対するIdocスクリプトの表示とテストを行うことができます。

B.1.1 機能

Need to Knowコンポーネントの特徴は、次のとおりです。

- Need to Knowコンポーネントは、セキュリティ・グループごとに適用されます。コンポーネントを使用するセキュリティ・グループを指定する必要があります。指定したセキュリティ・グループのすべてのコンテンツが、すべてのユーザーの検索結果に表示されます。

- このコンポーネントには、すべてのアカウントを表示可能にするオプションが用意されており、ユーザーは、アカウントに関係なく、コンテンツ・アイテムを検索でヒットできます。

- 「検索」ページの「セキュリティ・グループ」リストに、指定されたすべてのセキュリティ・グループが表示されます。アカウントが有効な場合は、「検索」ページの「アカウント」リストにすべてのアカウントが表示されます。

- Need to Know機能をサポートするには、新しい「DocDisclosureQuery」メタデータ・フィールドと新しいヒット・リスト・ロールを作成する必要があります。ヒット・リスト・ロールには、指定されたすべてのセキュリティ・グループに対する読取りアクセス権が付与されます。

- Need to Know問合せでは、ユーザー属性フィールドを新規作成するか、既存のものを使用することができます。

- ドキュメントをチェックインするときに、「DocDisclosureQuery」メタデータ・フィールドで問合せを定義できます。問合せ条件にコンテンツ・メタデータとユーザー属性を含め、問合せ結果によってドキュメントへのアクセス権が決まります。問合せはIdocスクリプトに手動で入力することも、Disclosure Query Securityアプレットを使用して問合せを構築することもできます。

- ユーザーが検索を行うときには、ヒット・リスト・ロールがユーザーに動的に適用され、指定されたセキュリティ・グループのすべてのコンテンツへの読取りアクセス権が付与されます。次に、コンテンツ・アイテムに対するユーザーのアクセス権を決める「DocDisclosureQuery」フィールドの問合せに対して、各コンテンツ・アイテムがチェックされます。

- 「DocDisclosureQuery」フィールドが空の場合は、標準セキュリティが適用されます。標準セキュリティは、問合せフィールドで明示的に指定することもできます。あるいは、他のドキュメントおよびユーザー属性とのブール組合せで使用して、読取りアクセス権を拡張したり制限することもできます。

- NTKセキュリティ・グループ内にないコンテンツ・アイテムに対する問合せが入力された場合、問合せは実行されず、標準セキュリティが適用されます。

- ユーザーが、セキュリティ・グループに対して書込み以上のアクセス権を持つ場合、「DocDisclosureQuery」フィールドの問合せは実行されず、標準セキュリティが適用されます。

- すべてのコンテンツに対してグローバル問合せを定義できます。そのため、コンテンツ・アイテムごとに個々の問合せを指定する必要はありません。チェックイン時に問合せが入力された場合、グローバル問合せをオーバーライドするようシステムを設定できます。

B.1.2 適用

このコンポーネントは、次のような複雑なセキュリティ実装の開始点として使用できます。

- 機密文書のダウンロードに対する統合された追跡。

- カスタム・ロジックを使用した、書込み以上の権限の制御。

- 特定のセキュリティ・グループ内のドキュメントは数回のダウンロードのみ行える、などの表示制限やサブスクリプションの制御の実装。

- カスタム・データベース表からのエントリまたはカスタムAPIからの結果の組込みによるアクセスの制御。これは、外部で制御される認可に対する仕組みです。

B.2 Need to Knowコンポーネントのインストール

コンポーネントは、「コンポーネント・ウィザード」またはコマンドラインのComponentToolを使用してインストールします。

「コンポーネント・ウィザード」によるNTKコンポーネントのインストール

1. コンポーネント・ウィザードを起動します。スタンドアロン・アプリケーションの使用方法の詳細は、第3.5.2項を参照してください。

2. 「コンポーネント・ウィザード」ページで、「オプション」→「追加」を選択します。

3. 「コンポーネントの追加」ウィンドウで、「既存のコンポーネントを使用」のラジオ・ボタンを選択します。

4. WebCenter Content shiphomeがインストールされた場所に移動し、Need to Knowコンポーネントを直接見つけます。次に例を示します。

MW_HOME\WC_CONTENT_ORACLE_HOME\ucm\cs\idc\components\NeedToKnow

5. NeedToKnow.hdaファイルを選択し、「OK」をクリックします。

6. 「有効化」をクリックします。
NTKコンポーネントが有効化されます。

ComponentToolでのNTKコンポーネントのインストール

Component Toolを実行し、WC_CONTENT_ORACLE_HOMEの構成名とパスを使用して、次のパスのNeedToKnow.hdaファイルを指定します。

MW_HOME\WC_CONTENT_ORACLE_HOME\ucm\cs\idc\components\NeedToKnow\NeedToKnow.hda

B.3 Need to Knowコンポーネントの構成

この項では、Need to Knowコンポーネントを使用した基本的なセキュリティ構成の設定手順について説明します。この手順では、セキュリティ構成変数、カスタム・メタデータ・フィールドおよびヒット・リスト・ロールの設定方法について説明します。基本的な構成の設定後、Need to Knowコンポーネント・インタフェースを使用して、セキュリティ構成の編集、テストおよび改善を行うことができます。

1. コンテンツ・サーバー・ポータルで、「管理」、「管理サーバー」、「一般構成」の順に選択します。

2. 「一般構成」の「追加の構成変数」で、テキスト領域の最下部までスクロールし、次のコードを追加します。

SpecialAuthGroups=group1,group2,...

コードでは、次の点に注意してください。

- group1,group2,...を、Need to Knowコンポーネントを使用するセキュリティ・グループに置き換えます。

- セキュリティ・グループは、小文字で入力する必要があります。

- リストされていないセキュリティ・グループには、標準セキュリティが適用されます。

注意:
Oracle WebCenter Content: Recordsなどのその他の製品にもSpecialAuthGroups構成変数を使用できるため、Need to Knowコンポーネントを使用するセキュリティ・グループに一意の名前を使用するよう注意してください。

3. コンテンツ・アイテム・レベルの問合せを指定する場合は、Configuration Managerを使用して新規メタデータ・フィールドを追加します。(グローバル問合せのみを使用する場合は不要です)。新規メタデータ・フィールドは、Configuration Managerを使用して追加する必要があります。Need to Knowコンポーネント・インタフェースからは追加できません。

- DocDisclosureQueryやNeedToKnowなど、任意のフィールド名とタイトルを使用できます。

- フィールドは、メモ・フィールドとして指定する必要があります。

- フィールドの追加後、「データベース設計の更新」→「検索索引の再構築」の順にクリックします。

注意:
コンテンツ・サーバー・インスタンスに多くのコンテンツがすでに含まれている場合、検索索引の再構築には時間がかかります(数日かかる場合もあります)。システムの保守期間やシステムがあまり使用されていないときに再構築するように考慮してください。

4. 「ユーザー管理」管理アプレットを使用して、ヒット・リスト・ロールを追加します。

- hitlistやNTKroleなど、任意のロール名を使用できます。

- SpecialAuthGroups構成エントリで指定したすべてのセキュリティ・グループに、読取りアクセス権を付与します。

- SpecialAuthGroups構成エントリで指定したセキュリティ・グループをチェックイン・ページまたは更新ページにリストするには、このロールに書込みアクセス権を付与する必要があります。

- 2つのヒット・リスト・ロールを作成し、別の名前と権限を付与することができます。1つ目のロールを、コンテンツ検索の問合せロールとしてNeed to Knowコンポーネントに構成し、もう1つのロールを、コンテンツ・チェックインおよび更新の更新ロールとしてNeed to Knowコンポーネントに構成できます。

- このロールはユーザーに割り当てないでください。ヒット・リスト・ロールが問合せまたは更新ロールとして構成された場合、ユーザーの属性に自動的に追加されます。

5. Need to Knowセキュリティの範囲を超えるアクセス権をユーザーに設定する場合、「一般構成」ページを使用して「追加の構成変数」セクションに追加セキュリティ構成設定を含めます。テキスト領域の最下部までスクロールし、必要な構成設定を入力します。

6. Need to Know問合せで使用する新規ユーザー属性フィールドを追加する場合、「ユーザー管理」ツールを使用してユーザー属性フィールドを追加します。

7. コンテンツ・サーバー・インスタンスを再起動します。

注意:
Need to Knowコンポーネントをインストールすると、特定のセキュリティ構成値がIntradocDir/data/needtoknow/ntk_config.hdaファイルに格納されます。これらの値は、付録Bで説明しているNeed to Know管理インタフェースを使用して編集できます。また、ntk_config.hdaファイルを直接編集することもできます。

B.4 Need to Knowコンポーネントの使用

この項の内容は次のとおりです。

- 付録B「セキュリティ構成のカスタマイズ」

- 付録B「Disclosure Query Securityアプレット」

- 付録B「問合せの構文」

- 付録B「コンテンツレベル問合せの定義」

B.4.1 セキュリティ構成のカスタマイズ

Need to Knowコンポーネントには、次の分野に重点を置いた追加のセキュリティ構成が用意されています。

- コンテンツ・セキュリティ: コンテンツ・アイテムへのユーザー・アクセスの変更。

- 検索結果: 検索結果の表示の変更。

- ヒット・リスト・ロール: 問合せおよびチェックイン・ページのユーザー資格証明の変更。

- WHERE句の導出: 検索でのWHERE句の使用の変更。

- コンテンツ・メタデータ・セキュリティ: コンテンツ・アイテムに対するメタデータの変更動作の変更。

B.4.1.1 コンテンツ・セキュリティ

標準セキュリティでは、セキュリティ・ロール、グループおよびアカウントを使用して、コンテンツ・アイテムへのアクセスに必要な権限レベルがユーザーにあるかどうかを判断します。Need to Knowコンポーネントでは、ユーザー権限の決定プロセスをカスタマイズできます。Need to Knowコンポーネント・インタフェースを使用して、構成フィールドを設定し、読取り、書込みおよび削除の権限レベルを設定するIdocスクリプトを作成します。Idocスクリプトに、ユーザーおよびコンテンツ・メタデータ値を含めることもできます。

Need to Knowコンポーネントでは、次のプロセスを使用してコンテンツ・セキュリティを導出します。

1. ユーザーがコンテンツ情報を表示するリンクをクリックします。

2. ユーザーにadminロールがある場合、標準セキュリティが使用され、ユーザーはコンテンツを表示することができます。

3. コンテンツ・アイテムのセキュリティ・グループがNeed to Know認可グループでない場合、標準セキュリティを使用してユーザーの読取りリクエストが評価されます。

4. Need to Knowセキュリティが、読取り権限レベルで有効でない場合、標準セキュリティを使用してユーザーの読取りリクエストが評価されます。

5. Need to Knowセキュリティが読取り権限レベルで制限されておらず、ユーザーがコンテンツ・アイテムへの標準セキュリティ・アクセス権を持つ場合、ユーザーはコンテンツへのアクセスが許可されます。

6. Need to KnowセキュリティIdocスクリプト(この場合は、読取りセキュリティ・スクリプト)が評価されます。

7. Need to Knowアクセス・フラグ(この場合は、isNTKReadAccess)が評価され、コンテンツへのアクセス権がユーザーにあるかどうかが判断されます。アクセスは、Need to Knowアクセス・フラグに基づいて、許可または拒否されます。

Need to Knowコンポーネントでは、読取り、書込み、削除の各アクセス・レベルに対してセキュリティ構成スクリプトをテストすることもできます。テストでは、ユーザーおよびコンテンツIDを指定でき、ロールとアカウントを指定できます。テストでは、ユーザーの実際の属性ではなく、これらの属性が使用されます。たとえば、属性にアクセスできない外部ユーザーを使用してIdocスクリプトをテストできます。テストの実行後、コンテンツ・アイテムへのアクセス権がユーザーにあるかどうか、Need to Knowセキュリティが使用されたかどうか、Need to Knowセキュリティが使用されなかった場合はその理由がコンポーネントからレポートされます。

Need to Knowコンポーネント・インタフェースを使用したコンテンツ・セキュリティの構成の詳細は、「NTK構成情報ページ」および「コンテンツ・セキュリティ構成情報ページ」を参照してください。コンテンツ・セキュリティを構成できるIdocスクリプトのサンプルは、付録Bを参照してください。

次のIdocスクリプト関数をスクリプト・フィールドで使用して、コンテンツ・セキュリティを判断できます。Idocスクリプトの詳細は、『Oracle WebCenter Contentでの開発』を参照してください。

Idocスクリプト関数

説明

allStrIntersect

2つのカンマ区切りの文字列を必須パラメータとし、1つのブール・フラグをオプション・パラメータとします。2番目の文字列のすべての値が最初の文字列に出現する場合、関数はtrueを返します。オプション・パラメータがtrueに設定され、2番目の値が空の文字列の場合、関数はtrueを返します。デフォルトでは、オプション・パラメータはfalseです。カンマ区切りの文字列値の比較では、大文字と小文字は区別されません。

includeNTKDeleteSecurityScript

削除セキュリティ・スクリプトを評価し、isNTKDeleteAccess変数を読取りセキュリティ・スクリプトまたは書込みセキュリティ・スクリプトで使用できるようにします。この関数が削除セキュリティ・スクリプトで使用された場合は、無視されます。

includeNTKReadSecurityScript

読取りセキュリティ・スクリプトを評価し、isNTKReadAccess変数を書込みセキュリティ・スクリプトまたは削除セキュリティ・スクリプトで使用できるようにします。この関数が読取りセキュリティ・スクリプトで使用された場合は、無視されます。

includeNTKWriteSecurityScript

書込みセキュリティ・スクリプトを評価し、isNTKWriteAccess変数を読取りセキュリティ・スクリプトまたは削除セキュリティ・スクリプトで使用できるようにします。この関数が書込みセキュリティ・スクリプトで使用された場合は、無視されます。

isDisclosureQuery

開示フィールド(指定されている場合)に対して問合せを評価し、trueまたはfalseを返します。オプションのパラメータを指定して、開示問合せが空の場合にtrueまたはfalseを返すかどうかを指定することができます。開示フィールドが指定されていない場合、または存在しない場合、この関数は常にfalseを返します。

isMetaChange

コンテンツ・セキュリティ・コールにコンテンツの更新またはチェックインが含まれる場合、この変数が設定されます。

isStrIntersect

2つのカンマ区切りの文字列を必須パラメータとし、1つのブール・フラグをオプション・パラメータとします。2番目の文字列の1つ以上の値が最初の文字列に出現する場合、関数はtrueを返します。オプション・パラメータがtrueに設定され、2番目の値が空の文字列の場合、関数はtrueを返します。デフォルトでは、オプション・パラメータはfalseです。カンマ区切りの文字列値の比較では、大文字と小文字は区別されません。

stdSecurityCheck

現在のアクセス・レベルに対する標準セキュリティを確認します。たとえば、関数が読取りセキュリティ・スクリプトに含まれる場合、読取りアクセス・レベルでセキュリティを確認します。

B.4.1.2 検索結果

Need to Knowコンポーネントでは、検索問合せから返される検索結果の表示をカスタマイズできます。NTKインタフェースを使用して、「非表示フィールド」と「スクリプト」の2つの構成値を設定できます。

非表示フィールド値は、「検索結果」ページのビューに表示されないフィールドのリストです。値は空の文字列に設定されます。フィールドを非表示にするには、コンポーネントの検索結果Idocスクリプトで、フィールドhideFieldsを設定する必要があります。

Idocスクリプトで、検索結果の表示を制御します。検索結果の行ごとに、Idocスクリプトが評価されます。スクリプト内に多くのフィールドを設定して、検索結果の表示を変更できます。フィールドのリストと、Need to Knowコンポーネント・インタフェースを使用した検索結果の表示スクリプトのカスタマイズの詳細は、「検索結果構成情報」ページを参照してください。

Need to Knowコンポーネントでは、securityCheck Idocスクリプト関数を使用して検索結果の表示を指定します。securityCheck関数では、構成値に応じて、現在のコンテンツ・アイテムに対するセキュリティ(標準セキュリティまたはNeed to Knowセキュリティ)が確認されます。関数には、確認するアクセス・レベルを指定するオプション・パラメータがあります。

- 1 = 読取り

- 2 = 書込み

- 4 = 削除

- 8 = 管理

securityCheckにパラメータが使用されない場合、デフォルトで読取りアクセス・レベルが確認されます。

検索結果の表示を変更するIdocスクリプトのサンプルは、付録Bを参照してください。

B.4.1.3 ヒット・リスト・ロール

ヒット・リスト・ロールでは、コンテンツの検索、コンテンツ・チェックイン、更新の各ページを使用するためのユーザー資格証明を変更できます。「ユーザー管理」アプレットを使用して、任意の名前でヒット・リスト・ロールを追加できます。ロールが有効になると、検索、チェックインまたは更新時にロールが自動的にユーザーの属性に追加されるため、ロールをユーザーに割り当てないでください。

ヒット・リスト・ロールを作成する場合は、SpecialAuthGroups構成エントリに指定するすべてのセキュリティ・グループに読取りアクセス権を付与する必要があります。これらのセキュリティ・グループをコンテンツ・チェックイン・ページまたは「更新」ページにリストするには、ヒット・リスト・ロールに書込みアクセス権も追加する必要があります。

Need to Knowコンポーネントの「ヒット・リスト・ロール構成情報」ページを使用して、問合せと更新の2つの形式のヒット・リスト・ロールを実装できます。問合せに使用されるヒット・リスト・ロールは、コンテンツ検索に適用されます。更新に使用されるヒット・リスト・ロールは、コンテンツのチェックインおよび更新に適用されます。

ヒット・リスト・ロールの使用方法の詳細は、「NTK構成情報」ページおよび「ヒット・リスト・ロール構成情報」ページを参照してください。ヒット・リスト・ロールの使用例は、付録Bを参照してください。

B.4.1.4 WHERE句の導出

Need to Knowコンポーネントには、検索結果の取得に使用される問合せのWHERE句をカスタマイズできる2つのフィルタが用意されています。

- preDetermineWhereClause: WHERE全体をオーバーライドします。

- postDetermineWhereClause: 標準セキュリティのWHERE句に追加します。

これらのフィルタのコードは、NTKFilter Javaクラスにあります。これらのフィルタの動作のサンプルは、付録Bを参照してください。

B.4.1.5 コンテンツ・メタデータ・セキュリティ

Need to Knowコンポーネントには、コンテンツ・アイテムがチェックインまたは更新されたときのメタデータの変更動作を変更できるcheckMetaChangeSecurityという名前のフィルタが用意されています。

このフィルタのコードは、NTKFilter Javaクラスにあります。このフィルタの動作の例は、付録Bを参照してください。

B.4.2 Disclosure Query Securityアプレット

「Disclosure Query Security」アプレットは、チェックイン時の特定のコンテンツ・アイテムに対する問合せの定義に使用されます。

アプレットにアクセスするには、「コンテンツ・チェックイン・フォーム」ページの「DocDisclosureQuery」フィールドの横にある「更新」ボタンをクリックします。

要素

説明

フィールド

問合せに指定するユーザー属性フィールドを選択します。このリストには、「ユーザー・ロケール」、「ユーザー名」、「ユーザー・ロール」と、すべてのカスタム・ユーザー属性フィールドが含まれています。

演算子

「フィールド」および「値」に適用する演算子を選択します。次の演算子が「ユーザー・ロール」以外のすべてのフィールドに使用されます。
次の値に等しい: 指定した「フィールド」の値が、指定した「値」と一致します。

次の値に等しくない: 指定した「フィールド」の値が、指定した「値」と一致しません。

次で始まる: 指定した「フィールド」の値が、指定した「値」で始まります。

次を含む: 指定した「フィールド」の値に、指定した「値」が含まれます。

「ユーザー・ロール」フィールドには、「メンバーあり」演算子のみがあり、「値」フィールドにロールのドロップダウン・リストが表示されます。

値

問合せに指定する値を入力します。

- 選択したフィールドに対するオプション・リストが指定されている場合は、ドロップダウン・リストから値を選択します。

- 選択したフィールドに対するオプション・リストが指定されていない場合は、テキスト・ボックスに値を入力します。

追加

「フィールド」、「演算子」および「値」フィールドで指定した問合せを、「問合せ式」テキスト・ボックスに入力します。「追加」ボタンをクリックするたびに、現在の設定がAND句として問合せに追加されます。

更新

選択した問合せ句を、「フィールド」、「演算子」、「値」の各フィールドで指定したパラメータで更新します。

マージ

選択した問合せ句に対するOR句を作成(パイプ文字を挿入)します。このボタンは、次の条件で使用可能になります。

- ドロップダウン・リストのフィールドが、選択した問合せ句に指定したフィールドと一致します。

- 選択した問合せ句の演算子が「次の値に等しくない」ではありません。

- ドロップダウン・リストの演算子が、「次の値に等しくない」ではありません。
注意: パイプ文字は、「ユーザー・ロール」の問合せ句の「問合せ式」には表示されませんが、「DocDisclosureQuery」フィールドに表示されます。

問合せ式

問合せの各句を1行に表示します。

削除

選択した問合せ句を削除します。

追加

「コンテンツ・チェックイン・フォーム」ページの「DocDisclosureQuery」フィールドの既存の問合せに「問合せ式」を追加します。

置換

「コンテンツ・チェックイン・フォーム」ページの「DocDisclosureQuery」フィールドの既存の問合せを「問合せ式」で置き換えます。

取消

問合せの変更を適用せずに、「Disclosure Query Security」アプレットを閉じます。

B.4.3 問合せの構文

「Disclosure Security Query」アプレットでは、正しいIdocスクリプト構文で問合せが作成されますが、独自の問合せを「DocDisclosureQuery」フィールドに直接入力することもできます。次のIdocスクリプト構文が開示問合せに使用されます。

- 付録B「Like演算子」

- 付録B「ブール演算子」

- 付録B「UserName変数」

- 付録B「stdSecurity変数」

- 付録B「ユーザー属性フィールド」

- 付録B「ユーザー・ロール」

注意:
「DocDisclosureQuery」フィールドに直接入力する場合の問合せ句の正しい書式は、「Disclosure Query Security」アプレットを使用して確認できます。

B.4.3.1 Like演算子

like演算子では、部分文字列とワイルドカード文字列が照合されます。文字列全体を一重引用符で囲みます。

B.4.3.1.1 部分文字列

like演算子を使用して部分文字列を照合します。

B.4.3.1.2 ワイルドカード文字列

ワイルドカード文字列を使用して可変文字とオプションを照合します。ワイルドカード文字列には、次の構文が使用されます。

* = 0文字以上の文字列と一致

? = 1文字と一致

| = 複数のオプションの区切りで、そのうちの1つのオプションのみが一致

たとえば、次のコードは"MyClient"、"3rd Quarter MyClient Report"、"MyClient Visit"、"Meeting with MyClient"および"1996 Reports"と一致します。この文字列は、"My Client"、"All 1996 Reports"または"1996 Report"とは一致しません。

dDocName like '*MyClient*|199? Reports'

B.4.3.2 ブール演算子

問合せ句は、and、orおよびnotのブール演算子で結合できます。

- ブール演算子には小文字を使用します。

- 各句をカッコで囲む必要があります。次に例を示します。

(uRoles like '*:contributor:*') and (uUserLocale like 'hq')

B.4.3.3 UserName変数

変数UserNameは、現在ログインしているユーザーの名前です。たとえば、次のコードはユーザーjgreenまたはhbrownにのみ権限を付与します。

UserName like 'jgreen|hbrown'

B.4.3.4 stdSecurity変数

変数stdSecurityは、標準セキュリティ・モデルを指定します。stdSecurityCheck Idocスクリプト関数にマップされます。この変数は、他の問合せ句とのブール組合せに使用して、アクセスを制限(and演算子を使用)または拡張(or演算子を使用)することができます。たとえば、次のコードは、ユーザーがドキュメントに通常アクセスできる場合、あるいはユーザーがjgreenまたはhbrownの場合に、ドキュメントへのアクセスを許可します。

stdSecurity or UserName like 'jgreen|hbrown'

B.4.3.5 ユーザー属性フィールド

問合せにユーザー属性フィールドを指定する場合、uFieldNameの形式を使用します。次に例を示します。

uMyUserField like 'Value'

B.4.3.6 ユーザー・ロール

UserRoles Idocスクリプト関数は、現在のユーザーに対するすべてのロールをカンマ区切り形式で返すため、ユーザー・ロールには特別な形式が必要です。(この例では、この関数用にuRolesショートカットが定義されています)。たとえば、uRolesの値は次のようになります。

role1,role2,...,role10

このため、値role1を含む問合せ文字列を指定するには、ロール・リスト内の位置に関係なく値が認識されるようにワイルドカードを含める必要があります。次に例を示します。

uRoles like '*role1*'

ただし、この問合せ文字列では、付与する必要のないロールrole10のユーザーにもセキュリティ・アクセス権が付与されます。問合せに指定されたロールにのみuRolesの値を限定するには、DelimitedUserRoles関数と構文を使用する必要があります。次のように、ロール値の両側に一重引用符とコロンを含めます。

uRoles like '*:role1:*'

role1またはrole2と一致するには、次の構文を使用します。

uRoles like '*:role1:*|*:role2:*'

B.4.4 コンテンツレベル問合せの定義

個々のコンテンツ・アイテムに対して問合せを定義する手順は次のとおりです。

1. 「コンテンツ・チェックイン・フォーム」ページ(新しいコンテンツ・アイテムの場合)または「情報更新フォーム」ページ(既存のコンテンツ・アイテムの場合)を開きます。

2. 「DocDisclosureQuery」フィールド(このフィールドの名前はインストール時に指定した名前)の横にある「更新」ボタンをクリックします。

3. 「Disclosure Query Security」アプレットで、問合せ句を作成するための「フィールド」、「演算子」、および「値」を選択します。

- フィールド: 「ユーザー・ロケール」、「ユーザー名」、「ユーザー・ロール」と、すべてのカスタム・ユーザー属性フィールドが含むユーザー属性リストから選択します。

- 演算子: 「フィールド」および「値」に適用する演算子を選択します。次の演算子が「ユーザー・ロール」以外のすべてのフィールドに使用されます。

- 次の値に等しい: 指定した「フィールド」の値が、指定した「値」と一致します。

- 次の値に等しくない: 指定した「フィールド」の値が、指定した「値」と一致しません。

- 次で始まる: 指定した「フィールド」の値が、指定した「値」で始まります。

- 次を含む: 指定した「フィールド」の値に、指定した「値」が含まれます。

「ユーザー・ロール」フィールドには、「メンバーあり」演算子のみがあり、「値」フィールドにロールのドロップダウン・リストが表示されます。

- 値: 選択したフィールドに対するオプション・リストが指定されている場合は、ドロップダウン・リストから値を選択します。選択したフィールドに対するオプション・リストが指定されていない場合は、テキスト・ボックスに値を入力します。

4. 「追加」をクリックします。
問合せ句が、「問合せ式」テキスト・ボックスに追加されます。

5. 問合せの構築を続けます。

- and演算子を使用して別の問合せ句を追加するには、値を入力して「追加」をクリックします。

- 既存の問合せ句を変更するには、新しい値を入力し、変更する問合せの行を選択して「更新」をクリックします。

- or句を作成するには、新しい値を入力し、変更する問合せの行を選択してマージをクリックします。

- 問合せ句を削除するには、問合せの行を選択して「削除」をクリックします。

6. 「DocDisclosureQuery」フィールドに問合せ式を入力します。

- 「DocDisclosureQuery」フィールドの既存の問合せを、アプレットの問合せ式で置き換えるには、「置換」をクリックします。

- アプレットの問合せ式を「DocDisclosureQuery」フィールドの既存の問合せに追加するには、「追加」をクリックします。

「Disclosure Query Security」アプレットでは、問合せ句が適切な構文に変換されて、「コンテンツ・チェックイン・フォーム」ページまたは「情報更新フォーム」ページの「DocDisclosureQuery」フィールドに問合せが入力されます。

注意:
「DocDisclosureQuery」フィールドに直接入力する場合の問合せ句の正しい書式は、「Disclosure Query Security」アプレットを使用して確認できます。

7. 残りのフィールドに入力したら、「チェックイン」または「更新」をクリックします。
開示問合せが検証されます。問合せの書式が間違っている場合は、エラー・メッセージに問合せの特定の問題が示されます。

B.5 管理インタフェース

Need to Knowコンポーネントのインストール後、NTK「構成情報」リンクは「管理」トレイまたはメニューから使用できます。このリンクから「NTK構成情報」ページにアクセスできます。このページには、セキュリティ構成ステータス情報が表示され、セキュリティ構成の編集機能を使用できます。

Need to Knowコンポーネントには、次の構成ページが用意されています。

- 付録B「「NTK構成情報」ページ」

- 付録B「「コンテンツ・セキュリティ構成情報」ページ」

- 付録B「「検索結果構成情報」ページ」

- 付録B「「ヒット・リスト・ロール構成情報」ページ」

- 付録B「「NTKコンテンツ・セキュリティのテスト」ページ」

B.5.1 「NTK構成情報」ページ

「NTK構成情報」ページには、、Need to Knowコンテンツ・セキュリティ構成、検索結果構成およびヒット・リスト・ロール構成に関する情報が示されます。またこのページでは、セキュリティ構成の編集、検索結果構成の編集、ヒット・リスト・ロール構成の編集、構成用のIdocスクリプトと非表示フィールドの表示およびIdocスクリプトのテストを行うこともできます。

このページにアクセスするには、メイン・メニューから「管理」→「NTK構成情報」を選択します。

要素

説明

アクセス・レベル

コンテンツ・アイテムにアクセスするための権限レベル(読取り、書込み、削除)を表示します。

有効

読取り、書込みまたは削除アクセスに対してNeed to Knowセキュリティが有効かどうかを示します。
いいえ: Need to Knowセキュリティは、アクセス・レベルで無効です。これがデフォルトです。

はい: Need to Knowセキュリティは、アクセス・レベルで有効です。

アクセスの制限

読取り、書込みおよび削除アクセスがNeed to Knowセキュリティで制限されているかどうかを指定します。ユーザー・アクセスの制限にNeed to Knowセキュリティが使用されている場合、コンテンツ・アイテムに対する標準の読取り、書込みまたは削除アクセス権がユーザーにあるかどうかに関係なくアクセスは制限されます。ユーザー・アクセスの制限にNeed to Knowセキュリティが使用されない場合、ユーザーはコンテンツ・アイテムへの標準アクセス権を持ちます。この機能によって、標準セキュリティ・モデルより制限の強いセキュリティ・モデルを作成できます。
いいえ: アクセスはNeed to Knowセキュリティで制限されません。これがデフォルトです。

はい: アクセスはNeed to Knowセキュリティで制限されます。

スクリプト

コンテンツ・アイテムに対する読取り、書込み、削除のアクセス権がユーザーにあるかどうかを評価するIdocスクリプトを表示またはテストするリンクがあります。Need to Knowコンポーネントでは、3つのパラメータのいずれかをフラグとして使用して、アクセス権が付与されているかどうかを判断します。
読取りアクセス: isNTKReadAccess

書込みアクセス: isNTKWriteAccess

削除アクセス: isNTKDeleteAccess

Idocスクリプトを表示するアクセス・レベルの行で「表示」をクリックします。スクリプトではNeed to Knowコンポーネントで、読取り、書込み、削除のアクセス権がユーザーにあるかどうかが評価されます。

Need to Knowセキュリティ構成をテストするアクセス・レベルの行で「テスト」をクリックします。「NTKコンテンツ・セキュリティのテスト」ページが表示されます。このページを使用して、セキュリティ構成用のIdocスクリプトのテストを作成および実行できます。詳細は、付録Bを参照してください。

開示フィールド

Idocスクリプト関数isDisclosureQueryに対して評価されるカスタム・メタデータ・フィールドを表示します。開示フィールドを使用して、コンテンツ固有の問合せを作成できます。デフォルト値は<none>です。
構成マネージャを使用してこのフィールドを作成し、それをメモ・フィールド・タイプにします。詳細は、付録Bおよび付録Bを参照してください。

開示フィールドがある場合、「コンテンツ・チェックイン・フォーム」ページでは、このフィールドの横に「更新」ボタンが表示されます。ボタンをクリックして、Disclosure Query Securityアプレット(付録Bを参照)にアクセスします。アプレットは、ユーザー・メタデータに基づいた問合せの作成に役立ちます。

セキュリティ認証グループ

Need to Knowセキュリティが使用されるセキュリティ・グループのリストを表示します。グループは、SpecialAuthGroups構成変数のサブセットです。グループが選択されていない場合、すべてのSpecialAuthGroupsが使用されます。SpecialAuthGroupsのデフォルト値は<All Special Auth Groups>です。
構成マネージャを使用してconfig.cfgファイルにSpecialAuthGroups値を指定します。詳細は、付録Bおよび付録Bを参照してください。

デバッグ

デバッグ・オプションのステータスを表示します。
はい: コンテンツ・アイテムに対して行われたセキュリティ・チェックに関するデバッグ情報がログ・ファイルに書き込まれます。管理者ロールのユーザーは、コンテンツ・アイテムへのアクセスが常に許可されるため、記録されません。

いいえ: デバッグ情報はログ・ファイルに書き込まれません。

編集
(「コンテンツ・セキュリティ統合情報」)

「コンテンツ・セキュリティ構成情報」ページを表示します。このページでは、コンテンツ・セキュリティ構成を変更できます。

非表示フィールド

「表示」をクリックして、「検索結果」ページで非表示にできるフィールドのリストを表示します。

スクリプト

「表示」をクリックして、「検索結果」ページの表示を制御するIdocスクリプトを表示します。

編集
(検索結果構成情報)

「検索結果構成情報」ページを表示します。このページでは、検索結果セキュリティ構成を変更できます。

問合せロール

問合せロールの名前または<none>を表示します。このロールは「検索」問合せページで適用されます。

更新ロール

更新ロールの名前または<none>を表示します。このロールは、コンテンツ・チェックインまたは更新ページで適用されます。

匿名ユーザーへのヒット・リスト・ロールの許可

匿名ユーザーにヒット・リスト・ロールを適用します。
いいえ: ヒット・リスト・ロールは、匿名ユーザーに適用されません。これはデフォルト値です。

はい: ヒット・リスト・ロールは、匿名ユーザーに適用されます。

編集
(ヒット・リスト・ロール構成情報)

「ヒット・リスト・ロール構成情報」ページを表示します。このページでは、ヒット・リスト・ロール・セキュリティ構成を変更できます。

B.5.2 「コンテンツ・セキュリティ構成情報」ページ

「コンテンツ・セキュリティ構成情報」ページでは、読取り、書込み、削除のセキュリティとアクセス構成、およびNeed to Knowコンポーネントの他のオプションを変更できます。

このページにアクセスするには、「NTK構成情報」ページのコンテンツ・セキュリティ構成情報領域の「編集」をクリックします。

要素

説明

読取りオプション: セキュリティ使用

「スクリプト」フィールドで指定されたセキュリティを使用します。
いいえ: Need to Knowコンテンツ・セキュリティを使用しません。これはデフォルト値です。

はい: Need to Knowコンテンツ・セキュリティを使用します。

読取りオプション: アクセスの制限

「スクリプト」フィールドで指定されたとおりにアクセ ス権限を制限します
いいえ: アクセス権限を制限しません。これはデフォルト値です。

はい: アクセス権限を制限します。

読取りオプション: スクリプト

このフィールドにIdocスクリプトを入力し、読取り権限に対するNeed do Knowセキュリティ構成を指定します。

書込みオプション: セキュリティ使用

「スクリプト」フィールドで指定されたセキュリティを使用します。
いいえ: Need to Knowコンテンツ・セキュリティを使用しません。これはデフォルト値です。

はい: Need to Knowコンテンツ・セキュリティを使用します。

書込みオプション: アクセスの制限

「スクリプト」フィールドで指定されたとおりにアクセ ス権限を制限します
いいえ: アクセス権限を制限しません。これはデフォルト値です。

はい: アクセス権限を制限します。

書込みオプション: スクリプト

このフィールドにIdocスクリプトを入力し、書込み権限に対するNeed do Knowセキュリティ構成を指定します。

削除オプション: セキュリティ使用

「スクリプト」フィールドで指定されたセキュリティを使用します。
いいえ: Need to Knowコンテンツ・セキュリティを使用しません。これはデフォルト値です。

はい: Need to Knowコンテンツ・セキュリティを使用します。

削除オプション: アクセスの制限

「スクリプト」フィールドで指定されたとおりにアクセ ス権限を制限します
いいえ: アクセス権限を制限しません。これはデフォルト値です。

はい: アクセス権限を制限します。

削除オプション: スクリプト

このフィールドにIdocスクリプトを入力し、削除権限に対するNeed do Knowセキュリティ構成を指定します。

その他のオプション: 開示フィールド

開示フィールドの名前をリストから選択します。このフィールドは、コンテンツ固有の問合せでのセキュリティの構成に使用されます。
注意: 構成マネージャを使用してコンテンツ・アイテム・レベルの問合せに対するメタデータ・フィールドを作成した場合、そのフィールドがオプションとしてリストに表示されます。

その他のオプション: セキュリティ認証グループ

コンテンツ固有の問合せで使用されるSpecialAuthGroupsを入力します。「一般構成」ページを使用してNeed to Knowコンポーネントに対する特定のセキュリティ・グループを作成した場合、ここでグループを指定できます。セキュリティ・グループを追加する必要がある場合、config.cfgファイルで追加の構成変数のSpecialAuthGroups値を編集することもできます。

その他のオプション: すべての認証グループ

Need to Knowコンポーネントで「セキュリティ認証グループ」フィールドにリストされている特定のグループではなく、すべてのSpecialAuthGroupsを使用するように指定します。このチェック・ボックスはデフォルトで選択されています。
注意: Records Managementなどの他の製品でもSpecialAuthGroups変数を使用できます。Need to Knowセキュリティ構成で使用するセキュリティ・グループのみを指定するよう注意してください。

その他のオプション: デバッグ

コンテンツ・アイテムに対するセキュリティ・チェックの表示にデバッグを使用するかどうかを選択します。
はい: コンテンツ・アイテムに対して行われたセキュリティ・チェックに関するデバッグ情報がログ・ファイルに書き込まれます。管理者ロールのユーザーは、コンテンツ・アイテムへのアクセスが常に許可されるため、記録されません。

デバッグが使用される場合、「表示」と「クリア」の2 つの追加オプションが表示されます。「表示」をクリックして、デバッグ情報のログ・ファイルを表示します。「クリア」をクリックして、情報のログ・ファイルを空にします。

いいえ: デバッグは使用されず、情報はログ・ファイルに書き込まれません。これはデフォルト値です。

更新

新しい設定を使用してコンテンツ・セキュリティ情報を更新し、コンテンツ・サーバー・インスタンスを再起動して、「NTK構成情報」ページに戻ります。

リセット

コンテンツ・セキュリティ構成設定を、最後に保存された値に戻します。

B.5.3 「検索結果構成情報」ページ

「検索結果構成情報」ページでは、検索問合せから返される検索結果をカスタマイズできます。返されるコンテンツ・アイテムは影響を受けません。結果の表示方法のみが影響を受けます。

このページにアクセスするには、「NTK構成情報」ページの検索結果構成情報領域の「編集」をクリックします。

要素

説明

非表示フィールド

コンテンツ検索問合せの結果のビューに表示されないフィールドのリストを表示します。値は空の文字列に設定されます。検索結果スクリプトでフィールドhideFieldsが設定されている場合、これらのフィールドは表示されません。

使用できるフィールド

コンテンツ検索問合せの結果に含まれるフィールドのリストを表示します。

追加

フィールド名を選択して「追加」をクリックし、フィールドを「使用できるフィールド」リストから「非表示フィールド」リストに移動すると、フィールドがコンテンツ検索結果で非表示になります。

削除

フィールド名を選択して「削除」をクリックし、フィールドを「非表示フィールド」リストから「使用できるフィールド」リストに移動すると、フィールドがコンテンツ検索結果で表示されます。

スクリプト

ドこのフィールドにIdocスクリプトを入力し、検索結果の表示を制御します。検索結果の行ごとに、Idocスクリプトが評価されます。多くのフィールドを設定して表示を変更できます。

- docInfo:enabled: コンテンツ情報リンクを無効にするには、0に設定します。

- docInfo:link: コンテンツ情報ページ・リンクを変更するには、これを設定します。

- docInfo:image_small: 情報リンクの小さいイメージを変更するには、これを設定します。

- docInfo:image_large: 情報リンクの大きいイメージを変更するには、これを設定します。

- url:enabled: URLリンクを無効にするには、0 に設定します。

- url:link: URLリンクを変更するには、これを設定します。

- url:image: URLリンクのイメージを変更するには、これを設定します。

- revHistory:enabled: 改訂履歴リンクを無効にするには、0に設定します。

- revHistory:link: 改訂履歴リンクを変更するには、これを設定します。

- checkout:enabled: チェックアウト・リンクを無効にするには、0に設定します。

- checkout:linkF: チェックアウト・リンクを変更するには、これを設定します。

- actions:enabled: アクション・ポップアップ・リンクを無効にするには、0に設定します。

- checkInSimilar:enabled: 「類似をチェックイン」リンクを無効にするには、0に設定します。

- email:enabled: 電子メール・リンクを無効にするには、0に設定します。

- dynConv:enabled: 「Dynamic Converter」リンクを無効にするには、0に設定します。

更新

検索問合せ結果の構成を更新し、コンテンツ・サーバー・インスタンスを再起動して、「NTK構成情報」ページに戻ります。

リセット

検索結果構成設定を前回保存された値に戻します。

B.5.4 「ヒット・リスト・ロール構成情報」ページ

The「ヒット・リスト・ロール構成情報」ページでは、ユーザーのヒット・リスト・ロールを構成できます。

このページにアクセスするには、「NTK構成情報」ページの「ヒット・リスト・ロール構成情報」領域の「編集」をクリックします。

要素

説明

問合せロール

「検索」ページが使用される際に、問合せロールとして適用されるヒット・リスト・ロールを選択します。読取りアクセス権を持つセキュリティ・グループが選択リストに表示されます。ユーザーがすでに読取りアクセス権を持つセキュリティ・グループ・ロールも含まれます。
このロールは、コンテンツ・セキュリティとは別です。コンテンツ・セキュリティ用に構成された検索結果にコンテンツ・アイテムを表示できても、そのアイテムの「コンテンツ情報」ページを表示できない場合があります。

更新ロール

「更新」ページが使用される際に、更新ロールとして適用されるヒット・リスト・ロールを選択します。書込みアクセス権を持つセキュリティ・グループが選択リストに表示されます。ユーザーがすでに書込みアクセス権を持つセキュリティ・グループ・ロールも含まれます。コンテンツ・アイテムが実際にチェックインまたは更新される際、このロールは適用されません。
このフィールドは、コンテンツ・セキュリティと組み合せると最も有効です。このフィールドの使用例は、付録Bを参照してください。

匿名ユーザーへのヒット・リスト・ロールの許可

匿名ユーザーにヒット・リスト・ロールを適用します。
いいえ: 匿名ユーザーにヒット・リスト・ロールを適用しません。これはデフォルト値です。

はい: 匿名ユーザーにヒット・リスト・ロールを適用します。

更新

ヒット・リスト構成を更新し、コンテンツ・サーバー・インスタンスを再起動して、「NTK構成情報」ページに戻ります。

リセット

ヒット・リスト・ロール構成設定を前回保存された値に戻します。

B.5.5 「NTKコンテンツ・セキュリティのテスト」ページ

「NTKコンテンツ・セキュリティのテスト」ページでは、ユーザーに対するテスト・セキュリティ・スクリプトを実行できます。

このページにアクセスするには、「NTK構成情報」ページに表示されている、いずれかのアクセス権限レベルの「スクリプト」列の「テスト」をクリックします。

要素

説明

アクセス・レベル

テストするよう選択した権限レベルに対するアクセスレベル(読取り、書込みまたは削除)を表示します。

スクリプト

コンテンツ・セキュリティ構成をテストすIdocスクリプトを入力します。

ユーザー

テスト用のユーザーID を入力します。

属性の設定

チェック・ボックスを選択して、ユーザーの既存の属性と一致するユーザー属性を自動的に設定します。

ロール

テスト用にユーザーに割り当てるロールを入力します。属性にアクセスできない外部ユーザーを使用してテストを行う場合、このフィールドを使用します。

アカウント

テスト用にユーザーに割り当てるアカウントを入力します。属性にアクセスできない外部ユーザーを使用してテストを行う場合、このフィールドを使用します。

コンテンツID

テスト用のコンテンツIDを入力します。

テスト

「テスト」をクリックして、「NTKコンテンツ・セキュリティのテスト」ページで指定した構成をテストします。Need to Knowコンポーネント・テストから結果(指定したアクセス権がユーザーにあるかどうか、Need to Knowセキュリティが使用されたかどうか、Need to Knowセキュリティが使用されなかった場合はその理由)が返されます。

リセット

「NTKコンテンツ・セキュリティのテスト」構成の設定を、最後に保存された値に戻します。

B.6 セキュリティ・カスタマイズのサンプル

この項では、セキュリティ・モデルのカスタマイズ例を示します。

- 付録B「コンテンツ・セキュリティのサンプル」

- 付録B「検索結果のサンプル」

- 付録B「ヒット・リスト・ロールのサンプル」

B.6.1 コンテンツ・セキュリティのサンプル

この項では、コンテンツ・セキュリティのカスタマイズ例を示します。

- 付録B「単純なIdocスクリプト関数」

- 付録B「stdSecurityCheckの使用」

- 付録B「isStrIntersectの使用」

- 付録B「allStrIntersectの使用」

- 付録B「includeNTKReadSecurityScriptの使用」

B.6.1.1 単純なIdocスクリプト関数

このサンプルでは、ユーザーのColorカスタム・フィールドとコンテンツのColorカスタム・フィールドが一致した場合に読取りアクセスが許可されます。

<$if strEquals(uColor, xColor)$><$isNTKReadAccess=1$><$endif$>

B.6.1.2 stdSecurityCheckの使用

このサンプルでは、ユーザーのColorがBlueで、コンテンツへの標準セキュリティがユーザーにある場合に読取りアクセスが許可されます。

<$if stdSecurityCheck() and strEquals(uColor, "Blue")$><$isNTKReadAccess=1$><$endif$>

B.6.1.3 isStrIntersectの使用

このサンプルでは、3が最初の文字列のメンバーであるため、trueが返されます。

<$if isStrIntersect("1,2,3,4", "5,3")$><$isNTKReadAccess=1$><$endif$>

このサンプルでは、5も6も最初の文字列のメンバーでないため、falseが返されます。

<$if isStrIntersect("1,2,3,4", "5,6")$><$isNTKReadAccess=1$><$endif$>

このサンプルでは、2番目の文字列が空で、3番目のパラメータが指定されていないため、falseが返されます。

<$if isStrIntersect("1,2,3,4", "")$><$isNTKReadAccess=1$><$endif$>

このサンプルでは、2番目の文字列が空で、3番目のパラメータがtrueのため、trueが返されます。

<$if isStrIntersect("1,2,3,4", "", 1)$><$isNTKReadAccess=1$><$endif$>

このサンプルでは、2番目の文字列が空で、3番目のパラメータがfalseのため、falseが返されます。3番目のパラメータは文字列("True"や"T"など)でも数値(1、0 など)でもよいことに注意してください。

<$if isStrIntersect("1,2,3,4", "", 0)$><$isNTKReadAccess=1$><$endif$>

B.6.1.4 allStrIntersectの使用

このサンプルでは、5が最初の文字列のメンバーでないため、falseが返されます。

<$if allStrIntersect("1,2,3,4", "5,3")$><$isNTKReadAccess=1$><$endif$>

このサンプルでは、3および4が最初の文字列のメンバーであるため、trueが返されます。

<$if allStrIntersect("1,2,3,4", "3,4")$><$isNTKReadAccess=1$><$endif$>

3番目のパラメータを使用する「isStrIntersectの使用」(4-2ページ)のサンプルは、allStrIntersectでも同様に動作します。

B.6.1.5 includeNTKReadSecurityScriptの使用

読取りスクリプト:

<$if strEquals(dDocType, "Document")$><$isNTKReadAccess=1$><$endif$>

書込みスクリプト:

<$includeNTKReadSecurityScript()$><$if isNTKReadAccess and strEquals(uColor, "Red")$><$isNTKWriteAccess=1$><$endif$>

読取りアクセス権(タイプはDocument)があり、ユーザーのColorがRedの場合、ユーザーはコンテンツ・アイテムへの書込みアクセス権を持ちます。

B.6.2 検索結果のサンプル

この項では、検索結果のカスタマイズ例を示します。

- 付録B「リンクの無効化」

- 付録B「 リンクの変更」

- 付録B「 イメージの変更」

B.6.2.1 リンクの無効化

このサンプルでは、コンテンツ・アイテムの読取りアクセス権がユーザーにない場合、URLとコンテンツ情報のリンクが無効になります。これは、検索結果に追加のコンテンツ・アイテムを表示する問合せロールを設定するが、追加アイテムへのリンクをユーザーに表示しない場合などに使用できます。

<$if not securityCheck()$><$docInfo:enabled=0$><$url:enabled=0$><$endif$>

B.6.2.2 リンクの変更

このサンプルでは、コンテンツのColorがRedの場合、コンテンツ情報とURLのリンクを別のサービスに変更します。

<$if strEquals(xColor, "Red")$><$docInfo:link=HttpCgiPath & "?IdcService=GET_USER_INFO"$><$url:link="javascript:alert('Cannot view content.')"$><$endif$>

B.6.2.3 イメージの変更

このサンプルでは、コンテンツ・アイテムのColorがGreenの場合、コンテンツ情報のリンクを変更します。

<$if strEquals(xColor, "Green")$><$docInfo:image_small=HttpImagesRoot & "oracle/tree_icons/historical.gif"$><$endif$>

B.6.3 ヒット・リスト・ロールのサンプル

この項では、ヒット・リスト・ロールのカスタマイズ例を示します。

- 付録B「問合せヒット・リスト・ロールの使用」

- 付録B「ブラック・ホール・チェック・インの作成」

B.6.3.1 問合せヒット・リスト・ロールの使用

問合せロールをqueryRoleに設定し、queryRoleにセキュリティ・グループNTKGroupへの書込みアクセス権がある場合、NTKGroupはセキュリティ・グループ・オプション・リストに表示されます。検索結果構成値をカスタマイズすることで、コンテンツ情報の表示を制限できます。

B.6.3.2 ブラック・ホール・チェックインの作成

更新ロールを使用して、ユーザーがコンテンツ・アイテムをチェックインし、そのアイテムの表示も編集もできないシナリオを作成できます。次の処理を行う必要があります。

1. セキュリティ・グループNTKGroupへの読取り/書込みアクセス権を持つupdateRoleという名前のロールを作成します。

2. メタ変更が発生し、セキュリティ・グループがNTKGroupの場合、アクセスを許可するように書込みコンテンツ・セキュリティ・スクリプトを更新します。

<$if isMetaChange and strEquals(dSecurityGroup, "NTKGroup")$><$isNTKWriteAccess=1$><$endif$>

C Oracle WebCenter Content用Kofax Capture Export Connectorの管理

この章では、Kofax CaptureおよびKofax Capture Export Connectorコンポーネントをインストールする方法と、それらのバッチ・クラスをOracle WebCenter Content Serverのチェックイン・パラメータと併用するよう構成する方法について説明します。

ここで説明する項目は、次のとおりです。

- はじめに

- インストール

- Kofax Capture Export Connector - Oracle WebCenter Contentの使用

- ユーザー・インタフェース

- Adobe Acrobat Captureの使用

C.1 概要

この項では、WebCenter Content用Kofax Capture Export Connector情報の概要について説明します。

- 付録C「製品の概要」

- 付録C「ソフトウェア要件」

C.1.1 製品の概要

この情報は、Kofax Captureコンポーネントをインストールし、Kofax索引フィールド、WebCenter Contentチェックイン・パラメータ、出力ファイル設定を構成する必要のあるシステム管理者を対象としています。Adobe Acrobat Captureの使用手順およびグローバル・オプションの設定手順も提供されます。このドキュメントでは、製品が正しくインストールされており、Oracle製品についての基本とWebCenter Contentの全体的な構造を理解していることを前提としています。

C.1.2 ソフトウェア要件

この情報は、製品テクノロジの進化、およびハードウェア、オペレーティング・システム、サード・パーティ・ソフトウェア・プログラムの作成、更新または変更によって、変更されることがあります。

この項の内容は次のとおりです。

- 第C.1.2.1項「Oracle WebCenter Contentとの互換性」

- 第C.1.2.2項「Kofax Captureとの互換性」

- 第C.1.2.3項「Adobe Acrobat Captureとの互換性」

C.1.2.1 Oracle WebCenter Contentとの互換性

Kofax Capture 11gR1コンポーネントには、WebCenter Content 11gR1との互換性があります。

C.1.2.2 Kofax Captureとの互換性

Kofax Capture Export Connector 11gR1コンポーネントは、Kofax Ascent Capture 8および9と互換性があります。それより前のバージョンのKofax Ascent Captureはサポートされません。

C.1.2.3 Adobe Acrobat Captureとの互換性

Kofax Capture Export Connector 11gR1コンポーネントは、Adobe Acrobat Capture 3.0と互換性があります。

C.2 インストール

この項の内容は次のとおりです。

- 第C.2.1項「インストールのサマリー」

- 第C.2.2項「インストール前のタスクおよび考慮事項」

- 第C.2.3項「Kofax Capture Export Connectorのインストール」

- 第C.2.4項「Kofax Captureの構成」

C.2.1 インストールのサマリー

基本的なインストール手順は、次のタスクで構成されます。

- Oracle WebCenter Content Serverのインストール。インストールの詳細は、WebCenter Contentのインストール・ドキュメントを参照してください。

- Kofax Captureのスタンドアロンまたはサーバー・バージョンとしてのインストール。(サーバー・バージョンでは、少なくとも1つのクライアント・システムが必要です。)インストールの詳細は、Kofax Captureのドキュメントを参照してください。

- Kofax Captureスタンドアロンまたはサーバー・システムへのKofax Capture Export Connectorコンポーネントのインストール。詳細は、第C.2.3項を参照してください。

- (オプション)Adobe Acrobat Captureのインストールおよび構成。インストールおよび構成の詳細は、Adobe Acrobat Captureのドキュメントを参照してください。

- Kofax Capture(およびオプションでAcrobat Capture)で使用するためのKofax Capture Export Connectorの構成。構成とユーザー情報は、第C.3項を参照してください。

C.2.2 インストール前のタスクおよび考慮事項

続行する前に、次のチェックリストを実行します。

- 次のシナリオを考慮して、スキャンされたすべてのドキュメントをOracle WebCenter Content Serverにチェックインするために使用するユーザーとパスワードを指定します。

- ユーザーに最大のアクセス権があること。
スキャンされたドキュメントをコンテンツ・サーバーの全領域にチェックインする場合は、ユーザーがシステム管理者であり、すべてのセキュリティ・グループに対する管理アクセス権を持っていることを確認してください。

- ユーザーに最小限のアクセス権があること。
スキャンされたドキュメントをコンテンツ・サーバーの一部の領域にのみチェックインする場合は、ユーザーが必要なセキュリティ・グループに対する書込みアクセス権を持っていることを確認してください。

- ユーザーが「作成者」コンテンツ情報フィールドを調整する必要がある場合。
ドキュメントの作成者を反映するために、スキャンを実行するユーザーが「作成者」コンテンツ情報フィールドを調整するようにするには、そのユーザーが必要なセキュリティ・グループに対する管理アクセス権を持っていることを確認してください。

- ユーザー名とパスワードを記録します。これらの名前は、新規インストール手順の実行中に入力します。詳細は、第C.2.3.1項を参照してください。

- コンテンツ・サーバー・インスタンスのサーバー・ホスト名(またはIPアドレス)を特定します。サーバー名はコンテンツ・サーバー・インスタンスの「構成情報」ページで確認できます。この名前は、新規インストール手順の実行中に入力します。詳細は、第C.2.3.2項を参照してください。

- コンテンツ・サーバーのプロキシ・インスタンスで使用するためにKofax Capture Export Connectorをインストールする場合は、プロキシ・インスタンスの「構成情報」ページで相対Webルートを確認します。たとえば、cs(スラッシュなし)です。この名前は、必要に応じて、新規インストール手順の実行中に入力します。詳細は、第C.2.3.2項を参照してください。

C.2.3 Kofax Capture Export Connectorのインストール

この項では、Kofax Capture Export Connectorのインストール方法について段階的に説明します。新規と更新のインストール手順は同じではありません。現在の構成に応じたインストール手順に従ってください。この項の内容は次のとおりです。

- 第C.2.3.1項「更新インストールの手順」

- 第C.2.3.2項「新規インストールの手順」

C.2.3.1 更新インストールの手順

以前のバージョンのKofax Capture Export Connector(または、古いバージョンの場合はAscent Capture)からアップグレードする場合は、新しいバージョンをインストールする前に、次のタスクを実行する必要があります。

- 第C.2.3.1.1項「既存のリリース・スクリプトの削除」

- 第C.2.3.1.2項「既存のバッチ・クラスの削除」

- 第C.2.3.1.3項「Kofax Capture Export Connectorの削除」

C.2.3.1.1 既存のリリース・スクリプトの削除

ドキュメント・クラスの割当てを解除して、以前のリリース・スクリプトを削除する手順は次のとおりです。

1. Windowsタスクバーで「スタート」ボタンをクリックし、「プログラム」、「Kofax Captureバージョン」(または、Kofaxの古いバージョンの場合は「Ascent Captureバージョン」)、「Administration」と選択します。

2. 「Kofax Capture Administration」ダイアログの「Batch」タブで、古いバッチ・クラスを展開し、ドキュメント・クラスを右クリックして、「Release Scripts」を選択します。

3. 「Release Scripts」ダイアログの「Assigned Release Scripts」列で、古いリリース・スクリプト名を選択し、「Remove」をクリックします。

4. 確認のダイアログ・ボックスで「Yes」をクリックします。これにより、ドキュメント・クラスと古いリリース・スクリプトとの関連付けが解除されます。

5. 「Close」をクリックします。

6. ドキュメント・クラスごとにステップ2から5を実行します。

7. 「Tools」を選択し、「Release Script Manager」を選択します。

8. 「Release Script Manager」ダイアログで、古いリリース・スクリプトを選択し、「Remove」をクリックします。

9. 「Close」をクリックします。

C.2.3.1.2 既存のバッチ・クラスの削除

既存のバッチ・クラスを削除する手順は次のとおりです。

注意:
続行する前に、バッチ・クラス内のドキュメント・クラスに対して行われたカスタマイズを確認し、既存のバッチ・クラスを削除する前にバックアップしておくことをお薦めします。

1. 「Kofax Capture Administration」ダイアログの「Batch」タブで、既存のバッチ・クラスを右クリックして、「Delete」を選択します。

2. 確認のダイアログ・ボックスで「Yes」をクリックし、バッチ・クラスを削除します。

3. Kofax Captureを終了します。

C.2.3.1.3 Kofax Capture Export Connectorの削除

Kofax Capture Export Connectorを削除する手順は次のとおりです。

1. Windowsタスクバーで、「スタート」をクリックし、「設定」、「コントロール パネル」、「プログラムの追加と削除」と選択します。

2. 「Kofax Capture Export Connector」を選択します。

3. 「変更と削除」をクリックします。アプリケーションを完全に削除するかどうかを確認されます。

4. 「OK」をクリックします。Kofax Capture Export Connectorファイルが削除され、「Maintenance Complete」ダイアログが開きます。

5. 「Finish」をクリックして、Windowsの「プログラムの追加と削除」ダイアログを閉じます。

第C.2.3.2項に、進んでください。

C.2.3.2 新規インストールの手順

Kofax Capture Export Connectorをインストールする手順は次のとおりです。

1. その他すべてのWindowsプログラムを終了します。

2. Windowsエクスプローラから、Kofax Capture Export Connector実行可能ファイルにナビゲートし、setup.exeを実行します。

3. 「Welcome」ダイアログで「Next」をクリックします。

4. ライセンス契約を確認し、「Yes」をクリックします。

5. 「Set Kofax Capture Export Connector - Oracle WebCenter Content」ダイアログで、第C.2.2項で使用したユーザー名とパスワードを入力し、「Next」をクリックします。

6. 「Scanned Files Directory」ダイアログで、デフォルトの設定を受け入れ、「Next」をクリックします。これは、スキャンされたファイルが一時的に保管されるディレクトリです。

7. 「Enter Text」ダイアログで、第C.2.2項で使用したサーバー・ホスト名を入力し、「Next」をクリックします。

8. 「Setup Type」ダイアログで、コンテンツ・サーバーのバージョンを選択して「Next」をクリックします。

9. 「Setup Type」ダイアログで、コンテンツ・サーバーのタイプ(マスターまたはプロキシ)を選択して「Next」をクリックします。

- マスター・インスタンスを選択すると、「Enter Text」ダイアログが開きます。ステップ10をスキップして、ステップ11に進みます。

- プロキシ・インスタンスを選択した場合は、ステップ10に進みます。

10. プロキシ・サーバーの場合は、プロキシ・インスタンスのリストから選択し、「Next」をクリックします。

注意:
プロキシ・インスタンスのリストが表示されない場合は、第C.2.2項のプロキシ・サーバーの相対Webルートを入力し、「Next」をクリックします。

11. 「Enter Text」ダイアログで、Webルートを入力し、「Next」をクリックします。

12. 「Enter Text」ダイアログで、URLへの変更(ある場合)を入力し、「Next」をクリックします。「InstallShield Wizard Complete」ダイアログが開きます。
変更を指定する必要があることはほとんどありません。(たとえば、異なるCGI名やWebフィルタを使用している場合に必要です。)変更を行う必要があるかどうかが不明な場合は、Webサイトのプロパティを調べて、Webサーバーでこの情報を確認してください。

13. 「終了」をクリックします。

C.2.4 Kofax Captureの構成

Kofax Capture Export Connectorとともに使用するようKofax Captureを構成する手順は次のとおりです。

- Kofax Capture Export ConnectorがKofax Captureクライアント・システムにインストールされている場合は、クライアント・システムからサーバー・システムにファイルをコピーします。

- Kofax Capture Export Connectorを使用するようにKofax Captureクライアント・システムを構成します。

- Kofax Capture Export Connectorがデフォルト・ディレクトリにインストールされていない場合は、Kofax Captureでイメージ・フォルダ・パスを構成します。

この項の内容は次のとおりです。

- 第C.2.4.1項「Kofax Captureクライアント・システムの構成」

- 第C.2.4.2項「Kofax Capture Export Connectorを使用するためのKofax Captureクライアントの構成」

- 第C.2.4.3項「非デフォルト・ディレクトリでのKofax Capture Export Connectorの構成」

C.2.4.1 Kofax Captureクライアント・システムの構成

Kofax Captureクライアント・システムにKofax Capture Export Connectorをインストールする場合は、最初のKofax Captureクライアント・システムからKofax Captureサーバー・システムに特定のレガシー・ファイルをコピーする必要があります。

注意:
追加のクライアント・システムに対してこれらのタスクを実行する必要はありません。ただし、管理モジュールを実行するその他すべてのクライアント・システムに、Kofax Captureがインストールされている必要があります。

クライアントKofax Capture Export Connectorインスタンスを構成するには、次の手順を実行します。

1. クライアント・システムから、Kofaxインストール・ディレクトリ\Bin\にあるStellentRelディレクトリをコピーします。

2. このディレクトリをサーバー・システムの\Ascentディレクトリに貼り付けます。たとえば、\\servername\共有ディレクトリ名\Ascent\Bin\です。

C.2.4.2 Kofax Capture Export Connectorを使用するためのKofax Captureクライアントの構成

Kofax Capture Export Connectorを使用するようにKofax Captureを構成するには、次のタスクを実行します。

- 第C.2.4.2.1項「リリース・スクリプトのインストール」

- 第C.2.4.2.2項「バッチ・クラスのインポート」

- 第C.2.4.2.3項「バッチ・クラスへのリリース・スクリプトの割当て」

- 第C.2.4.2.4項「バッチ・クラスの公開」

C.2.4.2.1 リリース・スクリプトのインストール

1. Windowsタスクバーで、「スタート」をクリックし、「プログラム」、「Kofax Capture」(または、古いシステムの場合は「Ascent Captureバージョン」)、「Administration」と選択します。

2. 「Administration」ダイアログで、「Tools」→「Release Script Manager」を選択します。

3. 「Release Script Manager」ダイアログで、「Add」をクリックします。

4. 「Open」ダイアログで、StellentRelディレクトリから、StellentRel.infを選択して、「Open」をクリックします。

5. 「Add Release Scripts」ダイアログで、「Kofax Capture Export Connector」を選択して、「Install」をクリックします。

6. 登録が完了したことを示すダイアログで「OK」をクリックします。

7. 「Close」をクリックして、「Add Release Scripts」ダイアログを閉じます。

8. 「Close」をクリックして、「Release Script Manager」ダイアログを閉じます。

C.2.4.2.2 バッチ・クラスのインポート

リリース・スクリプトをインストールしたら、「Kofax Capture Administration」ダイアログから次の手順を実行します。

1. 「File」を選択し、「Import」を選択します。

2. 「Open」ダイアログで、OracleWebCenterBatch.cabを選択して、「Open」をクリックします。パッケージが展開されます。

3. 「OK」をクリックします。「Import」ダイアログが開き、ScansOracleWebCenterおよびScansOracleWebCenterParamが使用可能なバッチ・クラスとしてリストされます。

4. 「Add All」をクリックします。

5. 「Transfer Mode」ボックスで、「Replace duplicates with items imported」を選択し、「Import」をクリックします。ファイルがインポートされます。

6. 「OK」をクリックして、「Import/Export」ダイアログを閉じます。ScansOracleWebCenterおよびScansOracleWebCenterParamが、「Kofax Capture Administration」ダイアログの「Batch」タブに表示されます。

C.2.4.2.3 バッチ・クラスへのリリース・スクリプトの割当て

バッチをインポートしたら、「Kofax Capture Administration」ダイアログから次の手順を実行します。

1. ScansOracleWebCenterバッチ・クラスを展開して、ScannedDocsOracleWebCenterドキュメント・クラスを右クリックし、「Release Scripts」を選択します。

2. 「Release Script」ダイアログで、「Kofax Capture Export Connector - Oracle WebCenter Content バージョン」を選択します。

3. 「Kofax Capture Export Connector - Oracle WebCenter Content Release Setup」ダイアログで、「Add >>」をクリックします。

4. スクリプトを選択して、「OK」をクリックします。

5. 「Close」をクリックして、「Release Scripts」ダイアログを閉じます。

6. ScansOracleWebCenterParamバッチ・クラスを展開して、ScannedDocsOracleWebCenterParamドキュメント・クラスを右クリックし、「Release Scripts」を選択します。

7. 「Release Scripts」ダイアログで、「Kofax Capture Export Connector - Oracle WebCenter Contentバージョン」を選択します。

8. 「Kofax Capture Export Connector - Oracle WebCenter Content Release Setup」ダイアログで、「Add >>」をクリックします。

9. スクリプトを選択して、「OK」をクリックします。

10. 「Close」をクリックして、「Release Scripts」ダイアログを閉じます。

C.2.4.2.4 バッチ・クラスの公開

リリース・スクリプトをバッチに追加したら、「Kofax Capture Administration」ダイアログから次の手順を実行します。

1. 「File」を選択し、「Publish」を選択します。

2. 「Select All」をクリックします。

3. 「Publish」をクリックします。検証および公開が警告およびエラーなしで行われます。

4. 「Close」をクリックします。バッチ・クラスScansOracleWebCenterおよびScansOracleWebCenterParamのアイコンが、「Kofax Capture Administration」ダイアログの「Batch」タブに、チェック・マーク付きで表示されます。

C.2.4.3 非デフォルト・ディレクトリでのKofax Capture Export Connectorの構成

Kofax Capture Export Connectorをデフォルト・ディレクトリにインストールしていない場合にのみ、次の手順を実行します。

1. Windowsタスクバーで、「スタート」ボタンをクリックし、「プログラム」、「Kofax Captureバージョン」、「Administration」とクリックします。

2. 「Kofax Capture Administration」ダイアログの「Batch」タブで、「ScansOracleWebCenter」を選択して、「Properties」を右クリックします。

3. Ascent\Imagesディレクトリを指すように、イメージ・フォルダのパスを調整します。

4. 「Batch」タブで、ScansOracleWebCenterParamを選択し、「Properties」を右クリックします。

5. Ascent\Imagesディレクトリを指すように、イメージ・フォルダのパスを調整します。

6. 第C.2.4.2.4項に記載されている手順のステップを実行します。

C.3 Kofax Capture Export Connector - Oracle WebCenter Contentの使用

この項では、Kofax Capture Export Connector - Oracle WebCenter ContentによるKofax Captureの使用に関する次のトピックについて説明します。

- 第C.3.1項「Kofax Captureバッチ・クラスの処理」

- 第C.3.2項「リリース・スクリプトのカスタマイズ」

- 第C.3.3項「CHECKINパラメータへのKofax索引フィールドのマッピング」

- 第C.3.4項「Kofax Captureのインストールの検証」

C.3.1 Kofax Captureバッチ・クラスの処理

インストールおよび構成タスクを完了すると、Kofax Captureワークステーションには、ScannedDocsOracleWebCenterおよびScannedDocsOracleWebCenterParamの2つのバッチ・クラスが公開されます。

どちらのバッチ・クラスも、標準の必須コンテンツ・サーバー・チェックイン・パラメータをサポートするようにセットアップされています。さらに、バッチ・クラスScansOracleWebCenterParamは、オプションのコンテンツ・サーバー・パラメータ(「リリース日」、「有効期限」など)用にバッチ・クラスを構成する方法を示します。

すべてのKofax Captureバッチ・クラスと同様に、これらのコンテンツ・サーバー・バッチ・クラスは、フィールド・タイプ、索引フィールド、フォーム・タイプおよびドキュメント・クラスを使用して構築されます。これは、次の項で説明します。

注意:
バッチ・クラスの詳細は、Kofax Captureのオンライン・ヘルプを参照してください。

この項の内容は次のとおりです。

- 第C.3.1.1項「フォルダ」

- 第C.3.1.2項「フィールド・タイプ」

- 第C.3.1.3項「フィールド・タイプの設定」

- 第C.3.1.4項「ドキュメント・クラス」

- 第C.3.1.5項「ドキュメント・クラス索引フィールドの設定」

- 第C.3.1.6項「マップ済索引フィールド」

- 第C.3.1.7項「フォーム・タイプ」

C.3.1.1 フォルダ

フォルダ・クラスにより、バッチ・クラスにフォルダのプロパティが定義されます。バッチとは、ユーザーが定義する階層に構造化されたページ、ドキュメントおよびフォルダの集まりのことです。バッチ・クラスの他の要素と同様に、フォルダ・クラスは作成、編集および削除できます。

Kofax Capture内でドキュメントを整理するだけでなく、フォルダを使用することの真の利点は、Kofax Captureからのドキュメントのリリース後に得られます。Kofax Capture内でのフォルダ階層が、ご使用のドキュメント管理ソフトウェアで使用される階層に(できるかぎり正確に)一致するようにすると、これらのドキュメントをより簡単にサード・パーティ・ソフトウェアにインポートできるようになります。

フォルダが作成されると、Kofax Captureワークフローで処理されたドキュメントが収められます。フォルダは(バッチ編集により)手動で作成するか、定義したルールに基づいて自動的に作成されるようにできます。同様に、ドキュメントをフォルダに手動でまたは自動的に置くことができます。

ページはドキュメントに追加でき、ドキュメントはフォルダに追加できます。フォルダは、最大32,000レベルまで他のフォルダに追加できます(ネスト)。ただし、個別のページをフォルダに追加することはできません(バッチのルート・レベルに個別のページが存在することはありますが、これらをフォルダに追加するには、まずドキュメントにまとめる必要があります)。

C.3.1.2 フィールド・タイプ

Kofax Captureリリース・スクリプトをインストールして構成すると、特定のKofax Captureフィールド・タイプが設定されます。これらのフィールド・タイプは、サンプル・ドキュメント・クラスScannedDocsOracleWebCenterおよびScannedDocsOracleWebCenterParamで索引フィールドを定義するために使用されます。新規索引フィールドを定義するときに、これらのフィールド・タイプを使用するか、必要に応じて追加のフィールド・タイプを作成できます。詳細は、第C.3.1.3項を参照してください。

C.3.1.3 フィールド・タイプの設定

フィールド・タイプを設定するには、次の手順を実行します。

1. Kofax Captureから、「Administration」ダイアログを開き、「Field Type」ツリー・ビュー・タブを選択します。

2. タブ内の任意の場所を右クリックし、「New Field Type」を選択します。

3. 「Create Field Type」ダイアログで、表示されたフィールドに値を入力します。

- 「General」タブの、「Name」と「Data type」は必須です。「Description」と「Dictionary」はオプションです。「Data type」には、Kofax Captureでは11 ODBC準拠タイプがサポートされます。

- 「Values」タブでは、フィールド・タイプの既知の値を入力し、強制一致と大/小文字の区別の設定を指定できます。

4. 完了したら、「Save」をクリックします。

注意:
フィールド・タイプの詳細は、Kofax Captureのオンライン・ヘルプを参照してください。

C.3.1.4 ドキュメント・クラス

第C.2.3項および第C.2.4項の説明に従ってKofax Captureリリース・スクリプトをインストールして構成すると、次のKofax Captureサンプル・ドキュメント・クラスが設定されます。

- ScansOracleWebCenter

- ScansOracleWebCenterParam

Kofax Captureで使用される各ドキュメント・クラスには、次のものが含まれます。

- 索引フィールド

- 索引フィールドの属性

- 1つ以上のフォーム・タイプ

注意:
ドキュメント・クラスに定義される索引フィールドは、コンテンツ・サーバー・チェックイン・パラメータにマップされます。詳細は、第C.3.3項を参照してください。

C.3.1.5 ドキュメント・クラス索引フィールドの設定

ドキュメント・クラスの索引フィールドを設定する手順は次のとおりです。

1. Kofax Captureから、「Administration」ダイアログを開き、「Document tree view」タブを選択します。

2. ドキュメント・クラスを右クリックして、「Properties」を選択します。「Document Class Properties」ダイアログが開きます。ScannedDocsおよびScannedDocsParamのダイアログの例は、第C.3.1.6.1項および第C.3.1.6.2項を参照してください。

3. 「New」をクリックし、次の情報を入力します。

- Name: わかりやすい名前。

- Field Type: ドロップダウン・リストから適切なフィールド・タイプを選択します。

- Default: 必要に応じて、索引フィールドに移入するデフォルト値を入力します。
技術的ヒント: 対応するコンテンツ・サーバーのメタデータ・フィールドが必須の場合は、デフォルト値を入力することをお薦めします。必須のメタデータ・フィールドに値が含まれていない場合、チェックインは失敗します。

- Required: 検証時にフィールドに値が含まれている必要がある場合は、「True」を選択します。
技術的ヒント: 対応するコンテンツ・サーバーのメタデータ・フィールドが必須の場合は、このフィールドを「True」に設定してください。

- Verify: 「False」に設定します。

- Hidden: 「False」に設定します。

- Sticky: 「False」に設定します。

- Total: 「False」に設定します。

4. 索引フィールドの追加が完了したら、「Apply」をクリックして続行するか、「OK」をクリックして終了します。

C.3.1.6 マップ済索引フィールド

この項の内容は次のとおりです。

- 第C.3.1.6.1項「ScannedDocs」

- 第C.3.1.6.2項「ScannedDocsParam」

C.3.1.6.1 ScannedDocs

このドキュメント・クラスには、コンテンツ・サーバーの標準の必須CHECKINパラメータにマップされるコア索引フィールドが含まれます。

図C-1 ScannedDocsドキュメント・クラスのマップ済索引フィールド

C.3.1.6.2 ScannedDocsParam

このドキュメント・クラスには、コンテンツ・サーバーの標準の必須チェックイン・パラメータにマップされるコア索引フィールドに加え、パラメータ・エディタのチェックインを使用してコンテンツ・サーバーのオプションのチェックイン・パラメータにマップできるサンプル索引フィールドが含まれます(第C.3.2.17項を参照)。

図C-2 ScannedDocsParamドキュメント・クラスのマップ済索引フィールド

各コンテンツ・サーバー・ドキュメント・クラスは、次の表に示す索引フィールドにより構成されます。両方のドキュメント・クラスに定義される索引フィールド(「Content ID」、「Type」、「Title」、「Author」および「Security Group」)が、コンテンツ・サーバーにドキュメントを正しくチェックインするために必要なコンテンツ・サーバー・パラメータにマップされます。

ScannedDocsParamに定義される追加の索引フィールドは、例示のみを目的として、ドキュメント・クラス内で提供されます。これらは仮定上、CHECKINパラメータ・エディタを使用してコンテンツ・サーバー・パラメータにマップできる索引フィールドの例です。

ScannedDocs索引フィールド

ScannedDocsParam索引フィールド

コンテンツID

コンテンツID

タイプ

タイプ

タイトル

タイトル

作成者

作成者

セキュリティ・グループ

セキュリティ・グループ

該当なし

リリース日

該当なし

リリース時間

該当なし

終了

該当なし

LIDebug

該当なし

作成日

該当なし

作成時間

該当なし

リビジョン・ラベル

該当なし

有効期限

該当なし

有効期限

該当なし

セキュリティ・チェックの実行

C.3.1.7 フォーム・タイプ

説明に従ってKofax Captureリリース・スクリプトをインストールして構成すると、次の図に示すフォーム・タイプを持つ2つのサンプル・ドキュメント・クラスが設定されます。

ドキュメント・クラスには1つ以上のフォーム・タイプを定義する必要があるため、フォーム・タイプ(SimpleFormおよびSimpleFormParameters)がコンテンツ・サーバー・ドキュメント・クラスに提供されます。フォーム・タイプにより一意のフォームが定義されるため、特定のアプリケーションでの必要に応じて独自のフォーム・タイプを設定してください。

注意:
フォーム・タイプの詳細は、Kofax Captureのオンライン・ヘルプを参照してください。

C.3.2 リリース・スクリプトのカスタマイズ

この項の内容は次のとおりです。

- 第C.3.2.1項「設定ダイアログへのアクセス」

- 第C.3.2.2項「「索引ストレージ」タブの使用」

- 第C.3.2.3項「索引値の設定」

- 第C.3.2.4項「「ドキュメント・ストレージ」タブの使用」

- 第C.3.2.5項「「イメージ形式」タブの使用」

- 第C.3.2.6項「PDF設定の指定」

- 第C.3.2.7項「リリース済イメージのファイル・タイプの設定」

- 第C.3.2.8項「複数ページのTIFF出力ファイル・タイプの選択」

- 第C.3.2.9項「TIFF、JPGまたはPCX出力ファイル・タイプの選択」

- 第C.3.2.10項「Adobe Acrobat Capture PDF出力ファイル・タイプの選択」

- 第C.3.2.11項「Adobe Acrobat Capture PDF設定の指定」

- 第C.3.2.12項「「サーバー」タブの使用」

- 第C.3.2.13項「URL、ユーザー名およびパスワードの設定」

- 第C.3.2.14項「プライマリ/代替ファイル形式の設定」

- 第C.3.2.15項「ワークフロー・ステータスの設定」

- 第C.3.2.16項「エラーが発生したAdobe Acrobat Capture PDFファイルに対するオプションの設定」

- 第C.3.2.17項「パラメータ・エディタのチェックインへのアクセス」

C.3.2.1 設定ダイアログへのアクセス

Kofax Captureリリース・スクリプトの設定ダイアログにアクセスする手順は次のとおりです。

1. Kofax Captureから、「Administration」ダイアログを開き、「Document tree view」タブを選択します。

2. コンテンツ・サーバーのバッチ・クラスを展開し、そのドキュメント・クラスを右クリックして、「Release Scripts」を選択します。

3. リリース・スクリプト・ダイアログの「Assigned Release Scripts」のリストで、「Kofax Capture Export Connector - Oracle WebCenter Contentバージョン」を選択し、「Setup」をクリックします。
リリース設定ダイアログが開き、次のタブが表示されます。

- 「索引ストレージ」タブ
索引値の設定に使用されます(第C.4.2項を参照)。

- 「ドキュメント・ストレージ」タブ
リリース・ディレクトリおよびAcrobat Captureの設定に使用されます(第C.4.3項を参照)。

- 「イメージ形式」タブ
イメージをファイル・タイプとしてリリースするための設定に使用されます(第C.4.4項を参照)。

- 「サーバー」タブ
コンテンツ・サーバーの設定に使用されます(第C.4.6項を参照)。

C.3.2.2 「索引ストレージ」タブの使用

「索引ストレージ」タブを使用して、バッチ・クラスの索引値を設定します。Kofax Captureリリース・スクリプトにより、最初のコンテンツ・サーバーのインストールに含まれる必須の情報フィールド・アイテムに対する割当てが確立されます。索引フィールドに割り当てられる値は、Kofax Captureバッチ処理中に検証モジュールから提供されます。

注意:
カスタマイズされたリリース・スクリプトで、索引フィールドを索引値として割り当てられるようにするには、まずドキュメント・クラスに索引フィールドを追加する必要があります。第C.3.1.5項を参照してください。デフォルトでは、選択されたドキュメント・クラスに現在定義されているすべての索引フィールドが索引値のリストに含められます。

注意:
このタブの詳細は、第C.4.2項を参照してください。

C.3.2.3 索引値の設定

索引値を設定するには、次の手順を実行します。

1. 必要な索引フィールドをドキュメント・クラス・プロパティに追加します。第C.3.1.5項または第C.3.1.6項を参照してください。

2. リリース設定ダイアログの「索引ストレージ」タブに移動し、「追加」をクリックします。既存の索引値のリストの末尾に空の索引値が追加されます。

3. 空の索引値の右側にあるコンテキスト・メニュー・ボタンをクリックします。

4. 「索引フィールド」メニュー・オプションから、索引フィールドを選択します。

5. 「適用」をクリックして続行するか、「OK」をクリックしてダイアログを終了します。

注意:
索引値を選択する際には、Kofax Capture値およびテキスト定数は選択しないでください。

注意:
コンテンツ・サーバーのオプションのチェックイン・パラメータに索引値をマップするには、CHECKINパラメータ・エディタを使用してマッピングを作成する必要があります。ただし、次の標準チェックイン・パラメータは自動的に割り当てられるため、マップする必要はありません。

- コンテンツID

- タイプ

- タイトル

- 作成者

- セキュリティ・グループ

- Account(コンテンツ・サーバーで有効になっている場合)

C.3.2.4 「ドキュメント・ストレージ」タブの使用

「ドキュメント・ストレージ」タブを使用して、リリースされたファイルのディレクトリ・パスを表示または変更したり、Kofax CaptureによるAcrobat Capture PDF変換プロセスの監視方法を設定します。

このタブの詳細は、第C.4.3項を参照してください。

C.3.2.5 「イメージ形式」タブの使用

「イメージ形式」タブを使用して、リリースされたイメージの形式(ファイル・タイプ)を設定します。

このタブの詳細は、第C.4.4項を参照してください。

C.3.2.6 PDF設定の指定

「設定」ボタンを使用して、PDF設定を指定するための「Adobe Acrobat Captureの設定」ダイアログ・ボックスを開きます。

このタブの詳細は、第C.4.5項を参照してください。

C.3.2.7 リリース済イメージのファイル・タイプの設定

Kofax Captureでは、様々な出力ファイル形式によるスキャン済イメージのリリースをサポートしています。Kofax Captureを使用する場合、次のイメージ・ファイルがサポートされます。

- JPG - JPG圧縮

- 複数ページのTIFF - CCITTグループ3

- 複数ページのTIFF - CCITTグループ3/2D

- 複数ページのTIFF - CCITTグループ4

- 複数ページのTIFF - JPEG圧縮

- 複数ページのTIFF -未圧縮

- PCX - PackBytes

- Adobe Acrobat Capture PDF (JPEGから)

- Adobe Acrobat Capture PDF(複数ページのTIFFから)

- Adobe Acrobat Capture PDF (PCXから)

- Adobe Acrobat Capture PDF(単一ページのTIFFから)

- TIFF - CCITTグループ3

- TIFF - CCITTグループ3/2D

- TIFF - CCITTグループ4

- TIFF - JPEG圧縮

- TIFF -未圧縮

C.3.2.8 複数ページのTIFF出力ファイル・タイプの選択

バッチに複数のTIFFイメージが含まれており、それらのイメージすべてをバンドルし、1つのコンテンツ・アイテムとしてコンテンツ・サーバーにチェックインする場合は、複数ページのTIFF出力ファイル・タイプを選択します。

1. リリース設定ダイアログの「イメージ形式」タブに移動します。

2. 「イメージ・ファイル・タイプとしてイメージをリリース」リストで、複数ページのTIFF出力ファイル・タイプをクリックします。

C.3.2.9 TIFF、JPGまたはPCX出力ファイル・タイプの選択

TIFF、JPGまたはPCX出力ファイル・タイプのいずれかの形式で、プライマリ(ネイティブ)および代替(Web表示可能)ファイルの両方としてコンテンツ・サーバーにファイルをチェックインする場合は、これらの出力ファイル・タイプを選択します。

TIFF、JPGまたはPCXを選択すると、各バッチの最初のグラフィックがコンテンツ・サーバーにチェックインされます。このため、バッチ内に複数のグラフィックが含まれる場合には、複数ページのTIFFを使用してください(第C.3.2.8項を参照)。かわりに、各バッチにグラフィックが1つのみ含まれるようにすることもできます。

1. リリース設定ダイアログの「イメージ形式」タブに移動します。

2. 「イメージ・ファイル・タイプとしてイメージをリリース」ドロップダウン・リストで、「TIFF」、「JPG」または「PCX」出力ファイル・タイプをクリックします。

C.3.2.10 Adobe Acrobat Capture PDF出力ファイル・タイプの選択

PDFファイルを、プライマリ(ネイティブ)または代替(Web表示可能)ファイルとしてコンテンツ・サーバーにチェックインする場合は、出力ファイル・タイプとしてAdobe Acrobat Capture PDFを選択します。

注意:
Adobe Acrobat Capture PDFを出力ファイル・タイプとして選択するには、Adobe Acrobat Captureを使用している必要があります。次の手順に進む前に、第C.5.1項をよく読んで実行してください。

1. リリース設定ダイアログの「イメージ形式」タブに移動します。

2. 「イメージ・ファイル・タイプとしてイメージをリリース」ドロップダウン・リストで、「Adobe Acrobat PDF(複数ページのTIFFから)」をクリックします。「設定」ボタンが使用できるようになります。

C.3.2.11 Adobe Acrobat Capture PDF設定の指定

「Adobe Acrobat Capture PDF (複数ページのTIFFから)」としてイメージをリリースすることを選択したら、「設定」ボタンを使用して、Adobe Acrobat Captureワークグループ・ハブ、監視フォルダ、ワークフローおよびその他の設定を指定します。

1. リリース設定ダイアログの「イメージ形式」タブで、「設定」をクリックします。

注意:
「Adobe Acrobat Capture PDF (複数ページのTIFFから)」設定は、単一ページおよび複数ページのTIFFファイルの両方に使用できます。

2. Adobe Acrobat Captureワークグループ・ハブの場所を次のように選択します。

1. ワークグループ・ハブ・フィールドの隣にある「参照」ボタンをクリックします。

2. Hubディレクトリの場所にナビゲートします。次に例を示します。

mapped drive/Program Files/Adobe/Adobe Acrobat Capture 3.0/Hub

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

ワークグループ・ハブを選択すると、ディクショナリおよび「ワークフロー」ドロップダウン・リストに使用可能なオプションが移入されます。

3. Adobe Acrobat Capture監視フォルダの場所を次のように選択します。

1. 監視フォルダ・フィールドの隣にある「参照」ボタンをクリックします。

2. Watchディレクトリの場所にナビゲートします。次に例を示します。

mapped drive/Program Files/Adobe/Adobe Acrobat Capture 3.0/Watch

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

4. 「ページ・コンテンツ」ドロップダウン・リストから、フォーマット済テキストとグラフィックを選択します。必要に応じて、「言語」、「PDFドキュメント設定」およびディクショナリのオプションを選択します。

5. 「ワークフロー」ドロップダウン・リストから「StellentScans」を選択します。必要に応じて、「サスペクト領域」および「詳細設定」のオプションを選択します。

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

C.3.2.12 「サーバー」タブの使用

リリース設定ダイアログの「サーバー」タブは、コンテンツ・サーバーURL、ユーザー名およびパスワードの設定を指定したり、ワークフローおよびプライマリ/代替ファイルのチェックイン・フォーマットのオプションを選択したり、CHECKINパラメータ・エディタにアクセスするために使用されます。

C.3.2.13 URL、ユーザー名およびパスワードの設定

これらの設定はKofax Captureのインストール中に行われ、必要に応じて、「サーバー」タブに表示されるフィールドを使用して変更できます。

C.3.2.14 プライマリ/代替ファイル形式の設定

Kofax Captureでは、(「ドキュメント・ストレージ」タブでの指定に従って)リリースされたファイルのコンテンツ・サーバーへのチェックイン方法を制御できます。

プライマリ・ファイル用と代替ファイル用の2つのドロップダウン・メニューを使用できます。各メニュー内では、「Image」、「Kofax PDF」、「Adobe Acrobat Capture PDF」または「OCR full text」を選択できます。代替ファイルのメニューには、代替ファイルをチェックインしない場合のために「None」オプションも含まれています。

メニューを使用して、たとえば、プライマリ(ネイティブ)ファイルとして「Image」を選択し、代替(Web表示可能)ファイルとして「Adobe Acrobat Capture PDF」を選択できます。

注意:
コンテンツ・サーバーでは、プライマリ・ファイルおよび代替ファイルの両方に、同じファイル拡張子(.pdfなど)の2つのファイルを指定できません。

注意:
Adobe Acrobat Captureの使用およびAdobe Acrobat Capture PDFのチェックインの詳細は、第C.5項を参照してください。

C.3.2.15 ワークフロー・ステータスの設定

Kofax Captureリリース・スクリプトを使用すると、Kofax Captureからアイテムがリリースされたときに、コンテンツ・サーバーで既存のワークフローを開始できます。

注意:
このダイアログでのワークフロー設定は、Adobe Acrobat Captureのワークフローではなく、コンテンツ・サーバーのワークフローを指します。

注意:
Kofax Captureからリリースされたアイテムがワークフローに入るには、その前にコンテンツ・サーバーにアクティブなワークフローが存在している必要があります。

1. リリース設定ダイアログの「サーバー」タブにナビゲートします。

2. 「ワークフローの許可」チェック・ボックスを使用して、ワークフローのステータスを設定します。

- コンテンツ・アイテムがKofaxからリリースされてコンテンツ・サーバーにチェックインされたときにワークフローが開始するようにするには、チェック・ボックスを選択します。

- コンテンツ・アイテムがKofaxからリリースされてコンテンツ・サーバーにチェックインされたときにワークフローが開始されないようにするには、チェック・ボックスの選択を解除します。

注意:
ユーザーが「検証」ダイアログで既存のコンテンツIDを指定している場合、Kofax Captureリリース・スクリプトによりコンテンツ・アイテム・リビジョンのチェックインが開始されます。

- 「ワークフローの許可」チェック・ボックスが選択されていない場合、リビジョンは無条件でチェックインされます。

- 「ワークフローの許可」チェック・ボックスが選択されている場合、(「検証」ダイアログで)ユーザーにより指定されたコンテンツ・アイテムを、Kofax Captureによりチェックインが開始される前にコンテンツ・サーバーからチェックアウトする必要があります。コンテンツ・アイテムがチェックアウトされていない場合、チェックインはエラー・メッセージを出して失敗します。

C.3.2.16 エラーが発生したAdobe Acrobat Capture PDFファイルに対するオプションの設定

Adobe Acrobat Capture PDFファイルにエラーが含まれている場合、ファイルのコンテンツ・サーバーへのチェックインを停止して、ファイルを確認できます。

「エラーが発生したAdobe Acrobat Capture PDFのチェックイン」オプションを使用して、Adobe Acrobat Captureにより生成され、Adobe Acrobat Captureの完了したドキュメントのログにエラーがあるPDFのチェックインを許可できます。さらに、PDFファイルを保持することを選択して、ファイルをリリース・ディレクトリに残して確認できるようにすることもできます。

PDFエラー・オプションを設定するには、次の手順を実行します。

1. リリース設定ダイアログの「サーバー」タブにナビゲートします。

2. PDFエラーのチェック・オプションを選択します。

- エラーを含むすべてのPDFファイルがコンテンツ・サーバーにチェックインされないようにするには、「エラーが発生したAdobe Acrobat Capture PDFのチェックイン」オプションを選択しないままにします。

- エラーが含まれていても、すべてのPDFファイルをコンテンツ・サーバーにチェックインするには、「エラーが発生したAdobe Acrobat Capture PDFのチェックイン」オプションを選択します。

3. エラーを含むファイルを残すか削除するかを決定します。

- エラーを含むPDFファイルをリリース・ディレクトリに残すには、「チェックイン失敗時にプライマリ・ファイルと代替ファイルをリリース・ディレクトリに保存」オプション(デフォルトで選択されています)を選択します。

- エラーを含むPDFファイルをリリース・ディレクトリから削除するには、「チェックイン失敗時にプライマリ・ファイルと代替ファイルをリリース・ディレクトリに保存」オプションの選択を解除します。

第C.5.3項で説明するように、PDFドキュメントのサルベージ・オプションを使用することもできます。

C.3.2.17 パラメータ・エディタのチェックインへのアクセス

Kofax Capture索引フィールドをコンテンツ・サーバーのCHECKINパラメータにマップする場合は、パラメータ・エディタのチェックインを使用します。エディタにアクセスする手順は次のとおりです。

1. リリース設定ダイアログの「サーバー」タブにナビゲートします。

2. 「サービス・パラメータのチェックイン」ボタンをクリックします。「パラメータ・エディタのチェックイン」ダイアログが開きます。

注意:
マッピングの作成方法の詳細は、第C.3.3項を参照してください。

C.3.3 CHECKINパラメータへのKofax索引フィールドのマッピング

Kofax Captureリリース・スクリプトを使用してコンテンツ・サーバーにドキュメントをチェックインする場合は、次の2つのコンテンツ・サーバーIdcCommandサービスのうちの1つが使用されます。

- CHECKIN_ARCHIVEサービスは、リリース設定ダイアログの「サーバー」タブで「ワークフローの許可」チェック・ボックスが選択されている場合に使用されます。第C.3.2.15項を参照してください。

- CHECKIN_UNIVERSALサービスは、リリース設定ダイアログの「サーバー」タブで「ワークフローの許可」チェック・ボックスが選択されていない場合に使用されます。第C.3.2.15項を参照してください。

各CHECKINサービスにより、コンテンツ・アイテムのチェックイン・プロセスを正しく実行するために必要な特定のパラメータが指定されます。その他のパラメータも指定できますが、必須ではありません。

注意:
コンテンツ・サーバーのCHECKINサービスおよびパラメータの詳細は、『Oracle WebCenter Contentサービス・リファレンス』を参照してください。

この項の内容は次のとおりです。

- 第C.3.3.1項「必須パラメータのマッピングの設定」

- 第C.3.3.2項「オプション・パラメータのマッピングの設定」

- 第C.3.3.3項「日付および時刻パラメータの設定」

- 第C.3.3.4項「LIDebugパラメータを使用したデバッグ」

C.3.3.1 必須パラメータのマッピングの設定

Kofax Captureを使用する場合、Kofax Captureには少なくとも、コンテンツ・サーバーでのコンテンツ・アイテムのチェックインに必要なコンテンツ情報(メタデータ)フィールドに対応する索引フィールドが必要です。次のリストに示す索引フィールドが、Kofaxドキュメント・クラスまたはバッチ・クラス内に存在している必要があります。

- Content ID(コンテンツ・サーバーでコンテンツIDの自動生成が有効になっている場合を除く)

- タイプ

- タイトル

- 作成者

- セキュリティ・グループ

- Account(セキュリティ・アカウントが有効になっている場合)

注意:
索引フィールドは、リリース・スクリプトにより必須フィールドとして認識され、コンテンツ・サーバー用に正しくフォーマットされるように、前述のリストに示すとおりの名前にする必要があります。

C.3.3.2 オプション・パラメータのマッピングの設定

注意:
マッピングの設定を行うには、コンテンツ・サーバーのCHECKINサービスおよびパラメータについて正しく理解している必要があります。無効なパラメータを使用すると、リリース/チェックイン中にバッチが失敗します。

「リリース日」、「有効期限」などの他のチェックイン・パラメータを指定する手順は次のとおりです。

1. 必要なパラメータの索引フィールドを設定します。詳細は、第C.3.1.5項を参照してください。

2. Kofax Captureリリース・スクリプトの索引値を設定します。詳細は、第C.3.2.3項を参照してください。

3. CHECKINパラメータ・エディタを開きます。詳細は、第C.3.2.17項を参照してください。

4. 「追加」をクリックします。

5. 「パラメータ詳細」ダイアログの「ユーザー・インタフェース名」リストから、必要な索引フィールドを選択します。

6. 「コンテンツ・サーバーのパラメータ」フィールドに、パラメータの名前を入力します。

注意:
パラメータを入力するときには、スペルと構文に十分注意してください。

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

8. 「パラメータ・エディタのチェックイン」のマッピングのリストで、必要に応じてマッピングを追加、編集、または削除します。完了したら、「保存」をクリックして終了し、変更を保存するか、「取消」をクリックして変更を保存せずに終了します。

9. 「はい」をクリックして、アクションを確認します。

10. 「OK」をクリックして、リリース設定ダイアログを終了します。

11. 「Close」をクリックして、「Release Scripts」ダイアログを閉じます。

12. バッチ・クラスを公開して、ドキュメントをインポートまたはスキャンするために次にバッチ・クラスを使用するときに変更が反映されるようにします。

C.3.3.3 日付および時刻パラメータの設定

コンテンツ・サーバーの日付フィールドには、1つのフィールドに日付および時刻の両方が含まれます。Kofax Captureでは、日付と時刻に個別のフィールドを使用します。

日付および時刻を単一のチェックイン・パラメータに連結する手順は次のとおりです。

1. 日付フィールド用の索引フィールドを設定します(たとえば、「Release Date」)。索引フィールドを定義する際には、必ず「Date」フィールド・タイプを使用してください。

2. 時刻フィールド用の索引フィールドを設定します(たとえば、「Release Time」)。索引フィールドを定義する際には、必ず「Time」フィールド・タイプを使用してください。

3. CHECKINパラメータ・エディタを使用して、日付索引フィールドを該当するコンテンツ・サーバー・チェックイン・パラメータにマップします。たとえば、「Release Date」をdInDateにマップします。

4. CHECKINパラメータ・エディタを使用して、時刻索引フィールドを同じコンテンツ・サーバー・チェックイン・パラメータにマップします。たとえば、「Release Time」をdInDateにマップします。

C.3.3.4 LIDebugパラメータを使用したデバッグ

マッピングLIDebug:LIDebugが作成され、検証ステップで値がTRUEに設定されると、Kofax Captureからコンテンツ・サーバーに渡される.hdaデータがリリース・スクリプトの実行時に表示されます。これにより、ユーザーは、正しいデータとパラメータがコンテンツ・サーバーに渡されていることを確認できます。

C.3.4 Kofax Captureのインストールの検証

次のタスクを実行して、Kofax Captureが正しくインストールされ、構成されていることを確認します。

- 第C.3.4.1項「バッチの作成」

- 第C.3.4.2項「バッチの処理: スキャン・キュー」

- 第C.3.4.3項「バッチの処理: 検証キュー」

- 第C.3.4.4項「バッチの処理: リリース・キュー」

注意:
続行する前に、コンテンツ・サーバーが実行されており、Kofaxドングル(ハードウェア・キー)が挿入されていることを確認してください。

C.3.4.1 バッチの作成

バッチを作成するには、次の手順を実行します。

1. Windowsタスクバーで、「スタート」をクリックし、「プログラム」、「Kofax Capture」、「Batch Manager」と選択します。

2. 「File」を選択し、「New Batch」を選択します。

3. 「Batch class」ドロップダウン・リストで、「ScansOracleWebCenter」を選択します。

4. 「Save」をクリックします。

5. 「Close」をクリックします。「Batch Manager」メイン・ダイアログに新規バッチが開きます。バッチはスキャン・キューにあり、「Ready」ステータスを示しています。

C.3.4.2 バッチの処理: スキャン・キュー

バッチを作成したら、次の手順に従ってスキャンを実行します。

1. Kofax Capture Batch Managerのメイン・ダイアログで、「File」→「Process Batch」を選択します。

2. 「Scan」モジュールで、リストから「Software Import」を選択します。

3. 「Scan」を選択し、「Start」を選択します。

4. 「Import」ダイアログで、サンプルTIFFファイルを選択し、「Open」をクリックします。TIFFイメージがバッチ・コンテンツに追加されます。

5. 「Batch」を選択し、「Close」を選択します。

6. 「はい」をクリックして、アクションを確認します。「Batch Manager」メイン・ダイアログで、バッチは検証キューにあり、Readyステータスを示しています。

C.3.4.3 バッチの処理: 検証キュー

スキャン・キューを実行したら、次の手順に従って検証を実行します。

1. 「Kofax Capture Batch Manager」ダイアログで、「File」→「Process Batch」を選択します。

2. 「Validation」モジュールで、必要なコンテンツ・サーバー・フィールド情報値を入力します。この情報に基づき、必要に応じて次のようにコンテンツIDを指定します。

- Use the default batch with the default Content ID: コンテンツは、一意の接尾辞が追加されたコンテンツID Kofax0001を使用してチェックインされます。

- Do not specify a Content ID(バッチを変更するか、検証ステップでコンテンツIDを削除することにより、デフォルトのコンテンツIDを削除できます): 自動的にコンテンツIDを割り当てるようにコンテンツ・サーバーが構成されている場合、コンテンツはこの自動のIDを使用してチェックインされます。コンテンツIDを割り当てるようにコンテンツ・サーバーが構成されていない場合、リリース・プロセス中にエラー・メッセージが表示されます。

- Specify a Content ID: コンテンツは、一意の接尾辞が追加されていない指定されたコンテンツIDを使用してコンテンツ・サーバーにチェックインされます。同じコンテンツIDを持つコンテンツ・アイテムがすでにチェックインされている場合、新しいドキュメントは、既存のコンテンツ・アイテムの新しいリビジョンとしてチェックインされます。

3. 「Batch」を選択し、「Close」を選択します。

4. プロンプトが表示されたら、「Yes」をクリックして、ドキュメントを閉じる前にデータを保存します。「Batch Manager」メイン・ダイアログで、バッチはリリース・キューにあり、Readyステータスを示しています。

C.3.4.4 バッチの処理: リリース・キュー

検証キューを実行したら、次の手順に従ってリリースを実行します。

1. Kofax Captureの「Batch Manager」ダイアログで、「File」→「Process Batch」を選択します。

- リリース・キューがエラーなしで実行されると、TIFFイメージがコンテンツ・サーバーにチェックインされます。

- リリース・キューがエラーで終了した場合は、エラー・メッセージを確認してください。

2. 「Batch Manager」モジュールを終了します。

C.4 ユーザー・インタフェース

この項では、ユーザー・インタフェースの情報について説明します。この項の内容は次のとおりです。

- 第C.4.1項「リリース設定ページ」

- 第C.4.2項「「索引ストレージ」タブ」

- 第C.4.3項「「ドキュメント・ストレージ」タブ」

- 第C.4.4項「「イメージ形式」タブ」

- 第C.4.5項「Adobe Acrobat Captureの設定」

- 第C.4.6項「「サーバー」タブ」

C.4.1 リリース設定ページ

このページを使用して、Kofax Captureリリース・スクリプトの設定ダイアログにアクセスします。

要素

説明

バッチ・クラス

このバッチ・クラスの名前。バッチ・クラスは、バッチ内のドキュメントの処理方法を示します。バッチ・クラスには、1つ以上のドキュメント・クラスが含まれ、ドキュメント・クラスには1つ以上のフォーム・タイプが含まれます。これにより、1つのバッチ内に複数の種類のドキュメントとフォームを含めることができます。

ドキュメント・クラス

このドキュメント・クラスの名前。ドキュメント・クラスは、注文用フォームや医療用フォームなど、特定のタイプのドキュメントの定義です。ドキュメント・クラスでは、同じ索引フィールドおよび処理設定のグループを複数のフォーム・タイプに関連付けるための便利な方法が提供されます。ドキュメント・クラスを定義してから、1つ以上のフォーム・タイプをそこに追加できます。続けて、索引フィールドと処理設定のセットをそのドキュメント・クラスに関連付けることができます。同じフィールドおよび設定のセットが、ドキュメント・クラスに定義されたすべてのフォーム・タイプで共有されます。

名前

このリリース・スクリプトの名前。

「索引ストレージ」タブ

「索引ストレージ」タブを開きます(第C.4.2項を参照)。

「ドキュメント・ストレージ」タブ

「ドキュメント・ストレージ」タブを開きます(第C.4.3項を参照)。

「イメージ形式」タブ

「イメージ形式」タブを開きます(第C.4.4項を参照)。

「サーバー」タブ

「サーバー」タブを開きます(第C.4.6項を参照)。

OK

現在の設定を保存します。

取消

現在の設定を保存せずにページを閉じます。

適用

現在の設定を適用して保存します。

ヘルプ

該当する状況依存ヘルプ・ウィンドウが開きます。

C.4.2 「索引ストレージ」タブ

「リリース設定」ページの「索引ストレージ」タブを使用して、バッチ・クラスの索引値を設定します。Kofax Captureリリース・スクリプトにより、最初のコンテンツ・サーバーのインストールに含まれる必須の情報フィールド・アイテムに対する割当てが確立されます。索引フィールドに割り当てられる値は、Kofax Captureバッチ処理中に検証モジュールから提供されます。

注意:
カスタマイズされたリリース・スクリプトで、索引フィールドを索引値として割り当てられるようにするには、まずドキュメント・クラスに索引フィールドを追加する必要があります。デフォルトでは、選択されたドキュメント・クラスに現在定義されているすべての索引フィールドが索引値のリストに含められます。

要素

説明

「シーケンス」番号

順序位置を使用して、指定された索引値の優先度を指定します。

索引値

新しいファイル・チェックインに関連付けられる索引値に使用されるコンテンツ・サーバー・メタデータ・パラメータ。

追加

新しいメタデータ・パラメータを索引値として追加するためのダイアログを開きます。

削除

選択された索引値をリストから削除します。

すべて削除

リストされた索引値をすべて削除します。

「上へ」/「下へ」

索引値リストで、選択したエントリの特定の配置順序を調整するために使用します。リスト内の各エントリの位置は、バッチ・プロセスにおけるその優先度に対応しています。リスト内のエントリの位置が高いほど、処理における優先度が高くなります。上または下矢印をクリックするたびに、選択したエントリのリスト内での位置が上または下に1つ移動します。

C.4.3 「ドキュメント・ストレージ」タブ

「リリース設定」ページの「ドキュメント・ストレージ」タブを使用して、リリースされたファイルのディレクトリ・パスを表示または変更したり、Kofax CaptureによるAcrobat Capture PDF変換プロセスの監視方法を設定します。

要素

説明

イメージ・ファイルのリリース

イメージ・ファイルをリリースする場合は、このチェック・ボックスを選択します。

リリース・ディレクトリ

ファイルをリリースするフォルダへのパスを入力します。必要に応じて、「参照」ボタンを使用できます。
注意: イメージ・ファイルのリリース・ディレクトリへのパスは、122文字以内である必要があります。

各ドキュメントの先頭ページをスキップ

ドキュメントの最初のページをリリースしない場合は、このチェック・ボックスを選択します。たとえば、セパレータ・シートを使用してバッチ内のドキュメントを区切っており、セパレータ・シートをリリースしない場合に、このオプションを選択します。
注意: セパレータ・シートを使用していない場合にこのオプションを選択すると、各ドキュメントの最初のページがスキップされます(リリースされません)。

OCR全文ファイルのリリース

OCR全文ファイルをリリースする場合は、このチェック・ボックスを選択します。

リリース・ディレクトリ

ファイルをリリースするフォルダへのパスを入力します。必要に応じて、「参照」ボタンを使用できます。
注意: OCRフルテキスト・ファイルのリリース・ディレクトリへのパスは、122文字以内である必要があります。

Kofax PDFファイルのリリース

Kofax PDFファイルをリリースする場合は、このチェック・ボックスを選択します。

リリース・ディレクトリ

ファイルをリリースするフォルダへのパスを入力します。必要に応じて、「参照」ボタンを使用できます。
注意: Kofax PDFファイルのリリース・ディレクトリへのパスは、122文字以内である必要があります。

C.4.4 「イメージ形式」タブ

「リリース設定」ページの「イメージ形式」タブを使用して、リリースされたイメージの形式(ファイル・タイプ)を設定します。

要素

説明

イメージ・ファイル・タイプ

コンテンツ・サーバーにドキュメントをチェックインするために使用するファイル・タイプのリストを提供します。

設定

「Adobe Acrobat Captureの設定」を開きます(第C.4.5項を参照)。

C.4.5 Adobe Acrobat Captureの設定

「設定」ボタンを使用して、PDF設定を指定するための「Adobe Acrobat Captureの設定」ダイアログ・ボックスを開きます。

要素

説明

ワークグループ・ハブ

「参照」ボタンを使用して、Adobe Acrobat Captureワークグループ・ハブの場所を選択します。ワークグループ・ハブは、ワークグループ外のすべてのステーションにアクセスできるドライブ上のフォルダです。グループ内の各ワークステーションに、操作するハブ・フォルダへの読取りおよび書込みアクセス権が必要です。「ワークグループ・ハブ」プロパティは、Adobe Acrobat Captureで必要です。ワークグループ・ハブを選択すると、ディクショナリおよび「ワークフロー」プロパティにデフォルト値が移入されます。

監視フォルダ

「参照」ボタンを使用して、Adobe Acrobat Capture監視フォルダの場所を選択します。これは、ファイルおよびイメージが、PDF処理用に一時的にコピーされる場所です。「監視フォルダ」プロパティはAdobe Acrobat Captureで必要であり、Adobe Acrobat Captureワークフローにファイルを送信するために使用されます。

ページ・コンテンツ

PDFイメージに使用する出力フォーマットを選択します。次のいずれかを選択できます。

- フォーマット済テキストとグラフィック: 「フォーマット済テキストとグラフィック」ファイルの各ページは、PDF Normalとも呼ばれ、テキストおよびビットマップ・イメージの組合せで構成されます。これはデフォルトのページ・コンテンツです。スケーラブルかつ索引付け、検索およびクリップボードへのコピーが可能なテキストが含まれます。ドキュメントでは、ページ・フォーマットおよびグラフィック・イメージが保持されます。

- 検索可能なイメージ-固定: 「検索可能なイメージ(固定)」ページ・コンテンツでは、PDF Normalと同じ機能を共有しますが、元のドキュメントの各ページの完全なビットマップも含みます。ドキュメントの元のスキャンされたイメージを、法的またはアーカイブの目的で保持する必要があるが、ドキュメントを検索可能にする場合にこのフォーマットを選択します。

- 検索可能なイメージ-圧縮: 「検索可能なイメージ(圧縮)」は、「検索可能なイメージ(固定)」の圧縮度の高いバージョンです。色を含まないテキスト領域は、フルカラーではなくモノクロームのイメージとして保管され、索引付け、検索およびクリップボードへのコピーが可能です。

- イメージのみ: 「イメージのみ」ページ・コンテンツでは、各ページの全コンテンツが1つの大きなビットマップとして保管されます。このタイプのファイルでは、コンテンツを検索できません。ただし、PDFエンジンではイメージに対する文字またはフォントの認識を行わないため、このタイプのPDFファイルの処理はきわめて高速になります。Adobe Acrobat Capture 3.0 Personal Editionでは、「イメージのみ」ページ・コンテンツに対してAdobeハードウェア・キーを減らさないことに注意してください。

注意: 「フォーマット済テキストとグラフィック」、「検索可能なイメージ(圧縮)」および「検索可能なイメージ(固定)」フォーマットでは、Adobe Acrobat Capture OCRエンジンを使用して、テキストのOCR処理を行います。認識できない語や文字に対するエンジンの動作を制御するには、次で説明しているように、「サスペクト領域」オプションを選択します。

言語

使用する言語を選択します。デフォルトは「英語(米国)」です。「英語(米国)」から言語を変更すると、文字セット、プライマリ・スペル・ディクショナリおよび(一部の言語では)認識エンジンが変更されます。

PDFドキュメント情報

必要なPDFドキュメント情報を入力または選択します。PDFファイルの表示時に、選択内容が「ドキュメント情報」として表示されます。「タイトル」、「件名」、「作成者」または「キーワード」に、テキストを入力するか、検索フィールド、バッチ・フィールドまたはKofax Capture値を選択できます。

ディクショナリ

OCR処理に使用するディクショナリを選択します。デフォルトのAdobe Acrobat Captureディクショナリを受け入れるか、事前定義されているカスタム・ディクショナリを選択して、ドキュメントを処理できます。ワークグループ・ハブが選択されると、デフォルト・ディクショナリが自動的に移入されることに注意してください。

ワークフロー

Adobe Acrobat Capture処理で使用するワークフローを選択します。デフォルトのAdobe Acrobat Captureワークフローを受け入れるか、別のワークフローを選択します。ワークグループ・ハブが選択されると、ワークフローが自動的に移入されます。ワークフローには、指定された監視フォルダが必要であることに注意してください。Adobe Acrobat Captureを使用して、独自のワークフローを作成したり、事前定義済ワークフローのいずれかを使用できます。

サスペクト領域

サスペクト領域の処理方法について必要な動作を選択します。サスペクト領域とは、Adobe Acrobat Captureエンジンにより、選択されたOCR信頼しきい値以上の信頼水準で認識できない領域のことです。

「OCR信頼度」

必要なOCR信頼しきい値を入力または選択します。語の信頼度が設定された信頼しきい値より小さい場合、その語は元のビットマップ領域で置き換えられます。デフォルトは95パーセントです。0から100パーセントの値を選択できます。
処理中に、Adobe Acrobat Captureエンジンにより、結果の正確性に対する信頼度を示す値が各語に割り当てられます。選択する信頼しきい値により、受け入れるエンジンからの最小の戻り値が決まります。しきい値以上の信頼水準を持つ語のみが、正しい語として返されます。その他すべてはサスペクト領域として返され、元のビットマップ領域で置き換えられます。

サスペクト・フォント

一般的ではないフォントの信頼度がOCR信頼しきい値より小さい場合に、そのフォントを元のビットマップ領域で置き換える場合に選択します。

「未登録語」

指定されたディクショナリで見つからない語を元のビットマップ領域で置き換える場合に選択します。

「英数字混在」

英数字が混在している語を元のビットマップ領域で置き換える場合に選択します。

「数字のみ」

数字のみが含まれている語を元のビットマップ領域で置き換える場合に選択します。

詳細設定

該当するチェック・ボックスを選択して、拡張機能をオンおよびオフにします。

「サムネイルの作成」

ドキュメント内の各ページのサムネイルを作成する場合に選択します。この設定を有効にすると、ファイル・サイズが大幅に増大することに注意してください。

「フォトの埋込み」

ドキュメントにフォントを埋め込む場合に選択します。これにより、ドキュメントを表示するコンピュータに選択したフォントが存在しない場合でも、必ず選択したフォントが使用されます。埋め込むフォントは、「Adobe Acrobat Captureイメージ・プロパティ」ダイアログ・ボックスで指定されているか、「レビューア」で割り当てられている必要があります。この設定を有効にすると、ファイル・サイズが大幅に増大することに注意してください。

「リンクの有効化」

目次、章および索引参照などのハイパーリンクをドキュメント内で有効にする場合に選択します。これにより、ドキュメント内のすべてのタイトルおよび見出しのブックマークもPDFファイルに追加されます。

「構造の有効化」

PDFビューアでの検索およびドキュメントのナビゲーションに使用する構造要素に非表示のタグを提供する場合に選択します。これは、Adobe Document Serverで提供されるような、テキスト・ベースのユーザー・インタフェースを視覚に障害のあるユーザーが使用する場合に特に便利です。

「ページの方向を自動的に検出」

ページの正しい方向を自動的に検出して、その方向にあわせてイメージを回転する場合に選択します。すべての入力ページの方向が正しいことがわかっている場合、または回転を処理するステップがAdobe Acrobat Captureワークフローの「Capture Image」ステップより前に行われる場合は、このオプションの選択を解除してください。

送信済ドキュメントのステータスについてAdobe Acrobat Captureをポーリング

Kofax Captureにより、Adobe Acrobat Capture変換プロセスのステータスを監視できるようにする場合は、このチェック・ボックスを選択します。ポーリングが有効になっている場合、「Kofax Capture PDFリリース」ダイアログ・ボックスのリリース・ワークステーションにステータス・メッセージが表示されます。
Kofax Captureにより、ドキュメントをAdobe Acrobat Captureにリリースしてバッチを閉じられるようにする場合は、このチェック・ボックスの選択を解除してください。Adobe Acrobat Capture変換プロセスのステータスは、Kofax Captureには返されません。

処理エラーが発生した場合はAdobe Acrobat Captureドキュメントを削除

PDF変換プロセス中にエラーが発生した場合に、Adobe Acrobat Capture内のすべての停止ドキュメントを自動的に取り消す場合は、このチェック・ボックスを選択します。選択を解除すると、エラーが発生したドキュメントがAdobe Acrobat Captureワークフロー内に残ります。このプロパティは、「送信済ドキュメントのステータスについてAdobe Acrobat Captureをポーリング」チェック・ボックスを選択している場合にのみ使用できます。
注意: リリース中にAdobe Acrobat Captureエラーが発生した場合は、Kofax Captureで同じドキュメントを再度リリースする前に、Adobe Acrobat Captureの完了ドキュメントを消去して、すべての停止ドキュメントを自動的にまたは手動で取り消す必要があります。

C.4.6 「サーバー」タブ

「リリース設定」ページの「サーバー」タブは、コンテンツ・サーバーURL、ユーザー名およびパスワードの設定を指定したり、ワークフローおよびプライマリ/代替ファイルのチェックイン・フォーマットのオプションを選択したり、CHECKINパラメータ・エディタにアクセスするために使用されます。

要素

説明

URL

コンテンツ・サーバーでの宛先URL。

ユーザー名

ユーザーの名前。

Password

「ユーザー名」フィールドに入力されたユーザーの名前のパスワード。

プライマリ・ファイル

新しいネイティブ・ファイル・チェックインのフォーマット・タイプ。

代替ファイル

Webで表示可能、またはWebで表示可能なフォーマットに変換可能な代替ファイルのチェックインのフォーマット・タイプ。

ワークフローの許可

ワークフローを許可する場合は、このチェック・ボックスを選択します。

エラーが発生したAdobe Acrobat Capture PDFのチェックイン

エラーを含む可能性がある新しいPDFファイルのチェックインを許可する場合は、このチェック・ボックスを選択します。

チェックイン失敗時にプライマリ・ファイルと代替ファイルをリリース・ディレクトリに保存

チェックイン手順が失敗した場合に、プライマリおよび代替ファイルをリリース・ディレクトリに保持する場合は、このチェック・ボックスを選択します。

サービス・パラメータのチェックイン

サービス・パラメータ設定を処理します。

C.5 Adobe Acrobat Captureの使用

この項の内容は次のとおりです。

- 第C.5.1項「Adobe Acrobat Captureの構成」

- 第C.5.2項「Adobe Acrobat Capture PDFファイルのチェックイン」

- 第C.5.3項「グローバル・オプションの設定」

C.5.1 Adobe Acrobat Captureの構成

Adobe Acrobat Capture 3.0ソフトウェアをKofax Capture ExportコンポーネントおよびKofax Captureとともに使用する場合は、追加のセットアップ・タスクを実行する必要があります。

注意:
Adobe Acrobat Captureは、Kofax Captureのリリース・ステーションとは異なるシステムにインストールする必要があります。

注意:
Adobe Acrobat Captureの構成後は、アプリケーションを常時実行したままにする必要があります。

Adobe Acrobat Captureを、ファイルを監視して処理するように構成する必要があります。この項の内容は次のとおりです。

- 第C.5.1.1項「監視ディレクトリの作成」

- 第C.5.1.2項「ワークフローの作成」

- 第C.5.1.3項「TIFFワークフローの作成」

- 第C.5.1.4項「JPGワークフローの作成」

C.5.1.1 監視ディレクトリの作成

Acrobat Captureでは、Watchディレクトリを使用して、Kofax Captureからの出力ファイルを見つけます。Watchディレクトリには、Kofax Captureリリース・ステーションおよびAdobe Acrobat Captureワークステーションからアクセスできる任意のディレクトリを指定できますが、この場所をAscent\Images\OracleWebCenterScan\ディレクトリには設定できないという例外があります。

Acrobat Captureのデフォルト・インストール・ディレクトリにWatchディレクトリを作成する手順は次のとおりです。

1. Program Files\Adobe\Adobe Acrobat Capture 3.0\にナビゲートします。

2. Watchという名前の新しいディレクトリを作成します。

C.5.1.2 ワークフローの作成

ワークフローを作成して、Kofax Captureで使用するようにAdobe Acrobat Captureを構成します。作成するワークフローのタイプは、PDFを作成するために使用するファイルのタイプによって異なります。

- 第C.5.1.3項「TIFFワークフローの作成」

- 第C.5.1.4項「JPGワークフローの作成」

C.5.1.3 TIFFワークフローの作成

Kofax Captureとともに使用するようAdobe Acrobat Captureを構成する手順は次のとおりです。

1. Windowsタスクバーで、「スタート」をクリックし、「プログラム」、「Adobe」、「Acrobat Capture 3.0」、該当する「バージョン」と選択します。

2. 「Configure」タブで、「Workflow」を選択し、「Insert Workflow」を右クリックします。図C-3のようなワークフローを作成します。

図C-3 ワークフローの例

3. 新しいワークフローに名前を付けます(たとえば、OracleWebCenterScans)。

4. 新しいワークフローの名前を選択し、「Insert Steps」を右クリックします。

5. 挿入ステップを「Split Multipage TIF」に設定し、「Insert」をクリックします。

6. 挿入ステップを「Capture Image」に設定し、「Insert」をクリックします。

7. 挿入ステップを「Bind Pages」に設定し、「Insert」をクリックします。

8. 挿入ステップを「Export to PDF」に設定し、「Insert」をクリックします。

9. 挿入ステップを「Store File (PDF)」に設定し、「Insert」をクリックします。

10. 「Done」をクリックします。

11. 左端のチェック・ボックスを選択し、ワークフローを実行します(図C-4)。

図C-4 チェック・ボックスの場所

12. 「Watch」タブを選択し、監視フォルダ・アイコンをクリックします(図C-5)。

図C-5 監視フォルダ・アイコン

13. 「Watched Folder Properties」ダイアログで、「Location」を前述の手順で作成したWatchディレクトリに設定します。Acrobat Captureのデフォルト・インストール・ディレクトリにWatchディレクトリを作成した場合、これはProgram Files\Adobe\Adobe Acrobat Capture 3.0\Watch\です。

注意:
ネットワーク接続されたドライブにWatchディレクトリを設定した場合は、WatchディレクトリへのUNCパス(たとえば、\\hostserver\..\Watch)を使用します。マップされたドライブは使用しないでください。

14. 「Submit Files to Workflow」を、ステップ3で作成した新しいワークフロー(この例では、OracleWebCenterScans)に設定します。

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

注意:
Adobe Acrobat Captureアプリケーションは、それに対して新しいファイルが送信された場合に必ず監視フォルダのコンテンツを処理できるように、常に実行されている必要があります。

C.5.1.4 JPGワークフローの作成

Kofax Captureとともに使用するようAdobe Acrobat Captureを構成する手順は次のとおりです。

1. Windowsタスクバーで、「スタート」をクリックし、「プログラム」、「Adobe」、「Acrobat Capture 3.0」、該当する「バージョン」と選択します。

2. 「Configure」タブで、「Workflow」を選択し、「Insert Workflow」を右クリックします。図C-6のようなワークフローを作成します。

図C-6 ワークフローの例

3. 新しいワークフローに名前を付けます(たとえば、OracleWebCenterScansPDF)。

4. 新しいワークフローの名前を選択し、「Insert Steps」を右クリックします。

5. 挿入ステップを「Capture Image」に設定し、「Insert」をクリックします。

6. 挿入ステップを「Bind Pages」に設定し、「Insert」をクリックします。

7. 挿入ステップを「Export to PDF」に設定し、「Insert」をクリックします。

8. 挿入ステップを「Store File (PDF)」に設定し、「Insert」をクリックします。

9. 「Done」をクリックします。

10. 左端のチェック・ボックスを選択し、ワークフローを実行します。

11. 「Watch」タブを選択し、監視フォルダ・アイコンをクリックします。

12. 「Watched Folder Properties」ダイアログで、「Location」を前述の手順で作成したWatchディレクトリに設定します。Acrobat Captureのデフォルト・インストール・ディレクトリにWatchディレクトリを作成した場合、これはProgram Files\Adobe\Adobe Acrobat Capture 3.0\Watch\です。

注意:
ネットワーク接続されたドライブにWatchディレクトリを設定した場合は、WatchディレクトリへのUNCパス(たとえば、\\hostserver\..\Watch)を使用します。マップされたドライブは使用しないでください。

13. 「Submit Files to Workflow」を、ステップ3で作成した新しいワークフロー(この例では、OracleWebCenterScansPDF)に設定します。

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

注意:
Adobe Acrobat Captureアプリケーションは、それに対して新しいファイルが送信された場合に必ず監視フォルダのコンテンツを処理できるように、常に実行されている必要があります。

C.5.2 Adobe Acrobat Capture PDFファイルのチェックイン

この項の内容は次のとおりです。

- 第C.5.2.1項「プライマリ/代替ファイル形式の設定」

- 第C.5.2.2項「Adobe Acrobat Captureを実行しているコンピュータの設定」

- 第C.5.2.3項「イメージ・ファイル・リリース・ディレクトリの設定」

C.5.2.1 プライマリ/代替ファイル形式の設定

プライマリ/代替ファイル形式を設定するには、次の手順を実行します。

1. 「リリース設定」ダイアログの「サーバー」タブにナビゲートします。

2. 「プライマリ」または「代替」ドロップダウン・リストのいずれかから、「Adobe Acrobat Capture PDF」を選択します。

注意:
「Adobe Acrobat Capture PDF」オプションは、次の場合にのみ使用できます。

- 「リリース設定」ダイアログの「イメージ形式」タブで、「Adobe Acrobat Capture PDF」がイメージ・ファイル・タイプとして選択されている場合。第C.3.2.10項を参照してください。

- Adobe Acrobat Captureがインストールされており、Kofax Captureで動作するように正しく構成されている場合。第C.5.1項を参照してください。

C.5.2.2 Adobe Acrobat Captureを実行しているコンピュータの設定

Adobe Captureを実行しているコンピュータを設定する手順は次のとおりです。

1. PDFファイルを保管するローカル・ディレクトリを作成します。
例: c:\OracleWebCenterScans

2. このディレクトリを共有します。
例: Share c:\OracleWebCenterScans as "OracleWebCenterScans"

3. Adobe Captureの「Store File」プロパティでUNCパスを設定します。
例: \\AdobeCaptureComputerName\OracleWebCenterScans

4. 「Store File」プロパティで、「No Renaming of Duplicates」を選択します。

C.5.2.3 イメージ・ファイル・リリース・ディレクトリの設定

Kofax Capture用コンテンツ・サーバーの設定で、次の手順を実行します。

1. 「ドキュメント・ストレージ」タブで、イメージ・ファイル・リリース・ディレクトリを、Adobe CaptureによりPDFファイルの保管のために使用される場所のUNCパスに設定します。
例: \\AdobeCaptureComputerName\OracleWebCenterScans

2. 新しい設定をバッチで使用できるようにするには、バッチ・クラスを公開します。

C.5.3 グローバル・オプションの設定

この項の内容は次のとおりです。

- 第C.5.3.1項「グローバル・オプションについて」

- 第C.5.3.2項「PDFドキュメントのサルベージ」

- 第C.5.3.3項「Adobe Acrobat Captureログのエラー・チェックの制限」

C.5.3.1 グローバル・オプションについて

「グローバル・オプション」ダイアログは、次のことを行うために使用できます。

- PDFドキュメントのサルベージ

- Adobe Acrobat Captureログのエラー・チェックの制限

これらのいずれかのオプションを設定するには、レジストリに対する書込み権限が必要です。これらの設定について質問がある場合は、システム管理者または情報技術部門にお問い合せください。

これらの設定は、リリース・スクリプトを実行しているワークステーションにのみ影響します。複数のリリース・ステーションを使用している場合は、ステーションごとにこれらのオプションを設定してください。

C.5.3.2 PDFドキュメントのサルベージ

チェックインするリリース・ディレクトリ内のPDFドキュメントをサルベージして、Adobe Acrobat CaptureでTIFFファイルが再変換されないようにできます。

注意:
バッチを自動で実行する場合は、この機能を無効にする必要があります。デフォルトでは無効です。

異なるリリース・ステーションで実行されている別のバッチにより生成されたPDFファイルが検出されないようにするために、Kofaxリリース・ステーションごとに個別のリリース・ディレクトリを構成することをお薦めします。PDFを作成するためにTIFがAdobe Acrobat Captureに送信されると、ダイアログが表示されます。PDF以外のフォーマットが使用された場合は、ダイアログは表示されません。

PDFをサルベージするには、次の手順を実行します。

1. StellentRelOptions.exe(通常はKofax Capture Install\Bin\StellentRelにインストールされています)を実行して、「グローバル・オプション」ダイアログを開きます。

2. 「PDFファイルがリリース・ディレクトリで検出された場合に「サルベージPDF」ダイアログを表示します。」を選択します。

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

4. 通常の方法でバッチに対してリリース・スクリプトを実行します。
リリース・スクリプトが実行されると、PDFファイルのリリース・ディレクトリが検査されます。PDFファイルが存在する場合、次のダイアログが開き、ここからチェックインするファイルを選択できます。これを使用して、チェックインが失敗したが、ファイルはまだ有効である場合に、Captureから新しいPDFを作成するのではなく、PDFをサルベージできます。

5. 表示されたPDFファイルのリストから、次に示す操作を実行できます。

- 「チェックイン」をクリックして、プライマリまたは代替ファイルとしてチェックインするPDFを選択します(Adobe Acrobat Captureのステップを実行する必要はありません)。

- 「開く」をクリックして、関連付けられているアプリケーション(通常はAdobe Acrobat Reader)でPDFを表示します。

- 「削除」をクリックして、リリース・ディレクトリからPDFファイルを削除します。

- 「取消」をクリックして(またはキーボードの[Esc]キーを押して)、Adobe Acrobat Captureにより通常の方法でPDFを作成します。

注意:
「チェックイン」、「開く」および「削除」ボタンは、ダイアログからPDFファイルを選択すると、使用できるようになります。

C.5.3.3 Adobe Acrobat Captureログのエラー・チェックの制限

Adobe Acrobat Captureの完了ドキュメントのログのエラー・チェックを、現在の時刻から指定した時間以内に完了したドキュメントに制限できます。この設定は、StellentRelOptions.exe(通常はKofax Install Dir\Bin\StellentRelにインストールされています)を実行して変更できます。

ログ履歴の制限を設定するには、次の手順を実行します。

1. StellentRelOptions.exe(通常はKofax Capture Install\Bin\StellentRelにインストールされています)を実行して、「グローバル・オプション」ダイアログを開きます。

2. 「Acrobat Captureドキュメント終了ログ履歴の制限」を選択します。

3. ログ・ファイルの切捨てポイントを時間数で入力します。Adobe Acrobat Captureログが、指定した時間内のエントリに制限されます。入力した時間より古いエントリは検査されません。通常はこの値を変更する必要はありません。

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

D Oracle WebCenter Contentのトラブルシューティング

この付録では、Oracle WebCenter Content、および特にコンテンツ・サーバーの使用時に発生する可能性のある問題について説明します。この付録では、トラブルシューティング・プロセスで役立つ方法とツールについての情報を提供します。

注意:
Inbound Refinery、Content Tracker、Records、WebCenter Contentリポジトリ、FoliosなどのOracle WebCenter Content機能のトラブルシューティングの詳細は、『Oracle WebCenter Contentのマネージング』を参照してください。

この付録では次の項について説明します。

- 第D.1項「Oracle WebCenter Contentのトラブルシューティングの概要」

- 第D.2項「Oracle WebCenter Contentの基本のトラブルシューティングのスタート・ガイド」

- 第D.3項「Oracle WebCenter Contentのアーカイブのトラブルシューティング」

- 第D.4項「Oracle Supportを使用したその他のトラブルシューティング情報」

D.1 Oracle WebCenter Contentのトラブルシューティングの概要

この項では、この付録内の情報を使用するためのガイドラインとプロセスについて説明します。次のガイドラインおよびプロセスに従うことで、作業の焦点を問題解決に絞り、問題解決までの時間を短縮できます。

ガイドライン

この付録の情報を使用する際には、次のことをお薦めします。

- この章の解決策を実行した後すぐに、このトラブルシューティング情報を利用するきっかけとなった失敗したタスクを再試行します。再試行してもタスクが失敗する場合、この章に記載されている他の解決策を実行し、再度失敗したタスクを実行します。このプロセスを問題が解決するまで繰り返します。

- 実行した解決策、確認された現象およびトラブルシューティング中に収集したデータを記録しておきます。この章の情報を使用しても問題が解決されずサービス・リクエストを記録することになった場合、これらの情報があると迅速な問題解決につながります。

プロセス

この付録の情報を利用する場合は、次に概要を示すプロセスに従ってください。特定の項の情報でも問題を解決できない場合は、このプロセスの次のステップに進んでください。

表D-1 この付録内の情報を使用するためのプロセス

手順

使用する項

目的

1

第D.2項

Oracle WebCenter Contentおよびコンテンツ・サーバー・インスタンスのトラブルシューティングを開始します。この項に示す手順によって、幅広い問題に迅速に対応できます。

2

第D.3項

コンテンツ・サーバーのアーカイブの問題に関する問題別トラブルシューティングの手順を実行します。この項では、次の内容について説明します。

- 問題の考えられる原因

- それぞれの考えられる原因に対応する解決策

3

第D.4項

My Oracle Supportを使用してその他のトラブルシューティング情報を取得します。My Oracle Supportから、ナレッジ・ベース記事、コミュニティ・フォーラム、ディスカッションを含むいくつかの有益なトラブルシューティング・リソースにアクセスできます。

4

第D.4項

この付録とMy Oracle Supportの情報では問題を解決できない場合に、サービス・リクエストを記録します。サービス・リクエストを記録するには、https://support.oracle.com">>https://support.oracle.comのMy Oracle Supportを使用できます。

D.2 Oracle WebCenter Contentの基本のトラブルシューティングのスタート・ガイド

この項では、トラブルシューティング・プロセスで役立つ有益で詳細な情報の様々なソースの使用についての情報を提供します。

- 第D.2.1項「トレースの使用」

- 第D.2.2項「スタック・トレースの使用」

- 第D.2.3項「環境パッケージャの使用」

- 第D.2.4項「Content Serverアナライザの使用」

- 第D.2.5項「デバッグ構成変数の使用」

- 第D.2.6項「HDAファイルの分析」

コンテンツ・サーバーのロギングの詳細は、第III部「Oracle WebCenter Content Serverの監視」を参照してください。

D.2.1 トレースの使用

コンテンツ・サーバーのトレースをアクティブ化して、トラブルシューティングおよびシステム・パフォーマンスの最適化に非常に役立つ詳細なシステム情報を表示できます。

- 第D.2.1.1項「サーバー全体のトレース」

- 第D.2.1.2項「アプレット固有のトレース」

D.2.1.1 サーバー全体のトレース

サーバー全体のトレースは、システム全体のアクティビティを表示するために使用します。サーバー全体のトレースをアクティブ化する方法は2つあります。

コンテンツ・サーバー管理インタフェースからトレースをアクティブ化するには、次の手順を実行します。

1. 「管理」、「システム監査情報」の順に選択します。

2. 詳細出力をサポートするアクティブなセクションについて詳細なトレースを確認するには、「完全な詳細トレース」を有効にします。

3. トレースをアクティブ化するように指定します。

4. 「更新」をクリックします。

5. 「サーバー出力の表示」をクリックします。

ヒント:
トレース・オプションは、システムを再起動する際に失われます。コンテンツ・サーバー・インスタンスの再起動後に設定を確実に保持するには、「保存」を有効にしてから「更新」をクリックします。

アプレットからトレースをアクティブ化するには、次の手順を実行します。

1. 管理アプレットを起動します。

2. 「オプション」の次に、「トレース」を選択します。

3. 「サーバー・トレース」を選択します。

4. アクティブ化するトレースまたはすべてを選択し、「OK」をクリックします。

次のトレース・オプションが使用できます。コンポーネントを追加する場合、追加のトレース・セクションをリストに表示できます。

- applet: このトレースには、構成マネージャやユーザー管理など、初期化されたアプレットからの結果セットが含まれます。

- archiver: このトレースでは、アーカイバ・データ・ファイルの読取りと書込み、および、アクティビティの開始および終了時刻など、アーカイブ・アクティビティに関する情報が提供されます。

- archiverlocks: このトレースでは、開始時刻など、アーカイブ・アクティビティ中にファイルに適用されるロックに関する情報が提供されます。

- chunkedrequest: このトレースでは、大きいリクエストが小さいリクエストにチャンク化される際に作成されるメッセージおよびヘッダーが表示されます。

- docprofile: このトレースでは、コンテンツ・プロファイルの計算、具体的には、どのフィールドがラベルであるか、非表示であるかなどを決定するルールの評価が表示されます。

- encoding: このトレースでは、発生したエンコーディング変換およびエンコーディングが発生したアクティビティに関する情報が提供されます。

- filelock: このトレースでは、発生する衝突およびタイムアウトに焦点を絞ったディレクトリに適用される短期のシステム・ロック(たとえばアーカイブなどのアクティビティ中)に関する情報が表示されます。

- filelonglock: このトレースでは、システムが設定した長期のロックの作成、削除および保守に関する情報が表示されます。

- filequeue: このトレースでは、ファイル・キューのアクセスに関する情報が表示されます。

- indexer: このトレースでは、索引の更新のために実行されるステップ、および各ステップの経過時間など、データベースの更新時に発生する索引機能に関する情報が表示されます。

- indexermonitor: このトレースでは、開始および終了時間など、自動索引アクティビティのサマリーが提供されます。

- indexerprocess: このトレースでは、手動で起動した索引プロセスに関する情報が表示され、プロセスが正常に終了したかどうかが示されます。

- localization: このトレースでは、ローカライズの使用状況およびアクティビティに関する情報が表示されます。

- mail: このトレースでは、コンテンツ・サーバー・インスタンスによって送信されるメールについて説明します。

- pagecreation: このトレースでは、サーバー・スレッド、およびページの生成にかかる時間など、表示されるページの作成に関する情報が表示されます。

- requestaudit: このトレースでは、リクエストの経過時間、および作成されたリクエストの数など、サービス・リクエストに関するサマリー・レポートが提供されます。詳細は、ブログ記事「Expanding on requestaudit – Tracing who is doing what…and for how long」を参照してください。

- scheduledevents: このトレースでは、毎時または日次のバックグラウンドのスケジュール化されたイベントのリストが提供されます。

- schema: このトレースでは、スキーマのパブリッシュ(.jsファイルとしてパブリッシュされた表およびビュー)、およびキャッシング(コンテンツ・サーバー・メモリーにキャッシュされた表)に関する情報が提供されます。

- searchquery: このトレースでは、検索に使用されるフィールド、および結果のソート順など、最近の検索に関する情報が表示されます。

- socketrequests: このトレースでは、ソケット・リクエストの日時とスレッド番号、およびリクエスト中のアクションが表示されます。

- system: このトレースでは、システムのソケット・リクエストおよびレスポンスなど、内部システム・メッセージが表示されます。

- systemdatabase: このトレースでは、実行された問合せ、索引の更新、使用されたスレッド、および開始時間など、データベース・アクティビティに関する情報が提供されます。

- transfermonitor: このトレースでは、アーカイバおよびバッチ・ファイル転送アクティビティに関する情報が表示されます。

- userstorage: このトレースでは、アクセス中に実行されたアクションなど、外部ユーザー・リポジトリのアクセスについて説明します。

- workflow: このトレースでは、ドキュメント・タイトルおよびリビジョン番号など、ワークフローで処理されるコンテンツ・アイテム上のメタデータのリストが表示されます。

注意:
国際的なサポートを促進するため、ほとんどのトレース・メッセージは英語で出力され、翻訳されていません。

D.2.1.2 アプレット固有のトレース

アプレット固有のトレースの場合、ブラウザのJavaコンソールに出力されます。アプレット別にトレースを実行するには、次の手順を実行します。

1. トレースする管理アプレットを起動します。

2. 「オプション」の次に、「トレース」を選択します。

3. 選択して、「OK」をクリックします。出力はブラウザのJavaコンソールに送られます。

図D-1 アプレット固有のトレース

D.2.2 スタック・トレースの使用

スタック・トレースによって、コンテンツ・サーバー・インスタンス内で現在実行中のスレッドがわかります。これは、スレッドに関する情報を提供する有益なトラブルシューティング・ツールで、コンテンツ・サーバーの処理を監視できます。

コンテンツ・サーバー・インスタンスの現在のスタック・トレースを開始する手順は、Oracle WebLogic Serverのドキュメントを参照してください。

D.2.3 環境パッケージャの使用

環境パッケージャは診断ツールです。それは、必要な状態ディレクトリ、ログ・ファイル、および他のコンポーネントやリソースのディレクトリのzipファイルを作成します。

環境zipファイルを作成するには、次の手順を実行します。

1. コンテンツ・サーバー・インスタンスに管理者としてログインします。

2. 「管理」、「環境パッケージャ」の順に選択します。

3. 「環境パッケージャ」ページで、パッケージ化する環境の部分を選択します。

4. 環境zipファイルを作成する準備が完了したら、「パッケージングの起動」をクリックします。zipファイルの作成中は、zipファイルへのリンクとともにメッセージが表示されます。パッケージング・プロセスは数分かかる場合があります。プロセスが完了するまでは、zipファイルのリンクは使用できません。

注意:
パッケージ化されたzipの名前は、server_environment_*.zipになります。コンテンツ・サーバー・インスタンスがパッケージ化されたzipファイルを作成している間、それはIntradocDir/vault/~tempにあります。zipファイルの作成が完了すると、それはIntradocDir/weblayout/groups/secure/logs/envに移動します。

D.2.4 Content Serverアナライザの使用

Content Serverアナライザ・アプリケーションによって、ファイル・システム、データベースおよび検索索引など、コンテンツ・サーバー・リポジトリ・コンポーネントの整合性を確認できます。また、リポジトリ・コンポーネントで検出された問題をシステム管理者が修正する場合にも役立ちます。

Content Serverアナライザを使用すると、システム管理者は次のことができます。

- コンテンツ・サーバーの3つの重要なデータベース表(Revisions、DocumentsおよびDocMeta)の間の同期化の精度を確認します。

- dRevClassIDフィールドおよびdDocNameフィールドが、すべてのリビジョンのコンテンツ・アイテム間で整合性がとれていることを確認します。

- ファイル・システム(ネイティブ・ファイル・リポジトリおよびWeb表示可能ファイル・リポジトリ)に重複ファイルや欠落したファイルがあるかどうかを判別します。

- 検索索引とファイル・システム間の整合性の精度を確認します。

- 検索索引とRevisionsデータベース表間の整合性の精度を確認します。

- ファイル・システムに必要なすべてのファイルが含まれていることを確認します。

- 重複ファイルを、ログ/ディレクトリに移動することによって、コンテンツ・サーバー・リポジトリから永久または一時的に削除します。

- コンテンツ・サーバー・リポジトリにコンテンツ・アイテムの状態で、一般的なレポートを作成します。

Content Serverアナライザの起動方法は、オペレーティング・システムに応じて異なります。

- 「スタート」、「Oracle Content Server」、インスタンス、「Content Serverアナライザ」の順に選択します。

- UNIX: DomainHome/ucm/cs/binディレクトリにナビゲートし、Content Serverアナライザ・プログラムを実行します。

次の項では、Content Serverアナライザのタスクについて説明します。

- 第D.2.4.1項「Content Serverアナライザへのアクセス」

- 第D.2.4.2項「カスタム・アナライザのログ・ディレクトリの指定」

- 第D.2.4.3項「解析プロセスの起動」

- 第D.2.4.4項「コンテンツ・サーバー・データベースの分析」

- 第D.2.4.5項「コンテンツ・サーバー検索索引の分析」

- 第D.2.4.6項「コンテンツ・サーバー・ファイル・システムの分析」

- 第D.2.4.7項「解析の進行状況および結果の表示」

- 第D.2.4.8項「ステータス・レポートの生成」

- 第D.2.4.9項「ステータス・レポートの取消」

D.2.4.1 Content Serverアナライザへのアクセス

Content Serverアナライザを表示するには、次の方法のうちの1つを使用します。

- Windows: 「スタート」、「プログラム」、「コンテンツ・サーバー」、インスタンス、「ユーティリティ」、「Content Serverアナライザ」の順に選択します。

- UNIX: DomainHome/ucm/cs/binディレクトリに変更し、シェル・ウィンドウで「IdcAnalyze」と入力して、キーボードで[RETURN]キーを押します。

Content Serverアナライザ・アプリケーションが表示されます。

D.2.4.2 カスタム・アナライザのログ・ディレクトリの指定

logs/ディレクトリは、Content Serverアナライザのデフォルトのロギング・ディレクトリです。解析の出力ファイルはこのディレクトリに書き込まれ、ファイル・システムの解析プロセス中に検出される追加のファイルもここに転送できます。オプションで、必要に応じて、デフォルトのlogs/ディレクトリの名前およびパスを変更できます。

アナライザのログ・ディレクトリの名前およびパスをカスタマイズするには、次の手順を実行します。

1. 「Content Serverアナライザ」の「構成」タブで、「Analyzerのログ・ディレクトリ」フィールドにカーソルを置きます。

2. 目的のディレクトリ・パスを入力します。次の解析プロセス中、Content Serverアナライザによって、DomainHome/ucm/cs/bin/ディレクトリ階層内に指定したディレクトリが自動的に作成されます。

D.2.4.3 解析プロセスの起動

解析プロセスを起動するには、次の手順を実行します。

1. 「Content Serverアナライザ」の「構成」タブで、必要なオプションを選択およびアクティブ化します(対応するチェック・ボックスをチェックします)。

2. 「解析の開始」をクリックします。

注意:
Content Serverアナライザを初めて実行した場合、logs/ディレクトリの出力ファイルは自動的に作成されます。その後の解析プロセスでは、既存のログ・ファイルを上書きしてよいかを尋ねる確認メッセージが表示されます。

3. 「はい」をクリックして、既存のログ・ファイルを上書きします。「Content Serverアナライザ」の「進行状況」タブが自動的に表示されます。選択したすべての解析プロセスが終了すると、完了メッセージが表示されます。

注意:
「いいえ」をクリックした場合、解析プロセスは終了し、Content Serverアナライザを再度実行する前に、logs/ディレクトリからファイルを手動で削除するよう求められます。

4. 「OK」をクリックします。
結果は、「進行状況」タブのコンソール領域に表示されます。

D.2.4.4 コンテンツ・サーバー・データベースの分析

「RevClassIDのチェック」および「データベースのクリーン」オプションは、データベース列の整合性をチェックするために使用されます。使用可能なオプションによって、コンテンツ・アイテムのリビジョン情報を格納するために使用される3つの表(DocMeta、DocumentsおよびRevisions)を調査できます。Revisions表で見つからない追加のエントリについて、DocMetaファイルを調査します。同様に、Revisions表のエントリに対応するのに十分なエントリがあることを確認するために、Documents表を調査します。

注意:
「データベースのチェック」オプションが選択されている場合のみ、「RevClassIDのチェック」および「データベースのクリーン」オプションはアクティブ化され、選択可能になります。

コンテンツ・サーバー・データベースを分析するには、次の手順を実行します。

1. 「Content Serverアナライザ」の「構成」タブで、適用可能なオプションを選択します。

2. 「解析の開始」をクリックします。
結果は、「Content Serverアナライザ」の「進行状況」タブのコンソール領域に表示されます。解析手順の詳細は、第D.2.4.3項「解析プロセスの起動」を参照してください。

D.2.4.5 コンテンツ・サーバー検索索引の分析

「検索索引のチェック」および「csIDCAnalyzeCleanIndex」オプションは、索引に属するすべてのドキュメントが正しくリストされていることを確認するために、Revisions表のエントリをチェックするために使用されます。また、検索索引に重複エントリがないことを確認するために、チェックを実行できます。

注意:
「検索索引のチェック」オプションが選択されている場合のみ、「csIDCAnalyzeCleanIndex」オプションはアクティブ化され、選択可能になります。

コンテンツ・サーバー検索索引を分析するには、次の手順を実行します。

1. 「Content Serverアナライザ」の「構成」タブで、適用可能なオプションを選択します。

2. 「解析の開始」ボタンをクリックします(解析手順の詳細は、第D.2.4.3項を参照してください)。
結果は、「Content Serverアナライザ」の「進行状況」タブのコンソール領域に表示されます。

D.2.4.6 コンテンツ・サーバー・ファイル・システムの分析

「ファイル・システムのチェック」、「削除」、「安全な削除」および「追加ファイルのチェック」オプションは、ファイル・システム(Webレイアウト・ファイル・リポジトリおよびボールト・ファイル・リポジトリ)の整合性をチェックするために使用されます。データベース内の情報を使用すると、これらのオプションによって、Revisions表内のすべてのファイルにはファイル・システムのアイテムに対応している正確なエントリが格納されていることを確認できます。ボールト・ファイル・リポジトリおよびWebレイアウト・ファイル・リポジトリ内で追加ファイルを検索するために、チェックを実行することもできます。

注意:
「ファイル・システムのチェック」オプションが選択されている場合のみ、「削除」、「安全な削除」および「追加ファイルのチェック」オプションはアクティブ化され、選択可能になります。

コンテンツ・サーバー・ファイル・システム(ボールト・ファイル・リポジトリおよびWebレイアウト・ファイル・リポジトリ)を分析するには、次の手順を実行します。

1. 「Content Serverアナライザ」の「構成」タブで、適用可能なオプションを選択します。

2. 「解析の開始」をクリックします。
結果は、「Content Serverアナライザ」の「進行状況」タブのコンソール領域に表示されます。解析手順の詳細は、第D.2.4.3項を参照してください。

D.2.4.7 解析の進行状況および結果の表示

「解析の開始」ボタンをクリックすると、「Content Serverアナライザ」の「進行状況」タブが自動的に表示されます。進行状況バーには、Content Serverアナライザが選択された分析オプションの処理を完了したタイミングが表示されます。次のイメージは、部分的に終了した分析を示しています。

解析プロセスが完了すると、結果は「進行状況」タブのコンソール領域に表示されます。結果は、選択した分析オプションに応じて異なります。次のコンソール領域のイメージは、データベース、検索索引およびファイル・システムのオプションを選択した場合の結果を示しています。

注意:
この例では、「レポートの生成」オプションは選択されていません。生成されたステータス・レポートの例は、第D.2.4.8項を参照してください。

図D-2 結果のコンソール表示の例

D.2.4.8 ステータス・レポートの生成

Content Serverアナライザによって生成されるステータス・レポートでは、リポジトリ内のコンテンツ・アイテムに関する統計が提供されます。ステータス・レポートの出力は、「進行状況」タブのコンソール領域に表示されます。

ステータス・レポートを生成するには、次の手順を実行します。

1. 「Content Serverアナライザ」の「構成」タブで、「レポートの生成」を選択します。

2. 「解析の開始」をクリックします。
解析プロセスが完了すると、「Content Serverアナライザ」の「進行状況」タブのコンソール領域に、標準的な解析結果の直後にステータス・レポート情報が表示されます。

D.2.4.9 ステータス・レポートの取消

解析プロセスの開始後に、レポート生成機能を抑制できます。解析プロセス中にコンテンツ・アイテムのステータス・レポートを取り消すには、次の手順を実行します。

1. 解析プロセス中に、Content Serverアナライザ・アプリケーションで、「取消」をクリックします。現在のタスクの終了後に取消を行うよう求められます。

2. 「はい」をクリックして、ステータス・レポートを抑制します。
「進行状況」タブのコンソール領域に表示される解析結果には、ステータス・レポートが含まれません。

D.2.5 デバッグ構成変数の使用

コンテンツ・サーバー・インスタンスでは、設定すると適切な診断情報をもたらすデバッグ構成変数IsDevelopmentEnvironmentも提供されます。この構成変数はインストール中およびコンテンツ・サーバー・インスタンスの更新時に、コンテンツ・サーバー・インスタンスの構成ファイル(IntradocDir/config/config.cfg)に設定されます。IsDevelopmentEnvironmentは、次のことを実行します。

- コンテンツ・サーバー・インスタンスをデバッグ・モードで実行する必要があるかどうかを定義します。

- スクリプト・エラーのトレースを有効にします。サービス・コールへのパラメータとして使用する場合、表示されるページの下部にスクリプト・エラー情報を追加できます。

同様にコンテンツ・サーバー・インスタンスの構成ファイル(IntradocDir/config/config.cfg)で設定されるデバッグ構成変数AlwaysReportErrorPageStackTraceは、エラーの発生時にコンテンツ・サーバーのインタフェースを表示するブラウザにスタック・トレースが報告されるよう指定します。

注意:
詳細は、『Oracle WebCenter Content構成リファレンス』を参照してください。

D.2.6 HDAファイルの分析

WebCenter Content管理者は、コンテンツ・サーバーの問題をトラブルシューティングする際に.hda (HDA)ファイルを分析する必要が生じる場合があります。HyperData (HDA)ファイルは、構造化された単純なASCIIファイル形式で、プロパティおよび表データを定義するために使用されます。これは、どのコンポーネントが有効および無効になっているか、またそのコンポーネントの定義ファイルがどこにあるかを判別するために、コンテンツ・サーバーによって使用されるテキスト・ファイル(ファイル名に含まれる接尾辞.hdaによって識別される)です。HDAファイル形式が役立つのは、頻繁に変わるデータです。それは、サイズがコンパクトで形式が単純であれば、コンテンツ・サーバーでデータ通信が、より高速かつ簡単になるからです。HDAの構造と使用方法の詳細は、『Oracle WebCenter Contentでの開発』を参照してください。

HDAを読み取るためのオプションの1つは、ページURLにIsPageDebug=1オプションを追加することです。IsPageDebug=1が使用されると、小さなグレーのタブがブラウザ・ウィンドウの右下隅に表示されます。タブをクリックすると展開されるため、表示する情報を選択できます。

- idocscript trace: 以前にOracle Universal Content Management 10gR1リリースのScriptDebugTrace=1変数で表示できたネストされたインクルードを表示します。

- initial binder: ページURLに&IsJava=1オプションを追加することで表示されるのと同様の、サービスから返されるローカル・データと結果セットを表示します。この表示では、結果は生HDA形式ではなく、読みやすいテーブルとしてフォーマットされます。

- final binder: ページ表示のためのすべてのインクルード(サービス・コールからだけではなく)を実行した後に、すべてのローカル・データと結果セットを表示します。

- javascript log: javascript関数とページ上で実行された回数についてレポートします。

詳細は、https://blogs.oracle.com/kyle/entry/what_do_you_mean_youにあるHDAが読めない場合のOracle Webページを参照してください。

D.3 Oracle WebCenter Contentのアーカイブのトラブルシューティング

この項では、コンテンツ・サーバーの一般的なアーカイブ問題に対する解決策を示します。サポートに問い合せる前に、お薦めされている解決策をお試しください。

この章の内容は、次のとおりです。

- 第D.3.1項「インポートの問題」

- 第D.3.2項「エクスポートの問題」

- 第D.3.3項「転送の問題」

- 第D.3.4項「レプリケーションの問題」

- 第D.3.5項「Oracle Databaseの問題」

- 第D.3.6項「その他の問題」

D.3.1 インポートの問題

この項の内容は次のとおりです。

- 第D.3.1.1項「インポート・システムでのファイル拡張子のエラー」

- 第D.3.1.2項「インポートでの特定のバッチ・ファイルの選択」

- 第D.3.1.3項「アーカイブのインポート後にインポート時の変更設定が機能しない」

- 第D.3.1.4項「アーカイブからのインポート済コンテンツ・アイテムの識別」

- 第D.3.1.5項「コンテンツ・サーバーの重複するコンテンツ・アイテム」

- 第D.3.1.6項「プロキシ・サーバーへのアーカイブ済コンテンツのインポートが失敗する」

- 第D.3.1.7項「インポート・エラーがないのにドキュメントが欠落する」

- 第D.3.1.8項「無効な選択リスト値に関するエラー」

- 第D.3.1.9項「必須フィールドの欠落によりインポートが失敗する」

- 第D.3.1.10項「変更されたメタデータ・フィールドによりインポート中にアーカイバがフリーズする」

D.3.1.1 インポート・システムでのファイル拡張子のエラー

現象

インポート先のシステムで、ドキュメントに関連する転送およびファイル拡張子の問題があることを示すエラーが発生します。

問題

次のエラーがアーカイバ・ログに発行されました。

Error: Event generated by user <user_name> at host <host_name>. File I/O error. Saving to file collection.hda. Write error.
Error: Import error for archive <archive_name> in collection <collection_name>:
Content item <item_name> was not successfully checked in. The primary and
alternate files must have different extensions.

推奨事項

エクスポート側のI/Oエラーによってバッチ・ファイルが破損したために、インポート側でのファイル拡張子エラーが発生しています。考えられる解決策は次のとおりです。

- テキスト・エディタでバッチ・ファイルを開いて、無効なデータがないか確認します。エクスポートしたcollection.hdaファイルを削除し、手動でエクスポートおよびインポート機能を再実行してみてください。

- エクスポート側のサーバーで、該当するcollection.hdaファイルを開いて、ファイル拡張子エラーの原因となったコンテンツ・アイテムに関連付けられている行を探します。これらのコンテンツ・アイテムのリビジョンによっては、代替ファイルの場所に示されたボールトの場所にネイティブ・ファイルが存在する可能性があります。代替ファイルにもフォーマット・エントリがある可能性があります。これらの行を削除して、ファイルを再インポートします。

- インポート側のサーバーで、コンテンツ・サーバーの構成ファイルconfig.cfg(IntradocDir/config/config.cfg)に代替拡張子構成設定を追加します。

1. IntradocDir/config/config.cfgファイルをテキスト・エディタで開きます。

2. General Option Variablesというセクションを見つけます。

3. 次の構成設定を入力します。
AllowSamePrimaryAlternateExtensions=true

この構成設定により、チェックインされたコンテンツ・アイテムは代替ファイルとプライマリ・ファイルの両方に同じドキュメント拡張子を使用できるようになります。

4. config.cfgファイルを保存して閉じます。

注意:
この構成設定をエクスポート側のサーバーのコンテンツ・サーバーconfig.cfg ファイルに追加することは、必須ではなくても、一般的な予防手段として行っておくと効果的です。

5. コンテンツ・サーバー・インスタンスを再起動します。

D.3.1.2 インポートでの特定のバッチ・ファイルの選択

質問

アーカイバ・ユーティリティの「一般」タブから特定のバッチ・ファイルを選択して再実行する際に、バックアップ目的で必要な他のファイルを削除せず残すにはどうすればよいですか。

推奨事項

最も効率的な方法は、新しいコレクションを作成して対象のアーカイブを新しいコレクションにコピーし、そこからインポートを実行することです。

D.3.1.3 アーカイブのインポート後にインポート時の変更設定が機能しない

現象

アーカイブ・コレクションへのインポート中に、値の変更を構成してメタデータ値を変更しました。しかし、転送後にインポート時の変更設定が機能しません。

問題

メタデータ値が構成済のメタデータ値変更を反映していませんでした。

推奨事項

ファイルをアーカイブにエクスポートし、後でそのアーカイブからインポートする場合に、メタデータ値の変更が保持されるようにするには、転送プロセスの両方の側で値の変更を構成する必要があります。つまり、ソース(エクスポート側)サーバーとターゲット(インポート側)サーバーの両方で、同じように値の変更を構成する必要があります。

D.3.1.4 アーカイブからのインポート済コンテンツ・アイテムの識別

質問

システム・クラッシュが発生したため、ドキュメントのコンテンツ情報(メタデータ)は変更せずに、古いアーカイブから新しいアーカイブにコンテンツをインポートする必要があります。この指定を使用するすべてのドキュメントが(実際は古いアーカイブから取得されたものであるが)新規のインポートであることを示すには、各コンテンツ・アイテムの先頭にどのように文字または数字を使用すればよいですか。

推奨事項

アーカイブ済のドキュメントは、再インポートして、他のインポート済コンテンツ・アイテムと区別するための適切なマークを付けることができます。これには、コンテンツIDメタデータ・フィールドを使用してインポート時の変更設定を適用します。インポート時の変更設定では、インポート中にメタデータ・フィールド間で値をどのようにコピーするかを構成できます。インポート時の変更設定を設定する手順は、次のとおりです。

1. アーカイバ・ユーティリティの「インポート時の変更設定」タブで、「フィールドの変更」セクションの「編集」をクリックします。

2. 「値マップの編集」ページで、「すべて」を選択します(「入力値」フィールドは空白のままにしておきます)。

3. 「フィールド」リストから「コンテンツID」を選択します。

4. 「出力値」フィールドに、X<$dDocName$>と入力します。
ここで、Xは再インポートされたコンテンツ・アイテムを区別するための文字または数字であり、dDocNameはドキュメントのコンテンツIDのデータベース表フィールド値です。

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

アーカイブを再インポートした後、Xに使用した文字または数字を各コンテンツ・アイテムのコンテンツIDに追加する必要があります。必ず、ソース(エクスポート側)サーバーとターゲット(インポート側)サーバーの両方に同じ値の変更を構成してください。これにより、ファイルがアーカイブからインポートされるときに、メタデータ値の変更が保持されます。

D.3.1.5 コンテンツ・サーバーの重複するコンテンツ・アイテム

現象

コンテンツ・アイテムをチェックインまたはインポートしようとすると、次のエラー・メッセージが発行されます。

Content item already exists.

推奨事項

このエラーは、コンテンツIDに対して同じ自動採番スキームを使用しているコントリビューション・サーバー間でアーカイブを行うと発行されます。次に例を示します。

- コンテンツID 003がコンテンツ・サーバー・インスタンスAにチェックインされ、その後でコンテンツ・サーバー・インスタンスBにアーカイブされたとします。あるファイルがコンテンツ・サーバー・インスタンスBにチェックインされた場合、次に自動生成された番号が003であると、エラーが発生します。

- コンテンツID 005 がコンテンツ・サーバー・インスタンスAとコンテンツ・サーバー・インスタンスBの両方にチェックインされたとします。この同じコンテンツ・アイテムがコンテンツ・サーバー・インスタンスAからコンテンツ・サーバー・インスタンスBにアーカイブされると、エラーが発生します。

考えられる解決策は次のとおりです。

- インポートされたファイルのコンテンツIDに接頭辞が追加されるように、インポート値の変更を設定します。詳細は、第D.3.1.4項を参照してください。

- 各コンテンツ・サーバー・インスタンスで、システム・プロパティ・ユーティリティを使用して、チェックインされたコンテンツ・アイテムに対する自動採番接頭辞を設定します。

1. システム・プロパティ・ユーティリティを起動します。

2. 「オプション」タブを開きます。

3. 「チェックイン時にコンテンツIDを自動割当てする」を選択します。

4. 「自動的に名前の前に付ける接頭辞」フィールドに対象の接頭辞を入力します。

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

6. コンテンツ・サーバー・インスタンスを再起動します。

D.3.1.6 プロキシ・サーバーへのアーカイブ済コンテンツのインポートが失敗する

現象

エクスポート済アーカイブからプロキシ・コンテンツ・サーバー・インスタンスにコンテンツをインポートしようとすると、インポートが失敗します。

推奨事項

アーカイバの問題の詳細は、(コンテンツ・サーバー・インスタンスの「管理」ページからアクセス可能な)アーカイバ・ログを開いて参照してください。これらのログには、メッセージのタイプと、記録されたメッセージに関する説明情報が示されています。

たとえば、アーカイバ・ログに、使用できないメタデータ・フィールド・オプション値がインポート問題に関連していると示されている場合、(「管理」ページからアクセス可能な)構成マネージャの「情報フィールド」タブで、メタデータ・フィールドの構成済オプション・リストに関する情報を確認できます。

この情報を使用して、エクスポート側サーバーとインポート側サーバーの両方で、オプション・リストと問題のメタデータ・フィールドを比較します。違いがある場合、一方のサーバーで修正を行えば両方のオプション・リストが同じになります。これにより、使用できないオプションによる不一致が解決されます。

D.3.1.7 インポート・エラーがないのにドキュメントが欠落する

現象

インポート機能を実行すると、エラーは発行されないのに、一部のドキュメントがインポートされません。

問題

開発サーバーから428個のドキュメントを構成情報(メタデータ・フィールド)とともにエクスポートしました。その後、アーカイブをメインの本番サーバーに転送し、インポートを実行しました。エラーが発行されなかったので、すべて正常に完了したと思っていました。ところが、ドキュメントを検索したところ、実際には最初の428個のうち198個しかインポートされていませんでした。

推奨事項

この問題の推奨される解決策は、次のとおりです。

- 検索索引にすべてのMicrosoft Wordドキュメントが含まれていることを確認します。
検索コンポーネントの特定のバージョンでは、検索索引に埋込みリンクがあるMicrosoft Wordドキュメントは除外されます。このため、これらのファイルは検索問合せで見つかりません。

影響を受けるドキュメントからすべての埋込みリンクを削除するか、次の構成設定をIntradocDir/config/config.cfgに追加できます。

CheckMkvdkDocCount=true

この構成設定により、すべてのWordファイルが検索索引に含められます。ただし、フルテキストではなくメタデータのみが含められます。

- 最初のドキュメント・セットをエクスポートしてみて、ソース・ファイルが削除されることを確認してください。その後、エクスポートしたアーカイブを再インポートします。

D.3.1.8 無効な選択リスト値に関するエラー

現象

インポートが失敗します。

問題

システムにより、無効な選択リスト値があることを示すエラー・メッセージが発行されます。現在、値の構成および管理には、依存選択リスト・アプレットのオプション・リストを使用しています。

推奨事項

オプション・リストに対して特定のメタデータ分類法が確立されたために、互いに依存するフィールドが存在していると考えられます。この場合、以前のオプション・リストで選択された値に基づいて、オプション・リスト内の特定の値が使用可能になります。ところが、アーカイバを使用する場合、オプション・リスト内の依存性がコンテンツ・サーバー・インスタンスのカスタム・メタデータ・フィールドの処理能力と競合することは明らかです。

この競合を回避する方法は、依存選択リスト・アプレットではなくコンテンツ・サーバー・インスタンスの構成マネージャ・ユーティリティを使用することです。このためには、構成マネージャの「情報フィールド」タブで、メタデータ・フィールドおよび対応するオプション・リスト値を入力する必要があります。

1. コンテンツ・サーバー・インスタンスに管理者としてログインします。

2. 「管理」→「構成マネージャ」を選択します。

3. 「構成マネージャ」ウィンドウで、「情報フィールド」タブを選択します。

4. 「追加」ボタンをクリックし、「カスタム情報フィールドの追加」ダイアログにメタデータ・フィールド名の1つを入力します。

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

6. 必要に応じて「カスタム情報フィールドの追加」ダイアログで残りのフィールドに入力します。

7. 「オプション・リスト・タイプ」フィールドで「NVタイプの選択リスト」オプションを選択します。

8. このオプションを使用すると、「オプション・リストの使用」フィールドに現在入力されている値と一致しない特定の値がコンテンツに含まれていても、コンテンツはその特定の値とともにチェックインされます。「オプション・リストの使用」フィールドには、ユーザーが特定のフィールドの値の選択に使用できる値リストの名前が示されます。

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

10. 「データベース設計の更新」をクリックします。

11. 「検索索引の再構築」をクリックします。

インポート・プロセスの継続中は、この方法を使用してください。

D.3.1.9 必須フィールドの欠落によりインポートが失敗する

現象

アーカイバを使用してドキュメントをエクスポートしました。その後、それらをインポートしようとすると、プロセスが失敗します。

問題

以前にエクスポートしたドキュメントをインポートしようとすると、コンテンツ・サーバーで、Companyメタデータ・フィールドが必要であることを示すエラーが発行されます。

推奨事項

コンテンツ・サーバー・インスタンスの構成マネージャ・ユーティリティを使用してCompanyフィールドを編集し、これを必須でないフィールドに設定する必要があります。

1. コンテンツ・サーバー・インスタンスに管理者としてログインします。

2. 「管理」→「構成マネージャ」を選択します。

3. 「構成マネージャ」ウィンドウで、「情報フィールド」タブを選択します。

4. 「フィールド情報」リストからCompanyメタデータ・フィールドを選択します。

5. 「編集」をクリックします。

6. 「カスタム情報フィールドの編集」ウィンドウで、「値が必要」の選択を解除します。

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

8. 「データベース設計の更新」をクリックします。

9. 「検索索引の再構築」をクリックします。

これで、アーカイブを正常に再インポートできるようになります。

D.3.1.10 変更されたメタデータ・フィールドによりインポート中にアーカイバがフリーズする

現象

製品名の一部が変更されたため、影響を受けるドキュメント内のメタデータ・フィールドの1つを更新する必要があります。古い製品名メタデータ・フィールドを含むすべてのドキュメントをエクスポートした後、新しい製品名メタデータ・フィールドを使用してドキュメントをインポートしようとしました。ところが、これを試行するたびに、アーカイバでは全体のアーカイブ・タスクのうち一部のみが処理され、その後停止します。

問題

アーカイバがフリーズすると、コンテンツ・サーバー・ユーザー・インタフェースのナビゲーションができなくなり、開いているブラウザをすべて停止する必要があります。また、ブラウザを停止してから5分間は、コンテンツ・サーバー・インスタンスにまったく接続できなくなります。この5分間が経過すると、コンテンツ・サーバー・インスタンスに再びアクセスできるようになります。

このフリーズの問題に加えて、次のエラー・メッセージが発行されます。

Stream error (299) - SKIPPING

推奨事項

1つ以上のプロセスがインポートを中断している可能性があります。次の操作により、問題が解決する可能性があります。

- メタデータ・フィールド・プロパティの確認

- 索引作成自動更新サイクルの確認

D.3.1.10.1 メタデータ・フィールド・プロパティの確認

構成マネージャで製品名メタデータ・フィールドが適切に更新されていない可能性があります。製品名のメタデータ・フィールドのタイプによっては、値の変更がロックアップ問題の原因となっていることがあります。製品名メタデータ・フィールドは(ロング)テキスト・フィールドのみか、それともオプション・リストにもなっているかを調べます。オプション・リストになっている場合は、対応するリストで新しい名前値が選択されていることを確認してください。

1. コンテンツ・サーバー・インスタンスに管理者としてログインします。

2. 「管理」→「構成マネージャ」を選択します。

3. 「構成マネージャ」ウィンドウで、「情報フィールド」タブを選択します。

4. 「フィールド情報」リストから製品名メタデータ・フィールドを選択します。

5. 「編集」をクリックします。

6. 「カスタム情報フィールドの編集」ウィンドウで、「フィールド・タイプ」の値が「テキスト」または「ロング・テキスト」であり、かつ「オプション・リストの有効化」が選択されていない場合は、「OK」または「取消」をクリックします(これにより、ロックアップの問題を回避できます)。
あるいは、

「オプション・リストの有効化」が選択されている場合、対応するリストで新しい製品名メタデータ・フィールド値が選択されていることを確認します。

1. 「オプション・リストの使用」フィールドを見つけて、「編集」をクリックします。

2. 「オプションリスト」ダイアログで、新しい製品名メタデータ・フィールド値を入力します。

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

7. (「カスタム情報フィールドの編集」ウィンドウで)再度「OK」をクリックします。

8. 「データベース設計の更新」をクリックします。

9. 「検索索引の再構築」をクリックします。

D.3.1.10.2 索引作成自動更新サイクルの確認

ロックアップの問題は、インデクサの自動更新サイクルが原因で発生する可能性があります。エラー・メッセージに、インデクサが接続を失ったために失敗したことが示されます。インデクサは5分ごとに自動更新サイクルを実行しますが、なんらかの理由で索引ファイルを取り込んでロックしてしまうことがあります。その場合、インポートの実行中に、インデクサの自動更新サイクルを無効にすると解決することがあります。

1. コンテンツ・サーバー・インスタンスに管理者としてログインします。

2. 「管理」→「リポジトリ・マネージャ」を選択します。

3. 「リポジトリ・マネージャ」ウィンドウで、「インデクサ」タブをクリックします。

4. タブの「自動更新サイクル」セクションで「構成」ボタンをクリックします。

5. 「自動更新サイクル」ウィンドウで、「インデクサの自動更新」の選択を解除します。

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

注意:
インポートの完了後、必ず自動更新サイクルを再びアクティブにしてください。そうしない場合、サーバーで自動的に索引データベースが更新されなくなるため、以降の検索結果に影響を及ぼすことがあります。

D.3.2 エクスポートの問題

この項の内容は次のとおりです。

- 第D.3.2.1項「「エクスポート問合せ」を空白にすると全部のエクスポートが可能」

- 第D.3.2.2項「新しいチェックインおよびバッチ・ファイル転送」

- 第D.3.2.3項「ユーザー属性のエクスポート」

- 第D.3.2.4項「コレクション表のレコード数が多すぎる場合にフォルダ・アーカイブ・エクスポートが機能しない」

D.3.2.1 「エクスポート問合せ」を空白にすると全部のエクスポートが可能

質問

エクスポートするコンテンツ・アイテムを定義するときにエクスポート問合せを作成しない場合、コンテンツ・サーバーのコンテンツ全部がエクスポートされますか。

推奨事項

はい、「エクスポート問合せ」セクションを空白のままにする(エクスポート問合せを定義しない)と、コンテンツ・サーバー・コンテンツは全部エクスポートされます。

D.3.2.2 新しいチェックインおよびバッチ・ファイル転送

質問

大規模なエクスポートを開始した後で、(エクスポートの完了前に)いくつかのドキュメントをコンテンツ・サーバーにチェックインした場合、それらのドキュメントはエクスポートに含められますか。それとも、アーカイバによりタイムスタンプ情報が読み取られ、新しいファイルが最初にエクスポートに割り当てられたファイルよりも最近のものであることが判別されて、エクスポートから除外されますか。また、エクスポート中にサーバー間の接続が中断されたり失われた場合、アーカイブ・エクスポートはどのようになりますか。

推奨事項

エクスポートの開始時に、アーカイバは、エクスポートするドキュメントのリストを作成するための問合せをシステムで実行します。この情報はキャッシュされ、エクスポート・アーカイブの作成に使用されます。このため、エクスポート・プロセス中にチェックインされた新しいドキュメントは、エクスポート問合せの定義と一致していても、エクスポートに含められません。

サーバー間の接続が中断された場合、ソース・サーバーでのエクスポート・プロセスは続行されますが、ターゲット・サーバーへの転送は停止されます。ソース・サーバーでは多数のバッチ・ファイルが累積されます。これらのファイルの転送を待機しながら、ソース・サーバーは定期的にターゲット・サーバーにpingを送信して接続を要求します。接続が再確立されると、累積されたバッチ・ファイルがターゲット・サーバーに転送されます。

自動(レプリケート)転送を使用している場合、バッチ・ファイルおよび関連付けられたコンテンツ・ファイルがソース・コンテンツ・サーバーから削除されます。手動転送を使用している場合、バッチ・ファイルおよび関連付けられたコンテンツ・ファイルはソース・コンテンツ・サーバー内に残ります。

D.3.2.3 ユーザー属性のエクスポート

質問

ユーザーをアーカイブでエクスポートするにはどうすればよいですか。

推奨事項

次のようにして、「ユーザー」データベース表からのユーザー属性を含むusers.hdaファイルをエクスポートできます。

1. コンテンツ・サーバー・インスタンスに管理者としてログインします。

2. 「管理」→「アーカイバ」を選択します。

3. 「アーカイバ」ウィンドウで、「データのエクスポート」タブを選択します。

4. 「追加データ」セクションで「編集」をクリックします。

5. 「追加データの編集」ダイアログで、「ユーザー構成情報のエクスポート」タブを選択します。

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

D.3.2.4 コレクション表のレコード数が多すぎる場合にフォルダ・アーカイブ・エクスポートが機能しない

現象

フォルダ・アーカイブのエクスポート機能を使用して、Site Studioで作成されたWebサイト階層を移動します。最初は、「仮想フォルダの管理構成」ページを使用して、問題なくフォルダをエクスポートできました。しかし、Webサイトが大きくなるにつれて、この機能が動作しなくなってきます。エクスポート手順の間、次のエラーが発行されます。

Error <timestamp> Event generated by user '<user>' at host '<host_name>'. Referred
to by http://<host>/intradoc-cgi/nph-idc_cgi.exe?IdcService= COLLECTION_GET_ADMIN_
CONFIG. Unable to retrieve content. Unable to execute service method
'loadCollectionArchive'. (System Error: Unknown error.)
Error <timestamp> IdcAdmin: Event generated by user '<user>' at host '<host>'.
Unable to obtain the console output. Unable to execute the service
'GET_SERVER_OUTPUT' on Content Server 'contribution'. Unable to receive request.
Response from host has been interrupted. Read timed out.

また、コンテンツ・サーバー出力コンソールにメモリー不足のエラーも表示されます。

<timestamp> SystemDatabase#Thread-13: SELECT * FROM Collections, ColMeta WHERE Collections.dCollectionID=ColMeta.dCollectionID AND dParentCollectionID=564
java.lang.OutOfMemoryError
Reporting error on thread Thread-13 occurring at <timestamp>.
java.lang.OutOfMemoryError
java.lang.OutOfMemoryError

問題

アーカイブ・ファイルとしてエクスポートされるフォルダ階層のサイズによっては、Java仮想マシン(JVM)のデフォルトのヒープ・サイズでは不十分な場合があります。

推奨事項

アプリケーション・サーバーでヒープ・サイズの設定を変更し、コンテンツ・サーバーにより多くのヒープ・メモリーを提供します。詳細は、該当するアプリケーション・サーバーのマニュアルを参照してください。

コンテンツ・サーバー・インスタンスの再起動後、アーカイブ・エクスポート機能は再び正常に機能するようになります。

D.3.3 転送の問題

この項の内容は次のとおりです。

- 第D.3.3.1項「ターゲットがロックアップして転送が停止される」

- 第D.3.3.2項「実行中の転送の中止/削除」

- 第D.3.3.3項「転送されたファイルの整合性の確認」

- 第D.3.3.4項「転送プロセスが機能しない」

D.3.3.1 ターゲットがロックアップして転送が停止される

現象

ターゲット・サーバーがロックアップして、自動転送機能が停止しました。

問題

ターゲット・サーバーを再起動すると、ログ・ファイルに、セキュリティ・グループに関する問題があったためにターゲット・サーバーへのインポートが行われなかったことを示すエラー・メッセージが記録されていました。

推奨事項

この場合は、転送を続行する前に、ターゲット・サーバー上のセキュリティ・グループ問題を修正する必要があります。次の2つの追加手順を実行することをお薦めします。

- 送信プロバイダの確認およびテスト

- コンテンツ・サーバーの再起動

D.3.3.1.1 送信プロバイダの確認およびテスト

送信プロバイダを確認してテストすると、送信プロバイダが適切に設定され、機能していることを確認できます。

1. 管理者としてソース・コンテンツ・サーバー・インスタンスにログインします。

2. 「管理」ページに移動し、「プロバイダ」リンクをクリックします。

3. 該当する送信プロバイダの「情報」リンクをクリックします。

4. 「送信プロバイダ情報」ページ上の情報を確認します。

5. 「プロバイダ」ページに戻り、送信プロバイダに対応する「テスト」リンクをクリックします。

D.3.3.1.2 コンテンツ・サーバーの再起動

ソース・サーバーまたはターゲット・サーバーで問題を修正した後、ソース・サーバーでの転送が停止する場合や、自動機能が動作しなくなる場合があります。いずれの場合も、コンテンツ・サーバー・インスタンスを再起動すると問題は解決されます。

D.3.3.2 実行中の転送の中止/削除

質問

誤って、非常に大きなファイルの本番コンテンツ・サーバー・インスタンスへの転送を開始してしまいました。実行中の転送プロセスを停止する最も効率的な方法は何ですか。

推奨事項

転送を中止または削除するには、次のような方法があります。

- 送信プロバイダの無効化

- 「転送先」タブからの転送の削除

- 自動転送の削除

D.3.3.2.1 送信プロバイダの無効化

実行中の転送を中止する最も速い方法は、ソース・サーバーの送信プロバイダを無効にすることです。

1. 管理者としてソース・コンテンツ・サーバー・インスタンスにログインします。

2. 「管理」ページに移動し、「プロバイダ」リンクをクリックします。

3. 「プロバイダ」ページで該当する送信プロバイダの「情報」リンクをクリックします。

4. 「送信プロバイダ情報」ページで、「無効化」ボタンをクリックします。

D.3.3.2.2 「転送先」タブからの転送の削除

「転送先」タブから転送を削除する手順は、次のとおりです。

1. 管理者としてソース・コンテンツ・サーバー・インスタンスにログインします。

2. 「管理」→「アーカイバ」を選択します。アーカイバ・ユーティリティが起動されます。

3. 「オプション」を選択し、「アーカイブ・コレクションを開く」を選択します。

4. リストから該当するコレクションを選択します。

5. 「開く」をクリックします。

6. 「アーカイバ」ウィンドウで、現在のアーカイブ・リストからソース・アーカイブを選択します。

7. 「転送先」タブを開きます。

8. 「転送先」セクションで「削除」をクリックします。

9. アクションを確認するプロンプトが表示されます。

10. 「はい」をクリックします。

D.3.3.2.3 自動転送の削除

「インスタンスの自動化の詳細」画面から自動転送を削除する手順は次のとおりです。

1. 管理者としてソース・コンテンツ・サーバー・インスタンスにログインします。

2. 「管理」→「アーカイバ」を選択します。アーカイバ・ユーティリティが起動されます。

3. 「オプション」を選択し、「インスタンスの自動化の詳細を表示する」を選択します。

4. 「インスタンスの自動化の詳細」ウィンドウで、「転送」タブを開きます。

5. 削除する自動転送を選択します。

6. 「削除」をクリックします。自動転送がリストから削除されます。

D.3.3.3 転送されたファイルの整合性の確認

質問

2つのサーバー間で転送されたファイルの整合性を確認するためには、どのようなアプローチが一番よいですか。当然ながら、ターゲット・コンテンツ・サーバー・インスタンスのドキュメントとソース・インスタンスのドキュメントは同一である必要があります。すべてのドキュメントが実際に転送されたことを確認し、転送されていないファイルがあれば、どのファイルの転送に失敗したかを判別する必要があります。

推奨事項

転送されたドキュメントがソース・サーバー上のドキュメントと同一であることを確認するために、2つのアイテムを簡単に確認できます。

- リビジョン表:
具体的には、両方のインスタンスでdDocName列とdRevLabel列の内容を照合し、両者が正確であり同じであることを確認します。

- ファイル・システム:
各サーバーで、ネイティブ・ファイル・リポジトリ

(DomainHome/ucm/cs/vault/content_type)

およびWeb表示可能ファイル・リポジトリ

(DomainHome/ucm/cs/weblayout/groups/public/documents/content_type)

を確認し、両者が正確であり同じであることを確認します。

D.3.3.4 転送プロセスが機能しない

現象

転送プロセスが適切に設定されません。

推奨事項

転送プロセスが正常に機能していない場合は、ソース・サーバー上の送信プロバイダを確認して、情報が正しいことを確認します。特に、サーバー・ホスト名が正しく、HTTPサーバー・アドレスと一致していることを確認してください。

ソース・サーバー上のサーバー・ホスト名を確認する手順は次のとおりです。

1. システム・プロパティ・ユーティリティを起動します。
./SystemProperties

2. 「インターネット」タブを開きます。

3. HTTPサーバー・アドレスを書き留めます。

4. 「管理」ページに移動し、「プロバイダ」をクリックします。

5. 「プロバイダ」ページで該当する送信プロバイダの「情報」リンクをクリックします。

6. 「送信プロバイダ情報」ページで、サーバー・ホスト名が「システム・プロパティ」のHTTPサーバー・アドレス設定と完全に一致していることを確認します。

7. サーバー・ホスト名の設定がHTTPサーバー・アドレスと異なっている場合は、「編集」ボタンをクリックします。

8. 必要に応じて「サーバー・ホスト名」設定を変更します。

9. 「更新」をクリックします。

10. コンテンツ・サーバー・インスタンスを再起動します。

D.3.4 レプリケーションの問題

このセクションの内容は次のとおりです。

- 第D.3.4.1項「自動インポート機能の停止」

D.3.4.1 自動インポート機能の停止

質問

自動インポート機能を停止するにはどうすればよいですか。

推奨事項

コンテンツが指定された基準を満たした場合、自動インポータはデフォルトで5分ごとにインポートを自動実行するように構成されています。ただし、自動インポート機能は次の2つの方法で無効化できます。

- 「レプリケーション」タブからのインポータの登録解除

- 「インスタンスの自動化」ページからの登録済インポータの削除

D.3.4.1.1 「レプリケーション」タブからのインポータの登録解除

「レプリケーション」タブからインポータを登録解除する手順は次のとおりです。

1. 管理者としてソース・コンテンツ・サーバー・インスタンスにログインします。

2. 「管理」→「アーカイバ」を選択します。
アーカイバ・ユーティリティが起動されます。

3. 現在のアーカイブ・リストからアーカイブを選択します。

4. 「レプリケーション」タブを選択します。

5. 「登録解除」をクリックします。
選択したアーカイブの自動インポート機能が無効になります。

D.3.4.1.2 「インスタンスの自動化の詳細」ページからの登録済インポータの削除

「インスタンスの自動化の詳細」ページから登録済インポータを削除する手順は次のとおりです。

1. 管理者としてソース・コンテンツ・サーバー・インスタンスにログインします。

2. 「管理」→「アーカイバ」を選択します。アーカイバ・ユーティリティが起動されます。

3. 「オプション」を選択し、「インスタンスの自動化の詳細を表示する」を選択します。

4. 「インスタンスの自動化の詳細」ウィンドウで、「インポータ」タブを開きます。

5. 削除する登録済インポータを選択します。

6. 「削除」をクリックします。
登録済インポータがリストから削除されます。

D.3.5 Oracle Databaseの問題

このセクションの内容は次のとおりです。

- 第D.3.5.1項「割り当てられた表領域の超過」

- 第D.3.5.2項「Oracle DatabaseのOracle WebCenter Contentのパフォーマンスの低下」

D.3.5.1 割り当てられた表領域の超過

現象

ファイルを転送できません。ファイルを転送しようとするたびに、最大エクステントのエラー・メッセージが表示されます。

問題

次のエラー・メッセージ(または類似のメッセージ)が発行されます。

IdcApp: Unable to execute query '<query_name>'. Error: ORA-01631: max # extents (50) reached in table <table_name>.
ORA-01631 max # extents (<text_string>) reached in table <table_name>.

推奨事項

コンテンツ・サーバー・インスタンスでは、データベース表領域の作成時に50エクステントのみが割り当てられます。データベースが大きくなり、索引作成が繰り返されるにつれて、より多くの領域(エクステント)が使用されます。遂には、50エクステントの制限を超過します。転送中に、1つのファイルの拡大で最大エクステントの制限を超える瞬間があります。この場合は、解決策として次のうち1つ以上を実施してください。

- 非常に大きなWebレイアウト問合せを探して削除し、転送を再試行します。

- コンテンツ・サーバー・ユーザーにコンテンツ・サーバー・スキーマへの適切な権限(リソースおよび接続)が付与されていない可能性があります。そのユーザーが一時表領域を所有している可能性があり、デフォルトの表領域はコンテンツ・サーバーのデフォルトに設定されています。

- システムの最大エクステントの制限がシステムの最大値より低い場合は、使用可能なエクステント数を増やす必要があります。表領域エクステントを増やすための適切なOracle SQLコマンドについては、Oracle Databaseのドキュメントを参照するか、データベース管理者に問い合せてください。

- オプションで、より大きい初期エクステント、次エクステントまたはパーセントを使用してデータベースを再作成し、表領域のパラメータを大きくすることもできます。この場合は、初期エクステントおよび次エクステントを1Mbに設定することをお薦めします。パラメータの拡大率を(PCTINCREASE)を0%に設定すると、表は必要に応じて自動的に拡大されます。

D.3.5.2 Oracle DatabaseのOracle WebCenter Contentのパフォーマンスの低下

現象

Oracle WebCenter Contentインスタンスの実行速度が遅いです。アプリケーション・サーバーのメモリーとCPUの使用率を確認しましたが、リソースは十分です。何が間違っているでしょうか。

推奨事項

Oracle WebCenter Contentインスタンスはアプリケーション・サーバーで実行されており、バックエンドのデータベース・サーバーに依存しています。アプリケーション・サーバー層が正常に実行されている場合は、データベース・サーバー層が問題の原因となるものをホストしている可能性があります。多数の要因によりパフォーマンスの問題が引き起こされている場合がありますが、アクティブなEnterprise Content Managementシステムでは、データベースの統計情報を更新し続けることが非常に重要になります。

Oracle Databaseには、データベース問合せをより効率的にするのに役立つ、一連の組込みオプティマイザ・ユーティリティがあります。ただし、オプティマイザの効率を最大にするために、表とそれに関連する索引の物理特性に関する統計を、更新または再作成することを強くお薦めします。詳細は、次の資料を参照してください。

https://blogs.oracle.com/ATEAM_WEBCENTER/entry/gathering_statistics_for_an_oracle

D.3.6 その他の問題

この項の内容は次のとおりです。

- 第D.3.6.1項「共有ファイル・システムを使用するアーカイブが機能しない」

- 第D.3.6.2項「送信プロバイダを経由するアーカイブが機能しない」

D.3.6.1 共有ファイル・システムを使用するアーカイブが機能しない

現象

2つのコンテンツ・サーバー・インスタンス間で共有ファイル・システムにアクセスする転送を試行していますが、成功しません。

推奨事項

共有ファイル・システム上のコンテンツ・サーバー・インスタンス間で転送を行う場合、マップまたはマウントされたドライブが両方のコンテンツ・サーバー・インスタンスで使用可能になっている必要があります。つまり、これらのコンピュータが稼働中であり、どちらのコンテンツ・サーバー・インスタンスにもシステム・アクセスできるユーザーとしてログインしている必要があります。次のすべての条件が満たされていることを確認してください。

- 両方のコンピュータが起動されています。

- 両方のコンピュータが、どちらのコンテンツ・サーバー・ファイル・システムにもシステム・アクセスできるユーザーとしてログインしている必要があります。

- 共有ドライブが、コンテンツ・サーバー・インスタンスに認識されるように適切にマップまたはマウントされています。コンピュータへのネットワーク・アクセスだけでは不十分です。

D.3.6.2 送信プロバイダを経由するアーカイブが機能しない

現象

2つのコンテンツ・サーバー・インスタンス間で送信プロバイダを経由する転送を試行していますが、成功しません。

推奨事項

送信プロバイダが設定されているコンテンツ・サーバー・インスタンスはローカル・サーバーとみなされ、送信プロバイダのターゲット・コンテンツ・サーバー・インスタンスはプロキシ・サーバーとみなされます。ファイルは常に、送信プロバイダの方向、つまりローカル(ソース)インスタンスからプロキシ(ターゲット)インスタンスに転送されます。

ソース・コンテンツ・サーバー・インスタンスで送信プロバイダが追加されて定義されたときに、「プロキシ」チェック・ボックスが選択された可能性があります。ところが、両方のコンテンツ・サーバー・インスタンスの相対Webルートが同じであると、送信プロバイダは混乱します。「プロキシ」チェック・ボックスは、ターゲット・コンテンツ・サーバー・インスタンスがローカル(マスター)コンテンツ・サーバー・インスタンスの実際のプロキシとしてインストールされた場合にのみ選択します。両方のコンテンツ・サーバー・インスタンスの相対Webルートが同じである場合は、このサーバー・オプションを選択しないでください。

D.4 My Oracle Supportを使用したその他のトラブルシューティング情報

Oracle Fusion Middlewareの問題の解決にMy Oracle Support (以前のMetaLink)を使用できます。My Oracle Supportには、次のような有用なトラブルシューティング・リソースが含まれています。

- ナレッジ・ベース記事

- コミュニティ・フォーラムとディスカッション

- パッチとアップグレード

- 動作保証情報

注意:
My Oracle Supportを使用してサービス・リクエストを記録することもできます。

My Oracle Supportにはhttps://support.oracle.com">>https://support.oracle.comからアクセスできます。

Oracleの法律上の注意点

コピーライト

Copyright © 1994-2018, 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およびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても一切の責任を負いかねます。

Pre-General Availability (一般提供前)版のドキュメントについて

このドキュメントがPre-General Availability (一般提供前)版の場合:

このドキュメントはPre-General Availability (一般提供前)版であり、デモおよび暫定使用のみを目的としたものです。このソフトウェアを使用するハードウェアに限定するものではありません。Oracle Corporationおよびその関連会社は、このドキュメントに関して一切の責任を負わず、いかなる保証もいたしません。また、このドキュメントを使用したことによって損失、費用、あるいは損害が発生しても、一切の責任を負いかねます。

非公開のPre-General Availability (一般提供前)版のドキュメントについて

このドキュメントが非公開のPre-General Availability (一般提供前)版の場合:

このドキュメントに含まれる情報は、情報の共有のみを目的としたものであって、顧客諮問委員会(Customer Advisory Board)のメンバーとしてのお客様の立場でのみ、またはお客様のPre-General Availability Trial Agreement (Pre-GAトライアル契約)のみに従って検討されるべきものとします。マテリアル、コード、または機能の提供をお約束するものではなく、購入決定を行う際の判断材料とすべきではありません。このドキュメントに記載されている特徴または機能の開発、リリースおよび時期については、オラクルの裁量により決定されます。

このドキュメントには、ソフトウェアまたは印刷物などの形式を問わず、オラクルが独占的な権利を有する財産的情報が含まれています。この機密資料へのアクセスと使用は、お客様とオラクルとの間で締結され、お客様が遵守に同意した、Oracle Master Agreement、Oracle License and Oracle Services Agreement (オラクル・ライセンスおよびサービスに関する契約書)、Oracle Partner Network 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)を参照してください。