| Oracle® Fusion Middleware Oracle WebCenter Portalの管理 11gリリース1 (11.1.1.9.0) E51441-06 |
|
 前 |
 次 |
| Oracle® Fusion Middleware Oracle WebCenter Portalの管理 11gリリース1 (11.1.1.9.0) E51441-06 |
|
前 |
次 |
この付録では、カスタムwiki抽出ツールをドキュメント移行ユーティリティと組み合せて使用することで、wikiコンテンツをConfluenceなどのwikiアプリケーションからWebCenter Portalに移行する方法について説明します。カスタムwiki抽出ツールは、ドキュメント移行ユーティリティを使用して、wikiコンテンツをWebCenter Portalコンテンツ・リポジトリにインポート可能なアーカイブ形式に抽出します。ポータル、ポータル・テンプレート、wikiドキュメントおよびwikiページに対してContent Serverで作成したコンテンツの理解とともにドキュメント移行ユーティリティおよびそのアーカイブの形式についての詳細な理解が必要です。
|
注意: WebCenter Portalのこのリリース(11.1.1.9.0)では、ポータル・フォルダとポータル・テンプレート・フォルダのエクスポートまたはインポートにドキュメント移行ユーティリティを使用しないでください。このリリース以降、コンテンツ・フォルダは、ポータルまたはポータル・テンプレートでエクスポートされます。詳細は、第40.1項「ポータルのデプロイ」および第40.2項「ポータル・テンプレートのデプロイ」を参照してください。 |
この付録には次のトピックが含まれます:
この項では、WebCenter Portalでのwikiドキュメントおよびwikiページの形式とその動作方法について説明します。WebCenter Portalでのwikiドキュメントおよびwikiページの詳細は、『Oracle WebCenter Portalの使用』の「Wikiでの作業」を参照してください。
この項には次のトピックが含まれます:
WebCenter Portalでは、ドキュメント・タスク・フローを使用してwikiドキュメントを作成できます。これらのドキュメントは、ポータル内に作成されたフォルダ階層の任意の場所に置くことができます。Wikiドキュメントは他のタイプのドキュメントとともに存在するか、または単一フォルダ内にすべてのwikiドキュメントを配置することを選択できます。
wikiドキュメントがWebCenter Portalで作成される場合、HTMLドキュメントが作成され、Content Serverにチェックインされます。このwikiドキュメントには、ドキュメントが通常のHTMLドキュメントではなく、wikiドキュメントであることをWebCenter Portalに伝える特別なメタデータ値が含まれます。これらのメタデータ値は次のとおりです。
dDocType = Application dDocFunction = wiki dOriginalName (document filename) = <wikiName>.htm
前述のメタデータを含むWebCenter Portalのドキュメントを開く場合、WebCenter Portalはそれをwikiドキュメントとして表示します。
WebCenter Portalで、Wikiページ・テンプレートに基づいてページを作成することによりwikiページを作成できます。wikiページに移動すると、wikiドキュメントが表示されます。ポータルの表示テンプレートに従って、クリックして、ポータルにすべてのwikiページをリストすることができる「Wiki」メニューを表示することができます。wikiページの作成方法の詳細は、『Oracle WebCenter Portalの使用』の「Wikiでの作業」を参照してください。
wikiページがWebCenter Portalで作成される場合、次のアーティファクトがContent Serverで作成されます。
wikiフォルダが、wikiページが作成されているポータルのフォルダに作成され、wikiフォルダの名前はwikiページ名と同じですが、特殊文字が削除されています。
/RootFolder/PortalFolder/wikiPageNameFolder/
ルート・フォルダは、Content Serverでフォルダ・サービスとしてFolders_gまたはFrameworkFoldersのどちらが有効化されているかに依存します。Folders_gが有効化されている場合、wikiフォルダは次のパスに作成されます。
/WebCenter/PortalFolder/wikiPageNameFolder/
FrameworkFoldersが有効化されている場合、wikiフォルダは次のパスに作成されます: /Enterprise Libraries/PortalFolder/wikiPageNameFolder/
ドキュメントは、次のメタデータとともにwikiフォルダ内に作成されます。
dDocTitle = ドキュメント・タイトル(wikiページ名と同じ名前で、拡張子.htmを持つ)
dOriginalName = ドキュメント・ファイル名(dDocTitleと同じ)
dDocFunction = wiki
dDocType = Application
xWCPageID = wikiページのJSPXページの名前
これは例を使用して適切に示されます。wikiページが作成されているポータルがMarketingで、作成されているwikiページがWiki1の場合、次のアーティファクトがContent Serverで作成されます。
フォルダ:
Folders_g設定内のフォルダの場所: /WebCenter/Marketing/Wiki1
FrameworkFolders設定内のフォルダの場所: /Enterprise Libraries/Marketing/Wiki1
ドキュメント:
Folders_g設定内のドキュメントの場所: /WebCenter/Marketing/Wiki1/Wiki1.htm
FrameworkFolders設定内のドキュメントの場所:
/Enterprise Libraries/Marketing/Wiki1/Wiki1.htm
ドキュメントの属性セット:
dDocTitle= Wiki1.htm
dOriginalName = Wiki1.htm
dDocFunction = 'wiki'
dDocType = 'Application'
xWCPageID = Wiki1.jspx
wikiページに移動すると、次の処理が実行されます。
Content Serverが次の場所のドキュメントを問い合せます。
/RootFolder/PortalFolder/wikiPageNameFolder/wikiPageName.htm
ドキュメントが見つかった場合は、wikiドキュメントとして表示されます。
ドキュメントでwikiページが見つからない場合は、wikiフォルダのコンテンツが表示されます。
WebCenter Portalのこのリリース(11.1.1.9.0)では、第F.3項「ソースWikiアプリケーションからWebCenter Portalへのデータの移行」で説明されているように、既存のwikiアプリケーションからWebCenter Portalへのコンテンツの移行には、ドキュメント移行ユーティリティのみを使用してください。
|
注意: ポータル・フォルダとポータル・テンプレート・フォルダのエクスポートまたはインポートにドキュメント移行ユーティリティを使用しないでください。このリリースでは、コンテンツ・フォルダは、ポータルまたはポータル・テンプレートでエクスポートされます。詳細は、第40.1項「ポータルのデプロイ」および第40.2項「ポータル・テンプレートのデプロイ」を参照してください。 |
この項では、ドキュメント移行ユーティリティについて説明します。この付録には、次の項があります。
エクスポート時に、指定されたポータルおよびポータル・テンプレートのContent Serverに格納されたドキュメント・コンテンツは、ドキュメント移行アーカイブに抽出されます。ドキュメント移行アーカイブは、ポータルまたはポータル・テンプレートのすべてのコンテンツをアーカイブのその独自のトップレベル・フォルダに抽出します。このフォルダの名前は、Content Serverのポータルまたはポータル・テンプレート・フォルダの内部GUIDに基づいています。
ドキュメント移行アーカイブには、エクスポートでは各ポータルまたはポータル・テンプレートのルート・フォルダが含まれます。つまり、4つのポータルからコンテンツをエクスポートする場合、アーカイブには4つのルート・フォルダがあります。これらのルート・フォルダの名前は、Content Serverの対応するポータルまたはポータル・テンプレート・フォルダの内部GUIDに基づいています。
ポータルまたはポータル・テンプレートごとに1つのアーカイブを持つために、ドキュメント移行ユーティリティは一度に1つのポータル/ポータル・テンプレートおよび固有のアーカイブ名を指定して、コールされる必要があります。
アーカイブ内の各トップ・レベル・フォルダにはXMLドキュメントが存在し(ExportImportData.xml)、そのルート・フォルダにあるデータについて詳細に説明しています(つまり、そのポータルまたはポータル・テンプレート用にエクスポートされたデータについて説明しています)。また、インポート時にメンテナンスされる、ソースContent Server内のフォルダおよびファイルのすべてのメタデータも含まれています。アーカイブの形式の詳細は、第F.2項「ドキュメント移行ユーティリティの理解」を参照してください。また、ソースとターゲット間でメンテナンスされるメタデータの詳細は、第F.2.2.1項「ドキュメント移行ユーティリティのメタデータの処理方法の理解」を参照してください。
コンテンツがエクスポートされるポータルまたはポータル・テンプレートがある場合、エクスポート中に次が発生します。
一時ディレクトリが作成されます。
各ポータルまたはポータル・テンプレートに対して
ディレクトリが、その名前がContent Serverの対応するフォルダのGUIDである一時ディレクトリに作成されます
ExportImportData.xmlドキュメントがその新しいディレクトリ内に作成されます
Content Serverは、ポータル/ポータル・テンプレートのコンテンツを問い合せます
コンテンツがある場合、コンテンツが読み込まれ、フォルダおよびドキュメントに関する情報がExportImportData.xmlドキュメントに記述されます。実際のファイルは、Content Serverとしてフォルダ階層を維持するディレクトリにダウンロードされます。たとえば、Content Serverで、ドキュメントdoc1.docがフォルダFolder1内にある場合、次に示すように、ドキュメントはFolder1の下のルート・フォルダに追加されます。
/<tmpDir>/<portalFolder>/Folder1/doc1.doc
すべてのコンテンツが抽出された後で、一時ディレクトリのコンテンツ全体がドキュメント移行アーカイブに圧縮されます。
ドキュメント移行ユーティリティを使用してコンテンツをインポートする前に、ターゲットのポータルまたはポータル・テンプレート(あるいはその両方)がターゲットContent Serverに存在している必要があります。これらのフォルダがContent Serverに存在しない場合、ドキュメント・コンテンツのインポートは失敗します。
|
注意: ソース内にあるのと同じ名前を持つポータルまたはポータル・テンプレートをターゲット内に作成して、動作させることはできません。この操作を行うと、Content Server内のフォルダの名前がソース内にあるフォルダと同じ名前になりますが、GUIDは異なります。このフォルダGUIDは、WebCenter Portal内のポータルとContent Server内のフォルダを結び付けるために使用され、さらにエクスポート・アーカイブ内のデータとターゲットContent Server内のターゲット・フォルダを同期化するのにも使用されます。 |
インポート時に、ドキュメント移行アーカイブが読み込まれ、各ポータルまたはポータル・テンプレートのデータごとに、ターゲットContent Serverの対応するポータルまたはポータル・テンプレートのフォルダにコンテンツが再作成されます。アーカイブのトップ・レベル・フォルダの名前は、ターゲットContent Serverインスタンスのポータルまたはポータル・テンプレート・フォルダと同期化するために使用されます。ターゲットContent Serverのポータルまたはポータル・テンプレート・フォルダにコンテンツがすでに含まれている場合、そのコンテンツはインポート処理が開始される前に削除されます。
|
注意: ファイル内のすべてのプロパティを指定して、ドキュメント移行ユーティリティを実行する場合、デフォルトの動作は、プロパティ・ファイルのCheckExistingContentsプロパティ(値はtrueまたはfalse)を指定することにより上書きできます。falseに設定される場合、ターゲット・フォルダが既存のコンテンツに対してチェックされないようにデフォルトの動作がオーバーライドされ、既存のコンテンツは削除されません。この設定がfalseの場合は注意する必要があります。ターゲットのコンテンツが同じコンテンツIDを持つか、同じフォルダのコンテンツが同じファイル名を持つ場合、インポートは失敗します。 |
各トップ・レベル・フォルダ内にあるXMLドキュメント(ExportImportData.xml)は、インポートを実行するために使用されます。このドキュメントには、ターゲットContent Server内で再作成するファイルとフォルダの階層が記述されています。また、アーティファクトの作成時に使用されるメタデータ、またドキュメントについては、アップロード時に使用するアーカイブのネイティブ・ファイルのパスも含まれています。アーカイブの形式の詳細は、第F.2項「ドキュメント移行ユーティリティの理解」を参照してください。
インポート時に、次の操作が実行されます。
ドキュメント移行アーカイブが一時ディレクトリに解凍されます。
アーカイブのルートにある各フォルダに対して(ポータルまたはポータル・テンプレートを表す)
対応するフォルダは、ターゲットContent Serverインスタンスから取得されます(Content ServerのフォルダのGUIDであるフォルダ名を使用)。
ExportImportData.xmlドキュメントが読み込まれます
ExportImportData.xmlで記述される各フォルダまたはファイルに対して、コンテンツがターゲット・インスタンスで再作成されます。
フォルダおよびファイルのExportImportData.xmlドキュメントの属性は、作成されるコンテンツのメタデータとして使用され、ファイルはアーカイブの対応する場所からアップロードされます。
インポートが成功した場合は、その最後に、この一時ディレクトリは削除されます。完了する前にインポートが失敗する場合は、この一時ディレクトリはそのまま残ります。
ドキュメント移行ユーティリティは、ソースとターゲット間でできるだけ多くのメタデータを維持します。ただし、多くの内部メタデータ(IDなど)は維持されません。次のメタデータは、エクスポート・セットには含まれません。
作成日(例: Folders_g設定のdCreateDate、dReleaseDate、dDocLastModifiedDate)などの日付メタデータ。FrameworkFolders設定のfCreateDate and fLastModifiedDate)。
ドキュメントに対して
ドキュメントの改訂またはレンディションの内部識別子(例: Folders_g設定のdID、dDocおよびFrameworkFolders設定のdIDおよびdDocId)がありません。コンテンツID、dDocNameが含まれることに注意してください。
ドキュメントが存在するフォルダのID (例: Folders_g設定のxCollectionIDおよびFrameworkFolders設定のfParentGUID)
Web表示可能レンディションがありません。これらはドキュメントがターゲットにチェックインされるときに再作成されるためです
実際のファイルに関する情報がありません(たとえば、そのファイル・タイプやMIMEタイプ)。これらはドキュメントがターゲットにチェックインされるときに設定されるためです
ターゲットでドキュメントを作成するときには関連がないため、チェックアウト済、リリース済状態などのステータス情報(たとえば、dIsCheckedOut、dReleaseState)がありません
フォルダに対して
親フォルダIDなどの内部識別子またはパス、または独自のパス(例: Folders_g設定のhasCollectionID、dCollectionID、dCollectionGUID、hasCollectionPath、and dCollectionPath、およびFrameworkFolders設定のfParentGUID、fFolderGUID、fApplicationGUID)がありません。
ストレージ・ルール。これはターゲットContent Serverの構成に依存しているためです
セキュリティ・グループまたは他のセキュリティ権限。これらはコンテンツがターゲットで作成されるときに設定されるためです(例: Folders_g設定のdSecurityGroup、dRead、canReadCollection、およびFrameworkFolders設定のfSecurityGroup)
維持されるメタデータ:
フォルダ名やドキュメント・タイトルなどのアーティファクトの名前(例: Folders_g設定のdCollectionNameおよびdDocTitle、およびFrameworkFolders設定のfFolderName、fDisplayNameおよびdDocTitle)。
コンテンツを作成し、それを変更したユーザーの名前(例: Folders_g設定のdCollectionOwnerおよびdDocOwner、およびFrameworkFolders設定のfOwnerおよびdDocOwner)。
dDocFunction、dDocType、xWCPageIDなどのWikiメタ―データ
ドキュメントに対して
ドキュメントに対してアップロードするファイルの名前(dOriginalName)
コンテンツID (dDocName)
インポート時に、同じコンテンツIDを持つコンテンツ・アイテムがターゲットContent Serverにすでに存在する場合、インポートは失敗します。プロパティCheckExistingContents=falseを設定して、インポートを再実行する場合、コンテンツIDエラーを回避するために、ターゲット・フォルダに、インポートされるアーカイブから取得されたコンテンツが含まれていないことを確認します。
カスタム・メタデータ(たとえば、myCustomInteger)。
ドキュメント移行ユーティリティは、ソースContent Serverからコンテンツをエクスポートするときに、単一のアーカイブを作成します。このアーカイブは、ドキュメント移行ユーティリティを実行して、ターゲット環境にデータをインポートする際に使用されます。ドキュメント移行アーカイブには、特定のレイアウトがあり、アーカイブがこのレイアウトに一致しない場合、ドキュメント移行ユーティリティのインポートは失敗します。
アーカイブ形式
次にドキュメント移行アーカイブのレイアウトについて説明します。
アーカイブのトップ・レベルには、データがエクスポートされた、各ポータル/ポータル・テンプレートのフォルダがあります。
単一のポータル/ポータル・テンプレートがエクスポートされている場合、ルート・フォルダは1つしかありません。複数のポータル/ポータル・テンプレートがエクスポートされている場合は、複数のルート・フォルダがあります。
ルート・フォルダ名は、Content Serverの対応するフォルダの内部GUIDと同じです(たとえば、13828FE1-75D8-4A0B-A53B-A76AE78C1AE6)
各トップ・レベル・フォルダには、そのポータルまたはポータル・テンプレートに対してターゲットContent Serverで再作成するためにファイルおよびフォルダの階層を記述するExportImportData.xmlドキュメントがあります。このドキュメントには、アーティファクトの作成時に使用されるメタデータが含まれています(xCollectionID、isreadonly、xStorageRuleなどの内部メタデータは含まれません)。ドキュメントに対して、アップロードで使用するためのアーカイブのネイティブ・ファイルへのパスが含まれています。
各トップレベル・ポータルおよびポータル・テンプレート・フォルダにはエクスポート済ドキュメントがあります。トップレベル・フォルダ内のドキュメントのレイアウトは、ソースContent Serverのポータル・スペースおよびポータル・テンプレートのレイアウトに似ています。たとえば、ドキュメントdoc1.docがfolder1にある場合、アーカイブのトップレベル・フォルダには、doc1.docが存在するフォルダfolder1が含まれています。トップレベル・フォルダのドキュメント・ファイル/フォルダ構造は、ExportImportData.xmlに記載されている階層に一致する必要があります。これは、インポート・コードがターゲットにドキュメントをアップロードしながら、そのドキュメントに記載されているドキュメントのネイティブ・ファイルを検出できるからです。ソースのポータルまたはポータル・テンプレート・フォルダの空のフォルダは、アーカイブにはありません。ただし、これらのフォルダは、ターゲットで再作成されるように、ExportImportData.xmlドキュメントで依然として記載されています。
簡略化された概要では、これは次のように表示されます。
Portal1トップ・レベル・フォルダ:
ExportImportData.xml
<ソースと同じフォルダ階層に配列されるPortal1のドキュメント>
Portal2トップ・レベル・フォルダ:
ExportImportData.xml
<ソースと同じフォルダ階層に配列されるPortal2のドキュメント>
ExportImportData.xmlドキュメントの理解
ExportImportData.xmlドキュメントのXSDを次に示します。
ExportImportData.xmlのXSD:
<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="groupspace-folder" type="FolderType" />
<!-- 'folders' must contain 1 or more 'folder' child elements -->
<xs:complexType name="FoldersType">
<xs:sequence>
<xs:element name="folder" type="FolderType"
minOccurs="1" maxOccurs="unbounded" />
</xs:sequence>
</xs:complexType>
<!-- 'documents' must contain 1 or more 'document' elements -->
<xs:complexType name="DocumentsType">
<xs:sequence>
<xs:element name="document" type="DocumentType"
minOccurs="1" maxOccurs="unbounded" />
</xs:sequence>
</xs:complexType>
<!-- 'attributes' must have 1 or more 'attribute' child elements -->
<xs:complexType name="AttributesType">
<xs:sequence>
<xs:element name="attribute" type="AttributeType"
minOccurs="1" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<!-- 'folder' has to have 1 and only 1 'attributes' child element
0 or 1 'folders' child element, 0 or 1 'documents' child element -->
<xs:complexType name="FolderType">
<xs:sequence>
<xs:element name="attributes" type="AttributesType"
minOccurs="1" maxOccurs="1" />
<xs:element name="folders" type="FoldersType"
minOccurs="0" maxOccurs="1" />
<xs:element name="documents" type="DocumentsType"
minOccurs="0" maxOccurs="1" />
</xs:sequence>
</xs:complexType>
<!-- 'document' has to have : 1 and only 1 'attributes' child element
and nothing else -->
<xs:complexType name="DocumentType">
<xs:sequence>
<xs:element name="attributes" type="AttributesType"
minOccurs="1" maxOccurs="1" />
</xs:sequence>
</xs:complexType>
<!-- 'attribute' element has to have a 'name' and 'value' attributes -->
<xs:complexType name="AttributeType">
<xs:attribute name="name" type="xs:string" use="required" />
<xs:attribute name="value" type="xs:string" use="required" />
</xs:complexType>
</xs:schema>
ここで:
<groupspace-folder>は、ポータルまたはポータル・テンプレート・フォルダを表すルート・タグです。
このタグには<attributes>タグが含まれ、ルート・フォルダおよびエクスポート・データに関する属性数が含まれます。これらの属性は情報のみを目的としているため、インポートでは使用されません。
<attributes>は、ドキュメントまたはフォルダのすべての属性をグループ化するために使用されます。
このタグには、1つ以上の<attribute>タグが含まれる必要があります。他の子タグは許可されません。
<attribute>には、フォルダまたはドキュメントのメタデータが含まれます。
このタグには次の2つの属性があります。
name: Content Serverメタデータ名
value: メタデータの値
子タグは許可されません。
<folders>は、現在のフォルダのすべてのフォルダをグループ化するために使用されます。
このタグには、1つ以上の<folder>タグが含まれる必要があります。他の子タグは許可されません。
<folder>は、子フォルダを示すために使用されます。
このタグには、<attributes>タグが必要です。フォルダに子フォルダがある場合は、<folders>タグがあります。フォルダに子ドキュメントがある場合は、<documents>タグがあります。
<documents>は、現在のフォルダのすべてのドキュメントをグループ化するために使用されます。
このタグには、1つ以上の<document>タグが含まれる必要があります。他の子タグは許可されません。
<document>は、現在のフォルダのすべてのドキュメントを示すために使用されます。
このタグには、<attributes>タグが必要です。他の子タグは許可されません。
Folders_g設定の注釈付きの例
次の注釈付きの例は、Folders_gがフォルダ・サービスとして使用される場合の、部分的に完了したExportImportData.xmlドキュメントを示します。例には、実際のExportImportData.xmlドキュメントでは存在しない空行とXMLコメントが含まれていることに注意してください。
<?xml version="1.0"encoding="UTF-8"standalone="yes"?>
<groupspace-folder>
<attributes>
<!-- Contains a set of attributes of the main portal folder -->
<attribute name="export-date" value="2011-07-22 13:02:29"/>
</attributes>
<folders> <!-- only present if the portal contains any child folders -->
<folder> <!-- a 'folder' tag exists for each child folder -->
<attributes>
<!-- contains the set of folder attributes, examples below -->
<attribute value="F1" name="dCollectionName"/>
</attributes>
<!-- a 'folder' tag will contain the 'folders' tag if this folder
contains child folders, i.e. if 'F1' has child folders -->
<folders>
<folder>
<!-- attribute tags, child folders, child documents etc -->
</folder>
</folders> <!-- closing tag for all the folders in the
current folder à
<!-- a 'folder' tag will contain the 'documents' tag if this folder
contains documents, i.e. if 'F1' has documents at its root -->
<documents>
<document>
<!-- attributes tags, see below -->
</document>
</documents> <!-- closing tag for all the documents in the
current folder -->
</folder> <!-- closing tag for folder 'F1' -->
</folders> <!-- closing tag for all the folders in the portal root -->
<documents> <!- only present if the folder contains any documents
in the root folder -->
<document> <!-- a 'document' tag exists for each document in the
folder -->
<attributes>
<!- contains the set of document attributes, examples below -->
<attribute name="dDocTitle" value="Doc1"/>
<attribute name="xForceFolderSecurity" value="TRUE"/>
<attribute name="xSecurityClearanceLevel" value="public"/>
</attributes>
<document> <!-- closing tag for document 'Doc1' -->
</documents><!-- closing tag for all the documents in the portal root -->
</groupspace-folder>
FrameworkFolders設定の注釈付きの例
次の注釈付きの例は、FrameworkFoldersがフォルダ・サービスとして使用される場合の、部分的に完了したExportImportData.xmlドキュメントを示します。例には、実際のExportImportData.xmlドキュメントでは存在しない空行とXMLコメントが含まれていることに注意してください。
<groupspace-folder>
<attributes>
<!-- Contains a set of attributes of the main portal folder -->
<attribute name="export-date" value="2011-07-22 13:02:29"/>
</attributes>
<folders><!-- only present if the portal contains any child folders -->
<folder><!-- a 'folder' tag exists for each child folder -->
<attributes>
<!-- contains the set of folder attributes, examples below -->
<attribute value="F1" name="fFolderName"/>
</attributes>
<!-- a 'folder' tag will contain the 'folders' tag if this folder contains child folders, i.e. if 'F1' has child folders -->
<folders>
<folder>
<!-- attribute tags, child folders, child documents etc -->
</folder>
</folders>
<!-- closing tag for all the folders in the current folder-->
<!-- a 'folder' tag will contain the 'documents' tag if this folder contains documents, i.e. if 'F1' has documents at its root -->
<documents>
<document>
<!-- attributes tags, see below -->
</document>
</documents><!-- closing tag for all the documents in the current folder -->
</folder>
<!-- closing tag for folder 'F1' -->
</folders>
<!-- closing tag for all the folders in the portal root -->
<documents>
<!-- only present if the folder contains any documents in the root folder -->
<document>
<!-- a 'document' tag exists for each document in the folder -->
<attributes>
<!-- contains the set of document attributes, examples below -->
<attribute name="dDocTitle" value="Doc1"/>
<attribute value="0" name="fInhibitPropagation"/>
</attributes>
</document>
<!-- closing tag for document 'Doc1' -->
</documents>
<!-- closing tag for all the documents in the portal root -->
</groupspace-folder>
ExportImportData.xmlドキュメントの構築
次にXMLドキュメントの構築方法に関する疑似コードを示します。
- query Content Server for the portal's folder information
- create a 'group-space-folder' node
- create an 'attributes' node
- for each of the three attributes we want to maintain (folder name, path
and GUID)
- create an 'attribute' node with name and value
- add that 'attribute' node to the 'attributes' node
- add that 'attributes' node to the 'group-space-folder' node
- query Content Server for the contents of the portal root folder
- * If there are child folders
- Create a 'folders' node
- For each child folder
- create a 'folder' node
- create an 'attributes' node
- for each folder metadata we want to maintain
- create an 'attribute' node with name and value
- add that 'attribute' node to the 'attributes' node
- add the 'attributes' node to the 'folder' node
- query Content Server for the contents of this current folder
- go to * and repeat traversing folders which reside in this
current folder
- go to # and repeat for documents which reside in this current
folder
- add the 'folder' node to the 'folders' node
- add the 'folders' node to the parent node (which will either be a
'folder' node or the 'group-space-folder' node)
- # If there are documents in this current folder
- create a 'documents' node
- for each document
- create a 'document' node
- create an 'attributes' node
- for each metadata we want to maintain
- create an 'attribute' node with name and value
- add that 'attribute' node to the 'attributes' node
- add the 'attributes' node to the 'document' node
- add that 'document' node to the 'documents' node
- add the 'documents' node to the 'folder' node
- use jaxb to write the whole data to an xml file
ドキュメント移行アーカイブの例
1セットのサンプル・データおよび例のポータルの1つに対するサンプルExportImportData.xmlドキュメントのアーカイブ形式の例を次に示します。
WebCenterデータ
次の例では、2つのポータル(MarketingおよびSales)がWebCenter Portalで作成されています。Marketingポータルでは、2つのwikiページが作成されています: MarketingWikiおよびTradeshows。Marketingポータルには、2つのフォルダ(「ブランド」および「プレゼンテーション」)が作成されていて、後者にはPowerPointドキュメントおよびwikiドキュメントを持つサブフォルダが含まれています。Salesポータルにはwikiページがありませんが、いくつかのコンテンツを持つ3つのフォルダが含まれています。
Marketing
Marketingポータルには、Content ServerフォルダGUID= 29A4E019-7AE7-46A1-823B-AF16A313BBEFが含まれています。
MarketingWiki
次のメタデータを持つMarketingWiki.htm:
dOriginalName="MarketingWiki.htm"
dDocTitle="MarketingWiki.htm"
dDocFunction="wiki"
dDocType="Application"
xWCPageID="Page2.jspx"
プレゼンテーション
ブランド
ProductBranding.pptx
次のメタデータを持つPresentation Dates.htm:
(ここでwikiページが前述のMarketingWiki.htmに関して作成されるときに作成されるのではなく、wikiドキュメントがポータルのフォルダ内で作成されることに注意してください)
dOriginalName=" Presentation Dates.htm"
dDocTitle="Presentation Dates"
dDocFunction="wiki"
dDocType="Application"
xWCPageID = not set (wikiページの作成時にwikiが作成されなかった)
ProjectedDesigns.pptx
製品
TradeShows
次のメタデータを持つTradeShows.htm:
dOriginalName=" TradeShows.htm"
dDocTitle=" TradeShows.htm"
dDocFunction="wiki"
dDocType="Application"
xWCPageID="Page4.jspx"
Sales
「WebCenter Content」フォルダ GUID = 629BFEBD-4E83-4DCA-895A-C72E5192FBFD
DecConference
GuestSpeakers.doc
SalesConference
Attendees.doc
TalkSchedules.doc
BudgetForcasts.doc
アーカイブ・コンテンツ
29A4E019-7AE7-46A1-823B-AF16A313BBEF (Marketingポータル・コンテンツを含む)
MarketingWiki
MarketingWiki.htm
プレゼンテーション
ブランド(ProductBranding.pptx)
ProjectedDesigns.pptx
Presentation Dates.htm
Tradeshows
TradeShows.htm
ExportImportData.xml
2001Plans.doc
629BFEBD-4E83-4DCA-895A-C72E5192FBFD (Salesポータル・コンテンツを含む)
DecConference
GuestSpeakers.doc
SalesConference
Attendees.doc
TalkSchedules.doc
ExportImportData.xml
BudgetForcasts.doc
|
注意: このフォルダにはドキュメントが含まれないため、Marketingポータルのルート・フォルダの下にProductsフォルダはありません。 |
Folders_g設定内のMarketingポータルのExportImportData.xml
<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<groupspace-folder>
<attributes>
<attribute value="2011-10-27 15:50:18" name="export-date" />
<attribute value="/WebCenter0711/Marketing/" name="group-space-path" />
<attribute value="Marketing" name="group-space-name" />
<attribute value="29A4E019-7AE7-46A1-823B-AF16A313BBEF"
name="group-space-guid" />
</attributes>
<folders>
<folder>
<attributes>
<attribute value="TRUE" name="xForceFolderSecurity" />
<attribute value="sysadmin" name="dCollectionCreator" />
<attribute value="MarketingWiki" name="dCollectionName" />
<attribute value="0" name="isLink" />
<attribute value="Page2.jspx" name="xWCPageId" />
<attribute value="sysadmin" name="dCollectionOwner" />
<attribute value="sysadmin" name="dCollectionModifier" />
<attribute value="1" name="dCollectionEnabled" />
</attributes>
<documents>
<document>
<attributes>
<attribute value="TRUE" name="xForceFolderSecurity" />
<attribute value="Page2.jspx" name="xWCPageId" />
<attribute value="wiki" name="dDocFunction" />
<attribute value="Application" name="dDocType" />
<attribute value="0" name="ishidden" />
<attribute value="sysadmin" name="dDocOwner" />
<attribute value="MarketingWiki.htm" name="dOriginalName" />
<attribute value="MarketingWiki.htm" name="dDocTitle" />
<attribute value="FALSE" name="xInhibitUpdate" />
<attribute value="0" name="isreadonly" />
<attribute value="0" name="CustomInteger" />
<attribute value="sysadmin" name="dDocCreator" />
<attribute value="sysadmin" name="dDocAuthor" />
<attribute value="OWCSVR01USORAC012754" name="dDocName" />
<attribute value="1" name="dRevisionID" />
<attribute value="sysadmin" name="dDocLastModifier" />
</attributes>
</document>
</documents>
</folder>
<folder>
<attributes>
<attribute value="TRUE" name="xForceFolderSecurity" />
<attribute value="sysadmin" name="dCollectionCreator" />
<attribute value="Presentations" name="dCollectionName" />
<attribute value="0" name="isLink" />
<attribute value="sysadmin" name="dCollectionOwner" />
<attribute value="sysadmin" name="dCollectionModifier" />
<attribute value="1" name="dCollectionEnabled" />
</attributes>
<folders>
<folder>
<attributes>
<attribute value="TRUE" name="xForceFolderSecurity" />
<attribute value="sysadmin" name="dCollectionCreator" />
<attribute value="Branding" name="dCollectionName" />
<attribute value="0" name="isLink" />
<attribute value="sysadmin" name="dCollectionOwner" />
<attribute value="sysadmin" name="dCollectionModifier" />
<attribute value="1" name="dCollectionEnabled" />
</attributes>
<documents>
<document>
<attributes>
<attribute value="TRUE" name="xForceFolderSecurity" />
<attribute value="Document" name="dDocType" />
<attribute value="sysadmin" name="dDocOwner" />
<attribute value="0" name="ishidden" />
<attribute value="ProductBranding.pptx" name="dDocTitle" />
<attribute value="ProductBranding.pptx"
name="dOriginalName" />
<attribute value="FALSE" name="xInhibitUpdate" />
<attribute value="0" name="isreadonly" />
<attribute value="0" name="CustomInteger" />
<attribute value="sysadmin" name="dDocCreator" />
<attribute value="sysadmin" name="dDocAuthor" />
<attribute value="OWCSVR01USORAC012748" name="dDocName" />
<attribute value="1" name="dRevisionID" />
<attribute value="sysadmin" name="dDocLastModifier" />
</attributes>
</document>
</documents>
</folder>
</folders>
<documents>
<document>
<attributes>
<attribute value="TRUE" name="xForceFolderSecurity" />
<attribute value="wiki" name="dDocFunction" />
<attribute value="Application" name="dDocType" />
<attribute value="0" name="ishidden" />
<attribute value="sysadmin" name="dDocOwner" />
<attribute value="Presentation Dates" name="dDocTitle" />
<attribute value="Presentation Dates.htm"
name="dOriginalName" />
<attribute value="FALSE" name="xInhibitUpdate" />
<attribute value="0" name="isreadonly" />
<attribute value="0" name="CustomInteger" />
<attribute value="sysadmin" name="dDocCreator" />
<attribute value="sysadmin" name="dDocAuthor" />
<attribute value="OWCSVR01USORAC012758" name="dDocName" />
<attribute value="1" name="dRevisionID" />
<attribute value="sysadmin" name="dDocLastModifier" />
</attributes>
</document>
<document>
<attributes>
<attribute value="TRUE" name="xForceFolderSecurity" />
<attribute value="Document" name="dDocType" />
<attribute value="sysadmin" name="dDocOwner" />
<attribute value="0" name="ishidden" />
<attribute value="ProjectedDesigns.pptx" name="dDocTitle" />
<attribute value="ProjectedDesigns.pptx"
name="dOriginalName" />
<attribute value="FALSE" name="xInhibitUpdate" />
<attribute value="0" name="isreadonly" />
<attribute value="0" name="CustomInteger" />
<attribute value="sysadmin" name="dDocCreator" />
<attribute value="sysadmin" name="dDocAuthor" />
<attribute value="OWCSVR01USORAC012747" name="dDocName" />
<attribute value="1" name="dRevisionID" />
<attribute value="sysadmin" name="dDocLastModifier" />
</attributes>
</document>
</documents>
</folder>
<folder>
<attributes>
<attribute value="TRUE" name="xForceFolderSecurity" />
<attribute value="sysadmin" name="dCollectionCreator" />
<attribute value="Products" name="dCollectionName" />
<attribute value="0" name="isLink" />
<attribute value="sysadmin" name="dCollectionOwner" />
<attribute value="sysadmin" name="dCollectionModifier" />
<attribute value="1" name="dCollectionEnabled" />
</attributes>
</folder>
<folder>
<attributes>
<attribute value="TRUE" name="xForceFolderSecurity" />
<attribute value="sysadmin" name="dCollectionCreator" />
<attribute value="TradeShows" name="dCollectionName" />
<attribute value="0" name="isLink" />
<attribute value="Page4.jspx" name="xWCPageId" />
<attribute value="sysadmin" name="dCollectionOwner" />
<attribute value="sysadmin" name="dCollectionModifier" />
<attribute value="1" name="dCollectionEnabled" />
</attributes>
<documents>
<document>
<attributes>
<attribute value="TRUE" name="xForceFolderSecurity" />
<attribute value="Page4.jspx" name="xWCPageId" />
<attribute value="wiki" name="dDocFunction" />
<attribute value="Application" name="dDocType" />
<attribute value="0" name="ishidden" />
<attribute value="sysadmin" name="dDocOwner" />
<attribute value="TradeShows.htm" name="dOriginalName" />
<attribute value="TradeShows.htm" name="dDocTitle" />
<attribute value="FALSE" name="xInhibitUpdate" />
<attribute value="0" name="isreadonly" />
<attribute value="0" name="CustomInteger" />
<attribute value="sysadmin" name="dDocCreator" />
<attribute value="sysadmin" name="dDocAuthor" />
<attribute value="OWCSVR01USORAC012756" name="dDocName" />
<attribute value="1" name="dRevisionID" />
<attribute value="sysadmin" name="dDocLastModifier" />
</attributes>
</document>
</documents>
</folder>
</folders>
<documents>
<document>
<attributes>
<attribute value="TRUE" name="xForceFolderSecurity" />
<attribute value="Document" name="dDocType" />
<attribute value="sysadmin" name="dDocOwner" />
<attribute value="0" name="ishidden" />
<attribute value="2011Plans.doc" name="dDocTitle" />
<attribute value="2011Plans.doc" name="dOriginalName" />
<attribute value="FALSE" name="xInhibitUpdate" />
<attribute value="0" name="isreadonly" />
<attribute value="0" name="CustomInteger" />
<attribute value="sysadmin" name="dDocCreator" />
<attribute value="sysadmin" name="dDocAuthor" />
<attribute value="OWCSVR01USORAC012746" name="dDocName" />
<attribute value="1" name="dRevisionID" />
<attribute value="sysadmin" name="dDocLastModifier" />
</attributes>
</document>
</documents>
</groupspace-folder>
FrameworkFolders設定内のMarketingポータルのExportImportData.xml
<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<groupspace-folder>
<attributes>
<attribute value="2011-10-27 15:50:18" name="export-date" />
<attribute value="/Enterprise Libraries/Marketing/" name="group-space-path" />
<attribute value="Marketing" name="group-space-name" />
<attribute value="WC01:29a4e019-7ae7-46a1-823b-af16a313bbef"
name="group-space-guid" />
</attributes>
<folders>
<folder>
<attributes>
<attribute value="sysadmin" name="fLastModifier"/>
<attribute value="sysadmin" name="fOwner"/>
<attribute value="MarketingWiki" name="fDisplayName"/>
<attribute value="0" name="fInhibitPropagation"/>
<attribute value="Page2.jspx" name="xWCPageId" />
<attribute value="sysadmin" name="fCreator"/>
<attribute value="owner" name="fFolderType"/>
<attribute value="MarketingWiki" name="fFolderName"/>
</attributes>
<documents>
<document>
<attributes>
<attribute value="sysadmin" name="fLastModifier"/>
<attribute value="sysadmin" name="fOwner"/>
<attribute value="MarketingWiki.htm" name="fDisplayName"/>
<attribute value="MarketingWiki.htm" name="fFileName"/>
<attribute value="wiki" name="dDocFunction"/>
<attribute value="Page2.jspx" name="xWCPageId" />
<attribute value="sysadmin" name="fCreator"/>
<attribute value="Application" name="dDocType"/>
<attribute value="sysadmin" name="dDocOwner"/>
<attribute value="MarketingWiki" name="dDocTitle"/>
<attribute value="MarketingWiki.htm" name="dOriginalName"/>
<attribute value="0" name="CustomInteger"/>
<attribute value="0" name="fInhibitPropagation"/>
<attribute value="sysadmin" name="dDocCreator"/>
<attribute value="sysadmin" name="dDocAuthor"/>
<attribute value="OWCSVR01USORAC012754" name="dDocName"/>
<attribute value="1" name="dRevisionID"/>
<attribute value="sysadmin" name="dDocLastModifier"/>
</attributes>
</document>
</documents>
</folder>
<folder>
<attributes>
<attribute value="sysadmin" name="fLastModifier"/>
<attribute value="sysadmin" name="fOwner"/>
<attribute value="Presentations" name="fDisplayName"/>
<attribute value="0" name="fInhibitPropagation"/>
<attribute value="sysadmin" name="fCreator"/>
<attribute value="owner" name="fFolderType"/>
<attribute value="Presentations" name="fFolderName"/>
</attributes>
<folders>
<folder>
<attributes>
<attribute value="sysadmin" name="fLastModifier"/>
<attribute value="sysadmin" name="fOwner"/>
<attribute value="Branding" name="fDisplayName"/>
<attribute value="0" name="fInhibitPropagation"/>
<attribute value="sysadmin" name="fCreator"/>
<attribute value="owner" name="fFolderType"/>
<attribute value="Branding" name="fFolderName"/>
</attributes>
<documents>
<document>
<attributes>
<attribute value="sysadmin" name="fLastModifier"/>
<attribute value="sysadmin" name="fOwner"/>
<attribute value="ProductBranding.pptx" name="fDisplayName"/>
<attribute value="ProductBranding.pptx" name="fFileName"/>
<attribute value="sysadmin" name="fCreator"/>
<attribute value="Document" name="dDocType"/>
<attribute value="sysadmin" name="dDocOwner"/>
<attribute value="ProductBranding" name="dDocTitle"/>
<attribute value="ProductBranding.pptx" name="dOriginalName"/>
<attribute value="0" name="CustomInteger"/>
<attribute value="sysadmin" name="dDocCreator"/>
<attribute value="0" name="fInhibitPropagation"/>
<attribute value="sysadmin" name="dDocAuthor"/>
<attribute value="OWCSVR01USORAC012748" name="dDocName"/>
<attribute value="1" name="dRevisionID"/>
<attribute value="sysadmin" name="dDocLastModifier"/>
</attributes>
</document>
</documents>
</folder>
</folders>
<documents>
<document>
<attributes>
<attribute value="sysadmin" name="fLastModifier"/>
<attribute value="sysadmin" name="fOwner"/>
<attribute value="Presentation Dates.htm" name="fDisplayName"/>
<attribute value="Presentation Dates.htm" name="fFileName"/>
<attribute value="wiki" name="dDocFunction"/>
<attribute value="sysadmin" name="fCreator"/>
<attribute value="Application" name="dDocType"/>
<attribute value="sysadmin" name="dDocOwner"/>
<attribute value="Presentation Dates" name="dDocTitle"/>
<attribute value="Presentation Dates.htm" name="dOriginalName"/>
<attribute value="0" name="CustomInteger"/>
<attribute value="0" name="fInhibitPropagation"/>
<attribute value="sysadmin" name="dDocCreator"/>
<attribute value="sysadmin" name="dDocAuthor"/>
<attribute value="OWCSVR01USORAC012758" name="dDocName"/>
<attribute value="1" name="dRevisionID"/>
<attribute value="sysadmin" name="dDocLastModifier"/>
</attributes>
</document>
<document>
<attributes>
<attribute value="1" name="dPublishedRevisionID"/>
<attribute value="sysadmin" name="fLastModifier"/>
<attribute value="sysadmin" name="fOwner"/>
<attribute value="ProjectedDesigns.pptx" name="fDisplayName"/>
<attribute value="ProjectedDesigns.pptx" name="fFileName"/>
<attribute value="sysadmin" name="fCreator"/>
<attribute value="Document" name="dDocType"/>
<attribute value="sysadmin" name="dDocOwner"/>
<attribute value="ProjectedDesigns" name="dDocTitle"/>
<attribute value="ProjectedDesigns.pptx" name="dOriginalName"/>
<attribute value="0" name="CustomInteger"/>
<attribute value="sysadmin" name="dDocCreator"/>
<attribute value="0" name="fInhibitPropagation"/>
<attribute value="sysadmin" name="dDocAuthor"/>
<attribute value="OWCSVR01USORAC012747" name="dDocName"/>
<attribute value="1" name="dRevisionID"/>
<attribute value="sysadmin" name="dDocLastModifier"/>
</attributes>
</document>
</documents>
</folder>
<folder>
<attributes>
<attribute value="sysadmin" name="fLastModifier"/>
<attribute value="sysadmin" name="fOwner"/>
<attribute value="Products" name="fDisplayName"/>
<attribute value="0" name="fInhibitPropagation"/>
<attribute value="sysadmin" name="fCreator"/>
<attribute value="owner" name="fFolderType"/>
<attribute value="Products" name="fFolderName"/>
</attributes>
</folder>
<folder>
<attributes>
<attribute value="sysadmin" name="fLastModifier"/>
<attribute value="sysadmin" name="fOwner"/>
<attribute value="TradeShows" name="fDisplayName"/>
<attribute value="0" name="fInhibitPropagation"/>
<attribute value="Page4.jspx" name="xWCPageId" />
<attribute value="sysadmin" name="fCreator"/>
<attribute value="owner" name="fFolderType"/>
<attribute value="TradeShows" name="fFolderName"/>
</attributes>
<documents>
<document>
<attributes>
<attribute value="sysadmin" name="fLastModifier"/>
<attribute value="sysadmin" name="fOwner"/>
<attribute value="Page4.jspx" name="xWCPageId" />
<attribute value="TradeShows.htm" name="fDisplayName"/>
<attribute value="TradeShows.htm" name="fFileName"/>
<attribute value="wiki" name="dDocFunction"/>
<attribute value="sysadmin" name="fCreator"/>
<attribute value="Application" name="dDocType"/>
<attribute value="sysadmin" name="dDocOwner"/>
<attribute value="TradeShows" name="dDocTitle"/>
<attribute value="TradeShows.htm" name="dOriginalName"/>
<attribute value="0" name="CustomInteger"/>
<attribute value="0" name="fInhibitPropagation"/>
<attribute value="sysadmin" name="dDocCreator"/>
<attribute value="sysadmin" name="dDocAuthor"/>
<attribute value="OWCSVR01USORAC012756" name="dDocName"/>
<attribute value="1" name="dRevisionID"/>
<attribute value="sysadmin" name="dDocLastModifier"/>
</attributes>
</document>
</documents>
</folder>
</folders>
<documents>
<document>
<attributes>
<attribute value="1" name="dPublishedRevisionID"/>
<attribute value="sysadmin" name="fLastModifier"/>
<attribute value="sysadmin" name="fOwner"/>
<attribute value="2011Plans.doc" name="fDisplayName"/>
<attribute value="2011Plans.doc" name="fFileName"/>
<attribute value="sysadmin" name="fCreator"/>
<attribute value="Document" name="dDocType"/>
<attribute value="sysadmin" name="dDocOwner"/>
<attribute value="2011Plans" name="dDocTitle"/>
<attribute value="2011Plans.doc" name="dOriginalName"/>
<attribute value="0" name="CustomInteger"/>
<attribute value="sysadmin" name="dDocCreator"/>
<attribute value="0" name="fInhibitPropagation"/>
<attribute value="sysadmin" name="dDocAuthor"/>
<attribute value="OWCSVR01USORAC012746" name="dDocName"/>
<attribute value="1" name="dRevisionID"/>
<attribute value="sysadmin" name="dDocLastModifier"/>
</attributes>
</document>
</documents>
</groupspace-folder>
既存のwikiアプリケーションからWebCenter Portalにコンテンツを移行するには、次の手順を実行します。
wikiコンテンツのインポート用にWebCenter Portalを準備します。
カスタムwiki抽出ツールを記述して実行し、Wikiアプリケーションからアーカイブ(ドキュメント移行ユーティリティで期待される正確な形式に一致している必要がある)にコンテンツを抽出します。
ドキュメント移行ユーティリティを使用して、Content Serverにアーカイブをインポートします。
WebCenter Portalでwikiページを作成し、Content Serverのコンテンツを関連付けます。
これら手順は、次の項で詳細に説明します。
ドキュメント・ツールがポータルまたはポータル・テンプレートで有効になっている場合、フォルダがそのポータルまたはポータル・テンプレートに対してContent Serverで作成されます。これらのフォルダのGUIDは、ドキュメント移行ユーティリティとともに使用するアーカイブを構築するために決定される必要があります。フォルダGUIDは次の手順で決定されます。
すべてのwikiコンテンツを単一ポータルまたは複数のポータルにインポートするかどうかを決定します。
WebCenter Portalにログインし、ポータルを作成して、ポータルの内部名をメモします。
ドキュメント・ツールを含むテンプレートを使用していることを確認します。そうでない場合、ドキュメント・ツールを有効にして、ポータル作成後にロール権限を設定する必要があります。
Content Serverにログインします。
ユーザーのレイアウトが「トップ・メニュー」であることを確認します。
ユーザー名をクリックして、ユーザーのプロファイル・ページを表示します。
「ユーザーのパーソナライズの設定」の下で、「レイアウト」をTop Menuに設定していることを確認します。
wikiコンテンツがインポートされる各ポータルに対して、フォルダGUIDを決定します。
「コンテンツの参照」をクリックします。
WebCenter Portalインスタンスのルート・フォルダをクリックします。
これは、Content Server接続のRoot Folder設定と同じです。
ポータルのフォルダをクリックします。
フォルダ名は、ポータルの内部名と同じです。
フォルダ情報を表示するには、ツールバーの「情報」をクリックします。
URLにIsSoap=1を追加します。
Folders_g設定内の文字列dCollectionGUIDを検索します。例:
<idc:field name="dCollectionGUID">05573322-E895-EDA3-8A83-07CF39CBDE05</idc:field>
FrameworkFoldersフォルダ・サービスを使用している場合は、文字列fApplicationGUIDを検索します。例:
<idc:field name="fApplicationGUID">WC01:8c1c6442-a258-4cd7-8cf1-adb60fc45ce2</idc:field>
次の手順でアーカイブを構築する際にGUIDが必要となるため、ポータル・フォルダ名とそのGUIDをメモします。
ソースwikiアプリケーションから、ドキュメント移行ユーティリティとともに使用するのに適したアーカイブにコンテンツを抽出するには、カスタム・アプリケーションを記述する必要があります。アーカイブの形式の詳細は、第F.2項「ドキュメント移行ユーティリティの理解」を参照してください。
カスタムwiki抽出ツールは、次の手順を実行する必要があります。
wikiコンテンツを抽出して配置します。
一時ディレクトリを作成し、ソースwikiアプリケーションからその一時ディレクトリにwikiコンテンツを抽出して、WebCenter Portalに表示されるとおりにファイル・システムに配置します。
wikiドキュメントのソースHTMLをクリーンアップします。
各wikiドキュメントに対して、HTMLを編集して、アプリケーション固有のHTMLタグを削除します。
URLをリライトします。
各wikiドキュメントに対して、ソースwikiアプリケーションのコンテンツへの既存のURLを、WebCenter Portalにインポートされる同じアーティファクトのURLに置き換えます。
ExportImportData.xmlドキュメントを構築します。
各ルート・フォルダに対して、エクスポート・セットのデータを記述し、インポートの実行に使用されるExportImportData.xmlドキュメントを構築します。
アーカイブ・ファイルを構築します。
wikiコンテンツをWebCenter Portalにインポートするために使用可能な操作済wikiコンテンツのアーカイブを作成します。
これらの各手順については、次の項で詳細に説明します。
ソース・アプリケーションのwikiドキュメントはファイル・システムの一時ディレクトリに抽出され、コンテンツがターゲットWebCenter Portalインスタンスにレイアウトされる方法をファイル・システムが模倣するように配置される必要があります。すべてのwikiドキュメントが単一ポータルにインポートされる場合、Content Serverの対応するポータル・フォルダのGUIDを使用して名付けられている単一のルート・フォルダの下にコンテンツのすべてが配置される必要があります。wikiドキュメントが複数のポータルにインポートされる場合、Content Serverの対応するフォルダのGUIDを使用して名付けられている複数のルート・フォルダの下にコンテンツが配置される必要があります。Content Serverにおけるポータル・フォルダのGUIDの決定の詳細は、第F.3.1項「WikiコンテンツのインポートのためのWebCenter Portalの準備」を参照してください。
ファイル・システムにwikiコンテンツを配置する場合は、そのコンテンツのWebCenter Portalでの使用方法を考慮する必要があることに注意してください。例:
wikiページが作成される場合は、wikiページのwikiドキュメントが同じ名前のフォルダの下にある必要があります。wikiページの詳細は、第F.1項「WikiドキュメントおよびWikiページの理解」を参照してください。
フォルダに多数のコンテンツが含まれている場合は、そのフォルダのコンテンツのレンダリングに障害が発生する可能性があります。
Content Serverには、フォルダ数とフォルダ内に格納可能なファイル数を制限する2つの設定があります(「仮想フォルダ当たりの最大フォルダ数」および「仮想フォルダ当たりの最大コンテンツ数」)。wikiコンテンツを配置する場合は、フォルダ制限設定より多くのフォルダおよびドキュメント制限設定より多くのドキュメントがフォルダにないことを確認してください。
抽出したwikiコンテンツを作成するには、次のタスクを実行します。
wikiドキュメントをインポートする先の各ポータルのルート・フォルダを作成し、Content Serverの対応するポータル・フォルダのGUIDに基づいてフォルダに名前を付けます。
インポート後に、wikiページがWebCenter Portalで作成されるwikiドキュメントに対して行う操作は次のとおりです。
wikiドキュメントと同じ名前を持つwikiフォルダを作成します。
このフォルダにwikiドキュメントを配置します。
必要に応じて、このフォルダに他のドキュメントを配置します。
関連するイメージおよび/またはドキュメントがある場合は、同様にそれらのドキュメントをこのwikiフォルダに追加します。
他のwikiドキュメントについて、ドキュメントを含めるフォルダ階層を作成します。
例:
Content ServerのPortal S1のフォルダには、21SD15F13B8_141D_421B_AD0e_BC54B6F16893のGUIDがあります。インポート後に、MarketingWikiおよびTradeshows wikiページが作成され、これらのwikiページにMarketingWiki.htmおよびTradeshows.htm wikiドキュメントが表示される必要があります。
抽出されたwikiドキュメントおよびアーティファクトの整理された構造を次に示します。
21SD15F13B8_141D_421B_AD0e_BC54B6F16893 (Root portal folder)
Home.htm (Wiki document)
MarketingWiki (Folder)
MarketingWiki.htm (Wiki document)
Branding (Folder)
Presentation Dates.htm (Wiki document)
Presentations (Folder)
ProductBranding.pptx (File)
ProjectedDesigns.pptx (File)
Tradeshows (Folder)
TradeShows.htm (Wiki document)
Images (Folder)
Image.jpg (Image)
WebCenter Portalで、wikiページが編集されるときにwikiエディタでHTMLタグが削除されます。したがって、インポート後にwikiドキュメントを編集する場合に削除されるタグの混乱を回避するために、WebCenter Portalにインポートする前に、wikiドキュメントでHTMLタグを削除することをお薦めします。次のタグは安全に削除することができます。
<html>, </html> <head>, </head> <meta>, </meta> <title>, </title> <body>, </body> <tbody>, </tbody> <thead>, </thead> <tfoot>, </tfoot> <script>, </script> <link>, </link>
ソースwikiアプリケーションのWikiページには、組込みイメージまたは他のwikiページやドキュメントへのリンクなど、ソースwikiアプリケーション内のアーティファクトを参照するURLが含まれる場合があります。これらのアーティファクトは、ターゲットWebCenter Portalインスタンスに移行され、これらのリンクは、ターゲットWebCenter Portalインスタンスの新しいアーティファクトの場所を参照するために更新される必要があります。
抽出されたwikiページの次のタイプのURLは、WebCenter Portalの同じアーティファクトのURLを参照するために変更される必要があります。
他のWikiページへのリンク
組込みイメージへのリンク
ドキュメントへのリンク
次の手順に従って、wikiドキュメントのURLをリライトします。
手順3のURLの置換で使用されるターゲットWebCenter Portalインスタンスの属性を定義します。
WC_BASE_URL: WebCenterインスタンス・ベースURL
例: WC_BASE_URL=https://webcenter.example.com
UCM_ID: Content ServerへのWebCenter Portalの接続の名前
例: UCM_ID=dev_ucm
SPACE_GUID: コンテンツが存在するWebCenter PortalのポータルのGUID
例: SPACE_GUID=s21sd15f13b8_141d_421b_ad0e_bc54b6f16893
GUIDの決定の詳細は、第F.3.1項「WikiコンテンツのインポートのためのWebCenter Portalの準備」を参照してください。
各コンテンツ・アイテムについて、手順3のURLの置換で使用されるアイテムの属性を定義します。
FILE_NAME: コンテンツ・アイテムのファイル名
例: FILE_NAME=Home.htm
FILE_ID: 一意のContent ServerのコンテンツID
例: MARKETINGPORTAL1001
FILE_IDは、Content Serverインスタンス全体にわたって、一意である必要があることに注意してください。推奨値は、一意の番号が後に付加された(名前にポータルのない)wikiドキュメントがインポートされるポータルの名前です(前述の例では、ポータル名はMarketing Portal)。
次のように、定義された属性を使用してURLをリライトします。
組込みイメージ
新しいURLの形式:
IMG_REPLACE=img alt="FILE_NAME" resourceid="UCM_ID#dDocName:FILE_ID" src="WC_BASE_URL/webcenter/content/conn/UCM_ID/uuid/dDocName%3aFILE_ID"
例:
ソースURL:
<img alt="image.jpg" src="images/image.jpg">
WebCenterのURL:
<img alt="image.jpg" resourceid="dev-ucm#dDocName:WSIMPORT4" src="http://webcenter.example.com/webcenter/content/conn/dev-ucm/uuid/dDocName%3aWSIMPORT4">
Wikiページ
新しいURLの形式:
URL_REPLACE=WC_BASE_URL/webcenter/faces/owResource.jspx?z=oracle.webcenter.doclib%21SPACE_GUID%21UCM_ID%2523dDocName%253AFILE_ID%21%21FILE_NAME
例:
ソースURL:
<a href="Home.htm">Home</a>
WebCenterのURL:
<a href="http://webcenter.example.com/webcenter/faces/owResource.jspx?z=oracle.webcenter.doclib%21sd15f13b8_141d_421b_ad0e_bc54b6f16893%21dev-ucm%2523dDocName%253AWSIMPORT25%21%21Home.htm>Home</a>
ドキュメントへのリンク
新しいURLの形式:
DOCUMENT_REPLACE=WC_BASE_URL/webcenter/content/conn/UCM_ID/uuid/dDocName%3aFILE_ID
例:
ソースURL:
<a href="MarketingWiki/Presentations/ProductBranding.pptx"> Download Product Branding Presentation</a>
WebCenterのURL:
<a href="http://webcenter.example.com/webcenter/content/dev-ucm/uuid/dDocName%3aWSIMPORT7"> Download Product Branding Presentation</a>
インポートされるコンテンツを含む各ルート・フォルダで、ExportImportData.xmlドキュメントを作成する必要があります。ExportImportData.xmlドキュメントは、ルート・フォルダのコンテンツを記述し、ドキュメント移行ユーティリティを使用してWebCenter Portalにコンテンツをインポートする際にインポートを実行するために使用されます。ドキュメント移行ユーティリティおよびExportImportData.xmlドキュメントの詳細は、第F.2項「ドキュメント移行ユーティリティの理解」を参照してください。
インポート時にドキュメントとともに作成されるメタデータは、ExportImportData.xmlドキュメントで指定する必要があります。WebCenter Portalでは、wikiドキュメントはHTMLドキュメントとして格納されますが、通常のHTMLドキュメントではなくwikiドキュメントとして識別するための追加のメタデータを持ちます。ExportImportData.xmlドキュメントが、抽出されたコンテンツのすべてのwikiドキュメントに対してこのメタデータを指定していることを確認してください。wikiドキュメントに必要なメタデータの詳細は、第F.1項「WikiドキュメントおよびWikiページの理解」を参照してください。
|
注意: コンテンツID (dDocName)は、ドキュメントが指定されずにチェックインされるときに、Content Serverによって自動的に生成されます。ドキュメントのコンテンツIDを固定する場合は、ExportImportData.xmlドキュメントにドキュメント・メタデータとともにdDocNameメタデータを含めてください。dDocNameは、Content Server全体で一意である必要があります。そうでない場合、ドキュメントのチェックインは失敗します。コンテンツIDに独自の接頭辞を選択し、末尾に番号を順次追加することをお薦めします。 |
ExportImportData.xmlドキュメントは、ルート・フォルダごとに手動で生成できます。または、カスタム・スクリプトを記述して、ルート・フォルダのコンテンツを通過し、ドキュメントを生成することができます。
ファイル・システムのコンテンツの構造が、ExportImportData.xmlドキュメントで正しく詳述されている必要があります。ExportImportData.xmlドキュメントとファイル・システムで記述されるコンテンツの階層間で不一致がある場合、ターゲットContent Serverのポータル・フォルダへのインポートは失敗します。
例:
この例では、convert_programという名前のカスタム・スクリプトが、21SD15F13B8_141D_421B_AD0e_BC54B6F16893というルート・フォルダを通過して、フォルダのコンテンツを詳述している現在作業中のディレクトリにExportImportData.xmlドキュメントを作成します。
cd 21SD15F13B8_141D_421B_AD0e_BC54B6F16893 run convert_program
ルート・ポータル・フォルダを圧縮することにより、抽出され、操作されたwikiドキュメントのアーカイブを作成します。圧縮されたアーカイブは、ルート・フォルダのコンテンツだけではなく、アーカイブ内にルート・フォルダを持っている必要があります。1つの圧縮ファイルには、様々なポータル用に複数のルート・フォルダを含むことができます。またはルート・フォルダごとに1つの圧縮ファイルを作成できます。
例:
次の例で、wikiドキュメントは、フォルダ/scratch/wikiexportsの21SD15F13B8_141D_421B_AD0e_BC54B6F16893というフォルダで抽出および操作されており、作成するアーカイブは、wsimport.zipです。
cd /scratch/wikiexports zip –r wcimport.zip 21SD15F13B8_141D_421B_AD0e_BC54B6F16893/
|
注意: 一部の圧縮ツールがアーカイブを上書きするのではなく、すでに存在している場合、指定されたアーカイブにコンテンツを追加するため、フォルダ・コンテンツを圧縮する前に、アーカイブが存在していないことを確認してください。 |
ターゲットContent Serverにコンテンツをインポートするには、前の手順で生成されたアーカイブを指定して、ドキュメント移行ユーティリティを実行します。ドキュメント移行ユーティリティの使用方法の詳細は、第F.3.3.2項「ドキュメント移行ユーティリティを使用したコンテンツの移行」を参照してください。
WebCenter Portalにログインして、コンテンツがインポートされたポータルに移動して、コンテンツが存在することを確認します。
表F-1に、ドキュメント移行ユーティリティの実行に必要なプロパティを示します。ユーティリティの実行方法の詳細は、第F.3.3.2項「ドキュメント移行ユーティリティを使用したコンテンツの移行」を参照してください。
表F-1 ドキュメント移行プロパティ
| プロパティ | 説明 | 要件 |
|---|---|---|
|
Usage |
コンテンツをファイルにインポートまたはエクスポートするかどうかを指定します。オプションは |
エクスポートおよびインポート |
|
MDSConn |
MDS JDBC接続を次の形式で指定します。
|
エクスポート |
|
MDSUser |
WebCenter Portalで使用されるMDSユーザー名を指定します。 |
エクスポート |
|
MDSPwd |
MDSユーザーのパスワードを指定します。パスワードのプロンプトを表示させないためにのみこれを含めます。 |
エクスポート |
|
ExportScopes |
各ポータル/ポータル・テンプレートの内部名をエクスポートするコンテンツとともに指定します。複数のポータル/テンプレート名をカンマで区切ります。ポータル・テンプレート名の先頭に 「ポータルについて」および「ポータル・テンプレートについて」ダイアログから内部名を取得できます。ここに表示名は入力しないでください。 |
エクスポート |
|
UCMConn |
Content Server URLを次の形式で指定します:
|
エクスポートおよびインポート |
|
UCMUser |
RIDCからの接続に使用されるContent Serverユーザー名を指定します。このユーザーには、エクスポートまたはインポートを実行するための十分な権限が必要です。つまり、外部アイデンティティ・ストアに定義されているユーザーまたはContent Server管理者 |
エクスポートおよびインポート |
|
UCMPwd |
Content Serverユーザーのパスワードを指定します。パスワードのプロンプトを表示させないためにのみこれを含めます。 |
エクスポートおよびインポート |
|
UCMSpacesRoot |
WebCenter Portalコンテンツが格納されているルート・フォルダを示します。値は、 |
エクスポートおよびインポート |
|
TmpDirPath |
オプション。データ抽出の一時的な場所。指定されない場合、デフォルトはシステムの |
エクスポートおよびインポート |
|
ArchivePath |
ドキュメント・アーカイブの場所。 |
エクスポートおよびインポート |
|
ArchiveName |
オプション。ドキュメント・アーカイブの名前( |
エクスポートおよびインポート |
次のいずれかの方法を使用できます。
プロパティ・ファイルでのドキュメント移行プロパティの指定
エクスポート/インポートに必要なすべてのプロパティを含むプロパティ・ファイルを作成します。すべてのプロパティの説明は、表F-1を参照してください。
次のプロパティ・ファイルをメモ帳または別の適切なテキスト・エディタにコピーして貼り付け、環境に応じて編集します。
# Document migration properties.
# Specify whether you want to export content to a file or
# import content from an archive to another content repository
# valid values: export | import
Usage=export
# Specify connection details for Oracle WebCenter Content repository:
# UCMConn - Content Server URL. Format: idc://host:intradocPort
# UCMUser - Content Server user name used to connect through RIDC
# UCMPwd - Password for UCMUser. Only include to avoid password prompt
# UCMSpacesRoot - Root folder where WebCenter Portal content is stored.
Format: /foldername
# Required for: Export and Import
UCMConn=idc://mycontentserver.mycompany.com:9444
UCMUser=<enter Content Server admin user name here>
#UCMPwd=<enter password for UCMUser here>
#UCMSpacesRoot=/portalrootfolder
# Specify a temp directory and name/location for the export archive
# TmpDirPath -Optional. Temporary location for data extraction.
# If not specified, defaults to the system temporary directory.
# ArchiveName -Optional. Name for the document archive (.zip).
# Default is docsexport.zip.
# ArchivePath -Document archive location
# Required for: Export and Import
TmpDirPath=/scratch/user1/migrateMyPortalDocs/tmpdir
ArchivePath=/scratch/user1/migrateMyPortalDocs/output
ArchiveName=myportaldocs.zip
# Specify MDS details (export only)
# MDSConn - MDS JDBC connection. Format:
# jdbc:oracle:thin:@host:port:SID or
# jdbc:oracle:thin:@host:port/ServiceName
# MDSUser - MDS schema user name used by the WebCenter Portal application
# MDSPwd = Password for MDSUser. Only include to avoid password prompt
# Required for: Export
MDSConn=jdbc:oracle:thin:@mymdshost.mycompany.com:1521:wkcdb01
MDSUser=<enter MDS user name here>
#MDSPwd=<enter password for MDSUser here>
# Specify target portal for export or import.
# Seperate multiple portal/template names with a comma.
# Use internal names only. Do not enter display names.
# Obtain internal names from "About Portal" and "About Portal Template" dialogs.
# Prefix portal template names with 'spacetemplate/<template_internal_name>'
# as indicated in the example.
# Required for: Export
ExportScopes=MyPortal1,MyPortal2,spacetemplate/MyPortalTemplate
ファイルを保存します。たとえば、myMigrationProperties.propertiesとして保存します。
ドキュメント移行ユーティリティcontent-migration-tool.jarがあるWCP_ORACLE_HOME/webcenter/archivesディレクトリに移動します。
絶対パスをコマンド行上のドキュメント移行プロパティ・ファイルに指定することにより、ドキュメント移行ユーティリティを実行します(例F-1)。
java -jar content-migration-tool.jar <absolute_path_to_migrationPropertiesFilename>
オプションで、第F.3.3.3項「追加のログを指定したドキュメント移行ユーティリティの実行」の説明に従って、java.util.logging.config.fileパラメータを使用したログ設定を指定します。
コマンド行でのドキュメント移行プロパティの指定
ドキュメント移行ユーティリティcontent-migration-tool.jarがあるWCP_ORACLE_HOME/webcenter/archivesディレクトリに移動します。
コマンド行上で個々のプロパティを指定することにより、ドキュメント移行ユーティリティを実行します。
コンテンツをエクスポートするには:
java -jar content-migration.jar Usage UCMConn UCMUser TmpDirPath ArchivePath ArchiveName MDSConn MDSUser ExportScopes [UCMPwd MDSPwd] UCMSpacesRoot
コンテンツをインポートするには:
java -jar content-migration.jar Usage UCMConn UCMUser TmpDirPath ArchvePath ArchiveName [UCMPwd] UCMSpacesRoot
注意: オプションで、コマンド行上で、UCMPwdおよびMDSPwdパラメータを指定できます。指定しない場合は、これらを指定するよう求められます。
オプションで、第F.3.3.3項「追加のログを指定したドキュメント移行ユーティリティの実行」の説明に従って、java.util.logging.config.fileパラメータを使用したログ設定を指定します。
求められた場合のコマンド行でのドキュメント移行プロパティの指定
ドキュメント移行ユーティリティcontent-migration-tool.jarがあるWCP_ORACLE_HOME/webcenter/archivesディレクトリに移動します。
求められた場合はコマンド行上でプロパティを指定することにより、ドキュメント移行ユーティリティを実行します。
java -jar content-migration.jar
オプションで、第F.3.3.3項「追加のログを指定したドキュメント移行ユーティリティの実行」の説明に従って、java.util.logging.config.fileパラメータを使用したログ設定を指定します。
次のようにオプションでjava.util.logging.config.fileパラメータを使用し、追加のログを指定してドキュメント移行ユーティリティを実行できます。
java -Djava.util.logging.config.file=<absolute_path_to_logging_properties_file> -jar content-migration-tool.jar <migrationProperties>
注意: java.util.logging.config.fileパラメータは、javaコマンドの直後、-jarの前に指定する必要があります。
logging_properties_fileに次のような設定が含まれます。
handlers=java.util.logging.ConsoleHandler.level=INFO java.util.logging.ConsoleHandler.level=FINER java.util.logging.ConsoleHandler.formatter=java.util.logging.SimpleFormatter oracle.webcenter.doclib.level=INFO
WebCenter Portal wikiページを使用して、インポートされたwikiを表示するには、次の手順を実行します。wikiページの詳細は、第F.1項「WikiドキュメントおよびWikiページの理解」を参照してください。
WebCenter Portalにログインします。
コンテンツがアップロードされているポータルを検索します。
「アクション」をクリックし、「作成」→「ページ」の順に選択します。
wikiページに「名前」を指定し、Wikiページ・レイアウトを選択します。
wikiページの名前がWebCenter Portalのポータル・フォルダのフォルダ名と一致している必要があることに注意してください。このフォルダには同じ名前のwikiページが含まれています。
たとえば、ポータル・フォルダに、MarketingWikiフォルダとMarketingWiki.htmドキュメントがある場合、wikiページの名前は、MarketingWikiである必要があります。
