8 WebCenter Portal用の検索の構成

検索を構成して、WebCenter Portalのオブジェクトの索引付けと検索を行います。

ノート: 検索を実行する前に、ポータル・スケジューラを実行して、検索の結果が正しく表示されることを確認する必要があります。

権限: この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdminロール、WebCenter Portal管理を使用して付与されるAdministratorロールが付与されている必要があります。

ロールと権限の詳細は、「管理操作、ロールおよびツールの理解」を参照してください。

ノート: リリース12c (12.2.1.4.0)からは、Oracle WebCenter PortalでのOracle SESのサポートは非推奨になりました。以前のリリースからアップグレードした場合、Oracle SESを使用するように、アップグレードしたインスタンスを構成できます。このケースでは、Elasticsearchを使用するようにWebCenter Portalを構成する必要があります。

トピック:

親トピック: ツールおよびサービスの管理

WebCenter Portalでのクロール管理ユーザーの作成

Elasticsearchを使用して検索するには、WebCenter Portalとバックエンドのアイデンティティ管理サーバーで、既存のユーザーをクロール管理に指定するか、クロール管理ユーザー(mycrawladminなど)を作成します。クロール管理ユーザーは一度だけ作成する必要があります。

ノート: ユーザーの作成方法の詳細は、ご使用のアイデンティティ管理システムのドキュメントを参照してください。

次の例では、Oracle Directory Services Managerを使用してmycrawladminユーザーを作成します。

「データ・ブラウザ」タブで、ターゲットcnに移動し、「作成」をクリックします。

この例では、"dc=com,dc=oracle,dc=us,cn=Users"に移動します。
「オブジェクト・クラスの追加」ダイアログで、該当するオブジェクト・クラスを選択し、「OK」をクリックします。
識別名(DN)パスを見つけて、「選択」をクリックします。

この例では、"dc=com,dc=oracle,dc=us,cn=Users"を選択します。
「新規エントリの作成」ダイアログで、プロパティを入力し、「次へ」をクリックします。
新規エントリが正常に作成されたことを確認したら、「終了」をクリックします。

Elasticsearchとの統合

Elasticsearchを構成して、WebCenter Portalのオブジェクトの索引付けと検索を行います。

トピック:

Elasticsearchでの検索の理解

Elasticsearchは高度にスケーラブルな検索エンジンです。大量のデータを迅速に保存、検索および分析でき、HTTP WebインタフェースとスキーマレスなJSONドキュメントを使用する分散型マルチテナント対応の全文検索エンジンを備えています。

Elasticsearchの利点

Elasticsearchは、Luceneに組み込まれている機能と同様の全文検索機能を備えています。
Elasticsearchはドキュメント指向型です。データを構造化されたJSONドキュメントとして保存し、すべてのフィールドがデフォルトで索引付けされるため、優れたパフォーマンスを実現します。
ElasticsearchはAPI指向であり、シンプルなRestful APIを使用して処理の実行が可能です。
Elasticsearchでは、テキストを直接検索するかわりに索引を検索するので、検索結果を高速に取得します。

WebCenter Portalでは、Elasticsearchを構成して次のリソースを検索できます。

ドキュメント(Wikiおよびブログを含む)
ポータル、ページ・メタデータ、ページ・コンテンツ(HTML、テキストおよびスタイル・テキスト・コンポーネントのコンテンツ)、リストおよび人的リソース

Elasticsearchの構成の前提条件

次の要件を確認してください。

Oracle WebCenter Portalがインストールされていること。
オプション検索にWebCenter Contentを使用する場合は、WebCenter Contentが構成され、必要なコンポーネントがすべて有効になっていることを確認してください。「Oracle WebCenter Content Serverへの接続の管理」を参照してください。

WebCenter PortalでのElasticsearchの構成ロードマップ

表8-1 ロードマップ - WebCenter PortalでのElasticsearchの設定

担当者	タスク
管理者	WebCenter Portalでのクロール管理ユーザーの作成
管理者	Elasticsearchのインストール
管理者	WebCenter Contentの検索の構成
管理者	WebCenter Portalの検索の構成
管理者	検索クローラの構成
管理者	(オプション) WebCenter Portal管理での検索設定のカスタマイズ
管理者	(オプション)検索のグローバル属性の変更
管理者	(オプション)検索のカスタム属性の構成
管理者	(オプション)カスタム・ファセットの作成

Elasticsearchのインストール

次のトピックでは、HTTPSを使用して単一サーバーを設定し、セキュリティ保護する方法について説明します。

単一サーバーの設定

ノート: Elasticsearch 7.17.xがすでにインストールされ、WebCenter Content Server用に構成されている場合は、WebCenter Portalにも同じものを使用でき、以下はスキップできます。ただし、WebCenter ContentのElasticsearchへの接続に使用するユーザー名は、WebCenter Portalのクロール管理ユーザーとして設定する必要があります。「WebCenter Portalでのクロール管理ユーザーの作成」を参照してください。

単一サーバー設定をインストールするには、まずElasticsearchリリースからElasticsearch 7.17.xバイナリをダウンロードする必要があります。Bashシェルが使用されていることを確認してから、次のステップに従います。

設定する環境変数

#For Linux
export ES_JAVA_HOME="Set the value to the Java home directory used to install WebCenter Portal"

#For Windows
set ES_JAVA_HOME="Set the value to the Java home directory used to install WebCenter Portal"

ORACLE_HOME/wcportal/es/secureES.propertiesファイルを編集し、プロパティの値を指定します。

secureES.properties

# A valid user name configured with crawler privileges.
SEARCH_APP_USER=
#
# Name of the Elasticsearch cluster. Default value is CURRENT_HOST_NAME and it will be replaced with current hostname. This default is appropriate for single-host environment only.
# If this value is changed, make sure that you don't reuse the same cluster names in different environments. Otherwise, you might end up with nodes joining the wrong cluster.
# Cluster name should be environment-specific and unique across your enterprise.
ELASTIC_SEARCH_CLUSTER_NAME=CURRENT_HOST_NAME
#
# Name of the Elasticsearch node. Default value is CURRENT_HOST_NAME and it will be replaced with current hostname. This default is appropriate for single-host environment only.
# If this value is changed, make sure that you don't reuse the same node name within the Elasticsearch cluster.
ELASTIC_SEARCH_NODE_NAME=CURRENT_HOST_NAME
#
# HTTP port of Elasticsearch server. Default value is 9200.
ELASTIC_SEARCH_PORT=9200
#
# Elasticsearch network host. Default value is 0.0.0.0 and it means Elasticsearch server will listen on all network interfaces.
# If you have a requirement to limit traffic on multi-homed hosts with multiple network interfaces, set to a specific hostname, IP address, or network interface name.
# If network interface name is to be specified, it should be specified as: _[networkInterface]_, for example _eth0_.
ELASTIC_SEARCH_NETWORK_HOST=0.0.0.0
#
# Elasticsearch home directory. It is the directory which contains bin,config,logs etc directories
ELASTIC_SEARCH_HOME=
#
# Transport port of Elasticsearch server. Default value is 9300.
# This configuration is used for internal communication between nodes within the cluster.
ELASTIC_SEARCH_TRANSPORT_PORT=9300
#
#
##########################################################################################################################################################################
#
# NOTE: The following properties are required/applicable only if setting up a cluster.
#
##########################################################################################################################################################################
#
# Elasticsearch cluster discovery host list. All the hosts that will be part of the cluster should be configured in this list.
# Each host should be declared by the appropriate fully-qualified hostname.
# Each host should be formatted in double-quotes separated with a comma and space. The list should be wrapped in square-brackets. For example, ["host1.example.com", "host2.example.com"].
ELASTIC_SEARCH_CLUSTER_HOST_LIST=
#
# Elasticsearch cluster discovery node list. All the nodes that will be part of the cluster should be configured in this list.
# Each node should be declared by the corresponding value of ELASTIC_SEARCH_NODE_NAME specified during the installation.
# Each node should be formatted in double-quotes separated with a comma and space. The list should be wrapped in square-brackets. For example, ["node-1", "node-2"].
ELASTIC_SEARCH_CLUSTER_NODE_LIST=
#
# The name of the certificate which will be generated and used for the secure communication between the nodes of the cluster.
# The certificate generated is of PKCS#12 format. Hence the certificate extension should be .p12 only.
ELASTIC_SEARCH_CERTIFICATE_NAME=node-certificate.p12
#
# The primary host of Elasticsearch cluster. This should be one of the hosts in ELASTIC_SEARCH_CLUSTER_HOST_LIST.
# Only during installation on this host, the certificate specified in ELASTIC_SEARCH_CERTIFICATE_NAME and user specified in SEARCH_APP_USER are created.
# The configured value should be fully-qualified hostname.
ELASTIC_SEARCH_PRIMARY_HOST=

次のコマンドを入力して、Elasticsearchをインストールします:

For Linux:
ORACLE_HOME/oracle_common/common/bin/wlst.sh ORACLE_HOME/wcportal/es/secureESNode.py ORACLE_HOME/wcportal/es/secureES.properties

For Windows:
ORACLE_HOME\oracle_common\common\bin\wlst.sh ORACLE_HOME\wcportal\es\secureESNode.py ORACLE_HOME\wcportal\es\secureES.properties

次に、Linuxに正常にインストールされた場合の出力例を示します:

セキュリティ構成スクリプト

Initializing WebLogic Scripting Tool (WLST) ...



Welcome to WebLogic Server Administration Scripting Shell

Type help() for help on available commands

Please provide a password for search application user [username = wccrawladmin]:

Please provide a password for certificate 'node-certificate.p12':

Generating node certificate for secured communication...
Node certificate generated and password added to elasticsearch keystore successfully.
Successfully updated the elasticseach.yml file
Creating the user wccrawladmin in Elasticsearch server...
Starting elastic search server
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100    82  100    23  100    59     15     39  0:00:01  0:00:01 --:--:--    39
Stopped elastic search server
The user wccrawladmin is created successfully.
Starting elastic search server
Elasticsearch server security configuration is complete.

正常にインストールされたら、Elasticsearchが正しく構成されていることを確認します。
1. Mozilla Firefoxブラウザを使用して、URL http://host:9200にアクセスします。
  
  ユーザー名とパスワードを入力する基本認証ダイアログが表示されます。
2. WebCenter Portalで作成したクロール・ユーザー名とパスワードを入力します。「WebCenter Portalでのクロール管理ユーザーの作成」を参照してください。
  
  正常にログインできれば、Elasticsearch Serverは正しく構成されています。
Elasticsearchを起動/停止するには、次のコマンドを使用します。

Elasticsearchの起動:
```
# For Linux:
# To run Elasticsearch as a daemon     
cd $ELASTIC_SEARCH_HOME; bin/elasticsearch -d -p pid


#For Windows:
#Start Elastic search
cd $ELASTIC_SEARCH_HOME; bin\elasticsearch -p pid
```
ログ・メッセージは、$ELASTIC_SEARCH_HOME/logs/directoryにあります。

Elasticsearchを停止するには、pidファイルに記録されたプロセスIDを強制終了します。
```
#For Linux:
pkill -F <pid>

#For Windows
taskkill /pid <pid> /f
```

HTTPSを使用したElasticsearchの保護

Elasticsearch 7.xサーバーは、クライアントとElasticsearchサーバー間の通信がSSLを介して発生するように、HTTPSを使用して保護できます。構成するには、次のステップが必要です:

Elasticsearchサーバーを停止します。
次の環境変数を設定します。
- ES_HOME - これをElasticsearchホーム・ディレクトリに設定します。
- ES_JAVA_HOME - これをJavaホーム・ディレクトリに設定します。
- PATH - $ES_JAVA_HOME/binを使用するように更新します。
Elasticsearchサーバーの証明書と秘密キーを生成します。プロンプトが表示されたら、証明書のパスワードを指定します。
```
$ES_HOME/bin/elasticsearch-certutil cert -s -out $ES_HOME/config/https-certificate.p12 --dns <DNS_name>
```
<DNS_name>は、Elasticsearchサーバーの完全修飾ホスト名です。

上で使用されるパスワードは、Elasticsearchキーストアに格納する必要があります。次のコマンドを実行して、パスワードを格納します。

$ES_HOME/bin/elasticsearch-keystore add xpack.security.http.ssl.keystore.secure_password
$ES_HOME/bin/elasticsearch-keystore add xpack.security.http.ssl.truststore.secure_password

次の構成を$ES_HOME/config/elasticsearch.ymlファイルに追加します。

xpack.security.http.ssl.enabled: true
xpack.security.http.ssl.verification_mode: certificate
xpack.security.http.ssl.keystore.path: https-certificate.p12
xpack.security.http.ssl.truststore.path: https-certificate.p12

Elasticsearchサーバーを起動します。

WebCenter Portalキーストアへの証明書の追加

クライアントとサーバー間の信頼を確立するには、Elasticsearchサーバー証明書をWebCenter Portalキーストアに追加する必要があります。

Elasticsearchサーバーからの証明書のダウンロード

次のステップを使用して、Elasticsearchサーバーから証明書を取得できます:

Firefoxブラウザを開き、次のコマンドを使用してElasticsearchサーバーに接続します:
```
https://host_name:9200
```
ここで、host_nameはElasticsearchサーバーの名前です。
セキュリティ例外を受け入れて続行します。プロンプトが表示されたら、ログイン資格証明を指定します。
「URL」フィールドで「ロック」アイコンをクリックし、「安全でない接続」、「詳細情報」の順に移動します。
ポップアップ・ウィンドウで、「証明書の表示」ボタンをクリックします。
「PEM (証明書)」リンクをクリックして、.PEM形式で証明書をダウンロードします。

WebCenter Portalキーストアへの証明書の追加

証明書がダウンロードされたら、WebCenter Portalキーストアにインポートする必要があります。

インポートするには:

WebCenter Portalサーバーで次のコマンドを実行し、プロンプトが表示されたらキーストアのパスワードを入力します:
```
keytool -importcert -alias es_cert -file /filepath/sslcertificate/es_certificate.pem -keystore <JDK_path>/jre/lib/security/cacerts
```
管理対象サーバーを再起動します。

WebCenter Portalカスタム信頼キーストアへの証明書の追加

追加するには、次のようにします。

次のコマンドを実行します。

keytool -importcert -alias es_cert -file /filepath/sslcertificate/es_certificate.pem -keystore <Custom Trust Key Store File Name>

この画像は、カスタム信頼キーストアのファイル名を示しています。

管理およびWC_Portalサーバーを再起動します。

HTTPSで実行されているElasticsearchサーバーへの接続の検索

検索接続が存在しない場合、HTTPSで実行されているElasticsearchサーバーへの検索接続は、次のコマンドを使用して作成できます:

createSearchConnection(appName='webcenter', name='<conn_name>', url='https://<ES_host>:<ES_port>', indexAliasName='<index_alias>', appUser='<app_user>', appPassword='<app_user_password>')

検索接続がすでに存在する場合は、HTTPSを使用するように更新する必要があり、次のコマンドを使用して実行できます:

setSearchConnection(appName='webcenter', name='<existing_conn_name>', indexAliasName='<existing_index_alias>', appUser='<app_user>', appPassword='<app_user_password>', useSSL=1)

OpenSearchを使用したOCI検索サービスとの統合

OpenSearchを構成して、WebCenter Portalのオブジェクトの索引付けと検索を行います。

トピック:

OpenSearchを使用したOCI検索サービスの理解

OpenSearchを使用したOracle Cloud Infrastructure (OCI)検索サービスは、Oracle管理サービスとして提供されるインサイト・エンジンです。停止時間なしで、サービスのパッチ適用、更新、アップグレード、バックアップおよびサイズ変更がOracleによって自動化されます。大量のデータをすばやく格納、検索および分析し、結果をほぼリアルタイムで確認できます。

OCI Search Serviceは、実績のあるOpenSearchテクノロジとOCIの柔軟性を兼ね備えています。

WebCenter Portalでは、OpenSearchを使用したOCI検索サービスを構成して次のリソースを検索できます:

ドキュメント(Wikiおよびブログを含む)
ポータル、ページ・メタデータ、ページ・コンテンツ(HTML、テキストおよびスタイル・テキスト・コンポーネントのコンテンツ)、リストおよび人的リソース
お知らせおよびディスカッション(以前のリリースからアップグレードされたポータルでのみ使用可能)。

ノート: Oracle WebCenter Portalは、オンプレミスでホストして実行できますが、WebCenter Portalをクラウドで実行する際にOCI OpenSearchとの統合を最大限に活用するために、WebCenter PortalをOCIにホストすることを常にお薦めします。

OpenSearchを使用したOCI検索サービスを構成するための前提条件

次の要件を確認してください。

OCIテナンシの詳細を取得します。

Oracle Cloudコンソールで必要なサービス・ポリシーを作成し、ニーズに合せてカスタマイズします。たとえば、任意のユーザーを目的のグループに変更し、必要に応じてコンパートメントへのパスを指定します。

機能するポリシー:

Allow group <your_group> to manage opensearch-family in compartment opensearch
Allow service opensearch to manage vcns in compartment opensearch
Allow service opensearch to manage vnics in compartment opensearch
Allow service opensearch to use subnets in compartment opensearch
Allow service opensearch to use network-security-groups in compartment opensearch    

パブリック・サブネットとプライベート・サブネットを持つVCNを作成します。
- 簡略化したプロセス:
  1. Oracle Cloudコンソールのナビゲーション・メニューを開きます。
  2. 「ネットワーキング」をクリックし、「仮想クラウド・ネットワーク」をクリックします。
  3. 「VCNウィザードの起動」をクリックし、「インターネット接続性を持つVCNの作成」をクリックします。
- カスタム・プロセス:
  1. Oracle Cloudコンソールのナビゲーション・メニューを開きます。
  2. 「ネットワーキング」をクリックし、「仮想クラウド・ネットワーク」をクリックします。
  3. 「VCNの作成」をクリックし、必要な詳細を指定します。

WebCenter PortalでのOpenSearchを使用したOCI検索サービスの構成ロードマップ

表10-4 ロードマップ - WebCenter PortalでのOpenSearchを使用したOCI検索サービスの設定

担当者	タスク
管理者	WebCenter Portalでのクロール管理ユーザーの作成
管理者	OCIでのOpenSearchインスタンスの作成
管理者	WebCenter Portalキーストアへの証明書の追加
管理者	WebCenter Contentの検索の構成
管理者	WebCenter Portalの検索の構成
管理者	検索クローラの構成
管理者	(オプション) WebCenter Portal管理での検索設定のカスタマイズ
管理者	(オプション)検索のグローバル属性の変更
管理者	(オプション)検索のカスタム属性の構成
管理者	(オプション)カスタム・ファセットの作成

OCIでのOpenSearchインスタンスの作成

タスク1: OCI検索サービス・クラスタの作成

Oracle Cloudコンソールのナビゲーション・メニューを開きます。「データベース」、OCI検索サービスの順にクリックし、「クラスタ」をクリックします。次に、「クラスタの作成」をクリックします。クラスタを作成するクラスタ名とコンパートメントを選択します。
「次」をクリックします。
セキュリティを構成します。ユーザー名は、上で作成したクロール管理ユーザーと同じにする必要があります。
クラスタのサイズ設定を選択し、「次」をクリックします。
作成したVCNを選択し、プライベート・サブネットを選択します。
「次」をクリックします。クラスタの作成後、OCI検索サービス・クラスタの詳細ページで、APIエンドポイントと、代替で使用できるIPアドレスをメモします。

タスク2: OpenSearchインスタンスにアクセスするためのセキュリティ・ルールの作成

Open Searchインスタンスのセキュリティ・リストを作成します:
1. Oracle Cloudコンソールのナビゲーション・メニューを開きます。
2. 「ネットワーキング」をクリックし、「仮想クラウド・ネットワーク」をクリックします。
3. WebCenter Portalインスタンスが作成されたVCNを開きます。
4. リソースのリストから「セキュリティ・リスト」を選択します。
5. 「セキュリティ・リストの作成」をクリックします。
6. セキュリティ・リストの名前とコンパートメントを指定します。例: OpenSearch_Security_Listのような名前を指定し、WebCenter Portalインスタンスを作成するコンパートメントを選択します。
7. 次のイングレス・ルールを追加します:
  1. ステートレス: これは選択を解除したままにします(すべてのルールはステートフルであることが必要なため)。
  2. ソース・タイプ: CIDR
  3. ソースCIDR: 0.0.0.0/0
  4. IPプロトコル: TCP
  5. ソース・ポート範囲: All
  6. 宛先ポート範囲: 9200
OpenSearchインスタンスで使用するサブネットに新しいセキュリティ・リストを追加します。
1. Oracle Cloudコンソールのナビゲーション・メニューを開きます。
2. 「ネットワーキング」をクリックし、「仮想クラウド・ネットワーク」をクリックします。
3. WebCenter Portalインスタンスが作成されたVCNを開きます。
4. リソースのリストから「サブネット」を選択します。
5. VCNでデフォルトで作成されたプライベート・サブネットを選択します(サブネット名は、「Private Subnet-<VNC name>」のようになります)。
6. 新しいOpenSearch_Security_Listセキュリティ・リストをサブネットに追加します。

ステートレス

タスク3: OpenSearchクラスタのプライベートIPのメモ

次の図に示すように、クラスタのプライベートIPをメモすることができます。

クラスタ情報

タスク4: OCI検索サービスへの接続のテスト - OpenSearchエンドポイント

https://<opensearch_private_ip>:9200にアクセスして、上で指定した資格証明を入力します。

次のようなレスポンスが表示されます:

{
  "name" : "opensearch-master-0",
  "cluster_name" : "amaaaaaawyxhaxqayue3os5ai2uiezzbuf6urm3dllo43accuxse57ztsaeq",
  "cluster_uuid" : "FncN4SpaT_em28b8gjb4hg",
  "version" : {
    "distribution" : "opensearch",
    "number" : "2.11.0",
    "build_type" : "tar",
    "build_hash" : "unknown",
    "build_date" : "2024-01-09T20:29:23.162321021Z",
    "build_snapshot" : false,
    "lucene_version" : "9.7.0",
    "minimum_wire_compatibility_version" : "7.10.0",
    "minimum_index_compatibility_version" : "7.0.0"
  },
  "tagline" : "The OpenSearch Project: https://opensearch.org/"
}

WebCenter Portalキーストアへの証明書の追加

クライアントとサーバー間の信頼を確立するには、OpenSearchサーバー証明書をWebCenter Portalキーストアに追加する必要があります。

OCI OpenSearchサーバーからの証明書のダウンロード

OCI OpenSearchサーバーから証明書を取得するには、次のステップを実行します:

Firefoxブラウザを開き、次のコマンドを使用してOCI OpenSearchサーバーに接続します:

https://host_name:9200

ここで、host_nameはOCI OpenSearchサーバーの名前です。
セキュリティ例外を受け入れて続行します。
プロンプトが表示されたら、ログイン資格証明を指定します。
「URL」フィールドで「ロック」アイコンをクリックし、「安全でない接続」、「詳細情報」の順に移動します。ポップアップ・ウィンドウで、「証明書の表示」ボタンをクリックします。
リンク「PEM (証明書)」をクリックして、.PEM形式で証明書をダウンロードします。

WebCenter Portalキーストアへの証明書の追加

証明書がダウンロードされたら、WebCenter Portalキーストアにインポートする必要があります。インポートするには:

WebCenter Portalサーバーで次のコマンドを実行し、プロンプトが表示されたらキーストアのパスワードを入力します:

keytool -importcert -alias opensearch_cert -file <path-to-PEM-certificate> -keystore <JDK_path>/jre/lib/security/cacerts
ポータル管理対象サーバーを再起動します。

ホスト名検証の無効化

ホスト名の検証を無効化するには:

WebLogicコンソールにログインします。
「ロックして編集」ボタンをクリックします。
左側のナビゲーションから「サーバー」を選択し、「サーバー名」、「構成」、「SSL」、「拡張」の順に選択します。「ホスト名の検証」ドロップダウン・メニューから「なし」を選択します。「保存」をクリックして、変更をアクティブ化します。

WebCenter Contentの検索の構成

ファセット検索およびソートの有効化

次のフィールドに対してファセット検索およびソートが有効になっていることを確認します。

ノート: 次のステップでは、デスクトップ・クライアント・アプリケーションを使用する必要があります。

「構成マネージャ・アプレット」、「拡張検索のデザイン」に移動し、次のフィールドを選択します。

dDocAccount: 「編集」をクリックし、チェック・ボックス「フィルタ・カテゴリです」を選択します(選択されていない場合)。「OK」をクリックします。
dDocAuthor: 「編集」をクリックし、チェック・ボックス「フィルタ・カテゴリです」および「ソート可能」を選択します(選択されていない場合)。「OK」をクリックします。
dDocLastModifiedDate: 「編集」をクリックし、チェック・ボックス「フィルタ・カテゴリです」および「ソート可能」を選択します(選択されていない場合)。「OK」をクリックします。
dDocTitle: 「編集」をクリックし、チェック・ボックス「ソート可能」を選択します(選択されていない場合)。「OK」をクリックします。
dFormat: 「編集」をクリックし、チェック・ボックス「フィルタ・カテゴリです」を選択します(選択されていない場合)。「OK」をクリックします。
xWCTags: 「編集」をクリックし、チェック・ボックス「フィルタ・カテゴリです」を選択します(選択されていない場合)。「OK」をクリックします。

WebCenter Contentでの検索索引の完全なコレクション再構築

完全なコレクションの再構築を実行するには:

システム管理者としてOracle WebCenter Contentにログインします。
WebCenter Contentホームページで、「管理」を開き、「管理アプレット」を選択します。
管理アプレット・ページで「リポジトリ・マネージャ」をクリックします。
「リポジトリ・マネージャ」ページで、「インデクサ」タブをクリックします。
「コレクション再構築サイクル」セクションで、「起動」をクリックします。ダイアログで、「高速再構築の使用」オプションの選択を解除し、「OK」をクリックして続行します。

WebCenter Portalの検索の構成

WebCenter Portalの検索を構成するには、WebCenter PortalとElasticsearch間の接続を構成する必要があります。

トピック:

Elasticsearch用のWebCenter Portalの構成

Elasticsearch用のWebCenter Portalの構成

WLSTの使用

次のように、WLSTコマンド・プロンプトでWLSTコマンドのcreateSearchConnectionを実行し、WebCenter PortalとElasticsearch間の接続を構成します。
```
createSearchConnection(appName, name, url, indexAliasName, appUser, appPassword)
```
ここで:
- appNameはWebCenter Portalのアプリケーション名で、値はwebcenterです
- nameは接続名です。名前はアプリケーション内で一意である必要があります。たとえば、dev-esです。
- urlはElasticsearchサーバーの場所です。たとえば、http://host:9200です
- indexAliasNameはElasticsearchサーバーの索引別名です。たとえば、webcenter_portalです。
  
  次の例に示すように、索引は別名を接頭辞として使用して作成されます: <indexAliasName>_portals 例: webcenter_portal_portals
  
  ノート: 名前は小文字の英数字とし、すべてのポータル・サーバー間で一意にする必要があります。
- appUserはクロール管理ユーザーの名前です。たとえば、mycrawladminです。
- appPasswordはクロール管理ユーザーのパスワードです。次の例では、WebCenter Portal (webcenter)とhttp://host:9200にあるElasticsearch間の接続を作成します:
createSearchConnection (appName='webcenter',name='dev-es', url='http://host:9200', indexAliasName='webcenter_portal', appUser='mycrawladmin', appPassword='welcome1')
Fusion Middleware Controlの使用
1. WebCenter Portalユーザーのかわりに検索を実行できるように、クロール管理ユーザーにアプリケーション・ロールを付与します。
  1. 管理者としてFusion Middleware Controlに接続します: http:<host:port>/em。
  2. 「WebLogicドメイン」、「セキュリティ」、「アプリケーション・ロール」の順に移動します。
    
    「アプリケーション・ロール」ページが開きます。
  3. アプリケーション・ストライプとして「webcenter」を選択します。
  4. 「ロール名」フィールドに対する矢印をクリックして、既存のすべてのロールを移入します。
  5. ロールwebcenter#-#defaultcrawlを選択し、「編集」をクリックします。
    
    アプリケーション・ロールの編集ページが開きます。
  6. 「追加」をクリックします。
    
    「プリンシパルの追加」ダイアログが開きます。
  7. 「アプリケーション・ロール」、「ユーザー」を「タイプ」として選択します。
  8. 「プリンシパル名」または「表示名」に基づいて、「クロール管理ユーザー」を検索します。
  9. 「プリンシパル」を選択し、「OK」をクリックします。
  10. 「アプリケーション・ロールの編集」ページで、「OK」をクリックします。
2. Fusion Middleware Controlを使用した検索サーバーへの接続の作成
  1. Fusion Middleware Controlにログインし、WebCenter Portalのホームページに移動します。
  2. 「WebCenter Portal」メニューから「設定」→「サービス構成」を選択します。
  3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「検索」を選択します。
  4. 「追加」をクリックします。
  5. 「接続名」フィールドに、検索接続の一意の名前を入力します。
  6. 「検索URL」フィールドに、Elasticsearchサーバーの場所を入力します。たとえば、http://host:9200です
  7. 「索引別名」フィールドに、Elasticsearchサーバーの索引別名を入力します。たとえば、webcenter_portalです
  8. 「アプリケーション・ユーザー名」フィールドに、クロール管理ユーザー名を入力します。たとえば、mycrawladminです。
  9. パスワードを入力します。
  10. 「テスト」をクリックして、作成した接続が機能するかどうかを検証します。
  11. 「OK」をクリックして接続を保存します。

WebCenter Portalでのユーザーの同期

ポータルのフル・クロールを実行する前に、LDAP同期WLSTコマンドを実行して、すべてのユーザーをポータルで使用できるようにしておくことをお薦めします。

WebCenter Portalでユーザーを同期するには:

Oracleホーム・ディレクトリに移動してWLSTスクリプトを起動します。

「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。
Oracle WebCenter Portalドメイン(WC_Portal)サーバーに接続します。
WLSTコマンド・プロンプトでWLSTコマンドのstartSyncProfilesを実行し、プロファイル情報を同期します。

startSyncProfiles(appName='webcenter')

ノート: プロファイル情報の同期には、ユーザー数によって少し時間がかかる場合があります。
isSyncProfilesRunningコマンドを実行して、ユーザー同期が完了していることを確認します。

isSyncProfilesRunning(appName='webcenter')

検索クローラの構成

次のタイプのクローラを構成して、WebCenter Portalリソースを索引付けできます:

ポータル・クローラ: ポータル・クロール・ソースを使用して、リスト、ページ・メタデータ、ページ・コンテンツ(HTML、テキストおよびスタイル・テキストの各コンポーネントのコンテンツ)、ポータル、プロファイルなどの特定のオブジェクトをクロールします。

次のトピックでは、WebCenter Portal管理の「スケジューラ」UIを使用して、様々なクロール・ソースを作成する方法を説明します。

ポータル・クロール・ソースの作成

ポータル・クロール・ソースの作成

クロール・ソースを作成してリスト、ページ・メタデータ、ページ・コンテンツ(HTML、テキストおよびスタイル・テキストの各コンポーネントのコンテンツ)、ポータル、プロファイルなどのオブジェクトをクロールする手順:

「設定」ページで(「WebCenter Portal管理の設定ページへのアクセス」を参照)、「ツールとサービス」をクリックします。

ブラウザに次のURLを入力して、直接「ツールとサービス」ページに移動することも可能です。
```
http://host:port/webcenter/portal/admin/settings/tools
```
検索のアイコンをクリックして「検索設定」ページを開きます。
「スケジューラ」タブで「ポータル」クロール・ソースを選択し、「編集」をクリックします。
「ポータル・クロール・ソースの編集」ページで、次のソース・パラメータを必要に応じて変更します。
- 最大接続試行回数: 構成URLにアクセスするための接続試行の最大数。2から10までの値を選択します。
- 構成URL: RSSクロール・サーブレットのURL。たとえば: http://wcp-host:wcp-port/rsscrawl
WebCenter Portalのクロール管理ユーザーの資格証明を入力します。
「テスト」をクリックして接続をテストします。
「保存して閉じる」をクリックして、変更内容を保存します。

検索のカスタム属性の構成

WebCenter Portalを使用して検索すると、特定の事前定義済属性のみが検索結果に表示されます。WebCenter Portalでは、検索結果に追加属性を表示することができます。これを行うには、ポータル管理の「検索設定」ページを使用し、そのページの「カスタム属性」セクションで、検索結果に表示されるカスタム検索属性と、それらの属性の表示順序を選択できます。「検索設定」ページのこのリストは、search-service-attributes.xmlによって導出されます。これには、各サービスでクロールするすべての属性のリストが含まれます。検索の索引のタイプは、このメタデータによって定義されます。search-service-attributes.xmlファイルでは、新しいカスタム属性を追加することも、既存の属性を変更することも可能です。

次の手順では、ドキュメント・サービスを例として使用し、新しいカスタム検索属性を追加する方法について説明します:

新しいカスタム検索属性を追加するには:

カスタム・メタデータ・フィールドを作成します。「Oracle WebCenter Contentへのカスタム・メタデータ・フィールドの追加」を参照してください。
WebCenter Contentでの検索索引の完全なコレクション再構築

新しいカスタム属性をsearch-service-attributes.xmlファイルに追加します。

次のように、WLSTコマンド・プロンプトでWLSTコマンドのexportMetadataを実行し、MDSリポジトリから最新のsearch-service-attributes.xmlファイルをエクスポートします。
```
exportMetadata('webcenter', 'WC_Portal', toLocation='/tmp/es', docs='/oracle/webcenter/search/scopedMD/
s8bba98ff_4cbb_40b8_beee_296c916a23ed/search-service-attributes.xml')
```

新しいカスタム属性をsearch-service-attributes.xmlファイルに追加します。

この例では、Custom Metadata Fieldがsearch-service-attributes.xmlファイルのoracle.webcenter.doclibサービスIDの下に追加されます。

<service id="oracle.webcenter.doclib">
    <attribute name="author" displayNameKey="WC_AUTHOR" displayName="Author" type="keyword"/>
    <attribute name="doc_author" displayNameKey="WC_DOC_AUTHOR" displayName="Author" type="keyword" backendAttribute="dDocAuthor"/>
       … 
       …
       …
       …
   <attribute name="wcsecattr" displayNameKey="WC_SECATTR" displayName="Security Attributes" type="keyword" hidden="true"/>
   <attribute name="wcsecattr_deny" displayNameKey="WC_SECATTRDENY" displayName="Security Deny Attributes" type="keyword" hidden="true"/>
   <attribute name="custom_metadata_field" displayNameKey="WC_CustomMetadataField" displayName="Custom Metadata Field"  type="keyword" backendAttribute="xCustomMetadataField”/>
</service>

更新されたsearch-service-attributes.xmlファイルを保存し、WLSTコマンドのimportMetadaを使用してMDSリポジトリにインポートします。

importMetadata('webcenter', 'WC_Portal', fromLocation='/tmp/es', docs='/oracle/webcenter/search/scopedMD/
s8bba98ff_4cbb_40b8_beee_296c916a23ed/search-service-attributes.xml')

ポータル管理の「検索設定」ページにアクセスし、新しい属性が「カスタム属性」セクションの「使用可能な属性」に表示されているかどうかを確認します。

この例では、「カスタム・メタデータ・フィールド」が新しく追加されたカスタム属性です。
「使用可能な属性」のリストから新しく追加されたカスタム属性を選択し、「組み込まれた属性」列に移動して、その属性が検索結果に表示されるようにします。
「適用」をクリックします。
ポータルに移動し、「グローバル検索」フィールドに検索条件を入力して、「検索」アイコンをクリックします。

次の図は、新しく作成されたカスタム属性Custom Metadata Fieldを含む検索結果を示しています。

カスタム・ファセットの作成

Oracle WebCenter Portalは、新しい検索を実行せずに検索結果を絞り込むファセット検索をサポートしています。ファセット検索を使用すると、検索結果が事前定義済カテゴリにグループ化されて、ユーザーが関連するカテゴリ(Author、Portal、Last Modified dateなど)に基づいて検索結果を絞り込むことができるようになります。

Oracle WebCenter Portalでは、デフォルトで、特定の事前定義済ファセットが「検索設定」ページで提供されます。ファセットのリストは、search-service-custom-facets.xmlメタデータ・ファイルによって導出され、ファイルの各ファセットはsearch-service-attributes.xmlメタデータ・ファイルにマップされます。

次に、search-service-custom-facets.xmlメタデータ・ファイルの例を示します。

<custom-facet dataType="keyword" displayName="Author" displayNameKey="ES_FACET_AUTHOR" mappedSearchAttribute="author" name="Author" itemsToDisplay="20"/>
<custom-facet dataType="keyword" displayName="Service ID" displayNameKey="ES_FACET_SERVICEID" mappedSearchAttribute="wc_serviceId" name="Service ID"/>
<custom-facet dataType="keyword" displayName="Portal" displayNameKey="ES_FACET_SCOPE" mappedSearchAttribute="wc_scopeGuid" name="Scope GUID" itemsToDisplay="20"/>
<custom-facet dataType="keyword" displayName="Tags" displayNameKey="ES_FACET_TAGS" mappedSearchAttribute="wc_tagWords" name="Tags"itemsToDisplay="20"/>
<custom-facet dataType="keyword" displayName="Mimetype" displayNameKey="ES_FACET_MIMETYPE" mappedSearchAttribute="mimetype" name="Mimetype" itemsToDisplay="20"/>
<custom-facet dataType="date" displayName="Last Modified Date" displayNameKey="ES_FACET_LASTMODIFIED" mappedSearchAttribute="lastmodified"
name="Last Modified Date" />

各要素の意味は次のとおりです。

nameは、ファセットの名前です。
displayNameKeyは、カスタム・ファセット・メタデータの値です。
displayNameは、ファセットの表示名です。

ノート: ビジネスが複数の言語でサポートされている場合は、新しく追加されたカスタム・ファセットを任意の言語に翻訳できます。「検索ファセットの文字列の翻訳」を参照してください。
mappedSearchAttributeは、検索属性を持つカスタム・ファセットのマップに使用されます。この値は、search-service-attributes.xmlメタデータ・ファイルのname属性値と同じである必要があります。
dataTypeは、データ型です。使用可能なデータ型は、keywordおよびdateです。この値は、search-service-attributes.xmlメタデータ・ファイルの型の値と同じである必要があります。
itemsToDisplayは、ファセットに表示される項目の最大数を定義するオプションの属性です。値が指定されていない場合は、WebCenter Portalの「管理」→「ツールとサービス」→「検索」オプションを使用してデフォルト値が構成されます。

ノート: この属性は、dataType keywordを使用している場合にのみサポートされます。

ビジネス・ニーズに基づいて、Oracle WebCenter Portalで使用可能な任意のサービスのsearch-service-custom-facets.xmlメタデータ・ファイルのファセットのリストを追加または変更できます。たとえば、search-service-custom-facets.xmlメタデータ・ファイルにリストされたドキュメント、ユーザーおよびその他のサービスのカスタム・ファセットを追加できます。

この項では、ドキュメント・サービスにカスタム・ファセットを追加する方法を示します。ドキュメント・サービスのカスタム・ファセットを追加するには、最初にOracle WebCenter Contentでカスタム・メタデータ・フィールドを追加してから、コンテンツ索引を再構築する必要があります。

次のステップでは、ドキュメント・サービスにカスタム・ファセットを追加する方法について説明します。

Oracle WebCenter Contentへのカスタム・メタデータ・フィールドの追加

ドキュメント・サービス用のカスタム・ファセットを追加するには、Oracle WebCenter Contentでメタデータ・フィールドの作成から開始する必要があります。この例では、新しいメタデータ・フィールドを作成し、そのフィールドにCustomMetadataFieldという名前を付けます。

Oracle WebCenter Contentにカスタム・メタデータ・フィールドを追加するには:

システム管理者としてOracle WebCenter Contentにログインします。
WebCenter Contentホーム・ページで、「管理」を開き、「管理アプレット」を選択します。
「管理アプレット」ページで、「構成マネージャ」をクリックします。
「構成マネージャ」ページで、「情報フィールド」タブをクリックし、「追加」をクリックして新しいカスタム・メタデータ・フィールドを追加します。
「メタデータ・フィールド名の追加」ダイアログで、メタデータの名前を入力します。たとえば、CustomMetadataFieldの場合、「OK」をクリックします。

ノート: メタデータ・フィールド名は一意である必要があり、最大フィールド長は29文字です。文字、数値およびアンダースコア(_)のみを使用します。空白やその他の特殊文字は使用できません。
「メタデータ・フィールド名の追加」ダイアログで、次の情報を編集します。
- フィールド・タイプ: ドロップダウン・リストから「ロング・テキスト」を選択します。
- ユーザー・インタフェース上で有効化: フィールドを表示するには「有効」を選択します。このオプションを選択しないと、このフィールドは検索ページで非表示になります。
- 検索索引の有効化: 検索用にメタデータ・フィールドを索引付する場合は、「索引付け」を選択します。このオプションを選択しなかった場合、フィールドは索引付けされず、検索ページにも表示されません。
「OK」をクリックします。
「構成マネージャ」ページで、「データベース設計の更新」をクリックし、「OK」をクリックして確認します。

構成マネージャ・アプレットでのファセット検索の有効化

「カスタム・メタデータ」フィールドのファセット検索を有効にするには、デスクトップ・クライアント・アプリケーションを使用する必要があります。

ファセット検索を有効にするには、次のステップを実行します:

構成マネージャ・アプレット、「拡張検索のデザイン」の順に移動し、ファセット検索を有効にするフィールドを選択して、「編集」をクリックします。
「詳細オプション」で、「フィルタ・カテゴリです」フィールドを選択して、変数がファセット検索に参加できるようにします。
「OK」をクリックすると、「検索索引の再構築」ボタンが有効になります。検索索引を再構築するには、このボタンをクリックします。

検索設定メタデータの構成

定義済のカスタム属性をOracle WebCenter Portalに追加する必要があります。新しいカスタム属性を「検索設定」ページに表示するには、search-service-attributes.xmlを追加または更新する必要があります。

定義済のカスタム属性を追加するには:

次のように、WLSTコマンド・プロンプトでWLSTコマンドのexportMetadataを実行し、MDSリポジトリから最新のsearch-service-attributes.xmlファイルをエクスポートします。
```
exportMetadata(application='webcenter', server='WC_Portal', toLocation='/tmp/mds_dump', docs='/oracle/webcenter/search/scopedMD/s8bba98ff_4cbb_40b8_beee_296c916a23ed/search-service-attributes.xml')
```
新しい検索属性フィールドをid="oracle.webcenter.doclib"のセクション内のsearch-service-attributes.xmlファイルに追加します。typeフィールドをkeywordに設定します。
```
<service id="oracle.webcenter.doclib">
.........................
......................
<attribute name="custom_metadata_field" 
displayNameKey="WC_CustomMetadataField"
displayName="Custom Metadata Field"  type="keyword" 
backendAttribute="xCustomMetadataField"/>
</service>
```
ノート: displayName属性を使用すると、言語のサポートが可能になり、displayNameはポータルの検索設定の「カスタム属性」セクションに表示されます。

Oracle WebCenter Portalでは、他の言語への文字列の翻訳がサポートされます。displayName属性を他の言語に翻訳するには、「カスタム検索属性の文字列の翻訳」を参照してください。

更新されたsearch-service-attributes.xmlファイルを保存し、WLSTコマンドのimportMetadaを使用してMDSリポジトリにインポートします。

 importMetadata(application='webcenter', server='WC_Portal', fromLocation='/tmp/mds_dump',docs='/oracle/webcenter/search/scopedMD/s8bba98ff_4cbb_40b8_beee_296c916a23ed/search-service-attributes.xml')

次に、新しいファセットを作成し、そのファセットを検索属性にマップします。「検索カスタム・ファセット・メタデータの構成」を参照してください。

検索カスタム・ファセット・メタデータの構成

WebCenter Portalの「検索設定」ページでは、検索結果とともに表示するファセットを選択できます。「検索設定」ページのこのリストは、search-service-custom-facets.xmlメタデータ・ファイルによって導出されます。これには、WebCenter Portalで使用されるファセットのリストが含まれます。search-service-custom-facets.xmlメタデータの各ファセットは、mappedSearchAttribute属性を使用してカスタム属性にマップされます。

検索カスタム・ファセット・メタデータを構成するには:

次のようにして、WLSTコマンド・プロンプトでexportMetadata WLSTコマンドを実行し、最新のsearch-service-custom-facets.xmlメタデータ・ファイルをMDSリポジトリからエクスポートします。
```
exportMetadata(application='webcenter', server='WC_Portal', toLocation='/tmp/mds_dump',docs='/oracle/webcenter/search/scopedMD/s8bba98ff_4cbb_40b8_beee_296c916a23ed/search-service-custom-facets.xml')
```
search-service-custom-facets.xmlファイルを開き、新しいファセットを作成して、ファセットを検索属性にマップします。
```
?xml version='1.0' encoding='UTF-8'?>
<search-service-custom-facets 
xmlns="http://xmlns.oracle.com/webcenter/search/customfacets">
.............................
<custom-facet name="CustomFacet" dataType="keyword"
    displayNameKey="WC_CustomFacet"
    displayName="Custom Facet" 
    mappedSearchAttribute="custom_metadata_field**"/>
</search-service-custom-facets>
```
説明
- custom-facet nameは、作成するカスタム・ファセットの名前です。
  
  ノート: dataTypeはkeywordである必要があります。また、displayName属性は言語サポートを提供するために使用する必要があり、displayNameはポータルの検索設定の「ファセット」セクションに表示されます。
  
  Oracle WebCenter Portalでは、他の言語への文字列の翻訳がサポートされます。displayName属性を他の言語に翻訳するには、「検索ファセットの文字列の翻訳」を参照してください。
- mappedSearchAttributeは、カスタム属性を持つファセットのマップに使用される属性です。
  
  ノート: search-service-custom-facets.xmlメタデータ・ファイルのmappedSearchAttribute属性には、search-service-attributes.xmlメタデータ・ファイルのname属性で指定された値と同じ値が含まれている必要があります。この例では、custom_metadata_fieldを使用します。

search-service-custom-facets.xmlメタデータ・ファイルを保存し、importMetada WLSTコマンドを使用してMDSリポジトリにインポートします。

importMetadata(application='webcenter', server='WC_Portal', fromLocation='/tmp/mds_dump',docs='/oracle/webcenter/search/scopedMD/s8bba98ff_4cbb_40b8_beee_296c916a23ed/search-service-custom-facets.xml'

WebCenter Portalにログインします。
ポータル管理の「検索設定」ページにアクセスして、新しい属性が「ファセット」および「カスタム属性」セクションに表示されるかどうかを確認します。
新しく追加したファセットを選択して、「組み込まれたファセット」セクションに移動し、「適用」をクリックします。

この例では、Custom Facetを選択します。
新しく追加したカスタム属性を選択して「組み込まれた属性」セクションに移動し、「適用」をクリックします。

この例では、CustomMetadata Fieldを選択します。

ポータル内のドキュメントのメタデータの更新

新しく作成したメタデータ・フィールド値をポータル内のドキュメントに追加します。この例では、CustomMetadataFieldです。

ドキュメントのメタデータ・フィールド値を更新するには:

ポータルで、ドキュメント・ページに移動します。
編集するドキュメントを選択し、「その他」ドロップダウン・メニューから「プロパティ」をクリックします。
「メタデータ」タブで、新しく追加したメタデータ・フィールドCustomMetadataFieldを見つけて、「編集」をクリックします。
新しく作成したメタデータ・フィールドの値を追加し、「保存」をクリックします。
ポータルに移動し、「グローバル検索」フィールドに検索条件を入力して、「検索」アイコンをクリックします。

次の図に、新しく作成したファセットCustom Facetを含む検索結果を示します。

検索結果でのファイル除外の構成

検索結果から特定のファイル・タイプを除外するように構成できます。ファイル・タイプを除外するには、メタデータ・ファイルsearch-service-exclude-file-types.xmlにファイル・タイプを指定する必要があります。

検索結果でファイルの除外を構成するには、次のステップを実行する必要があります:

メタデータ・サービス・ドキュメントのエクスポート
フィルタするファイル・タイプの更新
メタデータ・サービス・ドキュメントのインポート
検索結果でのファイル除外の確認

メタデータ・サービス・ドキュメントのエクスポート

MDS内のファイルの場所は、/oracle/webcenter/search/scopedMD/s8bba98ff_4cbb_40b8_beee_296c916a23ed/search-service-exclude-file-types.xmlです。

メタデータ・サービス・ドキュメントsearch-service-exclude-file-types.xmlをエクスポートするには、次のコマンドを入力します:

exportMetadata(application='webcenter', server='WC_Portal', toLocation='/tmp/search', docs='/oracle/webcenter/search/scopedMD/s8bba98ff_4cbb_40b8_beee_296c916a23ed/search-service-exclude-file-types.xml')

メタデータ・サービス・ドキュメントsearch-service-exclude-file-types.xmlで、除外するファイル・タイプをカスタマイズできます。

フィルタするファイル・タイプの更新

このメタデータは、検索中に除外する必要があるファイル・タイプを指定する方法について説明します。

<?xml version='1.0' encoding='UTF-8'?>
<search-service-exclude-file-types xmlns="http://xmlns.oracle.com/webcenter/search/excludefiletypes">
  <exclude-file-in-search>
    <fileType extension=".xml" customType="site-studio-file" description="Exclude Site Studio data files that have extension .xml"/>
    <fileType extension=".wav" description="Exclude all the file types with extension .wav"/>
    <fileType extension=".jpeg" description="Exclude all the file types with extension .jpeg"/>
  </exclude-file-in-search>
</search-service-exclude-file-types>

次に、このメタデータに関する重要なポイントをいくつか示します:

検索からフィルタするファイルの拡張子を、このメタデータ・ファイルに入力する必要があります。
customType属性はオプションです。検索結果でSite Studioのデータ・ファイルを除外する場合は、拡張子.xmlについてcustomTypeをsite-studio-fileと指定します。
description属性はオプションです。除外されるファイルの詳細を説明します。

メタデータ・サービス・ドキュメントのインポート

メタデータ・サービス・ドキュメントsearch-service-exclude-file-types.xmlをインポートするには、次のコマンドを入力します:

importMetadata(application='webcenter', server='WC_Portal', fromLocation='/tmp/search', docs='/oracle/webcenter/search/scopedMD/s8bba98ff_4cbb_40b8_beee_296c916a23ed/search-service-exclude-file-types.xml')

検索結果でのファイル除外の確認

ファイル・タイプの除外を確認するには、「検索」アイコンをクリックしてファイル・タイプ(*.wavや*.jpegなど)を指定し、これらのファイル・タイプが検索結果から除外されていることを確認します。同様に、.xmlファイルを検索し、Site Studioで作成された.xmlファイルが除外されていることを確認します。

クロールのスケジューリング

増分検索クロールをスケジュールすることや、フル・クロール、高速クロールまたは再索引付けクロールを手動で開始することができます。この項では、クロールをスケジュールする方法と、クロールを開始、有効化または無効化する方法を説明します。

増分クロールのスケジューリング

デフォルトでは、クローラは「手動」に設定されますが、次のようにして、分、時間単位、日単位など異なる頻度を指定できます。

「設定」ページで(「WebCenter Portal管理の設定ページへのアクセス」を参照)、「ツールとサービス」をクリックします。

ブラウザに次のURLを入力して、直接「ツールとサービス」ページに移動することも可能です。
```
http://host:port/webcenter/portal/admin/settings/tools
```
検索のアイコンをクリックして「検索設定」ページを開きます。
「スケジューラ」タブで、クロール・ソースを選択して「スケジュール」をクリックし、クロール・ソースの「スケジュール」ページを開きます。

「頻度タイプ」リストから必要な頻度タイプを選択します。

頻度タイプ	指定する必要があるデータ
手動による起動	これがデフォルトのクローラの頻度タイプです。「手動による起動」を選択した場合は、スケジュールを手動で起動してください。
分	「分」を選択した場合は、「起動の間隔」を分単位で指定します。指定できる値: 10から59分。
毎時	「毎時」を選択した場合は、「起動の間隔」を時間単位で指定します。指定できる値: 1から23時間。
毎日	「毎日」を選択した場合は、「起動の間隔」を日単位で指定し、「起動時間のスケジュール」を指定します。指定できる値: 1から99日および1から12 AMまたはPMまでの時間
毎週	「毎週」を選択した場合は、「起動の間隔」を週単位で指定し、「起動時間のスケジュール」を指定します。指定できる値: 1から12週および1から12 AMまたはPMまでの時間

「保存して閉じる」をクリックします。

スケジュール済クロールの有効化と無効化

クロールが処理中の場合は、クロールを無効化できません。クロールに定義されたスケジュールを有効化または無効化するには:

「設定」ページで(「WebCenter Portal管理の設定ページへのアクセス」を参照)、「ツールとサービス」をクリックします。

ブラウザに次のURLを入力して、直接「ツールとサービス」ページに移動することも可能です。
```
http://host:port/webcenter/portal/admin/settings/tools
```
検索のアイコンをクリックして「検索設定」ページを開きます。
「スケジューラ」タブで変更するクロール・ソースを選択し、「有効化」をクリックしてクロールに定義されているスケジュールを有効化するか、「無効化」クリックしてクロール・スケジュールを停止します。

手動によるフル・クロールの開始

フル・クロールを手動で開始すれば、WebCenter Portal内のすべてのアイテムをクロールできます。フル・クロールには時間がかかるため、ピーク時間外に開始してください。フル・クロールは手動で開始する必要があり、自動実行されるようにスケジュールできません。

フル・クロールを開始するには:

「設定」ページで(「WebCenter Portal管理の設定ページへのアクセス」を参照)、「ツールとサービス」をクリックします。

ブラウザに次のURLを入力して、直接「ツールとサービス」ページに移動することも可能です。
```
http://host:port/webcenter/portal/admin/settings/tools
```
検索のアイコンをクリックして「検索設定」ページを開きます。
「スケジューラ」タブで、クロール・ソースを選択して「スケジュール」をクリックし、クロール・ソースの「スケジュール」ページを開きます。
「スケジューラ」タブで、「すべてのアイテムのクロール」を展開し、「今すぐクロールを開始」をクリックします。

WebCenter Portalにより、選択したクロール・ソースのフル・クロールがただちに開始されます。

手動による増分クロールの開始

増分クロールを手動で開始して、WebCenter Portalの最後のクロール後に作成、更新または削除されたアイテムのみをクロールできます。

増分クロールを開始するには:

「設定」ページで(「WebCenter Portal管理の設定ページへのアクセス」を参照)、「ツールとサービス」をクリックします。

ブラウザに次のURLを入力して、直接「ツールとサービス」ページに移動することも可能です。
```
http://host:port/webcenter/portal/admin/settings/tools
```
検索のアイコンをクリックして「検索設定」ページを開きます。
「スケジューラ」タブでクロール・ソースを選択し、「開始」をクリックします。

選択したクロール・ソースの増分クロールがWebCenter Portalによって即時に開始されます。

検索クロールのサマリーと履歴

「検索設定」ページで検索クロールのサマリーと履歴にアクセスできます。

ポータル・クロール・ソースのクロール履歴

この図は、ポータル・クロール・ソースのクロール履歴を示しています。

クロール・タイプ(「フル」または「増分」)をクリックすると、クロールのサマリーが表示されます。

この図は、ポータル・クロール・ソースのクロール・サマリーを示しています。

WebCenter Portal管理での検索設定のカスタマイズ

WebCenter Portal管理の「検索設定」ページで、「結果タイプとフィルタリング」、「検索範囲」、「ファセット」および「カスタム属性」をカスタマイズできます。ポータル・マネージャは、管理するポータルの検索範囲のみをリセットできます。

Elasticsearchの検索設定をカスタマイズするには:

「設定」ページで(「WebCenter Portal管理の設定ページへのアクセス」を参照)、「ツールとサービス」をクリックします。

ブラウザに次のURLを入力して、直接「ツールとサービス」ページに移動することも可能です。
```
http://host:port/webcenter/portal/admin/settings/tools
```
検索のアイコンをクリックして「検索設定」ページを開きます。
「検索」タブで、「フィルタリング・ドロップダウンの有効化」を選択して、選択したサービスに基づいた検索結果のフィルタリングを有効にします。
検索結果に含める結果タイプを選択するには、「使用可能な結果タイプ」と「組み込まれた結果タイプ」間で結果タイプを移動します。
ホーム・ポータルのみまたはすべてのポータル(ホーム・ポータルを含む)の検索結果を含めるように「検索範囲」を設定します。
検索結果とともに表示するファセットとその表示順序を選択するために、「使用可能なファセット」リストと「組み込まれたファセット」リストの間でファセットを移動します。
「カスタム属性」セクションでは、「組み込まれた属性」セクションに属性を移動して、検索結果に表示されるカスタム検索属性と、それらの属性の表示順序を選択できます。
「適用」をクリックします。

検索のグローバル属性の変更

ノート: 次に説明する属性はElastisearchのものです。wcESConnectionTimeoutPeriod属性とwcESReadTimeoutPeriod属性は、WebCenter PortalとElasticsearch間の相互作用を構成する場合に使用します。

属性は次のとおりです。

wcESConnectionTimeoutPeriod: 接続タイムアウトまでの間隔(秒単位)。これは、WebCenter PortalでElasticsearchサーバーへの接続が確立されるまで待機する時間です。デフォルト値は30秒です。
wcESReadTimeoutPeriod: 読取りタイムアウトまでの間隔(秒単位)。WebCenter PortalがElasticsearchサーバーに接続されると、これによってElasticsearchサーバーが特定のリクエストに応答するまでの許容時間が指定されます。デフォルト値は30秒です。

WebCenter Portal管理の「属性」ページでは、属性のデフォルト値を変更できます。値を変更したら、WebCenter Portalサーバーを再起動して、変更を有効にする必要があります。

デフォルト値を変更するには:

「設定」ページで「属性」をクリックします。
「属性」ページで、属性の「アクション」アイコンをクリックして、「属性の編集」を選択します。
「属性の編集」ダイアログで、属性の値を変更します。
「OK」をクリックします。
WebCenter Portalを再起動します。