ファイルからインポート

ExcelファイルからALM Octaneにデータをインポートします。

このトピックの内容:

概要

次のデータ型をインポートできます。要件、バックログ項目、不具合、タスク、テスト、およびテストスイート。

要件のインポートの詳細については、Excelからの要件のインポートを参照してください。

Excel (.xlsまたは.xlsx) ファイルで、インポートする項目をリストします。タイプごとに個別のシートを使用して、1回のインポート操作で複数のタイプの項目 (ストーリーや不具合など) をインポートできます。

別のツールからファイルに項目をエクスポートした場合は、以下に説明する仕様に従ってファイルを更新する必要があります。

計算フィールドと特定のシステムフィールドはインポートできません。例: テストツールタイプ、過去の実行、見積もり時間数、コードカバレッジ。

標準設定では、1回のインポートでバックログ項目を1,000件までインポートできます。それ以上ある場合は、別々のファイルにインポートできます。

標準設定を変更するには、サイト管理者がIMPORT_WORK_ITEMS_FUSEパラメーターを設定できます。詳細については、設定パラメーターを参照してください。

トップに戻る

テンプレートファイル

インポートに必要なフォーマットとフィールドを備えたExcelファイルを準備するために、テンプレートファイルをダウンロードできます。設定をクリックして、適切なインポートアクションを選択します。[インポート] ダイアログボックスで、[インポートファイル例の表示] をクリックします。

または、ファイルをインポート、編集、および再インポートするのと同じ項目タイプの項目をエクスポートすることもできます。詳細については、ファイルへのエクスポートを参照してください。

トップに戻る

インポートファイルの準備

ALM Octaneから項目をエクスポートして、変更を加えて同じワークスペースに再インポートしたり、別のワークスペースにインポートしたりできます。詳細については、ファイルへのエクスポートを参照してください。

新しいインポートファイルを準備するには:

1. Excelファイルで、インポートする項目タイプごとに個別のシートを作成します。次のいずれかでシートに名前を付けます。ユーザーストーリー、品質ストーリー、不具合、手動テスト、テストスイート。

2. シートの行1に、値を入力するフィールドの名前を入力します。フィールドラベルではなく、フィールドの論理名を使用する必要があります。システムフィールドとユーザー定義フィールドの両方を一覧表示できます。各項目タイプでサポートされているフィールドと必須フィールドのリストについては、インポートファイルのフィールドを参照してください。

   REST API編集可能フィールドを含めることもできます。システム管理者に情報を問い合わせてください。

トップに戻る

フィールド値

スプレッドシートの別々の行に、インポートする各項目のフィールド値を入力します。

• 可能なフィールド値については、インポートファイルのフィールドを参照してください。
• 必須フィールド。ALM Octaneの各項目タイプには、ワークスペース構成で決定された必須フィールドがあります。項目のすべての必須フィールドに値を入力しない場合、ALM Octaneは項目をドラフトステータスでインポートします。
• メモフィールド。メモフィールドは、インポート時にソースフォーマットを保持しません。

• 複数の値。複数の値をサポートするフィールドでは、値をコンマで区切ります。

  注: コンマを含むフィールド値のインポートはサポートされていません。

• ローカリゼーション。システムリストを使用するフィールドでは、クライアントの言語に応じてローカライズされたリスト値を使用します。

• 日付フィールド。次の日付構文がサポートされています。

  定義	例
  オフセットのある時間	「2015-05-12T10:15:30 + 01:00」
  ゾーンIDとの時間	「2015-05-12T10:15:30Z」
  オフセットとゾーンIDの時間	「2015-05-12T10:15:30 + 01:00 [ヨーロッパ/パリ] 」 「2015-05-12T10:15:30 + 00:00 [Z] 」

• ヒント: user_tagsフィールドを使用して、インポートされた各項目にタグを追加します。これにより、ALM Octaneでインポートされた項目を識別してフィルタリングできます。

トップに戻る

特定の項目タイプのガイドライン

さまざまな項目タイプに関する次のガイドラインに注意してください。

項目タイプ	ガイドライン
バックログ項目	バックログ項目をインポートする場合、ALM Octaneは、エピックフィールドとフィーチャーフィールドの両方を使用して、バックログ項目が作成される場所を決定します。たとえば、エピックの下にあるフィーチャーの下にユーザーストーリーを配置したいが、エピックを指定しない場合、新しいフィーチャーがバックログルートの下に作成されます。
タスク	一般的な [設定] メニューとバックログ項目の [タスク] グリッドの両方からタスクをインポートできます。 設定メニューからインポートする場合、タスクはスプレッドシートで指定したバックログ項目にインポートされます。 タスクグリッドからインポートすると、スプレッドシート内のすべてのタスクが現在のストーリーまたは不具合にインポートされます。
手動テスト	手動テストに続く行で、テストの手順を定義します。テンプレートファイルの例を参照してください。 手動テスト行には、手動テストフィールドにのみ値を含める必要があります。テストステップの行には、テストステップのフィールドにのみ値を含める必要があります。 アプリケーションモジュール: アプリケーションモジュールの名前にスラッシュまたはバックスラッシュが含まれている場合は、インポートファイルでスラッシュを2倍にします。たとえば、アプリケーションモジュールの名前がapp/1の場合、ファイルでapp//1として指定します。 注: スラッシュで開始または終了するアプリケーションモジュールをインポートファイルで指定することはできません。
テストスイート	テストスイートに続く行に、スイートの一部であるテストをリストします。テンプレートファイルの例を参照してください。 手動テストシートのunique_id、またはALM OctaneのIDを使用したテストを参照してください。詳細については、以下の表を参照してください。 テストスイートの行には、テストスイートのフィールドにのみ値を含める必要があります。テスト行には、テストフィールドにのみ値を含める必要があります。

トップに戻る

既存の項目を更新する

ALM Octaneにすでに存在する項目のフィールドを更新できます。既存の項目を識別するには、'@で始まるunique_idカラムにそのALM Octane ID番号を指定します。例: '@ 9100。

変更するフィールドにのみ新しい値を入力します。他のすべてのフィールドは変更されません。

トップに戻る

カスタムルックアップリスト

カスタムルックアップリストを使用するフィールドでは、フィールドの各値で、フィールドが使用するルックアップリストを指定する必要があります。たとえば、ワークスペースの [テストの種類] フィールドは、標準設定のリストとは異なる値を持つカスタムリストを使用するように設定されている場合があります。

カスタムルックアップリストを使用する各セルで、次の構文を使用します:listName/listValue

• listName: カスタムルックアップリストの名前。
• listValue: カスタムルックアップリストの有効な値。

トップに戻る

ファイルのインポート

この手順に従って、ExcelファイルをALM Octaneにインポートします。

ファイルをインポートするには:

1. 設定メニューを展開します。インポートセクションで、タイプを選択します。

2. 参照をクリックして、Excelファイルのあるフォルダーに移動します。

   前回のインポート以降の変更が含まれている場合は、同じファイルを再インポートできます。

3. インポートをクリックします。ALM OctaneはExcelファイルの書式を検証し、同じファイルがすでにインポートされていないかどうかを確認します。

   ALM Octaneが検証を終了すると、次のようになります。

   エラーがある場合	ALM Octaneは、エラーがあるシートと行を検証レポートで表示します。 エラーレポートの下部にある [Excelにエクスポート] リンクをクリックすると、エラーレポートが保存されます。 エラーを修正して、インポートを再試行します。
   重複がある場合	バックログとテスト項目: ALM Octaneは、インポートする項目と同じ名前で同じツリーの場所に項目がある場合に警告します。これは、インポート中にネットワークの問題が発生した場合にも発生する可能性があります。 インポートをキャンセルして、インポートする前にExcelで重複する項目の名前を変更するか、とにかくインポートして、ALM Octaneに同じ名前の2つの項目を作成することができます。
   エラーがない場合	インポートが開始されます。

4. インポートが完了すると、項目は関連するモジュールと場所のALM Octaneに追加されます。

   必須フィールドに値を指定せずにインポートした項目は、ALM Octaneにドラフトとして作成されます。インポート後、ドラフトフィールドに基づいて関連するグリッドをフィルタリングし、すべての必須フィールドに値を入力します。

トップに戻る

参照情報:

• ドキュメントレポート
• スペースのエクスポートとインポート、およびスペースのカスタマイズ