要件をインポート

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

AI Assisted Requirements Importer

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

Importer へのアクセス

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

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

インポートの流れ

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

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

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

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

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

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

Legacy Importer

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

このプロセスでは、主に 3 つのステージ（Specification、Upload、Review）に沿って進みます。仕様のインポートが完了すると、サマリーが表示され、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）に戻ります。