この章では、コンテンツ・アイテムをWebCenter ContentからWebCenter Sitesにインポートし、コンテンツ・アイテムの更新に応じて2つのシステム間で同期を維持するようにシステムを設定する手順について説明します。必要なアイテムをアセットとしてインポートしたら、アセットの識別および操作についてコンテンツ・コントリビュータをサポートできます。詳しい手順は、次の各項で説明しています。
注意: この章の手順を開始する前に、次のことを実行してください。
|
この章は、次の項で構成されています。
一般に、コンテンツ・アイテムの同期はWebCenter Contentユーザーが有効化します。図52-1に示すように、各アイテムの「サイトに同期化」オプションを「True」
に設定します。有効なコンテンツ・アイテムはドキュメントとデジタル・アセットです。
図52-1 WebCenter Contentサーバーの更新フォームの「サイトに同期化」オプション
同期が有効なコンテンツ・アイテムはWCCコネクタで処理されます。ただし、コンテンツ・アイテムをWebCenter Sitesにインポートできるのは、WCCコネクタが、それらを正しいアセット・タイプにインポートできるよう有効化されている場合のみです。後続のいくつかの手順を実行することでコネクタを有効にします。第52.2項「手順2: 同期するレンディションの決定」に進みます。
第52.1項「手順1: コンテンツ・アイテムの同期の有効化」で同期が有効化されたコンテンツ・アイテムにはレンディションがあります。デフォルトのレンディション・タイプはprimary
およびweb
です。
primary
レンディションは、WebCenter Contentにチェックインされたネイティブ(元の)ファイルです(レンディションが作成される前のMicrosoft Wordドキュメントなど)。
コンテンツ・アイテムのweb
レンディションは、ネイティブ・ファイルのWeb表示可能なバージョンです。たとえば、Microsoft WordドキュメントのPDFバージョンはWordドキュメントのwebレンディションです。
カスタム・レンディションを使用できる場合もあります。WebCenter Sitesにインポートするレンディションを決定する際は、WebCenter Sitesを操作するサイト・デザイナに問い合わせてください。コネクタ用のレンディションは、後続の手順(第52.4項「手順4: WebCenter Contentへの接続」)で指定します。
次の手順を実行します。
ターゲット・アセット・タイプが次の同期要件を満たしていることを確認します。
第50.4.1項「アセット・タイプのマッピング」に示されている最小要件を満たしていること。たとえば、フレックス・ファミリに属している必要があります。
第52.1項「手順1: コンテンツ・アイテムの同期の有効化」で有効化されたコンテンツ・アイテムを受け入れるように設定されていること。
dDocName
メタデータ・フィールドのデフォルトのマッピングを(name
以外の属性に)変更する必要がある場合は、ここでwcc-integration.ini
ファイルのwcc.keyfield
パラメータをリセットします。パラメータがリセットされて同期が開始されたら、この値は再編集しないでください。
dDocName
の詳細は、第50.4.1.1項「コンテンツ識別子属性」を参照してください。wcc.keyfield
パラメータの詳細は、第54.2項「ユーザー構成可能なパラメータ」を参照してください。
アセット・タイプにテンプレート属性がある場合は、そのテンプレートの表示名をWebCenter Sites Adminインタフェースで表示されているとおりに正確にコピーしてテキスト・ファイルに貼り付けます。このテンプレート名は、第52.4項「手順4: WebCenter Contentへの接続」でコネクタ・ルールを構成する際に使用します。
この項では、WebCenter SitesをWebCenter Contentに接続して、コネクタ・ルールの属性マッピングで使用可能にする必要のあるレンディション(第52.2項「手順2: 同期するレンディションの決定」で決定)を指定します。
WebCenter Contentに接続するには:
「コネクタ管理者」タブで、「構成」を選択して「コネクタ構成」フォーム(図52-2)を開きます。
「コネクタ構成」フォームで、次のフィールドに値を入力します。
「サーバーURL」フィールドに、接続先のWebCenter Contentインスタンスのアドレスを入力します。HTTP、HTTPSまたはIDCプロトコルを使用できます。WebCenter ContentインスタンスのURLパスの決定方法の詳細は、『Oracle Fusion Middleware Oracle WebCenter Contentの管理』を参照してください。
「サーバー・ユーザー」フィールドに、WebCenter Contentインスタンスの管理権限を持つユーザーの名前を入力します。
注意: 「サーバーURL」フィールドにIDCプロトコルを指定した場合は、管理権限を持つローカル・ユーザーとして定義された名前を入力する必要があります(デフォルトはsysadmin)。 |
「サーバーURL」フィールドにHTTPまたはHTTPS接続を指定した場合のみ、「サーバー・パスワード」フィールドに管理ユーザーのパスワードを入力します。
注意: IDC接続の場合、サーバーのパスワードは必要ありません。IDCプロトコルは、WebCenter Contentサーバーに構成された信頼できるポートを使用します。 |
「レンディション名」フィールドに、(第52.2項「手順2: 同期するレンディションの決定」で決定した)インポートするすべてのレンディションの名前を追加します。
レンディションを追加するには、「新しいレンディションの追加」をクリックして名前を入力します。ビデオ・レンディションを追加する場合は、media:
rendition-name
などのコロン区切り形式を使用します(図52-3を参照)。たとえば、media:flash8
のように指定します。
レンディション・タイプprimary
およびweb
はデフォルトで入力されています。必要に応じて、そのまま保持することも削除することもできます。
「テスト」ボタンをクリックしてエントリをテストします。エントリが有効な場合は、確認メッセージが表示されます。
「保存」ボタンをクリックしてエントリを保存します。構成が保存されると、確認メッセージが表示されます。
アクティブ・ルールとは、実行時に従う必要のある、コネクタに対して有効な一連の命令です。コネクタは、アクティブ・ルールを使用して次のことを実行します。
第52.1項「手順1: コンテンツ・アイテムの同期の有効化」で有効化されたコンテンツ・アイテムをサンプリングして、アクティブ・ルールに一致するアイテムを取得します。
第52.3項「手順3: ターゲット・アセット・タイプの選択または作成」で選択または作成してアクティブ・ルールに指定されたターゲット・アセット・タイプの受信アセットを作成します。
第52.4項「手順4: WebCenter Contentへの接続」およびアクティブ・ルールで指定されたレンディションを同期します。
注意: ルールを作成する前に、計画および構成のガイドラインについて第50.4.2項「コネクタ・ルール」を読んでください。 ルールは、(この手順で)作成する際に、または後の手順(第52.6「手順6: アクティブ・ルールの優先順位の設定とルールの管理」)で有効化できます。 |
ルールを作成するには:
「コネクタ管理者」タブで「ルール」を選択します。
「コネクタ・ルール」フォームで「新規ルールの追加」をクリックします(図52-4)。
ルール・ウィザードが開きます(図52-5)。次の手順に従ってルール・ウィザードを実行します。
ルール・ウィザード: 手順1 名前
ルールに名前を付けて説明を追加し、ルールを有効にします。
ルールの名前を入力します(必須)。英数字とハイフンのみ使用できます。
ルールの説明を入力します(必須)。
「有効」オプションを選択して、このルールを有効にします。
注意: 「有効」オプションを選択しなければルールはアクティブ化されず、コネクタで実行されません。第52.6項「手順6: アクティブ・ルールの優先順位の設定とルールの管理」で説明しているように、ルールはいつでも現在のウィザードまたは「コネクタ・ルール」から有効または無効にできます。 |
ルール・ウィザードの「手順2 ルール」に進みます。
ルール・ウィザード: 手順2 ルール
第52.1項「手順1: コンテンツ・アイテムの同期の有効化」で有効化したコンテンツ・アイテムをポーリングする際にコネクタでのサンプリングが必要なメタデータを指定するルール文を設定します。
ルール・ウィザードのこの手順では、メタデータの名前を選択し、演算子を選択して、メタデータ値を指定します。AND
/OR
文を追加することで、多数のメタデータの名前と値を指定できます。
コネクタでのサンプリングが必要なメタデータを指定するには:
左側のドロップダウン・リストで、メタデータの名前を選択します。
リストには、WebCenter Contentに定義されているすべてのメタデータ名が表示されます。メタデータの詳細は、『Oracle Fusion Middleware Oracle WebCenter Contentでの開発』を参照してください。
共通のメタデータ名には、次のものがあります。
dDocName: WebCenter Contentのコンテンツ・アイテムのコンテンツID。
dDocType: WebCenter Contentのコンテンツ・アイテム・タイプ。
dDocTitle: WebCenter Contentのコンテンツ・アイテム・タイトル。
dExtension: WebCenter Contentのファイル拡張子(txt
、doc
、pdf
、jpg
など)。
xComments: WebCenter Contentのコメント・フィールド。
中央のドロップダウン・リストで、演算子を選択します。
次と一致する: コネクタは右側のフィールドに入力された文字列全体と一致するメタデータ値を検索します。たとえば、文がdDocType「次と一致する」imageの場合、コネクタはimage
を認識しますが、images
は認識しません。
次を含む: コネクタは右側のフィールドに入力されたメタデータ値の部分文字列検索を実行します。たとえば、文がdDocName「次を含む」abcの場合、コネクタはabc
、abcde
、およびabc
を含むその他のdDocName
をすべて認識します。
次で始まる: コネクタは右側のフィールドに入力された文字列で始まるメタデータ値を検索します。
次で終わる: コネクタは右側のフィールドに入力された文字列で終わるメタデータ値を検索します。
が次の値より大きい: 整数のみに適用されます(文字列の場合は無効)。
が次の値より小さい: 整数のみに適用されます(文字列の場合は無効)。
右側のフィールドに、選択したメタデータ・フィールドの値を入力します。
必要な数だけOR
文を追加します。
必要な数だけAND
文を追加します。
ルール・ウィザードの「手順3 ターゲット」に進みます。
ルール・ウィザード: 手順3 ターゲット
ターゲット・アセット・タイプ、アセット・タイプを有効にするコンテンツ管理サイト、および入力が必要なその他の情報を選択します。
注意: この手順のコンテンツは、アセット・タイプに応じて異なります。 |
ターゲット・アセット・タイプと、それを有効にするコンテンツ管理サイトを指定するには:
ドロップダウン・リストからターゲット・アセット・タイプを選択します。
選択したアセット・タイプに応じて異なるオプションがフォームに表示されます。
アセット・サブタイプを選択します。
リストから目的の親を有効にします。
「サイト」ドロップダウン・リストで、選択したアセット・タイプを有効にするコンテンツ管理サイトを指定します。1つ以上のサイトを選択します。コネクタは、コンテンツ・アイテムとメタデータを、選択されたすべてのサイト上のターゲット・アセット・タイプにインポートします。
必要なその他の情報を入力します。
ルール・ウィザードの「手順4 属性」に進みます。
ルール・ウィザード: 手順4 属性
同期が有効なコンテンツ・アイテム(第52.1項「手順1: コンテンツ・アイテムの同期の有効化」で指定)のメタデータをターゲット・アセット・タイプの属性にマップします。
ルール・ウィザードの「手順4 属性」ページ(図52-8)には、ルール・ウィザードの「手順3 ターゲット」で選択したアセット・タイプの属性名とそのデータ・タイプがリストされます(図52-7)。赤いアスタリスクの付いている属性は必須です。データのタイプに(M
)を含む属性は複数値属性です。このような属性には、単一値またはセミコロンで(;)区切られた複数値を指定できます。たとえば、value1;value2;
のように指定します。
コンテンツ・アイテム・メタデータをアセット・タイプ属性にマップするには:
属性ごとに「次から取得」列へ移動して、ドロップダウン リストからオプションを選択します。オプションは属性タイプによって異なります。オプションは次のとおりです。
「リテラル」または「メタデータ」: これらのオプションはblob
以外のタイプの属性のみに適用されます。
「リテラル」を選択した場合は、「値」列に標準テキスト文字列を入力します。選択した属性は、このルールでインポートするすべてのコンテンツ・アイテムに同じテキストを表示します。
次の事項にも注意してください。
アセット・タイプにテンプレート属性がある場合は、WebCenter Sites Adminインタフェースに表示されているとおりのテンプレート名を「値」列に入力してください。名前をコピーして「値」列に貼り付けることをお薦めします(第52.3項「手順3: ターゲット・アセット・タイプの選択または作成」でテキスト・ファイルに貼り付けた名前を使用できます)。
date
タイプの属性(たとえば、startdate
やenddate
という名前の属性)の場合、「リテラル」を選択すると、日付ピッカーを使用して日付を選択できます(図52-9参照)。
「次から取得」列のドロップダウン・リストから「メタデータ」を選択した場合は、「値」列からメタデータ名を選択します。
注意: 「メタデータ」を選択した場合、「値」列のドロップダウン・リストには、ターゲットとしている属性のデータのタイプに一致するメタデータ・フィールドがリストされます。たとえば、属性が |
「レンディション」または「変換」: これらのオプションはblob
タイプの属性のみに適用されます。
「次から取得」列のドロップダウン・リストから「レンディション」を選択した場合は、「値」列から目的のレンディション・タイプ(たとえば、web
、primary
またはその他のレンディション・タイプ)を選択します。
注意: 「レンディション」を選択した場合、「値」列のドロップダウン・リストには第52.4項「手順4: WebCenter Contentへの接続」の「コネクタ構成」フォームで指定したレンディション・タイプの名前のみがリストされます。 |
「次から取得」列のドロップダウン・リストから「変換」を選択した場合は、「値」列から目的の変換タイプを選択します。オプションは「html」と「イメージ」のみです(「変換」はHTML変換のみに使用するオプションです)。
たとえば、HTML変換をインポートするために、次のようなマップを作成できます(ターゲット属性がHTML
およびImages
という名前であるとします)。
ルール・ウィザード: 最終手順
ツールバーの「保存」アイコンをクリックして、ルールをWebCenter Sitesデータベースにコミットします。
注意: 「ルール・ウィザード: 手順1 名前」で「有効」オプションを選択しなかった場合、ルールは保存されますが有効化されません。ルールは、「コネクタ・ルール」フォームでいつでも有効または無効にできます。第52.6項「手順6: アクティブ・ルールの優先順位の設定とルールの管理」を参照してください。 |
必要に応じて追加ルールを作成します。
ルールを管理するうえで最も重要な点の1つに、それらをコネクタに対して有効にし、実行の優先順位を設定することがあります。この順位によって、同期セッション時、コネクタがコンテンツ・アイテムをターゲット・アセット・タイプ間で配布する方法が決まります。優先順位の設定の詳細は、第50.4.2項「コネクタ・ルール」を参照してください。
ルールの編集、削除、追加などのその他の操作も、ルールを有効化して優先順位を設定する同じフォームで実行できます。
ルールに優先順位を設定したりルールを管理したりするには:
「コネクタ管理者」タブで、「ルール」を選択して「コネクタ・ルール」フォームを開きます。
コネクタのルールにすぐに優先順位を設定する場合は、この手順を続行します(それ以外の場合は、「コネクタ・ルール」フォームの編集や削除などのルール管理オプションについて説明している手順3に進みます)。
優先するルールの「有効」チェック・ボックスが選択されていることを確認します。
ルールの順序を変更するには、「上に移動」または「下に移動」矢印を使用します。有効化されたルールが、設定された順序でコネクタによって実行されます。コンテンツ・アイテムがいずれかのアクティブ・ルールに一致すると、そのルールに従って同期化されます。当該コンテンツの同期に関するその他のルールはすべて無視されます。
「保存」をクリックします。
「コネクタ・ルール」フォームに表示される操作を実行する場合は、次のリストで操作の説明を参照してください。
ルールを編集するには、そのルールの「編集」アイコン(鉛筆)をクリックします。ルール・ウィザードが表示されます。ルールの構成方法の詳細は、第52.5項「手順5: アクティブ・ルールの作成」を参照してください。
ルールを削除するには、そのルールの「削除」アイコン(ゴミ箱)をクリックします。
ルールの順序を変更するには、「上に移動」または「下に移動」矢印を使用します。有効化されたルールが、設定された順序でコネクタのポーリング時に実行されます。コンテンツ・アイテムがいずれかのアクティブ・ルールに一致すると、そのルールに従って同期化されます。当該コンテンツの処理に関するその他のルールはすべて無視されます。
ルールを有効化または無効化するには、そのルールの「有効」オプションを選択または選択解除します。変更後、「保存」をクリックします。
注意:
|
ルールを表示または編集するには、「名前」列でそのルールの名前をクリックします。ルール・ウィザードが表示されます。
「説明」列にはルールの説明が示されます。この説明はルールの作成時に定義されます。
新しいルールを追加するには、「新規ルールの追加」ボタンをクリックします。ルール・ウィザードが表示されます。
ルールの有効化または無効化などの変更を保存するには、「保存」ボタンをクリックします。
アクティブ・ルールの最適化、有効化および優先順位の設定が完了したら、第52.7項「手順7: コネクタの手動実行」に進みます。
この手順では、コネクタを手動で実行し、第52.5項「手順5: アクティブ・ルールの作成」で構成して第52.6項「アクティブ・ルールの優先順位の設定とルールの管理」で優先順位を設定したルールをテストします。
コネクタを実行するには:
「コネクタ管理者」タブで、「コンソール」を選択して「コネクタ・コンソール」を開きます。
コネクタ・コンソールに第52.4項「手順4: WebCenter Contentへの接続」で指定した情報が表示されていることを確認します。
「サーバーURL」フィールドには、WebCenter Contentインスタンスのアドレスがリストされます。
「サーバー・ユーザー」フィールドには、WebCenter Contentインスタンスの管理権限を持つユーザーがリストされます。
「トークンを使用して今すぐ実行」をクリックします。
コネクタの実行が開始され、現在のトークン値がトークン・フィールドに表示されます。トークンの詳細は、第53.1項「同期ポイントのロールバック」を参照してください。
コネクタの実行中は、現在使用している同じフォームでそのアクティビティを監視できます。詳細は、第52.8項「手順8: コネクタの監視」を参照してください。
コネクタの実行時は、図52-12に示すように、(前の手順で移入した)「コネクタ・コンソール」に「最近のアクティビティ」表が表示されます。
「最近のアクティビティ」表には直近24時間以内のアクティビティが一度に10行ずつリストされます。最新の情報を表示するには、表を手動で更新する必要があります。各行が1つのバッチを表しています。デフォルトでは、コネクタはコンテンツ・アイテムをバッチで処理します(バッチ当たり最大50アイテム)。第54.2項「ユーザー構成可能なパラメータ」で説明しているように、バッチ・サイズは変更できます。
コネクタがコンテンツ・アイテムをWebCenter Sitesにインポートしているかどうかを判別するには、表を更新して「更新済」列を確認します。
次に「最近のアクティビティ」表のすべてのオプションと統計について説明します。
「リフレッシュ」をクリックすると表が更新されます。
「取消」をクリックすると現在実行中のコネクタが取り消されます。次のバッチ(ある場合)の処理が取り消される点に注意してください。現在のバッチは完了まで処理されます。
「このアイテムの調査」アイコン(虫メガネ)をクリックすると、選択したバッチのコネクタ履歴が表示されます。詳細は、第52.9.2項「単一バッチのコネクタ履歴の表示」を参照してください。
「タイムスタンプ」列にはバッチ処理の日付と時間が表示されます。
「起動者」列には、バッチ処理が名前付きユーザーによって(「コネクタ・コンソール」から)手動で起動されたか、あるいはSystemEvents
表のコネクタ・スケジュールによって自動で起動されたか(AUTO)がリストされます。コネクタ・スケジュールの詳細は、第52.12項「手順12: コネクタのスケジュール」を参照してください。
「状態」列にはバッチ処理の状態がリストされます。リストされる値には、「送信済」、「実行中」、「取消済」、「エラー」、「リセット」または「終了」があります。「リフレッシュ」をクリックすると最新の状態が表示されます。この表は自動更新されません。
「バッチ・サイズ」列にはバッチのアイテム数がリストされます。デフォルトでは、バッチ当たり最大50アイテムです。最大バッチ・サイズの変更方法の詳細は、第54章「WCCコネクタの構成ファイル」を参照してください。
「更新済」列には、バッチ処理時にWebCenter Sitesで更新されたアイテム数がリストされます。この数には、作成、更新または削除されたアセットが含まれます。
「ルールなし」列には、アクティブ・ルールに一致しなかったコンテンツ・アイテムの数がリストされます。
「エラー」列には、このバッチの処理エラー数がリストされます。
(すべてまたは選択したバッチで)コネクタの履歴を表示することで、コネクタのアクティビティに関する追加情報を収集できます。第52.9項「手順9: コネクタ履歴の表示」に進みます。
同期化されたアセットを抜き取り検査して、それらが意図したアセット・タイプに格納されていることを確認する場合は、第52.10項「手順10: インポートされたコンテンツの検証」に進みます。
コネクタ・セッションはすべてアーカイブされます。アーカイブ全体または選択したバッチを(1つずつ)表示できます。処理の詳細な情報を得るために、個々のコンテンツ・アイテムまで絞り込むこともできます。アーカイブされた情報は削除できます。
この項は、次のトピックで構成されています。
すべてのバッチのコネクタ履歴を表示するには:
「コネクタ管理者」タブで、「履歴」を選択して「コネクタ履歴」表を開きます。
「コネクタ履歴」表には次の情報とオプションが表示されます。
「コネクタ履歴」表の各行は1つのバッチを表しています。デフォルトでは、コネクタはコンテンツ・アイテムをバッチで処理します(バッチ当たり最大50アイテム)。
「このアイテムの調査」アイコン(虫メガネ)をクリックすると、選択したバッチのコネクタ履歴が表示されます。詳細は、第52.9.2項「単一バッチのコネクタ履歴の表示」を参照してください。
「タイムスタンプ」列にはバッチ処理の日付と時間が表示されます。
「起動者」列には、バッチ処理が名前付きユーザーによって(「コネクタ・コンソール」から)手動で起動されたか、あるいはSystemEvents
表のコネクタ・スケジュールによって自動で起動されたか(AUTO)がリストされます。コネクタ・スケジュールの詳細は、第52.12項「手順12: コネクタのスケジュール」を参照してください。
「状態」列にはバッチ処理の状態がリストされます。リストされる値には、「送信済」、「実行中」、「取消済」、「エラー」、「リセット」または「終了」があります。「リフレッシュ」をクリックすると最新の状態が表示されます。
「バッチ・サイズ」列にはバッチのアイテム数がリストされます。デフォルトでは、バッチ当たり最大50アイテムです。最大バッチ・サイズの変更方法の詳細は、第54章「WCCコネクタの構成ファイル」を参照してください。
「更新済」列には、バッチ処理時にWebCenter Sitesで更新されたアイテム数がリストされます。この数には、作成、更新または削除されたアセットが含まれます。
「ルールなし」列には、アクティブ・ルールに一致しなかったアイテムの数がリストされます。
「エラー」列には、このバッチの処理エラー数がリストされます。
「すべて」オプションを選択して「削除」ボタンをクリックすると、すべてのアクティビティ・リストが削除されます。
バッチ(行)を選択して「削除」ボタンをクリックすると、そのバッチが削除されます。
単一のバッチのコネクタ履歴を表示するには、そのバッチを選択します。「コネクタ履歴」表にそのバッチで処理されたすべてのアイテムがリストされます。第52.9.2項「単一バッチのコネクタ履歴の表示」の図52-14に示す例を参照してください。
「コネクタ管理者」タブで、「履歴」を選択して「コネクタ履歴」表を開きます。
目的のバッチ(行)を見つけ、「調査」アイコン(虫メガネ)をクリックします。
「コネクタ履歴」表に、選択したバッチで処理されたすべてのアイテムがリストされます(図52-14の例を参照)。
単一バッチの「コネクタ履歴」表には次の情報とオプションが表示されます。
各行はバッチ内の単一のアイテムを表します。
「コンテンツID」列にはバッチ内の各アイテムのコンテンツIDがリストされます。
「アセットID」列にはバッチ内の各アイテムのアセットIDがリストされます。
「ステータス」列にはバッチ内の各アイテムの同期ステータスがリストされます。共通のステータス・フラグは、Added
、Error
、Updated
、Not Matched
(一致するルールがない)、Not Present
(アセットが見つからない)およびDeleted
(アセットは削除済)です。
「注釈」列には、バッチ内の各アイテムに関する追加情報が示されます。「詳細の表示」アイコン(プラス記号)または「詳細の非表示」アイコン(マイナス記号)を切り替えます。共通で返されるメッセージの例と説明は、手順4を確認してください。
「戻る」ボタンをクリックすると、前の表(すべてのバッチの履歴を表示)に戻ります。
図52-15は、「注釈」列に表示されるメッセージの例を示しています。より包括的なリストは、図の下に記載されています。
次に、共通メッセージの一部を紹介します。
「有効なルールが見つかりません」
—ルールが定義されていないか、定義されたルールが無効であることを示しています。
「レコードが見つかりません」
—データベース表でレコードが見つからない、つまり、特定の表に表示するエントリがないことを示しています。
「QueueToken {0}の削除 」
—値{0}
はトークンIDです。このメッセージは、WebCenter Contentのアイテムが、WebCenter Sitesから削除する対象としてマークされていることを示しています。
「アセット{0}はサイト{1}から削除されました」
—値{0}
はassetType_assetID
です。値{1}はサイト名です。このメッセージは、リストされたアセットが指定されたコンテンツ管理サイトから削除されたことを示しています。
「アセットが削除されました」
—アセットが削除されたことを示しています。
「アセットが見つかりません」
—このメッセージは通常、削除するアイテムの検索時、そのアイテムがすでに削除されていたことを意味しています。
「サイト: {2}に対するアセットが作成されました: {0:1}」
—値{0:1}
はアセット・タイプとアセットIDです。値{2}はサイト名またはサイト名のカンマ区切りリストです。このメッセージは、リストされたアセットがリストされたサイトで作成されたことを示しています。
「サイト: {2}に対するアセットが更新されました: {0:1}」
—値{0:1}
はアセット・タイプとアセットIDです。値{2}
はサイト名またはサイト名のカンマ区切りリストです。このメッセージは、リストされたアセットがリストされたサイトで更新されたことを示しています。
「理由: {2}のため、サイト{1}からのアセット{0}の削除に失敗しました」
—値{0}
はアセットIDです。値{1}
はサイト名です。値{2}
は、削除が失敗した理由に関するメッセージです。通常、削除が失敗するのは、アセットが前回の同期以降に変更され、現在そのアセットを参照しているためです。削除に失敗した場合は、そのアイテムが「親がないコンテンツ」フォームにリストされます(詳細は、第52.13項「手順13: 同期されたアセットの管理」を参照してください)。
「QueueToken {0}のチェックイン」
—値{0}
はトークンIDです。このメッセージは、キュー・トークン・チェックイン・リクエスト、つまり、新規または更新済アイテムをWebCenter ContentからWebCenter Sitesにインポートする準備が整っていることを示しています。
「ルールは{0}に一致しました。WCCリクエスト: {1}」
—値{0}
はルール名です。値{1}
は、ルールの属性マッピング・セクションで要求されたWebCenter Contentレンディションまたは変換です。
「一致するルールはありません」
—アイテムに一致するルールがないことを示しています(「有効なルールが見つかりません」
と比較してください)。
「ルールは{0}に一致しましたが、マッピングが見つかりません」
—値{0}
はルール名です。このメッセージは、ルールがWebCenter Contentからインポートされるアイテムに一致したが、メタデータと属性のマッピングが見つからなかったことを示しています。
「レンディション{0}は返されませんでした」
—値{0}
はレンディション名です。このメッセージは、WebCenter Contentが要求されたレンディションを戻さなかったことを示しています(多くの場合はレンディションが使用不可のため)。「使用可能なレンディション: {0}」
および「リクエストされたレンディションは使用できません」
と比較してください。
「使用可能なレンディション: {0}」
—値{0}
は、WebCenter Content上で使用可能なアイテムのレンディションのリストです。
「リクエストされたレンディションは使用できません」
—リクエストされたレンディションが使用できないことを示しています。使用可能なレンディションのリストは、「使用可能なレンディション: {0}」
を参照してください。
「フィールド{0}、fieldDef: {1}でエラーが発生しました: {2}」
—値{0}
および{1}
は属性名(値は同一)です。値{2}
は例外のエラー・メッセージです。このメッセージは、コネクタがコンテンツ・アイテム・メタデータ・フィールドを属性にマッピング中に不明または予期しない例外が発生したときに戻されます。
同期の定期的な実行を自動化する前に、インポートされたコンテンツを検証して、それが意図したアセット・タイプに予期した詳細レベルで格納されていることを確認します。第52.10項「手順10: インポートされたコンテンツの検証」に進みます。
ここまでの操作で、コンテンツ同期の動作について理解できたと思います。確認のため、インポートされたコンテンツ・アイテムを抜き取り検査して、それらが意図したアセット・タイプに格納されていること、すべてのメタデータ値が正しい属性で記録されていること、そしてルールの属性マッピング部分で指定したその他のすべての条件が満たされていることを検証します。コンテンツ・アイテムおよびアセットを見つけるには、「コネクタ履歴」表でコンテンツIDとそれに対応するアセットIDを参照します。
検証が完了したら、次のいずれかを実行します。
調整が必要な場合は、第52.11項「手順11: 設定を変更する必要がある場合」に進みます。
要件が満たされている場合は、次の項に進みます。
同期セッションの結果が要件を満たしていない場合にシステム構成を調整する方法はいくつかあります。そのオプションを次に示します。調整方法は次のとおりです。
この章で説明したいくつかの手順に戻って、たとえば、より多くのコンテンツ・アイテムの同期を有効化したり、コンテンツ・アイテムを無効にしたり、ルールを変更したり、あるいはアクティブ・ルールの優先順位を再設定したりすることができます。
注意: アクティブ・ルールを変更したりルールの優先順位を再設定したりする場合は、最初に、同期されたアセットをWebCenter Sitesから削除してください。アセット・タイプを消去することで、コネクタを再実行した後の同期結果の解釈がシンプルになります。ロールバックを実行する場合は、これにより、同期ポイントを元の開始ポイントまたは特定の更新にロールバックするためのシステムの準備が整います。 |
wcc-integration.ini
ファイルを使用して、最大バッチ・サイズなどの様々なパラメータを再構成します。詳細は、第54項「WCCコネクタの構成ファイル」を参照してください。
トークンをリセットすることで、同期ポイントを元の開始ポイントまたは特定の更新にロールバックできます。
注意: トークンをリセットする場合は、コネクタによって新しい同期ポイントのすべてのコンテンツ・アイテムが再検査され、WebCenter Sitesに再同期されます。 ロールバックする前に、同期されたアセットをWebCenter Sitesから削除してシステムを準備します。この手順は、ターゲット・アセット・タイプの変更、コンテンツ管理サイトの変更、またはルールの優先順位の再設定のいずれかによってコネクタ・ルールが変更された場合に特に重要です。アセットが削除された後、トークンをリセットできます。トークンの詳細は、第53.1項「同期ポイントのロールバック」を参照してください。 |
設定を変更したら、次の項に進みます。
コンテンツ同期を構成して検証したら、時間に基づいて実行するようにコネクタをスケジュールできます。Oracle WebCenter Sites: Explorerユーティリティを使用して、SystemEvents
表に時間指定エントリを追加します。
コネクタをスケジュールするには:
配布ファイルのSitesExplorer
ディレクトリのあるSites Explorer実行可能ファイル(ContentServerExplorer.exe
)を起動します。
注意: Sites ExplorerはWindows専用ユーティリティです。 |
Sites Explorerにログインします。(ログイン資格証明の詳細は、『Oracle Fusion Middleware WebCenter Sites開発者ガイド』を参照してください。)
Sites Explorerで、次を実行します。
Tablesノードを展開します。
図52-16 Tablesノードの展開されたOracle WebCenter Sites: Explorer
SystemEvents表を選択します(図52-16を参照)。
メイン・メニューから、「ファイル」→「新規」→「レコード」の順に選択します。
次の情報を入力して、WCCコネクタのスケジュール・イベントを定義します。
eventname: WCCConnector
type: 1
enabled: 1
times: 現時点ではこのフィールドは空白のままにしておきます。手順eで設定します。
target: ContentServer
params: pagename=WCC/Pull
次の形式でtimes
フィールドに時間パターンを入力することで、コネクタを実行するスケジュールを定義します。
h:m:s W/D/M
時間パターンの各フィールドとそれらの有効な値を表52-2に示します。次の表は時間パターンの一例です。
表52-2 SystemEvents表の時間パターンのフィールド
フィールド | 有効な値 | すべての有効な値 | 単一値の形式 | 包含範囲の形式 | リストの形式 |
---|---|---|---|---|---|
|
0–23 |
* |
|
|
|
|
0–59 |
* |
|
|
|
|
0–59 |
* |
|
|
|
|
0–6(0=日曜日) |
* |
|
|
|
|
0–31 |
* |
|
|
|
|
1–12 |
* |
|
|
|
時間パターンの例:
2,5-7:0:0 5/*\/*
最初のフィールド2,5-7:0:0
は範囲を含む時間のカンマ区切りリストです。これはイベントが、午前2時、午前5時、午前6時および午前7時それぞれの0分0秒にトリガーされることを意味しています。次のフィールド(5/
)は、イベントが毎週金曜日にトリガーされることを指定しています。次のフィールド(*\
)は、イベントが毎日はトリガーされないことを指定しています。最後のフィールド(/*
)は、イベントがすべての月でトリガーされることを指定しています。
日付の仕様は、曜日(WD)と日付(DD)の2つのフィールドによって作成できます。両方を指定すると、両方が反映されます。たとえば、1:0:0 1/15/*
は、イベントが毎週月曜日と各月の15日の午前1時0分0秒にトリガーされることを意味しています。1つのフィールドのみで日付を指定するには、他のフィールドを*
に設定します。
「保存」をクリックします。
第52.13項「手順13: 同期されたアセットの管理」に進んで、同期されたアセットをコンテンツ・コントリビュータが識別および管理するうえで役立つ情報を参照してください。
必要なコンテンツ・アイテムをWebCenter Sitesにインポートしたら、特に同期セッションを定期的に実行する場合など、同期されたアセットの識別および管理についてコンテンツ・コントリビュータをサポートします。パブリッシュを行う管理者も、アセットが同期セッションにどのように影響されるかを理解しておく必要があります。
この項は、次のトピックで構成されています。
コンテンツ・コントリビュータが、コネクタ・ルールの属性マッピング部分で明示的にマップされた属性の値を変更することでアセットを変更した場合、それらの値は、コンテンツ・アイテムが更新され再同期された時点で更新されます。その他のすべての属性には、それぞれの値が保持されます。
注意: マップされた属性の値が変更された場合は、そのコンテンツ・アイテムが更新され再同期された時点で値が上書きされます。マップされた属性への変更を保持するには、アセットをコピーする必要があります。 |
同期で実行でないタスクの1つに、依存性のある同期化されたアセットの削除があります。これにより、親がないコンテンツが生じます。
親がないコンテンツとは、対応するコンテンツ・アイテムが同期で削除されたか、(「サイトに同期化」オプションを「False」に設定
して)無効化されたか、あるいは期限切れになったときに削除できないアセットです。親がないアセットは、前回の同期セッション以降、そのアセットに依存性が作成されているため削除できません。
注意: 同期されたアセットがコンテンツ管理サイト全体で共有されている場合は、依存性がないかぎり削除されます。 |
親がないアセットを判別するには:
WebCenter Sites Adminインタフェースで、「コネクタ管理者」タブを開きます。
「親がないコンテンツ」を選択し、「コネクタの親がないコンテンツ」表を開きます(図52-17を参照)。
「コネクタの親がないコンテンツ」表には、削除されたソースのコンテンツ・アイテム、親がないアセットおよびそれらの依存アセットを示す列が表示されます。
「コンテンツID」列には、WebCenter Contentの同期において削除または無効化されたコンテンツ・アイテムのコンテンツIDがリストされます。
「コネクタ・トークン」列には、トークンのupdate_number
がリストされ、これに基づいてコンテンツ・アイテムがコネクタによって処理された日時を導出できます。第53章「再同期オプション」で説明しているように、日時は「WCSキュー・サポート情報」表から取得できます。
「アセットID」列には、親がないアセットがWebCenter SitesアセットIDによってリストされます。
「参照元」列には、(親がないアセットを参照している)依存アセットがリストされます。
「注釈」列には、親がないアセットの追加情報(ある場合)がリストされます。
「コネクタの親がないコンテンツ」表を使用して、WebCenter Content内の親がないアセットを見つけます。削除されたコンテンツ・アイテムの詳細は、WebCenter Contentで確認できます。