要件をインポート

Requirements Module で利用可能な Import Wizard を使用すると、既存の要件データを Requirements Portal にすばやく簡単にアップロードできます。

AI Assisted Requirements Importer

要件エンジニアリングは、多くの場合、PDF や Excel スプレッドシートのような、データ構造が十分に整っていない文書でステークホルダー要件を作成することから始まります。こうした非構造化文書から要件データを手作業で抽出するのは、手間がかかるうえにミスも発生しやすくなります。Requirements Portal で要件を取り込むプロセスを迅速化するために、AI 機能を活用して、非構造化の PDF、Excel、Word、CSV ファイルから要件をインポートできます。

インポーターへのアクセス

AI Assisted Importer は、管理者が External Provider ページの Settings – ValiAssistant オプションを使用して有効または無効にできます（左下の アイコンをクリックし、表示されるメニューから Settings を選択して、左側ペインのリストから ValiAssistant を選択してアクセスします）。

有効になっている場合、AI Assisted Importer は Requirements Module（）からアクセスできます。ページ左上の ボタンをクリックし、表示されるメニューから Create Requirement を選択してください。あるいは、現在表示中の仕様に要件がない場合は、ページ上の Import ボタンをクリックしてインポーターにアクセスできます。

インポートフロー

インポーターにアクセスすると、Document Import ウィンドウが表示されます。AI Assisted Importer を続行するには、 ボタンをクリックします。

次の段階では、サポートされている種類のファイル（*.pdf、*.docx、*.xlsx、または .*csv）をアップロードできます。これを行うには、ファイルをウィンドウ内の該当領域にドラッグ＆ドロップするか、select from your computer コントロールをクリックしてハードドライブからファイルを参照・選択します。

ファイルのアップロードが正常に完了すると、そのエントリがウィンドウに表示されます。 アイコンをクリックすると、ウィンドウから削除できます。あるいは、別のファイルをウィンドウにドラッグ＆ドロップして既存のファイルを置き換えることもできます。

ボタンをクリックして先に進みます。インポーターがアップロードされたファイルを処理します。処理が完了すると、抽出されたデータが候補要件の表として表示されます。インポートしたい要件は、対応する行の左側にあるチェックボックスを有効にして選択できます。

ボタンをクリックして先に進みます。インポートが完了すると、確認ウィンドウが表示されます。

ボタンをクリックするとインポーターのファイルアップロード段階に戻り、 をクリックするとインポーターを終了します。

Legacy Importer

インポーターにアクセスする際（learn more）、構造化された要件データをアップロードするために、従来のインポートツールを続けて使用することもできます。また、従来のインポーターは、管理者によって Requirements & System Portal の設定で External Provider オプションが無効になっている場合にのみ利用できます。

このプロセスでは、Specification、Upload、Review の 3 つの主要な段階に沿って進みます。仕様のインポートが完了すると、概要が表示されるとともに、検証や他のファイルのインポートなどの追加操作を実行できます。これらの段階と操作については、以下のセクションで説明します。

仕様

Import Wizard のこの段階では、インポート先の仕様を定義できます。

• Import Requirements ウィンドウ左側の Select a specification 領域を使用して、既存の仕様と、必要に応じてそのセクションを選択します。

• Import Requirements ウィンドウ右側の Create a specification 領域を使用して、インポートウィザードを終了せずに新しい仕様を作成し（さらに略称と割り当て先ブロックも定義し）ます。

希望する方法を使用するには、必要な領域をクリックします。

アップロード

Import Wizard のこの段階では、サポートされている種類のファイルをアップロードできます。これを行うには、ファイルを Import Requirements ウィンドウ右側にドラッグ＆ドロップするか、Drop file コントロールをクリックしてハードドライブからファイルを参照・選択します。ファイルのアップロードが正常に完了すると、ウィンドウに通知が表示されます。

レビュー

Import Wizard のこの段階では、アップロードしたファイルからインポートされたデータの結果を確認し、ファイルオプションを設定し、ファイル内のデータを要件フィールドにマッピングできます。

Import Requirements ウィンドウの Destination 領域には、データがどこにインポートされるか（仕様またはセクションの観点で）が視覚的に示されます。

File options 領域では、次のオプションを利用できます。

• Update requirements – 有効にすると、インポート先仕様内の既存の要件はデータの置換によって上書きされます（ファイル内のデータが仕様内のデータを置き換えます）。

  • このオプションが無効で、インポート先として選択した仕様内にすでに存在する Identifier を持つ要件をインポートする場合、Requirements Portal はインポートされた要件の Identifier に _import のサフィックスを追加して区別します。

  • このオプションが無効で、現在のプロジェクト内にはすでに存在するが、インポート先として選択した仕様内には存在しない Identifier を持つ要件をインポートする場合、Requirements Portal はその Identifier に警告アイコンを追加し、同一プロジェクト内に重複 Identifier があることを知らせます。

  • このオプションが有効な場合、インポートするファイル内の空白値もサポートされます。つまり、ファイル内の値が空白であれば、その値は要件から削除されます。これは、Tags のような複数選択フィールドにも適用されます。

• Use header row – アップロードしたファイルのヘッダー行を使用するか、Requirements Portal が提供する一般的な参照用ヘッダー行（つまり列ヘッダーを A、B、C などとするもの）を使用するかを選択できます。

  Requirements Portal では、アップロードされたファイルの先頭行をヘッダー行として扱います。

• Sheet – 複数のシートを含むファイルの場合、どのシートからインポートするかを選択できます。

• Starting row – インポートしたファイルのどの行からデータ収集を開始し、Requirements Portal に挿入するかを選択できます。

Import Requirements ウィンドウ下部の表では、アップロードしたファイルのプレビューを確認し、その列を Requirements Portal のフィールドにマッピングできます。これにより、各列について Map To ドロップダウンで適切なフィールドを選択することで、ファイル内のデータを Requirements Portal の特定のフィールドにどのように対応付けるかを定義できます。ファイルに Requirements Portal のデフォルトフィールドと同一のヘッダーが含まれている場合、これらのフィールドは自動的にマッピングされます。ただし、必要に応じてこの自動マッピングを上書きまたは調整できます。

実行レポート

インポート処理が完了し、正常に完了した場合は、成功メッセージと実施された変更内容が表示されます。インポートに失敗した場合は、失敗メッセージが表示されます。成功したインポートの例を以下に示します。

インポーターの成功・失敗にかかわらず、Import new file（成功時）または Try again（失敗時）をクリックすると、ステージ 1 に戻って再インポートまたは新しいインポートを実行できます（Specification）。