34 Developer Toolsコマンドライン・ツールの使用

Developer Toolsのコマンドライン・ツールは、デプロイメントやその他のリソースの移動操作に使用できます。作業対象がDeveloper ToolsのワークスペースにかぎられるEclipse統合とは異なり、コマンドライン・ツールでは、どのワークスペースも作業対象にできます。また、コマンドライン・ツールには、Eclipse IDEでの作業時には使用できないインポート機能とエクスポート機能があります。たとえば、開発者は、任意のサイトにインポート可能なリソースを含むワークスペース(再利用可能なモジュール)を作成できます。

コマンドライン・ツールの実行および使用の詳細は、次の項を参照してください。

34.1 コマンドライン・ツールの実行と使用

コマンドライン・ツールを実行する手順は次のとおりです。

WebCenter Sitesのインストール・ディレクトリ(${Oracle Home}/wcsites/clients)のclientsフォルダにあるdeveloper-tools-command-line-x.y.z.zipファイルを解凍します。
developer-tools-command-line-x.y.z.jarファイルを実行し、次のようにJava EEライブラリ(例: サーブレットAPI実装)をクラスパスに含めます。
```
java -Xbootclasspath/a:lib/servlet-api.jar -jar developer-tools-command-line.jar 
http://<hostname>:<port>/<context-path>/ContentServer username=<username> password=<password>  
cmd=export|import|listcs|listds [options] 
```
プレースホルダのパラメータは、自分の開発環境に関する情報と、実行する必要のあるコマンドに置き換えてください。
- http://<hostname>:<port>/<context-path>: ローカルのWebCenter SitesインスタンスのURLで、ContentServerサーブレットも含まれます(例: http://localhost:8080/cs/ContentServer)
- usernameとpassword: WebCenter Sitesの一般管理者のユーザー名とパスワードです。このユーザーは、RestAdminグループのメンバーである必要があります(例: fwadmin/xceladmin)。
- cmd: 実行するコマンドです。次のコマンドを使用できます。
  - export: WebCenter Sitesからワークスペースにデータをエクスポートします。
  - import: ワークスペースからWebCenter Sitesにデータをインポートします。
  - listcs: WebCenter Sitesのコンテンツをリストします。
  - listds: ワークスペースのコンテンツをリストします
- options: importまたはexportには、次のいずれかを指定します。
  - resources: インポートまたはエクスポートするリソースを、リソース・タイプとリソースIDをセミコロンで区切ったリストで指定します。複数のリソースを指定する場合は、カンマ区切りのリストを使用します。特定のタイプのリソースをすべて指定する場合は、*記号を使用します。リソースを(ワークスペースに)エクスポートするには、そのリソースのローカルIDを指定します。たとえば、resources=Content_C:12345;Product_C:*を使用すると、特定のContent_CアセットとすべてのProduct_Cアセットがエクスポートされます。
    
    リソースを(WebCenter Sitesインスタンスに)インポートする場合は、そのリソースのfw_uidを指定します。リソースのfw_uidを取得するには、listdsオプションを使用します。
    
    すべてのリソース・セレクタを次に示します。
    
    @SITE: サイトを指定します。
    
    @ROLE: ロールを指定します。
    
    @ASSET_TYPE: アセット・タイプを指定します。
    
    @TREETAB: ツリー・タブを指定します。
    
    @STARTMENU: スタート・メニュー・アイテムを指定します。
    
    @ELEMENTCATALOG: ElementCatalogエントリを指定します。
    
    @SITECATALOG: サイト・カタログ・エントリを指定します。
    
    @ALL_NONASSETS: この簡略表記を使用すると、すべての非アセット・リソースが選択されます
    
    @ALL_ASSETS: この簡略表記を使用すると、すべての使用可能なアセットが選択されます
    
    asset type: 特定のタイプのアセットを指定します。
    
    注意:
    インポートまたはエクスポートの前に、セレクタが適切なリソースを選択するかどうかを確認するには、エクスポート操作にlistcsを使用し、インポート操作にlistdsを使用します。これらのコマンドにより、移動されるリソースのリストを表示して、実行前にセレクタを微調整します。
    
    リソースの依存性は自動的にエクスポートおよびインポートされます。ただし、listcsコマンドおよびlistdsコマンドを使用しても、依存性はリストされません。
  - fromSites: 指定したサイトのリソースのみを選択します。
  - toSites: (インポート専用)インポート時に、ナチュラル・サイト・アフィリエーションをサイトのカンマ区切りリストでオーバーライドします。指定するサイトは、ターゲット・システムに存在している必要があります。
  - modifiedSince: (アセット専用)指定した日付以降に変更されたリソースのみを選択します。日付書式は、yyyy-mm-dd hh:MM:ssです。
  - datastore: WebCenter Sitesリソースのエクスポート先にするワークスペース、またはWebCenter Sitesリソースのインポート元にするワークスペースを指定します。このパラメータの値の指定を省略すると、メインDeveloper Toolsワークスペースがデフォルトで指定されます。リソースをエクスポートするときに、指定のワークスペースが存在しない場合は、そのワークスペースがコマンドライン・ツールにより自動的に作成され、リソースがエクスポートされます。

34.2 コマンド例

コマンドライン・ツールを使用して実行できるコマンド例のリストを、次に示します。

このコマンドは、FirstSiteIIに属しているアセットのうち、指定した日付以降に変更された特定のContent_CアセットとすべてのProduct_Cアセットをエクスポートします。ワークスペースを指定していないため、Developer Toolsワークスペースがデフォルトで使用されます。
```
java -Xbootclasspath/a:lib/servlet-api.jar -jar developer-tools-command-line-x.y.z.jar http://localhost:8080/cs/ContentServer username=bob password=password resources=Content_C:123432123423,11234234212,111234341234;Product_C:* fromSites=FirstSiteII modifiedSince=2010-08-08 19:14:00 cmd=export
```

このコマンドは、ワークスペースに含まれる特定のContent_CアセットとすべてのProduct_Cアセットをインポートします。ワークスペースを指定していないため、Developer Toolsワークスペースがデフォルトで使用されます。
```
java -Xbootclasspath/a:lib/servlet-api.jar -jar developer-tools-command-line-x.y.z.jar  http://localhost:8080/cs/ContentServer username=bob password=password resources=Content_C:aad618e9-f04e-4ee4-b902-076224bb6f7b;Product_C:* fromSites=FirstSiteII cmd=import
```

このコマンドは、サイトSecondSiteIIのすべてのリソースをTheOutputという名前のワークスペースにエクスポートします。

java -Xbootclasspath/a:lib/servlet-api.jar -jar developer-tools-command-line-x.y.z.jar  http://localhost:8080/cs/ContentServer username=bob password=password resources=@ALL_ASSETS:*;@ALL_NONASSETS:*  fromSites=SecondSiteII  datastore=TheOutput cmd=export

このコマンドは、TheInputという名前のワークスペースに含まれるすべてのアセットとツリー・タブをサイトMySiteにインポートします。

java -Xbootclasspath/a:lib/servlet-api.jar -jar developer-tools-command-line-x.y.z.jar  http://localhost:8080/cs/ContentServer username=bob password=password resources=@ALL_ASSETS:*;@TREETAB:* toSites=MySite  datastore=TheInput cmd=import

34.3 モジュールのインポートについて

モジュールは、WebCenter Sitesインスタンスから特定のワークスペースにエクスポートされる関連リソースのセットです。datastoreパラメータを使用すると、WebCenter Sitesリソースのエクスポート先にするワークスペース、またはWebCenter Sitesリソースのインポート元にするワークスペースを指定できます。存在していないワークスペースにWebCenter Sitesリソースをエクスポートすると、そのワークスペースがコマンドライン・ツールにより自動的に作成され、リソースがエクスポートされます。

モジュールは再利用可能であり、モジュールに含まれるコンテンツは任意のCMサイトにインポートできます(そのサイトが、リソースのサイトに関する正規リストに示されていない場合でもインポートできます)。モジュールをCMサイトにインポートするには、importコマンドを実行する必要があります。datastoreパラメータでは、リソースが含まれているワークスペースを指定し、toSitesパラメータでは、それらのリソースをインポートするサイトを指定します。これにより、ワークスペースのコンテンツは、指定したCMサイトにインポートされます。