80 Developer Toolsのコマンドライン・インタフェース(CLI)を使用した再使用可能なモジュールの作成
Developer Toolsキットでは、モジュールという形でリソースを再利用および共有できます。モジュールは、サイトに固有ではないワークスペースです。このワークスペースには、テンプレート、フレックス・ファミリ、ElementCatalogエントリなどのリソースが含まれています。ナチュラル・マッピングを使用してアセットがサイトに追加される標準のエクスポート/インポートとは異なり、モジュールでは、どのサイトにでもインポートできるように、通常はサイトのオーバーライドを使用します。
トピック:
再利用可能なモデルの作成
Artieはフレックス定義のあるフレックス・ファミリを所有しています。このフレックス定義は、他のサイトで再利用する予定です。また、そのフレックス定義に関連付られたテンプレート・アセットも所有しています。次のシナリオでは、Artieがこれらのリソースを含むモジュールを作成します。
このシナリオでは、コマンドライン・インタフェースを使用して、Artieとチームが「Developer Toolsを使用したリソースの管理および交換」で開発したリソースを含むモジュールを作成します。
ノート:
コマンドライン・インタフェースを使用するために、Artieはコマンドを実行するたびに、一般管理者のユーザー名とパスワードを指定する必要があります。このユーザーは、RestAdminグループのメンバーである必要があります。このシナリオでは、Artieはfwadmin/xceladminを使用します。
次の項を参照してください。
WebCenter Sitesインスタンスでのリソースのリスト
Artieは、コマンドライン・インタフェースを使用してWebCenter Sitesインスタンスを参照します。resources=@ALL_ASSETSセレクタとfromSites=Acceptanceセレクタを使用して、Artieは「Acceptance」サイトのすべてのアセットをリストします。Artieはlistcsコマンドを使用して、自分のWebCenter Sitesインスタンス上のリソースをすべてリストします。
コマンド:
${sites-shared}/config/export/envision/cs_workspace$ java - Xbootclasspath/a:lib/servlet-api.jar -jar developer-tools-command-line.jar http://<host>:<port>/ <context>/ContentServer username=fwadmin password=xceladmin resources=@ALL_ASSETS fromSites=Acceptance cmd=listcs
出力:
Resource Type ||| Resource Id ||| Name ||| Description ||| Modified On -------------------------------------------------------------------------------- Author_CD ||| 1297720502271 ||| fictionAuthor (status=ED) ||| authors who write fiction ||| 2011-02-17 15:10:41 Author_A ||| 1297720502260 ||| authorName (status=ED) ||| author name ||| 2011-02-17 14:46:40 Author_A ||| 1297720502265 ||| authorBio (status=ED) ||| author biography ||| 2011-02-17 14:46:40 Author_A ||| 1297720502289 ||| 1297720502289 (status=VO) ||| author birthplace ||| 2011-02-17 15:12:35 Author_A ||| 1297720502293 ||| DOB (status=PL) ||| date of birth ||| 2011-02-17 14:46:40 Author_A ||| 1297720502305 ||| birthPlace (status=PL) ||| place of birth ||| 2011-02-17 15:10:22 Template ||| 1297720502331 ||| welcome (Typeless, status=ED) ||| welcome page ||| 2011-02-17 23:18:18
Artieは、5つのAuthor_Aフレックス属性インスタンス(そのうちの1つは無効)と1つのAuthor_CDフレックス定義、および1つのテンプレート・アセットがあることを確認します。
スタート・メニュー・アイテムのリスト
Artieはコマンドライン・インタフェースをさらに使用して、Acceptanceサイトに割り当てられているスタート・メニュー・アイテムを参照します。
コマンド:
${sites-shared}/config/export/envision/cs_workspace$ java - Xbootclasspath/a:lib/servlet-api.jar -jar developer-tools-command-line.jar http://<host>:<port>/ <context>/ContentServer username=fwadmin password=xceladmin resources=@STARTMENU:* fromSites=Acceptance cmd=listcs
出力:
Resource Type ||| Resource Id ||| Name ||| Description ||| Modified On -------------------------------------------------------------------------------- @STARTMENU ||| 1297720502206 ||| Find Author ||| null ||| - @STARTMENU ||| 1297720502214 ||| Find Author Attribute ||| null ||| - @STARTMENU ||| 1297720502222 ||| Find Author Definition ||| null ||| - @STARTMENU ||| 1297720502230 ||| Find Author Filter ||| null ||| - @STARTMENU ||| 1297720502238 ||| Find Author Parent ||| null ||| - @STARTMENU ||| 1297720502246 ||| Find Author Parent Def ||| null ||| - @STARTMENU ||| 1297720494070 ||| Find CSElement, FirstSiteII ||| Find CSElement ||| - @STARTMENU ||| 1297720494086 ||| Find Page, FirstSiteII ||| Find Page ||| - @STARTMENU ||| 1297720494078 ||| Find SiteEntry, FirstSiteII ||| Find SiteEntry ||| - @STARTMENU ||| 1297720494066 ||| Find Template, FirstSiteII ||| Find Template ||| - @STARTMENU ||| 1297720502210 ||| New Author ||| null ||| - @STARTMENU ||| 1297720502218 ||| New Author Attribute ||| null ||| - @STARTMENU ||| 1297720502226 ||| New Author Definition ||| null ||| - @STARTMENU ||| 1297720502234 ||| New Author Filter ||| null ||| - @STARTMENU ||| 1297720502242 ||| New Author Parent ||| null ||| - @STARTMENU ||| 1297720502250 ||| New Author Parent Def ||| null ||| - @STARTMENU ||| 1297720501427 ||| New CSElement ||| null ||| - @STARTMENU ||| 1297720494052 ||| New Page, FirstSiteII ||| New Page ||| - @STARTMENU ||| 1297720501431 ||| New SiteEntry ||| null ||| - @STARTMENU ||| 1297720501435 ||| New Template ||| null ||| -
ワークスペースへのすべてのリソースのエクスポート
Artieは、モジュールを作成する前に、まずすべてのリソースを特定のワークスペースにエクスポートします。
Artieは、「WebCenter Sitesインスタンスでのリソースのリスト」および「スタート・メニュー・アイテムのリスト」にリストされているすべてのリソースを使用してモジュールを作成したいと考えています。このため、次のコンテンツを実行して、指定されたワークスペースにすべてのリソースを一度にエクスポートします。
コマンド:
${sites-shared}/config/export/envision/cs_workspace$
java - Xbootclasspath/a:lib/servlet-api.jar -jar
developer-tools-command-line.jar http://<host>:<port>/
<context>/ContentServer username=fwadmin password=xceladmin
resources=@STARTMENU:*;@ALL_ASSETS fromSites=Acceptance cmd=export
datastore=authorModule
出力:
*** Exporting batch 1298385511005 Exporting ASSETDATA Author_CD:1297720502271 (batch 1298385511005) Exporting ASSETDATA Author_A:1297720502260 (batch 1298385511005) Exporting ASSET_TYPE Author_A (batch 1298385511005) Exporting ELEMENTCATALOG OpenMarket/Xcelerate/AssetType/Author_A/LoadSiteTree (batch 1298385511005) Exporting ELEMENTCATALOG OpenMarket/Xcelerate/AssetType/Author_A/AppendSelectDetails (batch 1298385511005) Exporting ELEMENTCATALOG OpenMarket/Xcelerate/AssetType/Author_A/AppendSelectDetailsSE (batch 1298385511005) Exporting ELEMENTCATALOG OpenMarket/Xcelerate/AssetType/Author_A/IndexAdd (batch 1298385511005) Exporting ELEMENTCATALOG OpenMarket/Xcelerate/AssetType/Author_A/IndexReplace (batch 1298385511005) Exporting ELEMENTCATALOG OpenMarket/Xcelerate/AssetType/Author_A/IndexCreateVerity (batch 1298385511005) Exporting ELEMENTCATALOG OpenMarket/Xcelerate/AssetType/Author_A/ContentDetails (batch 1298385511005) Exporting ELEMENTCATALOG OpenMarket/Xcelerate/AssetType/Author_A/ContentForm (batch 1298385511005) Exporting ELEMENTCATALOG OpenMarket/Xcelerate/AssetType/Author_A/PostUpdate (batch 1298385511005) Exporting ELEMENTCATALOG OpenMarket/Xcelerate/AssetType/Author_A/PreUpdate (batch 1298385511005) ...
エクスポートには、フレックス・ファミリのアセット・タイプがすべて含まれています。また、これらのタイプに属するエレメントもすべて含まれています。この情報は通常変更されませんが、Artieが作成しているモジュールを別のWebCenter Sitesインスタンスで再利用可能にするために必要になります。
モジュールのコンテンツの調査
Artieは、自分のファイル・システムのauthorModuleワークスペースを調べます。
Artieは自分のファイル・システムのワークスペースに、テンプレート・アセット、フレックス・ファミリのメンバー、アセット・タイプおよびスタート・メニュー・アイテムがすべてエクスポートされていることを確認します。
モジュールのアーカイブ
Artieは、あと一歩でauthorModuleをWebCenter Sitesインスタンスにインポートできるところまで来ています。
ArtieはauthorModuleワークスペースの.zipファイル・アーカイブを作成して、そのアーカイブを保存します。
WebCenter Sitesインスタンスへのモジュールのインポート
Artieは、サンプル・サイトにモジュールをインポートする準備ができました。
- Artieは、ターゲットのWebCenter Sitesインスタンスの、ワークスペースの場所にモジュールを解凍します。
- Artieは、FirstSiteIIサンプル・サイトのAdminインタフェースを開き、アセット・タイプとスタート・メニュー・アイテムが正常にインポートされていることを確認します。
- Artieは、FirstSiteIIサンプル・サイトにフレックス定義が正常にインポートされていることを確認します。
- コマンドライン・インタフェースを使用して、テンプレート・アセットもインポートします。次に、もう一度Adminインタフェースを開き、テンプレート・アセットが正しくインポートされていることを確認します。
モジュール全体が、FirstSiteIIサンプル・サイトに正常にインポートされています。このモジュールは再利用可能であり、任意のWebCenter Sitesインスタンスにインポートできます。
