この章では、統合されたWebCenter Sitesインスタンスからエクスポートしたリソースが、どのようにDeveloper Toolsに格納されているかについて説明します。
この章には次の項が含まれます。
ワークスペースとは、シリアライズされたWebCenter Sitesデータのディスクベースのリポジトリです。このデータは、ワークスペースのWebCenter Sitesインスタンスからのリソース、または別のインスタンスのワークスペースからのリソースを表します。ワークスペースには、アセット、フレックス・ファミリ、サイトなどのあらゆるタイプのWebCenter Sitesリソースを格納できます。各ワークスペースは、1つのWebCenter Sitesインスタンスに関連付けられています。
デフォルトでは、Eclipseは、WebCenter Sitesインスタンスごとに1つのメインDeveloper Toolsワークスペース(Eclipseプロジェクト・フォルダ内に配置される)を提供します。これは、Eclipse IDEで作業する際の継続的な開発に使用されます。カスタム・ワークスペースは、上級開発者がDeveloper Toolsのコマンドライン・ツールを使用して作成できます。カスタム・ワークスペースは、モジュールの作成などの特殊なプロジェクトに使用できます。カスタム・ワークスペースの作成方法の詳細は、第58章「Developer Tools: コマンドライン・ツール」を参照してください。
バージョン・コントロール・システム(Subversionなど)や共有ファイル・システムと併用することで、あるワークスペースに格納されたリソースを別のワークスペースと交換できるようになります。あるWebCenter Sitesインスタンスから関連ワークスペースにエクスポートされたリソースは、別のWebCenter Sitesインスタンスのワークスペースにコピーできます。これにより、そのリソースは、2番目のワークスペースの関連WebCenter Sitesインスタンスにインポートできるようになります。異なるワークスペース間でのリソース共有の詳細は、第59章「Developer Tools: バージョン・コントロール・システムとの統合」を参照してください。
ワークスペースは、WebCenter Sitesのインストール・ディレクトリ内にあるexport/envision
フォルダに作成されます。メインDeveloper Toolsワークスペースは、export/envision/cs_workspace
フォルダ内に配置されます。メインDeveloper Toolsワークスペースは、Eclipseのプロジェクト・フォルダで表示可能な唯一のワークスペースです。
ワークスペースの構造は、どれも同じです。ワークスペースに含まれる各リソースは、単一のファイルまたは相関する複数のファイルとして格納されます。各リソースのメイン・ファイルの末尾には、.main.xml
が付きます。このファイルには、リソース固有のメタデータが含まれます。また、メイン・ファイルには、そのリソースに関連付けられた他のファイル(添付されたドキュメント、JSPファイル、BLOBなど)へのリンクも含まれます。これにより、各リソースは、リソースの関連ファイルがすべてワークスペース内に格納されていれば、完全な自己完結型リソースになります。それ以外の場合、リソースは不完全になります。
リソースに複数のファイルが含まれている場合、それらのファイルは.main.xml
ファイルの最後のセクションに、storable0
、storable1
などの形でリストされます。どのリソースの関連ファイルにも、同様の名前が付けられます。このようにすることで、リソースに関連するすべてのファイルが、まとめて表示されるようになります。ただし、元のルート・パスを保持するために個別に格納されるElementCatalogのエントリを除きます。
ワークスペースに含まれるリソースのファイルの場所は、リソースのタイプに応じて異なります。ワークスペースは、次の各セクションに分割されています。
src/_metadata
: アセット、アセット・タイプ、サイト、ロールなどを含む特定のリソースのメタデータ・セクション。また、レガシーXMLコードは、ELEMENTS/
サブフォルダ内に格納されます。
src/jsp/cs_deployed
: このセクションには、リソースのJSPファイルが適切なパスの下に格納されます。
ワークスペースの構造は高度に一貫性が保たれているため、あるワークスペースから別のワークスペースにリソースをコピーできます。どのファイル・システムのコピー操作にも当てはまることですが、同じ名前のファイルを上書きしないように注意してください。
アセットは、src/_metadata/ASSET/asset type
という名前のフォルダ内に格納されます。この構造には、アセット・データを含む2レベルのハッシュベースの階層があります。アセット・ファイルの名前は、アセット名と、そのアセットのfw_uid
値に応じて決まります。アセットに添付ファイルやBLOBが含まれている場合、そのファイル名は、アセット名、属性名、fw_uid
値、およびドキュメントまたはBLOB (存在する場合)の名前に基づいて決定されます。
たとえば、FSII IES_Manual.pdfという名前のDocument_Cアセットには、IES_MDPlayer_Manual.pdfという添付ドキュメントが含まれているとします。その場合、このアセットは、次に示す2つの個別のファイルに格納されることになります。
最初のファイルは、.main.xml
ファイルです。このファイルには、アセットのメタデータと、アセットに関連付けられたファイルへのリンクが含まれます。
.src/_metadata/ASSET/Document_C/8/0/FSII IES_MDPlayer_ Manual.pdf(aa0b47b5-f558-49d4-a6ac2ee012d1b75).main.xml
2番目のファイルは、実際のドキュメントです。この例では、PDFファイルになります。
.src/_metadata/ASSET/Document_C/8/0/FSII IES_MDPlayer_ Manual.pdf.FSIIDocumentFile(aa0b47b5-f558-49d4-8a6a- c2ee012d1b75).IES_MDPlayer_Manual.pdf
注意: アセットに関連するすべてのファイルは、アセットの名前に基づいているため、アセット名の変更がファイル名の変更につながります。アセットをVCSで追跡している場合は、古い名前のファイルを削除してください。 |
テンプレート、CSElement、およびElementCatalogのエントリは、それらのコード・エレメントで必要になるストレージ・パスの下に格納されます。コード・ベースのリソースに関連付けられたJSPファイルは、src/jsp/cs_deployed
の下のワークスペースに格納され、XMLエレメントはsrc/_metadata/ELEMENTS
の下に格納されます。コード・ベースのリソースのメタデータ・ファイルは、そのリソースのJSPと同じ名前に拡張子.main.xml
が追加されたファイル名で格納されます。これにより、コード・ベースのリソースのメタデータ・ファイル、JSPファイル、およびXMLファイルは、ワークスペース内でグループ化されます。
属性エディタはアセットとして追跡されますが、ElementCatalogエントリのセットに対する暗黙の参照も含まれています。属性エディタのElementCatalogエントリは、個別に追跡されます。
たとえば、TextAreaエディタは、OpenMarket/Gator/AttributeTypes/TEXTAREA
ElementCatalogエントリを使用します(このエントリは、依存性として登録されています)。Developer Toolsは、TextAreaエディタ用に次のファイルを維持します。
.main.xml
ファイル:
src/_metadata/ASSET/AttrTypes/9/10/TextArea(e64f983d-9c7c-489baedb- 476d56f8121e).main.xml
urlxml
メタデータ・ファイル:
src/_metadata/ASSET/AttrTypes/9/10/TextArea.urlxml(e64f983d-9c7c- 489b-aedb-476d56f8121e).1095346398911.txt
ElementCatalogエントリ(個別のリソースとして追跡されます):
ElementCatalogエントリの.main.xml
ファイル:
src/_metadata/ELEMENTS/OpenMarket/Gator/AttributeTypes/TEXTAREA .xml.main.xml
属性エディタのエレメント・コード:
src/_metadata/ELEMENTS/OpenMarket/Gator/AttributeTypes/ TEXTAREA.xml
アセット・タイプには、メイン・メタデータの部分とエレメントのセットが含まれます。たとえば、Pageアセット・タイプの構造は、次のようになります。
ページのメイン・メタデータは、.main.xml
ファイルに格納されます。
src/_metadata/Asset_Type/Page(b8d8ae9-14cc-4554-b80e-0c22e39a3ec8) .main.xml
関連エレメントは個別に追跡されます(各エレメントに独自の.main.xml
ファイルが存在します)。
src/_metadata/ELEMENTS/OpenMarket/Xcelerate/AssetType/Page/ SearchForm.xml src/_metadata/ELEMENTS/OpenMarket/Xcelerate/AssetType/Page/ CheckDelete.xml src/_metadata/ELEMENTS/OpenMarket/Xcelerate/AssetType/Page/ ContentForm.xml.main.xml src/_metadata/ELEMENTS/OpenMarket/Xcelerate/AssetType/Page/ ContentDetails.xml.main.xml src/_metadata/ELEMENTS/OpenMarket/Xcelerate/AssetType/Page/ LoadSiteTree.xml src/_metadata/ELEMENTS/OpenMarket/Xcelerate/AssetType/Page/ IndexReplace.xml.main.xml src/_metadata/ELEMENTS/OpenMarket/Xcelerate/AssetType/Page/ LoadTree.xml src/_metadata/ELEMENTS/OpenMarket/Xcelerate/AssetType/Page/ IndexAdd.xml.main.xml src/_metadata/ELEMENTS/OpenMarket/Xcelerate/AssetType/Page/ SearchForm.xml.main.xml src/_metadata/ELEMENTS/OpenMarket/Xcelerate/AssetType/Page/ IndexReplace.xml src/_metadata/ELEMENTS/OpenMarket/Xcelerate/AssetType/Page/ PreviewPage.xml.main.xml src/_metadata/ELEMENTS/OpenMarket/Xcelerate/AssetType/Page/ LoadTree.xml.main.xml src/_metadata/ELEMENTS/OpenMarket/Xcelerate/AssetType/Page/ PreUpdate.xml src/_metadata/ELEMENTS/OpenMarket/Xcelerate/AssetType/Page/ Tile.xml.main.xml src/_metadata/ELEMENTS/OpenMarket/Xcelerate/AssetType/Page/ SimpleSearch.xml src/_metadata/ELEMENTS/OpenMarket/Xcelerate/AssetType/Page/ SimpleSearch.xml.main.xml src/_metadata/ELEMENTS/OpenMarket/Xcelerate/AssetType/Page/ ContentForm.xml src/_metadata/ELEMENTS/OpenMarket/Xcelerate/AssetType/Page/ AppendSelectDetailsSE.xml src/_metadata/ELEMENTS/OpenMarket/Xcelerate/AssetType/Page/ LoadSiteTree.xml.main.xml src/_metadata/ELEMENTS/OpenMarket/Xcelerate/AssetType/Page/ AppendSelectDetails.xml.main.xml src/_metadata/ELEMENTS/OpenMarket/Xcelerate/AssetType/Page/ ManageSchVars.xml src/_metadata/ELEMENTS/OpenMarket/Xcelerate/AssetType/Page/ PreviewPage.xml src/_metadata/ELEMENTS/OpenMarket/Xcelerate/AssetType/Page/ CheckDelete.xml.main.xml src/_metadata/ELEMENTS/OpenMarket/Xcelerate/AssetType/Page/ ManageSchVars.xml.main.xml src/_metadata/ELEMENTS/OpenMarket/Xcelerate/AssetType/ Page/PreUpdate.xml.main.xml src/_metadata/ELEMENTS/OpenMarket/Xcelerate/AssetType/Page/ AppendSelectDetails.xml src/_metadata/ELEMENTS/OpenMarket/Xcelerate/AssetType/Page/ IndexCreateVerity.xml.main.xml src/_metadata/ELEMENTS/OpenMarket/Xcelerate/AssetType/Page/ ContentDetails.xml src/_metadata/ELEMENTS/OpenMarket/Xcelerate/AssetType/Page/ PostUpdate.xml src/_metadata/ELEMENTS/OpenMarket/Xcelerate/AssetType/Page/ IndexAdd.xml src/_metadata/ELEMENTS/OpenMarket/Xcelerate/AssetType/Page/ IndexCreateVerity.xml src/_metadata/ELEMENTS/OpenMarket/Xcelerate/AssetType/Page/ Tile.xml src/_metadata/ELEMENTS/OpenMarket/Xcelerate/AssetType/Page/ AppendSelectDetailsSE.xml.main.xml src/_metadata/ELEMENTS/OpenMarket/Xcelerate/AssetType/Page/ PostUpdate.xml.main.xml