要件のインポート

既存の要件データは、Requirements Module で利用可能な Import Wizard を使用して、Requirements Portal に素早く簡単にアップロードできます。

AI Assisted Requirements Importer

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

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

AI Assisted Importer は、管理者が Settings – ValiAssistant ページの External Provider オプションで有効／無効を切り替えられます（右上の  アイコンをクリックし、表示されるメニューから Settings を選択し、左側ペインの一覧から ValiAssistant を選択してアクセスします）。

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

インポートの流れ

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

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

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

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

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

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

Legacy Importer

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

このプロセスでは、Specification、Upload、Review の 3 つの主要ステージに沿って案内されます。仕様のインポートが完了すると、サマリーが表示され、Valifying の実行や他ファイルのインポートなどの追加アクションも行えます。これらのステージとアクションは以下のセクションで説明します。

Specification

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

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

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

希望する方法に応じて、必要な領域をクリックします。

Upload

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

Review

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）に戻ります。