要件をインポート

AI Assisted Requirements Importer（Previous Iteration）

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

Importer へのアクセス（Previous Iteration）

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

インポートフロー（Previous Iteration）

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

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

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

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

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

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

Legacy Importer（Previous Iteration）

Importer にアクセスする際（learn more）、構造化された要件データをアップロードするために legacy import tool を使用して続行することを選択できます。また、legacy importer は、管理者によって Requirements & Systems Portal の設定で External Provider オプションが無効にされている場合にのみ利用できます。

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

Specification（Previous Iteration）

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

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

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

使用したい方法に応じて、該当する領域をクリックしてください。

Upload（Previous Iteration）

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

Review（Previous Iteration）

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

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

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

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

  • このオプションが無効で、インポートする要求の Identifier が宛先として選択した仕様内にすでに存在する場合、Requirements & Systems Portal は、区別するためにインポートされた要求の Identifier に接尾辞 _import を追加します。

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

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

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

  Requirements & Systems Portal では、アップロードされたファイルの最初の行をヘッダー行と見なします。

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

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

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

実行レポート（前回のイテレーション）

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

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