SystemStepSample
このスタンドアロンのサンプルは、ワークフローを作成し、プロパティーを設定し、システム・ステップを追加し、ワークフローを開始する方法を示します。
以下の例のようなコマンドを入力して、サンプルを実行します。
java SystemStepSample username password server_name:port_number/connectionPoint_name
queue_name output_filename
詳細については、サンプル・ソースのコメントを参照してください。サンプルは、IBM® FileNet® P8 Platform 資料ライブラリーの『Developer samples』セクションにあります。
「API サンプルの実行」も参照してください。
メソッド
SystemStepSample メソッドの一般的な説明を以下に示します。
main()
main メソッドは、一般的な技法を使用して、引数の値を検証し、そのデフォルト値を設定します。ログ出力ファイルのデフォルト値は SystemStepSample.out であり、キュー名のシステム・リスト内の最初のキュー名です。Main() は、VWSession および サンプルの Logger クラス オブジェクトを作成し、コンストラクターに渡します。main() は、セッションのログインとログオフを、サンプルの SessionHelper クラスの login() メソッドおよび logoff() メソッドで処理します。 また、サンプルの Logger クラスのインスタンスにより、ワークフローのログ機能を提供します。
SystemStepSample()
SystemStepSample コンストラクターは、新しい VWWorkflowDefinition オブジェクトを作成し、VWWorkflowDefinition.setSubject、VWWorkflowDefinition.setDescription、および VWWorkflowDefinition.setName を使用して新しいプロパティーを割り当てます。 VWWorkflowDefinition.createFieldUsingString を使用して、ワークフロー定義フィールドが追加されます。VWWorkflowDefinition.getMainMap が VWMapDefinition オブジェクトを取得し、VWMapDefinition.getStartStep が新しい起動ステップの VWMapNode オブジェクトを返します。次に、新しい複合ステップがサンプルの SystemStepHelper.addCompoundStep を使用して追加されます。SystemStepHelper.addCompoundStep によって返された VWCompoundStepDefinition を使用して、割り当て命令 (VWCompoundStepDefinition.createAssignInstruction) とタイマー命令 (VWCompoundStepDefinition.createBeginTimerInstruction) を追加します。VWMapNode.createRoute (引数として VWMapNode.getStepId を指定) を使用して、先行する起動ステップから新しいステップへのルートを作成します。次に、サンプルの SystemStepHelper.addStep を使用して、新しいステップをさらに追加します (VWMapNode.createRoute が、ステップからステップへの新しいルートを作成)。次に、SystemStepHelper.addCompoundStep は、タイマーを終了するための別の複合ステップを追加し (VWCompoundStepDefinition.createEndTimerInstruction を使用)、新しいステップが VWMapNode.createRoute を使用して再びリンクされます。次に、サンプルの SystemStepHelper.validate が新しいワークフロー定義を検証します。次に、ワークフロー定義 (SystemStepSample.pep) をファイルに書き込み ( VWWorkflowDefinition.writeToFile を使用)、転送し (VWSession.transfer を使用)、返された VWTransferResult オブジェクトを、 VWTransferResult.getVersion とサンプルの Logger.log を使用してログに記録します。次に、ワークフローを開始し (VWSession.createWorkflow を使用)、返された VWStepElement を使用して起動ステップ (VWStepElement.setComment) のコメントを設定し、ステップを完了します (VWStepElement.doDispatch)。