cscpiselect(プロセスインスタンスの検索)
形式
cscpiselect [-h]
-user <ログインユーザID>
-pass <ログインパスワード>
-csc <HCSCサーバ名>
-table
{process|activity|link|set|string|numeric|boolean
|message|relation|process_set}
[-detail]
[-separator {comma|tab}]
[{-count|-orderby <ソート条件>}]
[{-where <where句>
|-wherefile <where句が記載されたファイル名>
|[-processname <ビジネスプロセス定義名>]
[-date [<照会開始日時>],<照会終了日時>]
[-status {executing|completed|faulted|error|all}]}]
[-encoding <エンコーディング名>]
機能
セットアップ後のHCSCサーバに対して,指定された条件に従ってビジネスプロセス情報を検索し,CSVまたはTSV形式で出力します。
ログインユーザIDなどの必須オプションは,HCSC-Managerコマンド共通定義ファイルにデフォルト値を設定することで,このコマンドでの指定を省略できます。
引数
-h
コマンドの使用方法が表示されます。このオプションを指定している場合は,ほかのオプションを指定しても無視されます。
-user <ログインユーザID> ~<半角英数字およびアンダーライン(_)> ((1-16文字))
HCSC-Managerログイン時に使用するユーザIDを指定します。
-pass <ログインパスワード> ~<半角英数字およびアンダーライン(_)> ((1-16文字))
HCSC-Managerログイン時に使用するパスワードを指定します。
-csc <HCSCサーバ名> ~<半角英数字およびアンダーライン(_)> ((1-8文字))
SQLを実行するHCSCサーバ名を指定します。
-table {process|activity|link|set|string|numeric|boolean|message|relation|process_set}
検索するテーブルを指定します。
このオプションにprocess_setを指定した場合,内部でプロセス概要情報と相関セット情報を連結して検索します。そのため,検索条件にプロセス情報のカラムを指定する場合は,where句に「P」を,相関セット情報のカラムを指定する場合は,「C」を付けてください。このオプションにprocess_set以外を指定した場合は,where句にテーブル名の指定は不要です。where句に記載できる内容については,使用しているデータベースのSQLリファレンスマニュアルを参照してください。
誤った例:テーブル名を指定している
P.Status='Completed'
正しい例:テーブル名を指定していない
Status='Completed'
誤った例:コメント行を追加している
Status='Completed' AND
# ProcessDefinitionName like 'BP%'
正しい例::コメント行を追加していない
Status='Completed' AND
ProcessDefinitionName like 'BP%'
誤った例:テーブル名を指定していない
State='Completed'
正しい例1:テーブル名を指定している
P.State='Completed'
正しい例2:テーブル名を指定している
P.State='Completed' AND
C.ProcessDefinitionName like 'BP%'
-detail
テーブルの全情報を出力する場合に指定します。
-separator {comma|tab} ~<<comma>>
情報を区切るセパレータを指定します。
-count
検索結果の行数だけが出力されます。このオプションは,検索結果のデータが大量にある場合に,検索件数だけを知るときに使用します(SQL文のcount(*)に相当します)。
-orderby <ソート条件> ~ ((1文字以上))
データをソートする条件を指定します。SQL文のorder by句に相当します。-countオプションと同時には指定できません。order by句に記載できる内容については,使用しているデータベースのSQLリファレンスマニュアルを参照してください。-orderbyオプションを指定しない場合は,order by句の指定がないと仮定されます。
-where <where句> ~ ((1文字以上))
where句を指定します。where句に記載できる内容については,使用しているデータベースのSQLリファレンスマニュアルを参照してください。
-wherefile <where句が記載されたファイル名> ~ ((1-200バイト))
where句が記載されたファイル名を絶対パス,または相対パスで指定します。指定されたファイルの内容に改行コードをスペースに置き換えて,SQLが実行されます。記載できる内容については,使用しているデータベースのSQLリファレンスマニュアルを参照してください。
-processname <ビジネスプロセス定義名> ~((1文字以上))
ビジネスプロセス定義名で検索する場合に指定します。-tableオプションでrelationまたはprocess_set以外を指定した場合だけ指定できます。
-date [<照会開始日時>],<照会終了日時> ~<半角数字>
プロセスインスタンスの開始日時で検索する場合に指定します。指定した照会開始日時から照会終了日時までの間に開始したプロセスインスタンスを検索します。-tableオプションでprocessまたはactivityを指定した場合だけ指定できます。照会開始日時を省略した場合,照会終了日時より前に開始したプロセスインスタンスから検索します。照会開始日時と照会終了日時の間のコンマ(,)の前後に余分なスペースを指定しないでください。なお,指定できる日時の形式は次の形式です。また,日時の指定にはデフォルトタイムゾーンを使用してください。
-status {executing|completed|faulted|error|all} ~<<all>>
プロセスインスタンスの状態で検索する場合に指定します。-tableオプションでprocessまたはactivityを指定した場合だけ指定できます。
-encoding <エンコーディング名> ~<<JavaVMのデフォルトエンコーディング>> ((1文字以上))
-wherefileオプションで指定した入力ファイルのエンコーディング名を指定します。次のエンコーディング名を指定できます。
入力例
cscpiselect -user admin -pass admin -csc HCSC -table process
cscpiselect -user admin -pass admin -wherefile sql_where.txt -csc HCSC -table process_set
sql_where.txtの内容
C.CorrelationSetName = 'rentalNumber' AND C.CorrelationSetValue = '100'
cscpiselect -user admin -pass admin -count -wherefile sql_where.txt -csc HCSC -table activity
sql_where.txtの内容
ProcessDefinitionName like 'BP%'
cscpiselect -user admin -pass admin -csc HCSC -table link
cscpiselect -user admin -pass admin -csc HCSC -table set
cscpiselect -user admin -pass admin -wherefile sql_where.txt -csc HCSC -table string
sql_where.txtの内容
ProcessID = '11111'
cscpiselect -user admin -pass admin -wherefile sql_where.txt -csc HCSC -table numeric
sql_where.txtの内容
ProcessID = '11111' AND ProcessDefinitionName like 'BP%'
cscpiselect -user admin -pass admin -where "ProcessID = '11111' AND VariableValue = 0" -csc HCSC -table boolean
cscpiselect -user admin -pass admin -wherefile sql_where.txt -orderby "ProcessID DESC"-csc HCSC -table message
sql_where.txtの内容
ProcessID = '11111' AND VariableName like '%ABC%'
表示形式
ProcessID,ProcessDefinitionName,ProcessDefinitionVersion,State,StartTime,EndTime |
ProcessID,ProcessDefinitionName,ProcessDefinitionVersion,State,StartTime,EndTime,ChangeCount |
説明
表示項目 | 内容 | 説明 | 備考 |
---|---|---|---|
ProcessID | PI識別子 | プロセスインスタンスの識別子を示します。 | CSCBP_<クラスタ名>_PROCESSテーブルの1レコードの情報を示します。情報の詳細については,マニュアル「Cosminexus サービスプラットフォーム システム構築・運用ガイド」の「付録C データベースのテーブルの情報」を参照してください。 |
ProcessDefinitionName | ビジネスプロセス定義名 | ビジネスプロセス定義名を示します。 | |
ProcessDefinitionVersion | ビジネスプロセス定義バージョン | ビジネスプロセス定義バージョンを示します。 | |
State | PI状態 | プロセスインスタンスの状態を示します。 | |
StartTime | PI開始時刻 | プロセスインスタンスの開始時刻(GMT)を示します。 java.text.SimpleDateFormatで定義されているフォーマットに,YYYY/MM/DD hh:mm:ssの形式で出力されます。
| |
EndTime | PI終了時刻 | プロセスインスタンスの終了時刻(GMT)を示します。 ava.text.SimpleDateFormatで定義されているフォーマットに,YYYY/MM/DD hh:mm:ssの形式で出力されます。
| |
ChangeCount | 更新回数 | データの更新回数を示します。 |
ProcessID,ActivityNumber,ActivityDefinitionName,ActivityKind,State,StartTime,EndTime,WaitTime |
ProcessID,ActivityNumber,ProcessDefinitionName, |
説明
表示項目 | 内容 | 説明 | 備考 |
---|---|---|---|
ProcessID | PI識別子 | プロセスインスタンスの識別子を示します。 | CSCBP_<クラスタ名>_ACTIVITYテーブルの1レコードの情報を示します。情報の詳細については,マニュアル「Cosminexus サービスプラットフォーム システム構築・運用ガイド」の「付録C データベースのテーブルの情報」を参照してください。 |
ActivityNumber | ACI識別子 | アクティビティインスタンスの識別番号を示します。 プロセスインスタンス内で一意の値です。 | |
ProcessDefinitionName | ビジネスプロセス定義名 | ビジネスプロセス定義名を示します。 | |
ProcessDefinitionVersion | ビジネスプロセス定義バージョン | ビジネスプロセス定義バージョンを示します。 | |
ActivityDefinitionName | AC定義名 | アクティビティ定義名を示します。 | |
ActivityKind | AC種別 | アクティビティ種別を示します。 | |
ParentNumber | 親ACI識別番号 | 親アクティビティインスタンスの識別番号を示します。 | |
ScopeNumber | 所属SCI識別番号 | 所属するスコープインスタンスの識別番号を示します。 | |
RepeatNumber | 所属RP識別番号 | 所属する繰り返し処理の識別番号を示します。 | |
State | ACI状態 | アクティビティインスタンスの状態を示します。 | |
FirstChildNumber | 先頭の子ACI識別番号 | 先頭の子アクティビティインスタンスの識別番号を示します。 | |
LastChildNumber | 最後の子ACI識別番号 | 最後の子アクティビティインスタンスの識別番号を示します。 | |
StartTime※ | AC開始時刻 | アクティビティの開始時刻(GMT)を示します。java.text.SimpleDateFormatで定義されているフォーマットに,YYYY/MM/DD hh:mm:ssの形式で出力されます。
| |
EndTime※ | AC終了時刻 | アクティビティの終了時刻(GMT)を示します。java.text.SimpleDateFormatで定義されているフォーマットに,YYYY/MM/DD hh:mm:ssの形式で出力されます。
| |
WaitTime※ | AC待機解除時刻 | アクティビティの待機解除時刻(GMT)を示します。java.text.SimpleDateFormatで定義されているフォーマットに,YYYY/MM/DD hh:mm:ssの形式で出力されます。
|
注※ プロセスインスタンスの履歴情報に値が存在しない場合は,何も表示されません。
ProcessID,LinkDefinitionName,State |
ProcessID,ProcessDefinitionName,ProcessDefinitionVersion, |
説明
表示項目 | 内容 | 説明 | 備考 |
---|---|---|---|
ProcessID | PI識別子 | プロセスインスタンスの識別子を示します。 | CSCBP_<クラスタ名>_LINKテーブルの1レコードの情報を示します。情報の詳細については,マニュアル「Cosminexus サービスプラットフォーム システム構築・運用ガイド」の「付録C データベースのテーブルの情報」を参照してください。 |
ProcessDefinitionName | ビジネスプロセス定義名 | ビジネスプロセス定義名を示します。 | |
ProcessDefinitionVersion | ビジネスプロセス定義バージョン | ビジネスプロセス定義バージョンを示します。 | |
LinkDefinitionName | リンク定義名 | リンク定義名を示します。 | |
RepeatNumber | 所属RP識別番号 | 所属する繰り返し処理の識別番号を示します。 | |
State | リンク状態 | リンクの状態(真偽値)を示します。 |
ProcessID,CorrelationSetName,CorrelationSetValue |
ProcessID,ProcessDefinitionName,ProcessDefinitionVersion,ScopeDefinitionName, |
説明
表示項目 | 内容 | 説明 | 備考 |
---|---|---|---|
ProcessID | PI識別子 | プロセスインスタンスの識別子を示します。 | CSCBP_<クラスタ名>_CORRELATIONSETテーブルの1レコードの情報を示します。情報の詳細については,マニュアル「Cosminexus サービスプラットフォーム システム構築・運用ガイド」の「付録C データベースのテーブルの情報」を参照してください。 |
ProcessDefinitionName | ビジネスプロセス定義名 | ビジネスプロセス定義名を示します。 | |
ProcessDefinitionVersion | ビジネスプロセス定義バージョン | ビジネスプロセス定義バージョンを示します。 | |
ScopeDefinitionName | SC定義名 | スコープ定義名を示します。 | |
ScopeNumber | SCI識別番号 | スコープインスタンスの識別番号を示します。 | |
CorrelationSetName | 相関セット定義名 | 相関セット定義名を示します。 | |
CorrelationSetValue | 相関セット値 | 相関セット値を示します。文字列化および連結され格納されます。 | |
State | 相関セット有効性 | 相関セットの有効性(真偽値)を示します。 |
ProcessID,VariableName,VariableValue |
ProcessID,ProcessDefinitionName,ProcessDefinitionVersion, |
説明
表示項目 | 内容 | 説明 | 備考 |
---|---|---|---|
ProcessID | PI識別子 | プロセスインスタンスの識別子を示します。 | CSCBP_<クラスタ名>_STR_VARIABLEテーブルの1レコードの情報を示します。情報の詳細については,マニュアル「Cosminexus サービスプラットフォーム システム構築・運用ガイド」の「付録C データベースのテーブルの情報」を参照してください。 |
ProcessDefinitionName | ビジネスプロセス定義名 | ビジネスプロセス定義名を示します。 | |
ProcessDefinitionVersion | ビジネスプロセス定義バージョン | ビジネスプロセス定義バージョンを示します。 | |
ScopeDefinitionName | SC定義名 | スコープ定義名を示します。 | |
ScopeNumber | SCI識別番号 | スコープインスタンスの識別番号を示します。 | |
VariableName | 変数定義名 | 変数定義名を示します。 | |
VariableValue | 変数値 | 変数値を示します。 |
ProcessID,VariableName,VariableValue |
ProcessID,ProcessDefinitionName,ProcessDefinitionVersion, |
説明
表示項目 | 内容 | 説明 | 備考 |
---|---|---|---|
ProcessID | PI識別子 | プロセスインスタンスの識別子を示します。 | CSCBP_<クラスタ名>_NUM_VARIABLEテーブルの1レコードの情報を示します。情報の詳細については,マニュアル「Cosminexus サービスプラットフォーム システム構築・運用ガイド」の「付録C データベースのテーブルの情報」を参照してください。 |
ProcessDefinitionName | ビジネスプロセス定義名 | ビジネスプロセス定義名を示します。 | |
ProcessDefinitionVersion | ビジネスプロセス定義バージョン | ビジネスプロセス定義バージョンを示します。 | |
ScopeDefinitionName | SC定義名 | スコープ定義名を示します。 | |
ScopeNumber | SCI識別番号 | スコープインスタンスの識別番号を示します。 | |
VariableName | 変数定義名 | 変数定義名を示します。 | |
VariableValue | 変数値 | 変数値を示します。 |
(7)boolean変数情報(boolean指定時)
ProcessID,VariableName,VariableValue |
ProcessID,ProcessDefinitionName,ProcessDefinitionVersion, |
説明
表示項目 | 内容 | 説明 | 備考 |
---|---|---|---|
ProcessID | PI識別子 | プロセスインスタンスの識別子を示します。 | CSCBP_<クラスタ名>_BOOL_VARIABLEテーブルの1レコードの情報を示します。情報の詳細については,マニュアル「Cosminexus サービスプラットフォーム システム構築・運用ガイド」の「付録C データベースのテーブルの情報」を参照してください。 |
ProcessDefinitionName | ビジネスプロセス定義名 | ビジネスプロセス定義名を示します。 | |
ProcessDefinitionVersion | ビジネスプロセス定義バージョン | ビジネスプロセス定義バージョンを示します。 | |
ScopeDefinitionName | SC定義名 | スコープ定義名を示します。 | |
ScopeNumber | SCI識別番号 | スコープインスタンスの識別番号を示します。 | |
VariableName | 変数定義名 | 変数定義名を示します。 | |
VariableValue | 変数値 | 変数値を示します。 |
ProcessID,VariableName, |
ProcessID,ProcessDefinitionName,ProcessDefinitionVersion, |
説明
表示項目 | 内容 | 説明 | 備考 |
---|---|---|---|
ProcessID | PI識別子 | プロセスインスタンスの識別子を示します。 | CSCBP_<クラスタ名>_MSG_VARIABLEテーブルの1レコードの情報を示します。情報の詳細については,マニュアル「Cosminexus サービスプラットフォーム システム構築・運用ガイド」の「付録C データベースのテーブルの情報」を参照してください。 |
ProcessDefinitionName | ビジネスプロセス定義名 | ビジネスプロセス定義名を示します。 | |
ProcessDefinitionVersion | ビジネスプロセス定義バージョン | ビジネスプロセス定義バージョンを示します。 | |
ScopeDefinitionName | SC定義名 | スコープ定義名を示します。 | |
ScopeNumber | SCI識別番号 | スコープインスタンスの識別番号を示します。 | |
VariableName | 変数定義名 | 変数定義名を示します。 | |
VariableValue | 変数値 | 変数値を示します。 |
MessageID,ProcessID,ActivityNumber,SendOrReceive |
MessageID,ProcessID,ActivityNumber,SendOrReceive,AsynchronousMessagingID |
説明
表示項目 | 内容 | 説明 | 備考 |
---|---|---|---|
MessageID | MSG識別子 | メッセージの識別子を示します。 | CSCBP_<クラスタ名>_MSG_RELATIONテーブルの1レコードの情報を示します。情報の詳細については,マニュアル「Cosminexus サービスプラットフォーム システム構築・運用ガイド」の「付録C データベースのテーブルの情報」を参照してください。 |
ProcessID | PI識別子 | プロセスインスタンスの識別子を示します。 | |
ActivityNumber | ACI識別番号 | アクティビティインスタンスの識別番号を示します。 | |
SendOrReceive | 送受信フラグ | メッセージの送受信フラグを示します。 | |
AsynchronousMessagingID | ID | 非同期メッセージングのIDを示します。 |
KEOS52029-I: row count is 行のカウント数 |
戻り値
戻り値 | 意味 |
---|---|
0 | 正常終了しました。 |
1 | コマンドが異常終了しました。 |
2 | 通信タイムアウトが発生しました。 |
3 | 排他エラーが発生しました。 |
9 | 実行権限のチェックエラーが発生しました。 |
注意事項