要件をインポート

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 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）。