Hitachi

uCosminexus Service Coordinator Interactive Workflow コマンド

2.14　ciwtransbpmn（BPMNビジネスプロセス定義ファイルのCSCIWのビジネスプロセス定義ファイルへの変換）

ciwtransbpmnコマンドの詳細について説明します。ciwtransbpmnコマンドは，BPMNビジネスプロセス定義ファイル（.bpmn）を，CSCIWで使用できるビジネスプロセス定義ファイル（.hbx）の形式に変換します。

形式

機能

BPMN2.0に準拠したBPMNビジネスプロセス定義ファイル（.bpmn）から，次のファイルを生成します。

変換元のBPMNビジネスプロセス定義ファイルの指定方法には，ファイル指定とディレクトリ指定があります。ディレクトリ指定では，一度のコマンド実行で，複数の入力ファイルを変換できます。

コマンドを実行すると，-destdirオプションで指定したディレクトリの配下に次のデータが生成されます。

名称

タイプ

出力数

備考

<BPMNファイル名>

ディレクトリ

1つ以上

  • <BPMNファイル名>は，変換対象のBPMNビジネスプロセス定義ファイルから拡張子を除いた名称です。

  • -srcdirオプションが指定された場合，変換対象のBPMNビジネスプロセス定義ファイルの数だけディレクトリが作成されます。

  • ディレクトリが存在しない場合は作成します。

　

<ビジネスプロセス名>#<ビジネスプロセス定義バージョン>.hbx

ビジネスプロセス定義ファイル

1つ以上

  • -bpvオプションを省略した場合，<ビジネスプロセス定義バージョン>は「0001」になります。

  • 同名のファイルが存在する場合は，ファイルを上書きします。

  • -updateオプションを指定した場合，-bpfオプションで指定したビジネスプロセスに対応するプロセス要素の変換結果だけを出力します。

  • -updateオプションを指定した場合，<ビジネスプロセス定義バージョン>は-bpfオプションで指定したファイル名に付与されたビジネスプロセスバージョンとなります。

<ビジネスプロセス名>#<ビジネスプロセス定義バージョン>.bpmn

BPMNビジネスプロセス定義ファイル

1つ以上

  • -bpvオプションを省略した場合，<ビジネスプロセス定義バージョン>は「0001」になります。

  • 同名のファイルが存在する場合は，ファイルを上書きします。

  • ファイルの内容は，入力のBPMNビジネスプロセス定義ファイルと同一です（ファイル名だけ変更されます）。

  • -updateオプションを指定した場合，<ビジネスプロセス定義バージョン>は-bpfオプションで指定したファイル名に付与されたビジネスプロセスバージョンとなります。

実行権限

このコマンドは，管理者特権を使用しなくても実行できます。

ただし，uCosminexus Business Process Developerのインストール先を，管理者だけに更新権限が与えられているディレクトリ（「C:\Program Files」など）にしている場合は，管理者特権で実行してください。管理者特権で実行しないと，メッセージおよびトレースファイルの出力先をデフォルトにしている場合に，メッセージおよびトレースファイルが出力されません。

実行条件

このコマンドを実行できるコンポーネントの稼働状態を次に示します。なお，このコマンドを，同一マシンで複数同時に実行しないでください。

コンポーネント

稼働状態

起動中

停止中

CSCIWManagementServer

○

○

案件運用操作

○

○

CSCIWライブラリを使用した業務アプリケーション（J2EEアプリケーション）

○

○

CSCIWライブラリを使用した業務アプリケーション（Javaアプリケーション）

○

○

アプリケーション呼び出しサービス

○

○

RESTサービス

○

○

運用管理RESTサービス

○

○

同一マシンでの他のコマンド

○

○

異なるマシンでの同一コマンド

○

○

異なるマシンでの他のコマンド

○

○

DBMS

○

○
（凡例）

○：コマンドを実行できます。

引数

-src <bpmn_definition_file_name>

変換対象のBPMNビジネスプロセス定義ファイル（.bpmn）を指定します。

-srcdir <directory_name>

変換対象のBPMNビジネスプロセス定義ファイル（.bpmn）が格納されているディレクトリを指定します。

このオプションを指定すると，指定したディレクトリの直下にあるすべてのBPMNビジネスプロセス定義ファイルが変換されます。各ファイルの処理中にエラーが発生した場合，コマンドは終了せずに，エラーが発生したファイルの処理だけがスキップされます。

-bpv <process_definition_version>

生成するビジネスプロセス定義バージョンを指定します。

指定できる値は0001～9999です。先頭の連続する0は省略できます。

このオプションを省略した場合，0001が指定されたと見なされます。

-destdir <destination_directory_name>

変換結果の出力ルートディレクトリを指定します。指定したディレクトリが存在しない場合は，ディレクトリが作成されます。

このオプションを省略した場合，変換結果は次のディレクトリに出力されます。

<コマンド実行時のカレントディレクトリ>/ciwtransbpmn

-mimax <generating_max_count>

サブプロセス（マルチインスタンス）に対応する階層定義の生成数を設定します。サブプロセス（マルチインスタンス）は，次の2つの要素を含みます。

  • サブプロセス（シーケンシャルマルチインスタンス）

  • サブプロセス（パラレルマルチインスタンス）

オプション指定値は，サブプロセス（マルチインスタンス）に指定された繰り返し回数（loopCardinality）のXPath評価値以上を指定する必要があります。実際の繰り返し回数は，実行環境でのビジネスプロセス動作時点で決まります。実際の繰り返し回数がコマンド実行時のオプション指定値を上回った場合は，実行環境でエラーになります。なお，サブプロセス（マルチインスタンス）の定義で，繰り返し回数に1以上の整数値が指定されている場合は，オプション指定値は無視されます。

指定できる値は1～999の整数です。オプションが省略された場合のデフォルト値は10です。

-update <bpmn_definition_file_name>

登録済みのビジネスプロセスを一部変更する場合に，該当するビジネスプロセスが含まれる，変換対象のBPMNビジネスプロセス定義ファイル（.bpmn）を指定します。

-bpf <business_process_file_name>

登録済みのビジネスプロセスを一部変更する場合に，該当するビジネスプロセスが含まれる，登録済みのビジネスプロセス定義ファイル（.hbx）を指定します。ciwmngbpコマンドで取得したビジネスプロセス定義ファイルを指定してください。-updateオプションで指定したBPMNビジネスプロセス定義ファイル中に対応するプロセス定義が存在しない場合は，エラーとなります。

-file <option_file_name>

このオプションはすべてのコマンドで指定できます。詳細は，「1.5.1　-fileオプション」を参照してください。

-encoding <character_set>

このオプションはすべてのコマンドで指定できます。詳細は，「1.5.1　-fileオプション」を参照してください。

-h

このオプションはすべてのコマンドで指定できます。詳細は，「1.5.2　-hオプション」を参照してください。

CSCIWのチェック処理と設定

変換処理の実行時に，CSCIWのビジネスプロセスを検証します。検証内容は，ビジネスプロセスの登録時と同様です。

検証結果にエラーがあった場合は，入力となったBPMNビジネスプロセス定義ファイルに対する生成物（ディレクトリおよびファイル）は出力しません。

バイト長チェックで使用する最大長および文字コードは，次に示すチェック用プロパティファイルで指定します。

<uCosminexus Business Process Developer インストールディレクトリ>\conf\ciwtransbpmn.properties

指定する値は，実行環境のデータベースのテーブルの設定に合わせる必要があります。

キー名称

デフォルト値

説明

テーブル名※1

カラム名

process.name

64

ビジネスプロセス定義名

PROCESS_DEFINITION

Name

activity.name

64

業務ステップ定義名

ACTIVITY_DEFINITION

Name

activity.description

250

説明（業務ステップ定義）

ACTIVITY_DEFINITION

Description

work.name

64

作業定義名

WORK_DEFINITION

Name

work.description

250

説明（作業定義）

WORK_DEFINITION

Description

control.name

64

定義名（制御ノード定義）

CONTROLNODE_DEFINITION

Name

condition.name

64

定義名（条件定義）

CONDITION_DEFINITION

Name

condition.description

250

説明（条件定義）

CONDITION_DEFINITION

Description

condition.java.classname

255

Javaクラス名（条件定義（Java））

CONDITION_JAVA_DEF

ClassName

condition.java.exparameter

2,000

補助定数パラメタ（条件定義（Java））

CONDITION_JAVA_DEF

ExParameter

creation.name

64

定義名（生成ルール定義）

CREATIONRULE_DEFINITION

Name

creation.description

250

説明（生成ルール定義）

CREATIONRULE_DEFINITION

Description

creation.java.classname

255

Javaクラス名（生成ルール定義（Java））

CREATIONRULE_JAVA_DEF

ClassName

creation.java.exparameter

2,000

補助定数パラメタ（生成ルール定義（Java））

CREATIONRULE_JAVA_DEF

ExParameter

application.name

64

定義名（作業アプリケーション定義）

APPLICATION_DEF

ApplicationName

application.param

2,000

補助定数パラメタ（作業アプリケーション定義）

APPLICATION_DEF

ApplicationParam

application.description

250

説明（作業アプリケーション定義）

APPLICATION_DEF

Description

application.java.classname

255

Javaクラス名（作業アプリケーション定義（Java））

APPLICATION_JAVA_DEF

ClassName

hierarchy.name

64

階層名

HIERARCHY_DEFNITION

Name

DBCharacterName

UTF-8

バイト長チェック時の文字コード※2

－

－
（凡例）

−：該当しません。

注※1

実際のテーブル名は，先頭に<SYSTEMID>_が付与されます。

注※2

Javaでサポートされているエンコーディングの正準名を指定します。

戻り値

戻り値

内容

0

正常終了

1

致命的なエラー

9

実行権限エラー

49

BPMN解析での警告，およびCSCIWのビジネスプロセス検証での警告

51

パラメーター不正

100

BPMN解析エラー・ビジネスプロセス定義変換時エラー

120

登録済みビジネスプロセスの変更（-updateオプション）に伴うエラー

150

I/Oエラー

200

-srcdirオプションで指定したディレクトリ内のどれかのファイルでエラー発生

240

CSCIWのビジネスプロセス検証でのエラー

254

異常終了

注意事項

ページの先頭へ

All Rights Reserved. Copyright (C) 2007, 2022, Hitachi, Ltd.