* flowgenユーティリティを利用した作成方法 [#ob75e293]

** ユーティリティ概要 [#n27126d1]

CUIコンソール上でBPMNファイルを生成するためのユーティリティとして、GoCutoはflowgenユーティリティを提供しています。
flowgenユーティリティはbinディレクトリ内に配置されており、以下のコマンド形式で実行します。

 flowgen 簡易フローファイルのパス

*** リターンコード [#p4ac74e7]

flowgenユーティリティは実行結果に応じて以下のリターンコードを返します。

|返却値|説明|h
|0|正常終了|
|1|引数が指定されていない/過剰に指定された|
|2|簡易フローファイル内の書式エラー|
|4|BPMNファイルの出力失敗|

** 簡易フローファイル [#w289b842]

*** 書式 [#ldd29c0f]

簡易フローファイルはBPMNよりも感覚的にフローを記述できる独自形式のファイルです。
ファイル内では実行するジョブ名と以下の2種類の記号を利用してフローを記述します。

|記号|使用例|意味|h
|->|ジョブ1->ジョブ2|ジョブ1の終了を待ってからジョブ2の実行を開始する。|
|[ , ]|[ジョブ1,ジョブ2,ジョブ3]|ジョブ1、ジョブ2、ジョブ3を並列に実行する。|

なお、以下のように角括弧内で矢印を使って先行関係付きのジョブ実行をしたり、角括弧同士やジョブと角括弧の間に先行関係を付けることが可能です。

 ジョブ1->[ジョブ2->ジョブ3,ジョブ4]->[ジョブ5,ジョブ6->ジョブ7,ジョブ8]->ジョブ9

また、空白文字(半角スペース、タブ文字、改行文字)は全て無視されますので、これらを使って読みやすいように整形をすることが可能です。

 ジョブ1 ->
 [
   ジョブ2 -> ジョブ3,
   ジョブ4
 ] ->
 [
   ジョブ5,
   ジョブ6 -> ジョブ7,
   ジョブ8
 ] ->
 ジョブ9
 

*** 禁則事項 [#i96aba4e]

以下の条件のいずれかに該当する場合はエラーとなり、BPMNファイルの生成ができません。

- ジョブが1つもない

- 空の角括弧がある

 ジョブ1->[]->ジョブ2

- 角括弧内に空の経路がある

 ジョブ1->[ジョブ2,,ジョブ3]->ジョブ4

- 並列実行のネスト(角括弧内の角括弧)が存在する

 ジョブ1->[ジョブ2,[ジョブ3,ジョブ4]]->ジョブ5

- ジョブ名に以下の禁止文字のいずれかが含まれている

 \ / : * ? < > $ & [ ] , -

*** 出力ファイルについて [#wefcb1d6]

flowgenユーティリティにより生成されたBPMNファイルは、元となった簡易フローファイルと同ディレクトリに保存されます。ファイル名は元ファイルの拡張子を「.bpmn」に変えた物になります。

|元ファイル名|出力ファイル名|h
|example.flow|example.bpmn|
|example2.subname.flow|example2.subname.bpmn|
|example3|example3.bpmn|

同名のファイルが存在する場合は、末尾に「.bk」を付けたファイル名にリネームされます。

トップ   編集 差分 バックアップ 添付 複製 名前変更 リロード   新規 一覧 単語検索 最終更新   ヘルプ   最終更新のRSS