Breadcrumbs

JIRA プロジェクトにテスト ケースをインポートする

[テスト スイート (Test Suites)] ページからテスト ケース (.csv) を JIRA プロジェクトにインポートできます。

テスト ケースのインポート時に留意すべき点 :

  1. 要約はインポートの開始に必須です。

  2. 日付フィールドの処理にあたって適切な日付形式が必要です。

    • Java SimpleDateFormat に従った構文を使用します。

    • 例 : 2030-01-01 12:00 AM として日付時刻の値をインポートする場合、日付形式を yyyy-MM-dd h:mm a に設定します。

  3. ステップを指定する際にステップ ID が必須になります。

  4. 課題キーを指定すると、該当する課題が見つかった場合にこれが更新されます。

  5. テスト ケースと要件の関連付けをインポートする場合は、[要件 (Requirement)] 列で要件 ID を指定します。
    注意 : インポート ファイルで指定した要件 ID がプロジェクトで見つからない場合、テスト ケースは要件の関連付けなしでインポートされます。

  6. テスト スイートの関連付けと共にテスト ケースをインポートする場合は、[テスト スイート (Test Suite)] 列でテスト スイート パスを指定します。
    注意 : インポート ファイルで指定したテスト スイート パスがプロジェクトで見つからない場合は、インポート ファイルから作成されます。

  7. CSV ファイルのインポート ウィザードの最後に、CSV 構成ファイルを作成するオプションが表示されます。構成ファイルには CSV ファイル インポート ウィザードを実行したときに設定した内容が含まれています。これは、実稼働システムでインポートを実行する前にテスト JIRA サーバーに CSV ファイル インポートをテストする必要がある場合に便利です。

.csv ファイルからテスト ケースを JIRA プロジェクトにインポートするには、以下の手順に従います。

  1. [テスト スイート (Test Suites)] ページの [テスト ケースのインポート (Import Test Cases)] タブをクリックします。

  2. [インポート (Import)] ボタンをクリックします。

  3. [ファイルの選択 (Choose Files)] ボタンをクリックし、テスト ケース ファイル (.csv 形式) を参照します。

  4. 必要に応じて "区切り記号" を指定します。

  5. [既存の構成ファイルを使用する (Use an existing configuration file)] を選択すると、構成ファイルを選択するダイアログが表示され、次のページでファイル内のマッピングが自動的に読み込まれます。

  6. [次へ (Next)] ボタンをクリックします。

  7. インポートする CSV フィールドを選択し、これらを JIRA のフィールドにどのように変換したいかを設定します。

    • 注意 : 以前インポートで構成ファイルを作成した場合は、手順 5 でフィールド マッピングが自動的に行われます。

  8. [インポート (Import)] ボタンをクリックします。

注意 :

この手順で使用したものと同じ (または似たような) 設定の別の CSV ファイルをインポートする必要がある場合は、[構成を保存 (save the configuration)] リンクをクリックして CSV 構成ファイルをダウンロードし、CSV ファイル インポート ウィザードの手順 5 で使用できます。

UG0044_Test_Suite_Panel_Import_Test_Case.png

[スクリーンショット - UG0044_Test_Suite_Panel_Import_Test_Case]

JIRA フィールドに CSV データをインポートする際のヒント

CSV ファイルのデータを特定の JIRA システム フィールドおよびユーザーが作成したカスタム フィールドにインポートする際のヒントを以下に示します。

JIRA フィールド

インポートに関する注記

 -

synapseRT インポートは JIRA システム フィールド (要約、優先度など) および JIRA の標準フィールド タイプからのカスタム フィールド (チェックボックス、日付ピッカーなど) のみサポートします。

JIRA の詳細フィールド タイプ (開発の要約、グローバル ランクなど) およびサードパーティ アプリからのフィールド タイプはサポートされません。

要約 (Summary)

これが唯一の必須フィールドです。

課題キー (Issue Key)

インポートされた課題の課題キーを設定できます。指定したキーを持つ課題が JIRA に既に存在する場合、その課題は更新されます。

コンポーネント (Component(s))

各コンポーネントを別個の列に入力することで、複数のコンポーネントを持つ課題をインポートできます。

影響バージョン (Affects Version(s))

各バージョンを別個の列に入力することで、複数の '影響バージョン' を持つ課題をインポートできます。

修正バージョン (Fix Version(s))

各バージョンを別個の列に入力することで、複数の '修正バージョン' を持つ課題をインポートできます。

期限 (Due Date)

  • Java SimpleDateFormat に従った構文を使用します。

  • 例 : 2030-01-01 12:00 AM として日付時刻の値をインポートする場合、日付形式を yyyy-MM-dd h:mm a に設定します。

ラベル (Labels)

各コンポーネントを別個の列に入力することで、複数のラベルを持つ課題をインポートできます。

エピック リンク (Epic Link)

課題を JIRA の既存のエピックにリンクする場合は、エピック課題キーを入力します。

カスタム フィールド タイプ :

  • 日付ピッカー

  • 日付時刻ピッカー

  • Java SimpleDateFormat に従った構文を使用します。

  • 例 : 2030-01-01 12:00 AM として日付時刻の値をインポートする場合、日付形式を yyyy-MM-dd h:mm a に設定します。

カスタム フィールド タイプ :

  • チェックボックス

  • ラベル

  • 選択リスト (複数選択)

  • 各値を別個の列に入力することで、複数の値を持つ課題をインポートできます。

  • 'チェックボックス' および '選択リスト' (複数選択) フィールドの値は JIRA サーバーであらかじめ定義されている必要があります。

  • 'ラベル' フィールドの値は JIRA サーバーであらかじめ定義されている必要はありません。値はインポート処理時に作成されます。

例 :

Summary, Checkbox, Checkbox, Checkbox, Label, Label "First issue", value1, , , Label1, "Second issue", value2, , , Label1, Label2 "Third issue", value1, value2, value3, Label1,

カスタム フィールド タイプ :

  • 数値フィールド

  • テキスト フィールド (複数行)

  • テキスト フィールド (単一行)

  • URL フィールド

  • これらのフィールドの値は JIRA サーバーであらかじめ定義されている必要はありません。

  • 値はインポート処理時に作成されます。

カスタム フィールド タイプ :

  • 選択リスト (カスケード)

  • '->' 区切り文字を使用して階層をインポートできます。

  • このフィールドの値は JIRA サーバーであらかじめ定義されている必要があります。

例 :

Summary, Cascading Custom Field Example Summary, Parent Value -> Child Value

カスタム フィールド タイプ :

  • ユーザー ピッカー (単一ユーザー)

  • インポートを正常に行うには、csv ファイルで JIRA の 'ユーザー名' が指定されている必要があります。

  • csv ファイルで指定したユーザー (ユーザー名) は JIRA サーバーであらかじめ定義されている必要があります。

ダウンロード可能なサンプル