# astah* コマンドラインツール 利用ガイド

2012年3月22日更新
株式会社チェンジビジョン

## 【概要】

astah*インストールフォルダに含まれるコマンドラインツール (astah-commandw.exe[※MacとLinuxではastah-command.sh])を利用することで、 コマンドラインから図の画像出力やプロジェクトの簡易比較が行えます。

- 図の画像出力
- プロジェクトの簡易比較（professional版のみ）
- コマンドラインツールの設定

## 【図の画像出力】

-imageを使用することで、プロジェクトファイルに含まれる図をPNG、EMF、JPEG のいずれかの形式で画像ファイルとして出力できます。 画像フォーマットを指定しない場合は、PNG 形式で出力されます。

Macでの実行にはシステム要件を満たしたJavaを別途インストールしてください。

Windowsで、C:\input\hoge.astaファイルのER図をC:\output配下にPNG形式で出力する例 `astah-commandw.exe -image er -f C:\input\hoge.asta -o C:\output`
Mac/Linuxで、~/input/hoge.astaファイルの全図を~/output配下にJPEG形式で出力する例 `astah-command.sh -image all -f ~/input/hoge.asta -o ~/output -t jpg`
オプション

オプション | 説明 | 種類 | 備考
--- | --- | --- | ---
-image | 画像出力アクション | all | 全図
cl | クラス図
uc | ユースケース図
ucd | ユースケース記述
sc | ステートマシン図
act | アクティビティ図
seq | シーケンス図
com | コミュニケーション図
cmp | コンポーネント図
dep | 配置図
cs | 合成構造図
fc | フローチャート
dfd | データフロー図
er | ER図
crud | CRUD
mm | マインドマップ
rqd | 要求図
rqt | 要求テーブル
tm | トレーサビリティマップ
ignore-ref | 参照プロジェクトの図を無視する
-dpi,--dpi [image dpi] | 出力解像度 | - | 出力する画像の解像度を指定する。 デフォルトは、96（システムプロパティに設定されている値）。 解像度を72にすると、画面に表示されている大きさと同等の画像を出力する。
-f,--file [target file] | 出力対象ファイル | - | -
-id,--dgm_id [ids for target diagrams] | 出力対象ID指定 | - | 図のID列をスペース区切りで指定。 この場合、出力時に名前空間のフォルダを作成せず、フラットに画像ファイルを出力する。 ファイル名は、図名ではなく、ID名になる。
-o,--output [output] | 出力先ベースフォルダ | - | 出力先フォルダは、「出力先ベースフォルダ + プロジェクトファイル名」
-t,--type [image type] | 出力画像フォーマット | png | PNG
jpg | JPEG
emf | EMF(拡張メタファイル)

## 【プロジェクトの簡易比較】

-diffを利用することで、コマンドラインからプロジェクトの簡易比較を行います。
Windowsで、base.astaとref.astaを比較する例 `astah-commandw.exe -diff base.asta ref.asta`
Mac/Linuxで、base.astaとref.astaを比較する例 `astah-command.sh -diff base.asta ref.asta`

## 【コマンドラインツールの設定】

コマンドラインツールの実行には、astah*の実行環境が必要です。 大きなサイズのプロジェクトファイルを扱う場合に、JavaVMのメモリ管理オプションの調整が必要なことがあります。 スタックサイズは、astah*のシステムプロパティの設定値を使用します。 初期ヒープサイズと最大ヒープサイズは、以下のように設定してください。
Windows環境 : astah-commandw.l4j.iniの編集 [初期ヒープサイズ]
-Xms16m
16mの部分がサイズ（この例では16Mバイト）になりますので、ファイルに含まれるこの部分を変更します。
[最大ヒープサイズ]
-Xmx384m
384mの部分がサイズ（この例では384Mバイト）になりますので、ファイルに含まれるこの部分を変更します。
Mac/Linux環境 : astah-command.shの編集 [初期ヒープサイズ]
INITIAL_HEAP_SIZE=64m
64mの部分がサイズ（この例では64Mバイト）になりますので、ファイルに含まれるこの部分を変更します。
[最大ヒープサイズ]
MAXIMUM_HEAP_SIZE=1024m
1024mの部分がサイズ（この例では1024Mバイト）になりますので、ファイルに含まれるこの部分を変更します。