Oracle WebCenter Contentの統合機能(WCC統合とも呼ばれる)は、GUIで制御されるコネクタです。この機能によって、WebCenter Contentのコンテンツ・アイテムがWebCenter Sitesに同期され、そこでネイティブ・アセットとして管理されます。このアセットは、WebCenter Sitesで直接作成されたアセットと同様に編集、削除、プレビュー、リビジョン追跡、およびパブリッシュできます。
この章では、最初にWCC統合を使用するための前提条件について概説します。その後、コンテンツ同期を計画、設定および管理するための基本的な概念について説明します。
この章は、次の項で構成されています。
WCC統合は、WebCenter ContentとWebCenter Sitesの知識を備えた、それらのデータ・モデルの使用に精通している管理者向けの機能です。前提条件には、コンテンツ・アイテム、レンディション、変換、およびWebCenter Contentで定義されたメタデータに関する明確な知識が含まれます。WebCenter Sitesのアセット・タイプ、特にフレックス・ファミリについても十分理解している必要があります。作業の重要な部分では、コンテンツ・アイテム・メタデータをアセット・タイプ属性にマッピングします。アセット・タイプを作成する必要がある場合は開発者とコラボレートします。
WebCenter Contentの詳細は、『Oracle Fusion Middleware Oracle WebCenter Contentの使用』を参照してください。
WCC統合では、WebCenter Contentとそのコンテンツ変換エンジンの変換機能が利用されます。具体的には、WCC統合は、WebCenter Contentのドキュメントおよびデジタル・アセット(イメージやビデオなど)をネイティブ・ファイル、レンディションおよびHTML変換としてWebCenter Sitesに同期するように設計されています。レンディションは、ネイティブ・ファイルのタイプおよび必要なレンディションに応じて、コア変換エンジンまたはDigital Asset Managerで作成できます。HTML変換はDynamic Converterによって生成されます。ファイル形式に制限はありません。コンテンツの変換の詳細は、『Oracle Fusion Middleware Oracle WebCenter Contentの使用』を参照してください。
WCC統合を有効にして設定する方法を紹介する前に、その最も重要な概念について説明します。この概念は、WCC統合機能とこのガイドの章全体を通して使用されます。ここでは、WebCenter Contentのデータ・モデル、そのWebCenter Sitesのアセット・タイプへのマッピング、およびWebCenter Contentのポーリング時にコネクタを誘導するよう構成するルールについて説明します。詳細は、第50.3項「WebCenter Contentのデータ・モデル」および第50.4項「アセット・タイプのマッピングとコネクタ・ルール」を参照してください。
WebCenter Contentのデータ・モデルはコンテンツ・アイテムと呼ばれるオブジェクトに基づいており、ここにネイティブ・ファイル、そのレンディション、変換、および関連付けられたメタデータなどの情報が保持されます。
ネイティブ・ファイルはユーザーによってWebCenter Contentで直接作成され、元の形式で保持されます。WCC統合の有効なネイティブ・ファイルは、ドキュメント(docx
ファイルなど)およびデジタル・アセット(イメージ・ファイルやビデオなど)です。
レンディションは変換されたコンテンツ・アイテムであり、ネイティブ・コンテンツの異なる形式を表します。コンテンツ変換エンジンによって生成されるファイルで、ネイティブ(元の)ファイルを格納するコンテンツ・アイテムに関連付けられます。
次に例を示します。
ネイティブ・ドキュメントは、コア変換エンジン(WebCenter Contentでデフォルトで使用可能)によってWeb上で見やすいWeb形式に変換できます。これは一般にMicrosoft WordドキュメントのPDFファイルへの変換を意味します。このネイティブ・ドキュメントがプライマリ・レンディション、そのWeb表示可能なコピーがWebレンディションと呼ばれます。ネイティブ・ファイルとそのレンディションは同じコンテンツ・アイテムに含まれます。
ネイティブ・イメージ・ファイルとビデオは、Digital Asset Managerによって異なるサイズと形式の複数のレンディションに変換できます。元のイメージ・ファイルがプライマリ・レンディションとすると、その小さいサムネイル・バージョンはスモール・サムネイル・レンディション、大きいサムネイル・バージョンはラージ・サムネイル・レンディションのように呼ばれます。
HTML変換は、(Microsoft Wordなど)ネイティブ・ドキュメントの特別なレンディションです。このレンディションは、テキストとグラフィックの両方を含む単一のネイティブ・ドキュメントをHTMLレンディションに変換するDynamic Converterによって作成されます。レンディションは、(1)ネイティブ・ドキュメントのすべてのテキストを含むHTMLファイルと、(2)グラフィックスを表すイメージ・ファイルの集合で構成されます。
コンテンツ・アイテムに関連付けられたメタデータは、アセット・タイプに関連付けられた属性と似ています。
初回実行時、WCCコネクタはネイティブ・ファイル、レンディション、変換、メタデータまたはそれらの組合せの最新リリース・バージョンをWebCenter Sitesにインポートします。インポートするコンテンツは、コネクタ・ルールとそれが指定するマッピングによって異なります。
その後、WebCenter Content上でコンテンツ・アイテムが変更されると、コネクタによって次回のセッション時にWebCenter Sitesに同期されます。更新されたコンテンツ・アイテムはWebCenter Sitesに再インポートされ、削除されたコンテンツ・アイテムは、その対応するアセットがWebCenter Sitesから削除されます(前回の同期セッション以降、それらのアセットへの依存性が作成されていない場合)。
インポートと同期は手動でトリガーすることも、時間に基づいて実行するようにスケジュールすることもできます。
同期は常にWebCenter ContentからWebCenter Sitesへの一方向です。WCC統合は、多対1のクライアント/サーバー・モデルをサポートします。任意の数のWebCenter Sitesクライアントを単一のWebCenter Contentインスタンスに接続できます。
WebCenter Contentのデータ・モデルの詳細は、Oracle Fusion Middleware Oracle WebCenter Contentの理解およびOracle WebCenter Content Dynamic Converter管理者ガイドを参照してください。
管理対象アイテムは、WebCenter Contentではコンテンツ・アイテムと呼ばれ、WebCenter Sitesではアセットと呼ばれます。
WebCenter Contentのコンテンツ・アイテムには、それに関連付けられたメタデータがあります。
WebCenter Sitesのアセットはアセット・タイプのインスタンスであり、それに関連付けられた属性があります。
WCC統合を使用する目的は、コンテンツ・アイテムをアセットとしてWebCenter Sitesにインポートし、コンテンツ・アイテムの更新に応じた同期を維持することです。同期が成功するかどうかは多くの要因に左右されますが、その大部分はターゲット・アセット・タイプに依存します。具体的には、コンテンツ・アイテム・メタデータのアセット・タイプ属性へのマッピング、ポーリング・セッションを通してコネクタで使用されるルール内のマッピングの構成、およびルールの優先順位の設定に依存します。
この項は、次のトピックで構成されています。
ターゲット・アセット・タイプは作成または再利用できます。どのアセット・タイプをいくつ使用するかはコンテンツの要件によって異なります。ただし、次の最小限の要件があります。
ターゲット・アセット・タイプはフレックス・ファミリに属している必要があります。
ターゲット・アセット・タイプは少なくとも次の属性タイプを保持している必要があります。
WebCenter Contentで使用されるコンテンツ識別子メタデータ・フィールドにマップするコンテンツ識別子属性。詳細は、第50.4.1.1項「コンテンツ識別子属性」を参照してください。
インポートされたファイル(ネイティブ・ファイル、レンディション、変換またはそれらの任意の組合せ)を保持するためのコンテンツ記憶域属性。詳細は、第50.4.1.2項「コンテンツ記憶域属性」を参照してください。
アセットのプレビューが要件であること(一般のケース)を前提に、アセットのプレビューを有効にするためのテンプレート記憶域属性。
テンプレート属性が作成される場合は、第50.4.1.3項「テンプレート属性」で説明しているように、動的に変換されたHTMLファイルとその参照先イメージをプレビューするためのテンプレート・コードに特に注意する必要があります。
残りの要件は各ユーザーのニーズに固有であり、第50.4.1.4項「管理者定義の仕様」で概説しています。
WebCenter Contentでは各アイテムに一意のIDがあり、これはdDocName
という名前のデータベース・フィールドに格納されます(そして、アイテムの「コンテンツID」フィールドに表示されます)。デフォルトでは、dDocName
はname
属性にマップされます。WebCenter Sitesでアセットが作成されてコンテンツ・アイテムが格納されるたびに、そのコンテンツ・アイテムのdDocName
の値がアセットのname
属性に記録されます。
dDocName
(「コンテンツID」)はいくつかの方法で使用されます。この識別子を使用することで、WCCコネクタ(および管理者)は、アセットを調べて対応するコンテンツ・アイテムを確認することができます。また、コンテンツ・アイテムがWebCenter Sitesに同期されているかどうかをコネクタで判断し、コンテンツ・アイテムの作成、更新または削除に応じた新規アセットの作成、既存アセットの更新または削除を実行できます。
第54.2項「ユーザー構成可能なパラメータ」で説明しているように、dDocName
のname
へのデフォルトのマッピングは変更できます。これは新しいシステムで、コネクタ・ルールが作成され最初の同期セッションが開始される前に1回だけ実行してください。
コンテンツ・アイテムをファイルとしてWebCenter Sitesにインポートする場合は、ターゲット・アセット・タイプにファイルを受け入れるためのblob
型属性(単一値または複数値のいずれか)が必要です。
動的に変換されるドキュメントにはいくつかの特別な処理が必要になります。これは、単一のネイティブ・ファイルのHTMLへの変換プロセスで複数のアーティファクトが生成されるためです。たとえば、テキストとグラフィックの両方を含む単一のMicrosoft Wordドキュメントは、(1)すべてのテキストを含むHTMLファイルと、(2)すべてのグラフィックを表すイメージ・ファイルの集合に変換されます。
HTMLとイメージ・ファイルは個別の属性にマップされます。HTMLファイルは単一値のblob
型属性にマップされます。イメージ・ファイルは複数値のblob
型属性にマップされます。第50.4.1.3項「テンプレート属性」で説明しているように、アセットをプレビューするためのテンプレート属性とテンプレートを構成する必要もあります。
通常、WebCenter Sitesのアセット・タイプには、アセットのプレビューをサポートするテンプレート属性があります。
特別な注意が必要なテンプレート
動的に変換されるHTMLファイルのテンプレートには、次の理由から特別な注意が必要です。
動的に変換されるHTMLファイルには、WebCenter Content形式のイメージ・リンクが含まれます。次に例を示します。
<img src="${wcmUrl('dcresource','20673.jpg')}" width="360" height="270" alt="2007_06240117.JPG" />
WebCenter Sitesでは${wcmUrl('dcresource','20673.jpg')}
のような形式は認識されないため、このリンクをblob
リンクに変換する必要があります。リンク形式の変換は、WebCenter Sitesの配布ファイルの/misc/Samples/WCC
ディレクトリにあるWccConversionPreview.jsp
という名前のサンプル・テンプレートに例示されています。開発者はサンプル・テンプレートをそのまま使用することも、そのロジックの一部をそれぞれのテンプレートに組み込むこともできます。サンプル・テンプレートは、表50-1に示すファイル記憶域属性の名前とともにハードコードされています。
ターゲット・アセット・タイプの属性名がhtml
およびimages
以外の場合、開発者はサンプル・テンプレートWccConversionPreview.jsp
をターゲット・アセット・タイプ内で使用されている属性名で更新する必要があります。
第50.4.1.1項「コンテンツ識別子属性」、第50.4.1.2項「コンテンツ記憶域属性」および第50.4.1.3項「テンプレート属性」で説明した必須の属性に加えて、ターゲット・アセット・タイプへの同期に必要なメタデータ用の属性を追加するオプションが用意されています。
ターゲット・アセット・タイプは、必要な数のコンテンツ管理サイトで有効にできます。同期セッション時、コンテンツ・アイテムはコネクタ・ルールに指定されたすべてのサイトのターゲット・アセット・タイプに同期されます。コネクタ・ルールの詳細は、第50.4.2項「コネクタ・ルール」を参照してください。
WCCコネクタには1つ以上のアクティブ(有効な)ルールが必要です。アクティブ・ルールがないと、コネクタはWebCenter Contentをポーリングできません。
アクティブ・ルールとは、実行時に従う必要のある、コネクタに対して有効な一連の命令です。ルールはWebCenter Sitesで構成されて有効化されます。これには、WebCenter Content上のどのメタデータをポーリングするか、どのターゲット・アセット・タイプを、そのターゲット・アセット・タイプが有効になっているどのコンテンツ管理サイトで起動するか、コンテンツ・アイテム・メタデータをどのようにアセット・タイプ属性にマップするかなどの命令が含まれます。コネクタはマップを使用して、取得した情報を格納する属性を決定します。
コネクタ・ルールを計画して構成する際は、以降の情報を考慮して、コンテンツ・アイテムが予期したとおりに処理されるようにしてください。
ルールおよびターゲット・アセット・タイプ
1つのコネクタ・ルールで選択できるターゲット・アセット・タイプは1つのみです。そのため、WebCenter Sitesに様々なコンテンツ・アイテムを同期する場合は複数のルールを作成することになります。次に例を示します。
動的に変換されたHTMLファイルとその参照先イメージを単一のアセット・タイプにインポートする必要があるとします。この場合は、目的のターゲット・アセット・タイプを指定した単一のルールを作成し、HTMLファイルとそのイメージをhtml属性およびimages属性にマップします。
Microsoft Wordドキュメントおよび関連のないPDFファイルをインポートする必要があるとします。アセット・タイプには、docx
ファイル専用のアセット・タイプとpdf
ファイル専用のアセット・タイプがあります。この場合は、docx
ファイルを最初のアセット・タイプに同期するルールとpdf
ファイルを2番目のアセット・タイプに同期するルールの2つのルールを作成します。
アクティブ・ルールの優先順位の設定
同じコンテンツ・アイテムをそれぞれ異なるアセット・タイプにマップする複数のアクティブ・ルールがある場合、コネクタではそのコンテンツ・アイテムに最初に一致したルールのみが実行されます。ルールの実行順序によって、どのコンテンツ・アイテムがどのアセット・タイプに同期されるかが決まります。
たとえば、surfing.jpg
、surfing.png
およびskiing.png
という名前の新しいアイテムがあり、さらに次の2つのアクティブ・ルールがあるとします。
ルール1は、surfing.
any_extension
アイテムをavisportsサイト上のImages_avi
アセット・タイプにマップします。
ルール2は、png
アイテムをFirstSite II上のImages_FSII
アセット・タイプにマップします。
表50-2は、ルール1とルール2が異なる順序で実行されたときに、アイテムが2つのアセット・タイプに異なる方法で配布されることを示しています。目的の結果を得られるように、ルールに優先順位を設定する必要があります。
表50-2 アクティブ・コネクタ・ルールの順序により決定されるコンテンツの配布方法
アクティブ・ルール | Images_aviターゲット・アセット・タイプ | Images_FSIIアセット・タイプ |
---|---|---|
ルール1が最初に実行される場合 |
|
|
ルール2が最初に実行される場合 |
|
|
注意: ここでは、コネクタがルールを使用してコンテンツ・アイテムをWebCenter Sitesに同期する方法を詳しく説明します。
|
コンテンツ・アイテムのWebCenter Sitesへの再同期
WebCenter Sitesに同期されたコンテンツ・アイテムは、それがWebCenter Content上で変更(更新または削除)された場合のみ再同期されます。
注意: WebCenter Sitesに同期されたコンテンツ・アイテムがWebCenter Contentから削除された場合は、前回の同期セッション以降そのアセットに依存性が作成されていなければ、対応するアセットがWebCenter Sitesから削除されます。 |
アクティブ・ルールの無効化および削除
アクティブ・ルールが無効化または削除された場合、そのルールによってWebCenter Sitesにインポートされたコンテンツ・アイテムはWebCenter Sitesに残ります。無効化されたルールはコネクタで無視されます。
その他の考慮事項
ルールの作成および管理は、コンテンツ同期の設定の一部にすぎません。完全な手順では、最初にWCC統合のいくつかの要素を有効にしてから(1回のみ操作します)、コンテンツ同期をサポートするようにそれらを構成します。詳細は、第50.5項「WebCenter Contentの統合とその要素」を参照してください。
WCC統合機能はいくつかの要素で構成されており、それらを最初に有効にしてからコンテンツ同期を設定および管理するように構成します。この要素は、SitesIntegrationコンポーネント、WCCコネクタ、およびコネクタを制御する「コネクタ管理者」タブです。
SitesIntegration: インストール時にデフォルトでWebCenter Contentにインストールされるコンポーネントで、WCCコネクタをサポートするために有効にする必要があります。
SitesIntegrationコンポーネントを有効にすると、次の機能がWebCenter Contentに追加されます。
「サイトに同期化」オプション。このオプションはコンテンツのチェックイン・フォーム、更新フォームおよび検索フォームに表示されます。「True」
に設定すると、コネクタでコンテンツ・アイテムを取得できるようになります。コンテンツが実際に取得され格納されるかどうかは、そのコンテンツが作成されたアクティブ・ルールの条件に一致するかどうかによって決まります。
「WCSキュー・サポート情報」。このグラフィカル・インタフェースは、各WebCenter Sitesクライアントのトークン履歴をリストします。トークン情報は、前の更新にロールバックするために使用できます。
SitesIntegrationコンポーネントの有効化の詳細は、第51.1項「SitesIntegrationコンポーネントの有効化」を参照してください。
WCCコネクタ: WebCenter Contentと通信するためにWebCenter Sitesにインストールされます。WebCenter Sitesのインストール時またはアップグレード時にインストールするように選択することも、後からインストールすることもできます(前者の方法をお薦めします)。WebCenter Contentをポーリングするようにコネクタを構成するには、WebCenter Sites Adminインタフェースにある「コネクタ管理者」タブを使用します。
「コネクタ管理者」タブ: コネクタを制御するために使用されるグラフィカル・インタフェースです。WCC統合がインストールされると、図50-1に示すように、WebCenter Sites Adminインタフェースのナビゲーション・ツリーに「コネクタ管理者」タブが追加されます。
「コネクタ管理者」タブはコネクタを設定、実行および管理するために使用されます。たとえば、コネクタ・ルールの作成および有効化、WebCenter Contentへの接続の確立、コネクタの手動実行、コネクタ・アクティビティの監視、コネクタ履歴の表示およびトークン情報の取得を実行できます。
「コネクタ管理者」タブの有効化の詳細は、第51.2項「「コネクタ管理者」タブへのアクセスの有効化」を参照してください。
WebCenter Sitesにコンテンツをインポートするには、第51章「WebCenter Contentの統合機能の有効化」で説明しているように、コンテンツ同期をサポートするWCC統合の2つの要素を有効にする必要があります。最初の(1回のみ実行する)手順は、第51章「WebCenter Contentの統合機能の有効化」のすべての手順を完了する(または完了を確認する)ことです。詳細は次のとおりです。
第51.1項「SitesIntegrationコンポーネントの有効化」で説明しているように、WebCenter ContentのSitesIntegrationコンポーネントを有効にします。
第51.2項「「コネクタ管理者」タブへのアクセスの有効化」で説明しているように、WebCenter Sitesで管理者自身と他のユーザーの「コネクタ管理者」タブを有効にします。
第52章「コンテンツ同期の設定」で説明しているように、前述の手順が完了すると、システムでコンテンツ同期セッションを設定する準備が整います。