任意タイプのアセットのインポート

XMLPostユーティリティを使用したアセットのインポートについて

データ設計を決定し、アセット・タイプを作成し、これらを開発システムでテストし、管理システムに移動したら、アセット(コンテンツ)を現在のソースから管理システム上のデータベースにインポートする準備は完了です。コンテンツの中にはリモートから生成されるもの(ワイヤー・フィード・サービスやその他のソースを使用して生成されるもの)もあり、それを管理システム上のWebCenter Sitesデータベースにインポートすることが必要になる場合があります。

XMLPostユーティリティを使用して、データをWebCenter Sitesデータベースにインポートします。アセットをインポートするには、WebCenter Sitesで用意されているインポート(ポスト)・エレメントのいずれかをそのアセット・タイプに応じて呼び出すように、XMLPostユーティリティに指示します。

このプロセスでは次の4つのものが必要です。

WebCenter Sitesに付属しているXMLPostユーティリティ。
ポスト・エレメント。WebCenter Sitesには、RemoteContentPostという名前のポスト・エレメントが用意されています。WebCenter Sitesには、「フレックス・アセットのインポート」で説明している3つの追加のポスト・エレメントも用意されています。
ファイル拡張子が.iniの構成ファイル。インポートする予定のアセット・タイプごとに1つの構成ファイルを作成します。このファイルには、ソース・ファイルに含まれていると想定されるもの(XMLPostによって検出されるタグの種類)、提供されたデータの処理方法、およびデータをインポートするために使用するインポート(ポスト)・エレメントが記述されています。
ソース・ファイル。インポートするアセットごとに個別のソース・ファイルを用意します(整形式XMLファイル)。ファイル内の各タグは、そのアセット・タイプのフィールドを指定します。このタグに含まれている情報は、その列に書き込まれるデータです。

XMLPostユーティリティは、アセット・タイプに提供されるデータを解釈する方法を確認するために構成ファイルを解析します。また、ソース・ファイルを解析して、各フィールド値の名前と値のペアを作成し、これらの名前と値のペアをICS変数としてRemoteContentPostエレメントに渡します。RemoteContentPostエレメントは、これらの変数に基づいてアセットを作成します。

XMLPostユーティリティと組み合せて機能する独自のポスト・エレメントを作成することもできます。ただし、アセットをインポートする場合は、WebCenter Sitesに用意されているポスト・エレメントで十分です。

ノート:

セキュリティを向上するために、RemoteContentPostページの名前を変更してシステムへのハッキング試行を防止する必要があります。

開発者が実行する手順

この項では、XMLPostユーティリティを起動する前に開発者が実行するステップと、XMLPostユーティリティが実行する処理について概述します。

WebCenter Sitesデータベースにアセットをインポートするときに実行する一般的なステップは、次のとおりです。

インポートするアセットのタイプとソース・ファイル内で使用されているタグを指定する構成ファイルを作成します。

このファイルでは、いくつかの構成プロパティも設定します。これには、XMLPostで使用するポスト・エレメントのSiteCatalogエントリの名前が含まれます。すべてのアセットについて、このポスト・エレメントの名前はRemoteContentPostになります。フレックス・アセットのポスト・エレメントについては、「フレックス・アセットのインポート」を参照してください。

構成ファイルはこのアセット・タイプに固有のものです。アセット・タイプごとに別個の構成ファイルを用意する必要があります。
インポートするデータのソース・ファイルを作成します。アセットごとに別個のソース・ファイルを作成します。
ソース・ファイルと構成ファイルを管理システム上のディレクトリ内に配置します。
そのディレクトリから、ソース・ファイルとこれらのソース・ファイル用に使用する構成ファイルを指定して、XMLPostユーティリティを起動します。

XMLPostとWebCenter Sitesが実行する処理

XMLPostユーティリティを起動してソース・ファイルをインポートした後に、次の図およびそれに続くステップに示すプロセスが開始されます。

図31-1 XMLPostユーティリティのプロセス図

「図31-1 XMLPostユーティリティのプロセス図」の説明

XMLPostユーティリティは構成ファイルを解析します。
XMLPostはソース・ファイルを解析して、ソース・ファイルで指定された各フィールド値の名前と値のペアを作成します。
XMLPostは、構成ファイルから渡されたページ名にこれらの名前と値のペアをICS変数としてポスト(HTTP POST)することで、FormPoster Javaクラスを呼び出します。ベーシック・アセット・タイプをインポートする際のページ名は次のとおりです。
```
OpenMarket/Xcelerate/Actions/RemoteContentPost
```
WebCenter Sitesは、そのページをSiteCatalog表内で検索し、RemoteContentPostページのルート・エレメントを呼び出します。このルート・エレメントはデフォルトで同じ名前(RemoteContentPost)を持ちます。
RemoteContentPostエレメントは、ソース・ファイル内のデータを変数として、該当するタイプのアセットのPreUpdateエレメントに渡します。
PreUpdateエレメントは、そのアセットの変数値を設定してRemoteContentPostエレメントに戻ります。
RemoteContentPostエレメントはそのアセットを作成します。
WebサーバーはHTMLのストリームをXMLPostに返し、XMLPostはそのストリームを解析してインポート操作が成功したかどうかを判断して、結果を構成ファイルで指定されたテキスト・ファイルに記録します。
インポートするアセットのアセット・タイプが検索エンジンを使用する場合、RemoteContentPostは新しいエレメントを索引付けします。
構成ファイルで特定のパラメータを設定した場合、RemoteContentPostは正常にインポートされたアセットのソース・ファイルを削除します。

XMLPost構成ファイルの使用

XMLPost構成ファイルには、3つのタイプのプロパティが含まれています。プロパティの中には、XMLPostにデータベース情報および環境情報を提供するものや、構成値をインポートするものや、ソース・ファイルに使用されるタグを指定するものがあります。

XMLPostにデータベースおよび環境に関する情報を提供するプロパティは、独自のポスト・エレメントを作成する場合でも変わりません。
ポスト(インポート)・プロセスの構成値を提供するプロパティ。次のトピックでは、RemoteContentPostエレメントが正常に機能するために指定する必要のあるプロパティについて説明します。

プロパティの例としてあげられるのは、RemoteContentPostを呼び出すページのURL、データベース内のアセット・タイプ表に対する書込み権限をXMLPostに付与するユーザー名とパスワード、インポートするアセット・タイプの名前、エラーのログ記録方法、インポートするすべてのアセットについて同じであるデータ値などです。
ソース・ファイル内で使用されているタグを指定するプロパティ。

特定の情報は、構成ファイルのRemoteContentPostセクションまたはソース・ファイル・セクションで構成できます。これらの情報としては、アセットが所属するサイトや、アセットに割り当てられるワークフローなどがあります。

たとえば、1つのコンテンツ管理サイトで作業している場合や、同じサイトに属している新しいをインポートする場合は、そのサイトの名前を構成セクションで指定することにより、その情報を各ソース・ファイルで繰り返し指定する必要がないようにします。複数のコンテンツ管理サイトがある場合は、アセットが属するサイトを個別のソース・ファイル内で指定します。

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

XMLPostのプロパティの構成

この表は、XMLPostユーティリティが必要とするデータベース接続情報や他の一般的な構成指示内容を指定するプロパティを示しています。

表31-1 XMLPostの構成プロパティ

プロパティ	説明
`xmlpost.xmlfilenamefilter`	必須。ソース・ファイルのファイル拡張子。通常は`xml`に設定します。たとえば: `xmlpost.xmlfilenamefilter: .xml`
`xmlpost.proxyhost`	オプション。アセットのインポート先にするWebCenter Sitesデータベースと開発者のマシンの間にファイアウォールが配置されている場合は、このプロパティを使用してプロキシ・サーバーのホスト名を指定します。たとえば: `xmlpost.proxyhost:` `nameOfServer`
`xmlpost.proxyport`	オプション。アセットのインポート先となるWebCenter Sitesデータベースと開発者のマシンの間にファイアウォールが配置されている場合は、このプロパティを使用して、XMLPostの接続先となるプロキシ・サーバー上のポート番号を指定します。たとえば: `xmlpost.proxyport: 80`
`xmlpost.url`	必須。ポスト・エレメントのページ・エントリのURLの最初の部分。 XMLPostは、このプロパティで指定された値をページ名`postargname`(後述)で指定された値の前に付加することで、ポスト・エレメントのURLを作成します。このプロパティで指定する値は、次の規則に従う必要があります。 WebCenter Sitesデータベースが配置されているサーバーの名前。サーバー上にインストールされたアプリケーション・サーバー・ソフトウェアに適したCGIパス。WebLogicとWebSphereの場合は、このパスは`/servlet/`です。 ContentServerサーブレットの名前。たとえば: `xmlpost.url: http://`servername`/servlet/ContentServer`
`xmlpost.logfile`	オプション。各ソース・ファイルのインポート(ポスト)結果を記録するファイルの名前。各ソース・ファイルは、ポスト・リクエストを通じてWebCenter Sitesデータベースにポストされます。ポスト要求がWebサーバーから戻ってくると、XMLPostはWebサーバーが返したHTMLストリームを解析して、`postsuccess`パラメータと`postfailure`パラメータを探します。次にXMLPostは、このパラメータで指定されたファイルに結果を書き込みます。たとえば: `xmlpost.logfile: ArticlePost.txt`
`xmlpost.success`	オプション。ポストが成功したかどうかを判断するために応答内で検索する文字列。たとえば: `xmlpost.success: Success!`
`xmlpost.failure`	オプション。ポストが失敗したかどうかを判断するために応答内で検索する文字列。たとえば: `xmlpost.failure: Error`
`xmlpost.deletefile`	オプション。 WebCenter Sitesデータベースに正常にインポートされたソース・ファイルを削除するかどうか。有効な値は`y` (yes)または`n` (no)です。デフォルトでは、ソース・ファイルは削除されません。たとえば: `xmlpost.deletefile: y`

ポスト・エレメントの構成プロパティ

この表は、RemoteContentPostページにポストされる必要のある(およびRemoteContentPostエレメントに渡される必要のある)情報を指定する引数を示しています。これらの引数の値は、RemoteContentPostページにポストされるURLに付加されます。これらの引数は構成ファイル内でどのような順序でもかまいません。

表31-2 ポスト・エレメントの構成プロパティ

プロパティ	説明
`xmlpost.numargs`	必須。ページ名は、URLに付加される名前と値のペアとして構成ファイルからXMLPostに渡されるいくつかの必須の変数内の主な変数です。このプロパティ(`xmlpost.numargs`)を使用して、構成ファイルによって渡される変数の数をXMLPostに通知します。たとえば: `xmlpost.numargs: 7` これらの名前と値のペアで独自のカスタム変数を指定することもできます。
`xmlpost.argname1: pagename`	必須。 `RemoteContentPost`エレメントのページ名。通常は、`pagename`引数は`xmlpost.argname1`として指定します。たとえば: `xmlpost.argname1: pagenamexmlpost.argvalue1: OpenMarket/Xcelerate/Actions/RemoteContentPost`
`xmlpost.argname2: AssetType`	必須。ソース・ファイル内で定義されているアセットのアセット・タイプ。通常は、`AssetType`は`xmlpost.argname2`として指定します。たとえば: `xmlpost.argname2: AssetType` `xmlpost.argvalue2: Collection` `AssetType`引数の値は、このタイプのアセットが格納されている表の表名と完全に一致している必要があります。
`xmlpost.argname3: authusername`	必須。アセットのインポート先になるWebCenter Sitesデータベースにログインするために、XMLPostが使用するユーザー名。通常は、`authusername`は`xmlpost.argname3`として指定します。たとえば: `xmlpost.argname3: authusername` `xmlpost.argvalue3: editor` 指定するユーザー名は、インポートするタイプのアセットが格納されている表に対する書込み権限を持っている必要があります。(つまり、そのユーザー名には適切なACLが割り当てられている必要があります。)
`xmlpost.argname4: authpassword`	必須。アセットのインポート先となるWebCenter SitesデータベースにログインするためにXMLPostが使用するユーザーのパスワード。通常は、`authpassword`は`xmlpost.argname4`として指定します。たとえば: `xmlpost.argname4: authpassword` `xmlpost.argvalue4: xceleditor`
`xmlpost.argname5: xmlpostdebug`	オプション。 `xmlpost.logfile`プロパティで指定されたXMLPostログ・ファイルに書き込まれる結果情報にデバッグ情報を含めるかどうか。このプロパティは任意の値に設定できます。たとえば: `xmlpost.argname5: xmlpostdebug` `xmlpost.argvalue5: on` ノート: デバッグを有効にする場合は、`xmlpost.logfile`プロパティの値を必ず含めてください。
`xmlpost.argname6: inifile`	オプション。 WebCenter Sitesデータベースに接続する際に使用する`ini`ファイルの名前。通常は、`inifile`は`xmlpost.argname5`として指定します。たとえば: `xmlpost.argname6: inifile` `xmlpost.argvalue6: futuretense.ini`
`xmlpost.argname7: publication`	オプション。このプロパティは必須ではありませんが、インポートする各アセットのサイトを指定する必要があります。システムで単一のコンテンツ管理サイト(パブリケーション),を使用している場合や、このタイプのすべてのアセットを同じサイト上で有効にする必要がある場合は、この引数を使用してそのサイトの名前を指定します。たとえば: `xmlpost.argname7: publicationxmlpost.argvalue7: Fiscal News` 複数のコンテンツ管理サイトを使用する場合、個別のソース・ファイル内でアセットごとにサイトの値を指定する必要があります。
`xmlpost.argname8:startmenu`	オプション。ワークフローを使用している場合に、インポートするアセットのすべてに同じワークフローを割り当てる場合は、この引数を使用してそれらのアセットのスタート・メニュー・ショートカットを設定します。(これはワークフローIDを新しいアセットに割り当てるスタート・メニュー・ショートカットです。) たとえば: `xmlpost.argname8: startmenu` `xmlpost.argvalue8: New Article` このタイプのアセット用の複数のワークフローがある場合は、各アセットのスタート・メニュー・ショートカットの値を個別のソース・ファイル内で指定する必要があります。

ソース・ファイルの構成プロパティ

構成ファイル内のソース・ファイル・セクションでは、ソース・ファイル内で使用されているタグが指定されます。タグは、このタイプのアセットが格納されている表の列名を表します。タグのペアの内側にあるコンテンツは、その列に書き込まれる情報です。構成ファイルには、アセット・タイプのプライマリ記憶域表の列ごとにタグをリストする必要があるため、アセット・タイプごとに別個の構成ファイルを用意する必要があります。

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

サイトのプロパティ

アセット・タイプに対して使用可能なタグに加えて、次の表では、アセットを関連付けるサイトやアセットで使用するワークフローを指定できる別のタグについて説明します。

表31-3 サイトのプロパティ

サイト・タグのプロパティ値説明

サイト・タグのプロパティ	値	説明
`postpublication`	`y` or `n` (yesまたはno)	オプション。アセットが属するサイトを指定するサイト名をソース・ファイルで示すことを指定します。たとえば: `postpublication: y` ソース・ファイル内で`publication`タグを使用して指定されたサイト(パブリケーション)値は、構成ファイルのXMLPostセクションの`XMLPost`引数で指定された値よりも優先されます。
`postprimarypubid`	`y` or `n` (yesまたはno)	オプション。アセットが属するサイトを指定する`pubid` (サイトの一意のID)の値をソース・ファイルで示すことを指定します。たとえば: `postprimarypubid: y`
`postpublist`	`y` or `n` (yesまたはno)	オプション。アセットを共有するサイトのリストをソース・ファイルで示すことを指定します。たとえば: `postpublist: y`
`poststartmenu`	`y` or `n` (yesまたはno)	オプション。アセットをワークフロー・プロセス内に配置するスタート・メニュー・ショートカットの値をソース・ファイルで示すことを指定します。たとえば: `poststartmenu: y`

postpublication

y or n

(yesまたはno)

オプション。

アセットが属するサイトを指定するサイト名をソース・ファイルで示すことを指定します。

たとえば:

postpublication: y

ソース・ファイル内でpublicationタグを使用して指定されたサイト(パブリケーション)値は、構成ファイルのXMLPostセクションのXMLPost引数で指定された値よりも優先されます。

postprimarypubid

y or n

(yesまたはno)

オプション。

アセットが属するサイトを指定するpubid (サイトの一意のID)の値をソース・ファイルで示すことを指定します。

たとえば:

postprimarypubid: y

postpublist

y or n

(yesまたはno)

オプション。

アセットを共有するサイトのリストをソース・ファイルで示すことを指定します。

たとえば:

postpublist: y

poststartmenu

y or n

(yesまたはno)

オプション。

アセットをワークフロー・プロセス内に配置するスタート・メニュー・ショートカットの値をソース・ファイルで示すことを指定します。

たとえば:

poststartmenu: y

インポートするすべてのアセットについてサイトまたはワークフローが同じである場合は、サイトまたはワークフローの値を引数として構成ファイルのXMLPostセクションで指定できます。そうすることで、同じ情報をすべてのソース・ファイルで繰り返し指定する必要がなくなります。

アセット・タイプのプロパティ

アセット・タイプに固有のタグを設定するには、そのタイプのアセットのデータベース表の各列のタグを指定します。ただし、構成ファイル内のすべてのタグでタグ付けされたデータをソース・ファイルに含める必要はありません。(当然ながら、ソース・ファイルには必須フィールドのデータを含める必要があります。)

フィールド(列)を表す各タグについて、そのタグの名前を指定するとともに、必要に応じてそのタグの追加の処理プロパティを指定します。タグの名前は、対応するフィールド(列)の名前です。追加のプロパティについては、タグの名前の前に単語を付加するという規則に従う必要があります。

この表は、アセット・タイプに固有のタグを指定する方法を説明しています。

表31-4 アセット・タイプのプロパティ

タグのプロパティ値説明

タグのプロパティ	値	説明
`posttagname`	`y` or `n` (yesまたはno)	必須。タグの名前を指定します。この名前は、そのタグが表しているフィールドの名前と完全に一致している必要があります。たとえば、nameフィールドには、このタグのプロパティを次のように指定します。 `postname: y`
`trunctagname`	`N` (整数)	オプション。このタグでマークされたソース・ファイル内のデータを途中で切り捨てるかどうか。たとえば: `truncname: 64` XMLPostが`<name>`タグ内で64文字を超える文字列を検出した場合は、64文字を超える部分を切り捨てて、残った64文字の文字列を変数に格納します。
`notrimtagname`	`y` or `n` (yesまたはno)	オプション。このタグの先頭または末尾の空白を削除するかどうか。空白を保持するには、このプロパティを`y` (yes)に設定します。たとえば: `notrimname: y` このプロパティを空白のままにすると、XMLPostはデフォルトでこのタグの空白を削除します。
`multitagname`	`combine` または `separate`	このプロパティは、単一のソース・ファイル内で同じタグが複数回使用されている場合は必須です。ソース・ファイル内で同一のタグが複数回使用されている場合に、これらのタグのデータを格納する変数の数を決定します。これを`combine`に設定した場合、すべてのタグのデータは、各値がカンマで区切られた形で(カンマ区切り文字列として)同じ変数に格納されます。このプロパティを`separate`に設定した場合、各タグのデータは別々の変数に格納されます。これらの変数を識別するために、`seedtagname`で指定した値が変数名の後ろに付加されます。たとえば、`keyword`フィールド(列)の場合は、次のようになります。 `multikeyword: combine`と設定した場合、XMLPostは、`keyword`タグでマークされたすべての値を同じ`keyword`変数に格納します。 `multikeyword: separate`および `seedkeyword: 1`と設定した場合、XMLPostは各値を別々の変数に格納します。最初に検出された値は、`keyword1`という名前の変数に格納されます。2番目に検出された値は、`keyword2`という名前の変数に格納され、それ以降の値も同様です。
`seedtagname`	`seed value`	このプロパティは、`multitagname`が`separate`に設定されている場合は必須です。同一のタグが複数回使用されていて、これらのタグ内のデータを別々の変数に格納する場合に、その変数名の末尾に付加される連続番号の最初の番号を指定します。`multitagname`の説明を参照してください。たとえば: `multikeyword: separate` `seedkeyword: 1`
`filetagname`	`y` or `n` (yesまたはno)	このプロパティは、タグがアップロード・フィールド(URL列またはBLOB)を表している場合は必須です。タグがURL列を持つフィールドを表している場合は、このプロパティを使用する必要があるとともに、ソース・ファイルでは、`RemoteContentPost`によってその列にアップロードするファイルの名前を指定する必要があります。たとえば、`imagefile`アセット・タイプは、`urlpicture`という名前のアップロード・フィールドを備えています。この`imagefile`アセット・タイプの構成ファイルには、次のプロパティが含まれます。 `posturlpicture: y` `fileurlpicture: y` この場合は、`imagefile`アセットのソース・ファイルでは、`urlpicture`フィールドの値を次のように指定します。 `<urlpicture>relative_path_to/filename.jpg` `</urlpicture>` ファイルの場所は、XMLPostユーティリティを実行しているディレクトリを基準にした相対パスで指定する必要があります。

posttagname

y or n

(yesまたはno)

必須。

タグの名前を指定します。この名前は、そのタグが表しているフィールドの名前と完全に一致している必要があります。

たとえば、nameフィールドには、このタグのプロパティを次のように指定します。

postname: y

trunctagname

N

(整数)

オプション。

このタグでマークされたソース・ファイル内のデータを途中で切り捨てるかどうか。

たとえば:

truncname: 64

XMLPostが<name>タグ内で64文字を超える文字列を検出した場合は、64文字を超える部分を切り捨てて、残った64文字の文字列を変数に格納します。

notrimtagname

y or n

(yesまたはno)

オプション。

このタグの先頭または末尾の空白を削除するかどうか。

空白を保持するには、このプロパティをy (yes)に設定します。

たとえば:

notrimname: y

このプロパティを空白のままにすると、XMLPostはデフォルトでこのタグの空白を削除します。

multitagname

combine

または

separate

このプロパティは、単一のソース・ファイル内で同じタグが複数回使用されている場合は必須です。

ソース・ファイル内で同一のタグが複数回使用されている場合に、これらのタグのデータを格納する変数の数を決定します。

これをcombineに設定した場合、すべてのタグのデータは、各値がカンマで区切られた形で(カンマ区切り文字列として)同じ変数に格納されます。

このプロパティをseparateに設定した場合、各タグのデータは別々の変数に格納されます。これらの変数を識別するために、seedtagnameで指定した値が変数名の後ろに付加されます。

たとえば、keywordフィールド(列)の場合は、次のようになります。

multikeyword: combineと設定した場合、XMLPostは、keywordタグでマークされたすべての値を同じkeyword変数に格納します。
multikeyword: separateおよび seedkeyword: 1と設定した場合、XMLPostは各値を別々の変数に格納します。最初に検出された値は、keyword1という名前の変数に格納されます。2番目に検出された値は、keyword2という名前の変数に格納され、それ以降の値も同様です。

seedtagname

seed value

このプロパティは、multitagnameがseparateに設定されている場合は必須です。

同一のタグが複数回使用されていて、これらのタグ内のデータを別々の変数に格納する場合に、その変数名の末尾に付加される連続番号の最初の番号を指定します。multitagnameの説明を参照してください。

たとえば:

multikeyword: separate

seedkeyword: 1

filetagname

y or n

(yesまたはno)

このプロパティは、タグがアップロード・フィールド(URL列またはBLOB)を表している場合は必須です。

タグがURL列を持つフィールドを表している場合は、このプロパティを使用する必要があるとともに、ソース・ファイルでは、RemoteContentPostによってその列にアップロードするファイルの名前を指定する必要があります。

たとえば、imagefileアセット・タイプは、urlpictureという名前のアップロード・フィールドを備えています。このimagefileアセット・タイプの構成ファイルには、次のプロパティが含まれます。

posturlpicture: y

fileurlpicture: y

この場合は、imagefileアセットのソース・ファイルでは、urlpictureフィールドの値を次のように指定します。

<urlpicture>relative_path_to/filename.jpg

</urlpicture>

ファイルの場所は、XMLPostユーティリティを実行しているディレクトリを基準にした相対パスで指定する必要があります。

XMLPostのサンプル構成ファイル

ここでは、Fiscal Newsという名前のサイトのimagefileアセットをインポートするために使用するimagefile.iniという名前のサンプル構成ファイルを示します。

xmlpost.xmlfilenamefilter: xml
#xmlpost.xmlproxypost: Future
#xmlpost.xmlproxyport: 80
xmlpost.url: http://localhost/servlet/ContentServer
xmlpost.numargs: 6
xmlpost.argname1: pagename
xmlpost.argvalue1: OpenMarket/Xcelerate/Actions/RemoteContentPost
xmlpost.argname2: AssetType
xmlpost.argvalue2: ImageFile
xmlpost.argname3: authusername
xmlpost.argvalue3: user_author
xmlpost.argname4: authpassword
xmlpost.argvalue4: user
xmlpost.argname5: inifile
xmlpost.argvalue5: futuretense.ini
xmlpost.argname6: publication
xmlpost.argvalue6: FiscalNews

xmlpost.success: Success
xmlpost.failure: Error
xmlpost.logfile: ImageFilePost.txt

postpublication: y
postprimarypubid: y
postpublist: y

postcategory: y
truncategory: 4

postpath: y
truncpath: 255

postname: y
truncname: 32

posttemplate: y
trunctemplate: 32

postsubtype: y
truncsubtype: 24

postfilename: y
truncfilename: 64

poststartdate: y

postdescription: y
truncdescription: 128

postsource: y

posturlpicture: y
fileurlpicture: y

posturlthumbnail: y
fileurlthumbnail: y

postmimetype: y
postwidth: y
postheight: y
postalign: y
postalttext: y

postkeywords: y
multikeywords: combine
trunckeywords: 128

postimagedate: y

XMLPostソース・ファイルの使用

ソース・ファイルは、Document Type Definition (DTD)ファイルを必要としない整形式XMLで構成されている必要があります。実際には、構成ファイルは、ソース・ファイル内で処理されるタグを定義することでDTDファイルのような役割を果たします。

ソース・ファイル内のデータは、そのタイプのアセットが格納されている表の列名と一致する名前を持つタグによってタグ付けされている必要があります。たとえば、imagefileアセットのソース・ファイルでは、name、caption、picutureurlなどの名前を持つタグが使用されています。

この項では、ソース・ファイルに含める必要のある内容と、XMLPostがソース・ファイルに対して実行する処理について説明します。ここでは、XMLソース・ファイルの生成を自動化する方法は説明しません。ソース・ファイルの作成方法は、データのソースと、そのデータをXMLファイルに変換するために使用するツールによって異なります。

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

XMLPostのサンプル・ソース・ファイル

ここでは、imagefileアセットのサンプル・ソース・ファイルを示します。このファイル内のタグは、「XMLPostのサンプル構成ファイル」に示したサンプル構成ファイルで定義されています。

<document>
<name>High Five 25</name>
<keyword>Five</keyword>
<category>a</category>
<artist>by Ann. Artist</artist>
<alttext>Congratulations</alttext>
<align>CENTER</align>
<caption>A man extends <keyword>congratulations</keyword> with a boy.</caption>
<pictureurl>/images/eZine/highfive.jpg</pictureurl>
</document>

データを渡す(ポストする)方法

ソース・ファイル内のXMLタグのペアの内側にあるすべてのテキストは、Variables.tagnameという構文規則に従った変数として、XMLPostからRemoteContentPostエレメントに渡されます。

たとえば、次のコードでは、

<name>High Five 25</name>

このコード行は、Variables.nameとしてRemoteContentPostに送信され、nameの値はHigh Fiveという文字列になります。

XMLPostとファイル・エンコード方式

ソース・ファイル内のデータに使用されているファイル・エンコード方式が、WebCenter Sitesシステムのデフォルト・ファイル・エンコード方式ではないが、データベースがその文字セットに対応している場合は、ソース・ファイルの先頭のXMLバージョン文で、その代替のファイル・エンコード方式を指定します。たとえば:

<?xml version= "1.0" encoding="UTF-8" ?>

XMLPostユーティリティの使用

XMLPostユーティリティは、コマンドライン、スクリプト・ファイル、バッチ・ファイルまたはプログラムから起動できます。

どの方法でXMLPostを起動する場合でも、次の情報を提供する必要があります。

使用する構成ファイルの名前。
ソース・ファイル。ソース・ファイルは、単一のファイルとして、ファイルのリストとしてまたはファイルのディレクトリとして指定できます。

次のトピックを参照してください。

開始する前に

XMLPostユーティリティを使用する前に、次の条件が満たされている必要があります。
- 使用するアセット・タイプが作成されていること。(作成されていない場合は、アセットをインポートする先となるデータベース表がありません。)
- 使用するコンテンツ管理サイトが作成されており、適切なアセット・タイプが各サイトに対して有効化されていること。
- ワークフローを使用する場合は、使用するワークフロー・プロセスが作成されていること。
- スタート・メニュー・ショートカットが作成されていること。ワークフローを使用する場合は、これらのショートカットによって適切なワークフロー・プロセスが適切なアセット・タイプに割り当てられていること。
- 使用するアセット・タイプのテンプレートが作成されていること。
- 使用するアセット・タイプのアソシエーション・フィールドが作成されていること。ただし、XMLPostを使用してアソシエーション・フィールドの値を設定するには、カスタム・コードが必要です。RemoteContentPostとPreUpdateのカスタマイズを参照してください。
XMLPostを起動する際は、UTF-8エンコード方式が確実に使用されるようにするために、クラスパスの前に-Dfile.encoding=UTF-8というコマンドを挿入してください。
ノート:
- すべての.jarファイルのバージョン番号を確認してください。バージョン番号は、WebCenter Sitesのパッチ間で異なる可能性があります。
- XML Postインポート用としてUTF-8を使用してエンコードされたファイルを作成する場合、UTF-8ではBOMが必要なく推奨もされないため、BOMを使用せずに作成するようにしてください。ただし、BOMを使用する他のエンコード・フォームからUTF-8データを変換する場合や、BOMをUTF-8署名として使用する場合、BOMの使用が発生する可能性があります。

コマンドラインからのXMLPostの実行

XMLPostを実行するには:

構成ファイルとソース・ファイルを、WebCenter Sitesがインストールされているシステム上のディレクトリに配置します。
XMLPostを起動し稼働するには、クラスパスに<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\*、<ORACLE_HOME>\oracle_common\modules\clients\*、<ORACLE_HOME>\oracle_common\modules\thirdparty\*および<ORACLE_HOME>\wcsites\wcsites_common\lib\*ディレクトリを設定します。
そのディレクトリから次のコマンドを(単一のコマンドラインで)実行します。
この例では、LinuxおよびSolarisを含むUNIXベースのシステム用に、Windowsの構文を使用します。区切りには、スラッシュ(/)およびコロン(:)を使用します。

ノート:

iniファイルにユーザー資格証明を指定できなくなりました。これらを指定する唯一の方法は、コマンドラインを使用する方法です。
```
java -Xmx512m -Dfile.encoding=UTF-8 -Dhttpclient=true -classpath
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\*;
<ORACLE_HOME>\oracle_common\modules\clients\*;
<ORACLE_HOME>\oracle_common\modules\thirdparty\*; 
<ORACLE_HOME>\wcsites\wcsites_common\lib\*;
<cs_app_dir>\WEB-INF\lib\servlet-api.jar;
<Sites WLS Domain>\wcsites\wcsites\config\*
COM.FutureTense.XML.Post.XMLPostMain -sSourcefile.xml -cConfigfile.ini
-ufwadmin -pxceladmin 
```
ここで:
- -Xmx512mは、使用する最大メモリーを設定します。これは、大きな挿入操作に必要です。
- <cs_app_dir>は、WebCenter Sitesアプリケーションが配置されているアプリケーション・サーバー上のディレクトリです。
ソース・ファイルを指定するには複数の方法があります。詳細は、「ソース・ファイルの識別」を参照してください。

ノート:

j2ee.jarファイルは、J2EE SDKに含まれています。XMLPostを実行する前に、このSDKをインストールする必要があります。

コマンドラインで、作業ディレクトリ内にないソース・ファイルおよび構成ファイルへのパスを指定します。たとえば: -s/products/product.xml。

ソース・ファイルの識別

XMLPostユーティリティに対してソース・ファイルを指定するためのソース・パラメータでは、次のいずれかを指定できます。

単一のファイル。
ファイルのディレクトリ。そのディレクトリ内のファイルのうち、構成ファイルで指定されたファイル拡張子(通常は.xml)を持つすべてのファイルがポスト(インポート)されます。
インポートするすべてのファイルのリストが記述されたリスト・ファイル。このファイルは.iniファイルと似ていますが、ファイル拡張子は.lstです。

単一のファイル

単一のファイルの内容をポストするには、そのファイルの名前をコマンドラインで指定します。次の例では、articlepost.iniという名前の構成ファイルとarticle.xmlという名前のソース・ファイルを使用するようにXMLPostに指示しています。

この例では、LinuxおよびSolarisを含むUNIXベースのシステム用に、Windowsの構文を使用します。区切りには、スラッシュ(/)およびコロン(:)を使用します。

java -Xmx512m -Dfile.encoding=UTF-8 -Dhttpclient=true -Dsites.config=<Sites WLS Domain>\wcsites\wcsites\config -classpath  
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\apache-mime4j-0.5.jar; 
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\commons-codec-1.7.jar;
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\commons-fileupload-1.3.1.jar; 
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\commons-lang-2.5.jar;
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\commons-lang3-3.1.jar;
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\commons-logging-1.1.3.jar;
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\esapi-2.0.1.jar;
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\httpclient-4.3.6.jar;
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\httpcore-4.3.3.jar;
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\httpmime.jar;
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\log4j-1.2.17.jar;
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\sites-cache.jar;
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\sites-core.jar;
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\sites-cs.jar;
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\sites-msxml.jar;
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\sites-nio.jar;
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\sites-security.jar;
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\spring-beans-3.2.6.RELEASE.jar;
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\spring-context-3.2.6.RELEASE.jar; 
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\spring-core-3.2.6.RELEASE.jar; 
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\spring-expression-3.2.6.RELEASE.jar;
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\spring-web-3.2.6.RELEASE.jar;
<ORACLE_HOME>\oracle_common\modules\clients\com.oracle.jersey.fmw.client.jar; 
<ORACLE_HOME>\oracle_common\modules\clients\com.oracle.webservices.fmw.client.jar

COM.FutureTense.XML.Post.XMLPostMain -sSourcefile.xml -cConfigfile.ini
-ufwadmin -pxceladmin

ファイルのディレクトリ

ディレクトリ内のすべてのファイルをポストするには、そのディレクトリのパスをコマンドラインで指定します。次の例では、xmlpostfilesディレクトリ内のファイルをインポートするようにXMLPostに指示しています。

この例では、LinuxおよびSolarisを含むUNIXベースのシステム用に、Windowsの構文を使用します。区切りには、スラッシュ(/)およびコロン(:)を使用します。

java -Xmx512m -Dfile.encoding=UTF-8 -Dhttpclient=true -Dsites.config=<Sites WLS Domain>\wcsites\wcsites\config -classpath  
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\apache-mime4j-0.5.jar; 
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\commons-codec-1.7.jar;
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\commons-fileupload-1.3.1.jar; 
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\commons-lang-2.5.jar;
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\commons-lang3-3.1.jar;
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\commons-logging-1.1.3.jar;
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\esapi-2.0.1.jar;
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\httpclient-4.3.6.jar;
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\httpcore-4.3.3.jar;
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\httpmime.jar;
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\log4j-1.2.17.jar;
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\sites-cache.jar;
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\sites-core.jar;
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\sites-cs.jar;
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\sites-msxml.jar;
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\sites-nio.jar;
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\sites-security.jar;
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\spring-beans-3.2.6.RELEASE.jar;
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\spring-context-3.2.6.RELEASE.jar; 
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\spring-core-3.2.6.RELEASE.jar; 
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\spring-expression-3.2.6.RELEASE.jar;
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\spring-web-3.2.6.RELEASE.jar;
<ORACLE_HOME>\oracle_common\modules\clients\com.oracle.jersey.fmw.client.jar; 
<ORACLE_HOME>\oracle_common\modules\clients\com.oracle.webservices.fmw.client.jar

COM.FutureTense.XML.Post.XMLPostMain -sxmlpostfiles -carticlepost.ini -ufwadmin -pxceladmin

リスト・ファイル

ディレクトリを指定するかわりに、次のプロパティが含まれた.iniファイル形式のリスト・ファイルを作成できます。

numfiles: リストに含まれるファイルの数を指定します。
fileN: ファイルのパスとファイル名を指定します。Nは、リスト・ファイル内のそのファイルの順番を表します。リストの1番目のファイルはfile1、2番目のファイルはfile2というようになります。

リストの最後のfileNのNの値は、numfilesプロパティで指定された値と一致する必要があります。XMLPostは、numfilesプロパティで指定された数のファイルをインポートした時点で、インポートを終了します。XMLPostは、numfiles状態の値よりも多くのファイルはインポートしません。

リスト・ファイルのファイル拡張子は、.lstにする必要があります。

次のサンプル・リスト・ファイルはxmlpostfiles.lstという名前です。

numfiles: 3
file1: c:\xmlpost\article1.xml
file2: c:\xmlpost\article2.xml
file3: c:\xmlpost\article3.xml

このファイル・リストで指定されたファイルをポストするには、このリスト・ファイルの名前をコマンドラインで指定します。次の例では、xmlpostfiles.lstファイルで指定されたファイルをインポートするようにXMLPostに指示しています。

この例では、LinuxおよびSolarisを含むUNIXベースのシステム用に、Windowsの構文を使用します。区切りには、スラッシュ(/)およびコロン(:)を使用します。

java -Xmx512m -Dfile.encoding=UTF-8 -Dhttpclient=true -Dsites.config=<Sites WLS Domain>\wcsites\wcsites\config -classpath  
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\apache-mime4j-0.5.jar; 
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\commons-codec-1.7.jar;
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\commons-fileupload-1.3.1.jar; 
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\commons-lang-2.5.jar;
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\commons-lang3-3.1.jar;
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\commons-logging-1.1.3.jar;
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\esapi-2.0.1.jar;
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\httpclient-4.3.6.jar;
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\httpcore-4.3.3.jar;
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\httpmime.jar;
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\log4j-1.2.17.jar;
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\sites-cache.jar;
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\sites-core.jar;
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\sites-cs.jar;
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\sites-msxml.jar;
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\sites-nio.jar;
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\sites-security.jar;
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\spring-beans-3.2.6.RELEASE.jar;
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\spring-context-3.2.6.RELEASE.jar; 
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\spring-core-3.2.6.RELEASE.jar; 
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\spring-expression-3.2.6.RELEASE.jar;
<ORACLE_HOME>\wcsites\webcentersites\sites-home\lib\spring-web-3.2.6.RELEASE.jar;
<ORACLE_HOME>\oracle_common\modules\clients\com.oracle.jersey.fmw.client.jar; 
<ORACLE_HOME>\oracle_common\modules\clients\com.oracle.webservices.fmw.client.jar

COM.FutureTense.XML.Post.XMLPostMain-sc:\xmlpostfiles.lst -carticlepost.ini -ufwadmin -pxceladmin

バッチ・プロセスとしてのXMLPostの実行

複数のタイプのアセットをインポートする場合は、アセット・タイプごとに個別にXMLPostを実行することにより、タイプごとに固有の構成ファイルを指定します。XMLPostは、手動で実行することも、バッチ・ファイルから自動的に実行することもできます。このバッチ・ファイル内には、アセット・タイプごとに1つのコマンドライン文を記述します(この文では構成ファイルと、ソース・ファイルの場所を指定します)。前の項で説明した方法のいずれかを使用してソース・ファイルを指定できます。

プログラムからのXMLPostの実行

XMLPostユーティリティをプログラムから起動するには、XMLPostオブジェクトを作成して、doItメソッドのdoIt(String[] args)をコールします(このメソッドの入力は文字列配列です)。この配列のエレメントは、XMLPostをコマンドラインから実行する場合に使用するのと同じフラグです。

たとえば:

String args [] = {"-sSourcefile.xml","-cConfigfile.ini"};
COM.FutureTense.XML.Post.XMLPost poster = new
COM.FutureTense.XML.Post.XMLPost();
try {
  poster.doIt(args);
  } catch (Exception e) {
  e.printStackTrace();("error in XMLPost under program control");
}

ソース・ファイルと構成ファイルの完全パスを指定する必要があります。

RemoteContentPostとPreUpdateのカスタマイズ

必要に応じて、アセット・タイプのRemoteContentPostエレメントやPreUpdateエレメント内のコードを追加または変更することで、XMLPostプロセスをカスタマイズできます。

アセットに関する情報を他の表にインポートするには、そのアセット・タイプのPreUpdateエレメントを変更する必要があります。

この項では、次の2つのカスタマイズ例を紹介します。

Articleアセット・タイプのPreUpdateエレメントをカスタマイズして、このエレメントで説明フィールド内のヘッドライン情報が設定されるようにします。Article表にはdescription列がありますが、「新規」記事フォームや「編集」記事フォーム内のフィールドの名前は「ヘッドライン」になります。
Articleアセット・タイプのPreUpdateエレメントをカスタマイズして、このエレメントが記事にアソシエーションを追加できるようにします。

次のトピックを参照してください。

プログラムによるフィールド値の設定

記事アセット・タイプは、「ヘッドライン」と呼ばれる「新規」および「編集」フォーム内にフィールドを持ち、その値はArticle表内のdescription列に格納されます。Articleアセットのインポート時にヘッドライン・テキストが正しい列(description列)に書き込まれるようにするために、Articleアセット・タイプのPreUpdateエレメントが変更されます。

まず、WebCenter Sites製品キット内のXcelerate/Samples/XMLPostディレクトリに配置されたArticlePost.iniという名前のサンプル構成ファイルを調べます。このファイルには、次のように「ヘッドライン」フィールドに対して指定されたタグが含まれています。

# headline gets stored in the description field
postheadline: y

記事アセット・タイプのPreUpdateエレメント内の次のコードは、RemoteContentPostがVariable.headlineとして渡すデータを正しいデータベース列に書き込みます。

<if COND="IsVariable.headline=true">
  <then>
    <ASSET.SET NAME="theCurrentAsset" 
     FIELD="description" 
     VALUE="Variables.headline"/>
  </then>
</if>

この例では、ASSET.SETというタグを使用しています。このタグは、現在メモリー内にあるアセットのフィールド内のデータを設定します。このタグでは次の3つのパラメータを指定できます。

NAME: (必須)。メモリーに格納されているアセット・オブジェクトの名前です。このアセット・オブジェクトは、ASSET.LOADタグかASSET.CREATEタグで、あらかじめインスタンス化されている必要があります。WebCenter Sitesでは慣例的にtheCurrentAssetという名前を使用して、現在のアセット・オブジェクトを参照します。
FIELD: (必須)。値を設定しようとしているフィールドの名前。このフィールドの名前は、このタイプのアセットの記憶域表内の列の名前と完全に一致している必要があります。
VALUE: (必須)。列に挿入するデータ。

アセットのアソシエーションの設定

アセット間のアソシエーションに関する情報は、AssetRelationTree表に書き込まれます。XMLPostの標準動作では、アセットの情報はそのアセット・タイプのプライマリ記憶域表にのみ書き込まれるため、アセットのアソシエーションを指定するには、そのアセット・タイプのPreUpdateエレメントを変更する必要があります。たとえば、Articleアセット・タイプにはMainImageFileという名前のアソシエーション・フィールドがあります。コンテンツ・プロバイダは記事アセットを作成する際に、適切なイメージファイル・アセットをこのフィールドで選択します。

WebCenter Sites製品キット内のXcelerate/Samples/XMLPostディレクトリに配置されたArticlePost.iniという名前のサンプル構成ファイルを調べてください。このファイルには、次のようにMainImageFileアソシエーション・フィールドに対して指定されたタグが含まれています。

postMainImageFile-name: y

記事アセット・タイプのPreUpdateエレメント内の次のコードは、RemoteContentPostがVariable.mainimagefileとして渡すデータを正しいデータベース表に書き込みます。

<if COND="IsVariable.MainImageFile-name=true">
<then>
 <ASSET.LOAD NAME="anAssociatedImage" TYPE="ImageFile"
  FIELD="name" VALUE="Variables.MainImageFile-name"/>
  <if COND="IsError.Variables.errno=false">
    <then>
      <ASSET.GET NAME="anAssociatedImage" FIELD="id" OUTPUT="imageid"/>
      <ASSET.ADDCHILD NAME="theCurrentAsset" TYPE="ImageFile"
       CHILDID="Variables.imageid" CODE="MainImageFile"/>
    </then>
  </if>
</then>
</if>

ノート:

ASSET.ADDCHILDタグは、2つのアセット間のリンクのみを作成します。関連付けられたアセットは作成しません。このコードが正常に機能するためには、CHILDIDパラメータで指定されたアセットが、WebCenter Sitesデータベース内に存在している必要があります。

この例では、ASSET.ADDCHILDというタグを使用しています。このタグは、子アセットを、現在メモリー内に保持されているアセットと関連付けます。このタグでは次の5つのパラメータを指定できます。

NAME: (必須)。メモリーに格納されているアセット・オブジェクトの名前です。このアセット・オブジェクトは、ASSET.LOADタグかASSET.CREATEタグで、あらかじめインスタンス化されている必要があります。WebCenter Sitesでは慣例的にtheCurrentAssetという名前を使用して、現在のアセット・オブジェクトを参照します。
TYPE: (必須)。子アセットのアセット・タイプ。
CHILDID: (必須)。子アセットのID。
CODE (オプション)。アソシエーションの名前。この値は、AssetRelationTree表のncode列に書き込まれます。
RANK (オプション)。子アセットの順番を設定するための数値。この値は、AssetRelationTree表のnrank列に書き込まれます。

ASSET.GETおよびASSET.LOADの詳細は、『Oracle WebCenter Sitesリファレンス・タグ・リファレンス』を参照してください。

XMLPostのトラブルシューティング

XMLPostが実行されず、ログ・ファイルが作成されないことがあります。アセットを保存しようとすると、エラー105が発生することがあります。さらに読み進めると、XMLPostエラーおよびポスト・エレメントのデバッグに関する理解が深まります。

ここでは、XMLPostユーティリティの実行時に発生する可能性のあるいくつかの問題について簡単に説明します。

XMLPostが実行されず、ログ・ファイル・メッセージが作成されない

XMLPostが起動しない理由としては次の2つが考えられます。

構成ファイル内のxmlpost.URLプロパティの設定で無効なサーバー名が指定されています。
インポート先のシステム上でWebCenter Sitesが実行されていません。それを起動してください。

XMLPostでエラーが発生して、ログ・ファイルにエンティティの欠落というメッセージが記録されている

このメッセージは、ソース・ファイル内に無効なXMLがあることを意味します。このような場合は通常、XMLにHTMLコードが含まれており、そのコードに含まれている特殊なHTML文字がそれらのHTML文字の文字エンティティ・コードで参照されていません。最適なコーディング手法として、すべてのHTMLコードを<![CDATA[...]]>タグ内に埋め込んでください。

XMLPostがアセットを保存しようとするとエラー105が発生する

アセットの保存時にデータベース・エラーが発生する理由はいくつか存在します。105エラーの一般的な理由の1つは、XMLPostが保存しようとしているデータが大きすぎて列(フィールド)に収まらないことです。この問題の解決方法は目的に応じて異なります。列に収まらないデータが途中で切り捨てられてもかまわない場合は、trunctagプロパティを構成ファイルに追加することで解決できます。たとえば、truncbody: 2000と指定します。

このエラー・コードのもう1つの一般的な理由は、同じ名前を持つそのタイプのアセットが存在していることです。そのアセットの名前を変更してから、そのアセットをもう一度インポートしてみてください。

ポスト・エレメントのデバッグ

RemoteContentPostエレメントを変更した場合、または独自のポスティング・エレメントを作成した場合、XML Debuggerユーティリティを使用してこのエレメントをテストします。XML Debuggerを使用するには、xmlpost.urlプロパティの設定でContentServerをDebugServerに置き換えます。たとえば、xmlpost.url: http://6ipjk/servlet/ContentServerをxmlpost.url: http://6ipjk/servlet/DebugServerに変更します

WebCenter Sitesのツールおよびユーティリティの概要のXML Debuggerユーティリティを参照してください。