XMLを使用してのワークフロー作成

Jira のワークフロー エディタは、Jira のデータベースに格納されている OSWorkflow XML 定義を生成します。Jira のワークフロー エディタで利用できない OSWorkflow ベースの機能が必要な場合、ワークフローを XML で定義し、次のように Jira にインポートできます。

XML ワークフローがインポートされると、Jira のワークフロー エディタは、作成や編集できない OSWorklow を含む、ほとんどの OSWorkflow 定義を表示できるようになります。

たとえば、ワークフロー トランジションの表示ページのその他タブにワークフロートランジションの条件結果が表示されます。

その他タブは、エディターで直接サポートされていない要素がトランジションに含まれている場合にのみ表示されます。

Jira への XML ワークフローのインポート

1. 「Jira システム管理者」 グローバル権限を持つユーザーとしてログインします。
2. [管理] ( ) > [課題] を選択します。[ワークフロー] を選択し、システム内のすべてのワークフローを表示する [ワークフロー] ページを開きます。
3. XML からインポートボタンをクリックしてワークフローのインポート ダイアログボックスを開きます。
4. 名前フィールドで、新しいワークフローの名前を入力して (通常、2 ～ 3 語) 新しいワークフローを識別します。
5. (オプション) 説明フィールドで、新しいワークフローの詳細な説明を入力します。
6. ワークフローの定義オプションでは、次のいずれかを実行できます。
   
   • XML ワークフロー定義ファイルのアップロード — これを実行するには、XML ファイルへの完全なパスを入力するオプションを選択して、ファイルパスフィールドで XML ワークフロー定義ファイルへの完全パスを入力します。
     このパスはローカル側のパスでなければなりません。したがって、XML ワークフロー定義ファイルはユーザーの JIRA サーバーに配置されている必要があります。
   • XML ワークフロー定義ファイルの内容を Jira に貼り付ける — これを実行するには、[ワークフローの XML 定義を貼り付るけ] オプションを選択し、XML ワークフロー定義ファイルの内容をコピーして、[ワークフロー定義 (XML)] フィールドにペーストします。
7. インポートボタンをクリックします。

システム間のワークフローをコピーする

場合によっては、テストシステムにワークフローを作成して本番環境システムにそれをコピーすると便利です。これを実行するには次の手順に従います。

1. テストシステムで、ワークフローの表示ページに表示されるリストで、ワークフローの横にあるXML リンクをクリックしてワークフローを XML にエクスポートし、出力をファイルに保存します。
2. 本番環境で、上記のように「XML からワークフローをインポートする」リンクからファイルをインポートします。

Jira にXML ワークフローをインポートする場合、次の点に留意します。

• Jira の XML ワークフロー定義には Jira のメタ属性への参照が含まれます。例えば、各ワークフロー ステップのリンク済み Jira ステータスの ID は "jira.status.id" メタ属性としてステップ定義に保存されます。そのため、XML でワークフローを手動で作成する場合、ワークフローを Jira にインポートする前に、参照されるすべての外部エンティティが存在することを確認してください。

システム間でワークフローをコピーする場合:

• 条件、バリデータ、事後操作は、あるシステムでは有効だが他のシステムでは無効かもしれないパラメータを持つことができます。例えば、別のシステムが「解決状況」フィールドに異なる値を含んでいるとします。「課題フィールドの更新」事後操作が、「解決状況」フィールドに、あるシステムにはあるが他のシステムにはないかもしれない値を設定するのに使用される場合に問題になります。