要件をインポート

AI Assisted Requirements Importer（旧バージョン）

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

Importer へのアクセス（旧バージョン）

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）、構造化された要求データをアップロードするために legacy import tool を引き続き使用することを選択できます。また、legacy importer は、管理者によって Requirements & Systems Portal 設定で External Provider オプションが無効になっている場合にのみ使用できます。

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

Specification（旧バージョン）

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

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

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

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

Upload（旧バージョン）

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

Review（旧バージョン）

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 のデフォルトフィールドと同一のヘッダーが含まれている場合、これらのフィールドは自動的にマッピングされます。ただし、必要に応じてこの自動マッピングを上書きまたは調整できます。

Execution Report (Previous Iteration)

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

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