第7章

コンテンツのインポートおよびエクスポート

この章では、exteNd DirectorContentManagementサブシステムに提供されているインポート機能およびエクスポート機能について説明します。この章は、次の節から構成されています。

インポートおよびエクスポートについて

CMサブシステムには、データベース間または単一のデータベース内でデータをインポートおよびエクスポートするための機能が含まれています。

インポート機能およびエクスポート機能の使用には次の操作が含まれます。

リポジトリ内でフォルダ、カテゴリ、およびドキュメントを移動したり、コピーしたりする。
異なる開発段階で、CMデータを移動する。
サードパーティベンダと統合する。
CMデータのバックアップを作成し、復元する。
デバッグおよびデータ分析を行う。

この章では、インポート機能およびエクスポート機能の動作、およびこれらの機能をカスタマイズする方法について説明します。

インポート機能およびエクスポート機能の使用

For more information CMS管理コンソールのインポート機能およびエクスポート機能を使用できます。

For more information 詳細については、

エクスポート機能について

エクスポート機能には、次の要素が含まれます。

エクスポート機能要素	説明
エクスポートコンポーネント(複数可)	ユーザにより選択されたDED (データエクスポート記述子)を取得し、EbiExporterオブジェクトにより生成されたCMアーカイブをユーザが保存できるようにするポータルポートレット(または他のUI要素)。注記: この機能は、CMS管理コンソールで提供されています。
DED (データエクスポート記述子)	ユーザにより選択されたエクスポートデータを定義するXML記述子。詳細については、データエクスポート記述子(DED)のカスタマイズを参照してください。
EbiExporter	CMデータをエクスポートするためのAPIが含まれます。このオブジェクトは、DEDで指定されたスコープに基づいてデータのCMリポジトリを照会してから、その結果をCMアーカイブにパッケージ化します。
CMエクスポートサーブレット	EbiExporterオブジェクトとエクスポータポートレット間での接続を提供します。このオブジェクトは、ポートレットからエクスポータAPIにDEDを渡し、エクスポータからCMアーカイブを取得してそれをポートレットに返します。
CMアーカイブ	後のインポート機能での使用に備えて、CMエクスポートデータおよびデフォルトのDID (データインポート記述子)を含むZIPファイル。アーカイブコンテンツの詳細については、データインポートまたはエクスポートアーカイブの構造を参照してください。

エクスポートプロセス

エクスポートプロセスは、次のように機能します。

exportProcess

選択したDEDがポートレットによって取得され、CMエクスポートサーブレットに渡されると、エクスポートプロセスが開始します。
エクスポートサーブレットは、EbiExporter APIを実装するオブジェクトにDEDを転送します。

注記: サーブレットでは、EbiExporter APIへのリモートアクセスが提供されますが、ポートレットでは、APIを直接呼び出すことができます。
CMエクスポータAPIでは、DEDを使用して、ユーザが特定したすべてのデータおよびインフラストラクチャを表すクエリを作成し、CMデータベースに対してクエリを実行します。
CMデータベースは、加工されていない結果セットを返すことによって、クエリに応答します。
CMエクスポータAPIでは、加工されていないクエリ結果を、コンテンツおよびデータ記述子を含む構造化されたZIPアーカイブファイルにフォーマットして、アーカイブをエクスポートサーブレットに返します。
エクスポートサーブレットは、MIMEタイプがapplication/zipのコンテンツのバイト列として、ZIPファイルをポートレットに返します。
エクスポートポートレットでは、ZIPファイルを取得し、ユーザが指定したディスクの場所に保存します。

インポート機能について

インポート機能は、次の要素から構成されています。

インポート機能要素	説明
インポートコンポーネント(複数可)	インポートデータをユーザが選択するためにUIを提供するポータルポートレット(または他のUI要素)。このインポート機能は、CMS管理コンソールで提供されています。
DID (データインポート記述子)	エクスポータにより生成されたCMアーカイブのコンテンツに基づくXML記述子。詳細については、DID (データインポート記述子)についてを参照してください。
EbiImporter	CMデータをインポートするためのAPIが含まれます。CMアーカイブからDIDを抽出し、これを使用してターゲットデータベースにデータを挿入します。
CMインポートサーブレット	EbiImporterとCMS管理コンソール間の接続を提供します。このオブジェクトは、CMアーカイブをインポータAPIに渡し、インポートプロセスで発生した警告や失敗をすべて表示するXMLドキュメントを作成します。

インポートプロセス

インポートプロセスは、次のように機能します。

importProcess

ポートレットにより、ユーザがDIDを含むCMアーカイブを選択できるようになると、インポートプロセスが開始します。

CMアーカイブは、エクスポート機能により生成されます。
インポートポートレットは、HTTPを介してCMインポートサーブレットにZIPファイルをポストします。

注記: サーブレットでは、EbiImporter APIへのリモートアクセスが提供されますが、ポートレットでは、APIを直接呼び出すことができます。
インポートサーブレットは、ZIPファイルを入力ストリームとしてCMインポータに渡します。
CMインポータは、ZIPからDIDを抽出し、これを使用してZIPファイルから基盤となるコンテンツリポジトリにデータを転送します。
CMインポータは、CMインポートサーブレットに実行の要約を返します。
インポートサーブレットは、インポートプロセス中に発生した成功、警告、失敗を表すXMLドキュメントを作成します。
インポートサーブレットは、ポートレットにXMLドキュメントを返し、その結果、ユーザに対してレポートが生成されます。

インポートおよびエクスポートのカスタマイズ

データのインポートおよびエクスポートをカスタマイズするいくつかの方法を次に示します。

操作	オプションのカスタマイズ
エクスポートの場合	カスタムDEDファイルを指定してから、エクスポートを実行する
インポートの場合	生成されたDIDを編集してから、インポートを実行する
インポートの場合	CMアーカイブから項目を追加または削除してから、インポートを実行する
エクスポートまたはインポートの場合	インポートAPIおよびエクスポートAPIを実装することによって、独自の論理を提供する

データエクスポート記述子(DED)のカスタマイズ

DED (データエクスポート記述子)は、次の操作を実行するために使用できるXMLファイルです。

データエクスポートの設定オプションを設定する
エクスポートアーカイブに配置するCMデータを指定する

エントリの形式 DEDのエントリは、プロジェクトのlibrary/ContentMgmtService/ContentMgmtService.spf/DTDディレクトリにあるDTDに準拠している必要があります。

サンプルDEDファイルプロジェクトのlibrary/ContentMgmtService/ContentMgmtService.spf/DTDディレクトリには、いくつかのサンプルDEDファイルがあります。各サンプルは、次のような一般的なエクスポートシナリオを表します。

サンプルファイル	操作
contentmgmt-export-descr_5_0_sample.xml	CMシステムからすべてのデータをエクスポートする操作のオプションを指定する
contentmgmt-export-descr_5_0_sample2.xml	CMシステムから基盤となる特定のデータをエクスポートする
contentmgmt-export-descr_5_0_sample3.xml	CMシステムから基盤となる特定のデータをエクスポートする要素階層で依存する項目をエクスポートする
contentmgmt-export-descr_5_0_sample4.xml	デフォルトの設定オプションを使用して、すべてのドキュメントおよびサポートインフラストラクチャをエクスポートする
contentmgmt-export-descr_5_0_sample5.xml	contentmgmt-docmeta-search_5_0.dtdに従って、クエリを満たすドキュメントの特定の要素をエクスポートする

DID (データインポート記述子)について

DID (データインポート記述子)は、次の操作を実行するために使用できるXMLファイルです。

データインポートの設定オプションを設定する
各タイプのCMデータに対して上書きオプションを設定する
インポートのターゲットフォルダを指定する

エントリの形式 DIDのエントリは、プロジェクトのlibrary/ContentMgmtService/ContentMgmtService.spf/DTDディレクトリにあるcontentmgmt-import-descr_5_0.dtdに準拠している必要があります。

サンプルDIDファイルプロジェクトのlibrary/ContentMgmtService/ContentMgmtService.spf/DTDディレクトリには、サンプルDIDファイルがあり、利用可能なすべてのインポートオプションの設定方法を表示します。

contentmgmt-import-descr_5_0_sample.xml

インポートAPIおよびエクスポートAPIへのアクセス

多くの場合、記述子またはCMアーカイブを編集することで、ほとんどの必要な柔軟性が得られるはずですが、インポートAPIおよびエクスポートAPIに直接アクセスすると、1回限りのインポートおよびエクスポートから、独自の機能の作成に至るまで、さまざまなタスクを実行できます。

EbiImporterおよびEbiExporterで提供される機能は、次の場合に使用できます。

既存のドキュメントを新しいexteNd Director CMシステムにインポートする
CMデータのバックアップを作成し、復元する。
2つのCMシステム間でデータを複製する
単一のCMシステム内でデータを移動およびコピーする

For more information 詳細については、EbiExporterおよびEbiImporterのオンラインAPIマニュアルを参照してください。