要件をインポートする
Requirements Module で利用できる Import Wizard を使用すると、既存の要件データを Requirements Portal にすばやく簡単にアップロードできます。AI を活用した抽出機能により、構造化されていない PDF、Word、Excel、CSV ファイルから要件をインポートできるため、要件データを手作業で転記するための時間と労力を削減し、より正確かつ効率的に要件を取り込むことができます。
Importer へのアクセス
Importer は、Requirements Module（
）で、ページ左上の 
ボタンをクリックし、表示されるメニューから Create Requirement を選択することでアクセスできます。あるいは、現在表示している仕様に要件が存在しない場合は、ページ上の Import ボタンをクリックして Importer にアクセスできます。
ファイルのアップロード
Import Requirements ウィンドウが開きます。この段階では、サポートされている形式（*.pdf、*.docx、*.xlsx、または *.csv）のファイルをアップロードできます。アップロードするには、ウィンドウ内の該当領域にファイルをドラッグ＆ドロップするか、select from your computer コントロールをクリックしてハードドライブからファイルを参照して選択します。
*.pdf および *.docx 形式のファイルは、デフォルトで有効になっている AI importer でのみインポートできます。必要に応じて、Workspace 管理者が External Provider ページの Settings – ValiAssistant オプションを使用して無効にできます（右上の 
アイコンをクリックし、表示されるメニューから Settings を選択し、続いて左側ペインの一覧から ValiAssistant を選択してアクセス）– 
。
External Provider オプションが無効な場合、classic importer を使用してインポートできるのは *.xlsx および *.csv 形式のファイルのみです。この場合、Import Requirements ウィンドウ上部に対応するメッセージが表示されます（
）。
ファイルのアップロードに成功すると、そのエントリがウィンドウに表示されます。
アイコンをクリックすると、ウィンドウから削除できます。
アップロードした *.xlsx または *.csv ファイルについては、ウィンドウ左下の Classic Import (Non-AI) オプションを有効にすることで、classic importer を使用して続行することもできます。
抽出データの確認
必要なファイルをアップロードしたら、
ボタンをクリックして先へ進みます。抽出されたデータは、確認用の提案要件テーブルとして表示されます。
デフォルトでは、提案された要件は Importer にアクセスした時点で表示されていた仕様にインポートされます。必要な仕様は、ウィンドウ上部のドロップダウンから選択できます。また、ドロップダウンから + Add specification エントリを選択し、表示される仕様名フィールドで新しい仕様名を定義することで、新しい仕様を作成することもできます（
）。
Update requirements オプションを有効にすると、データを置き換えることで、宛先仕様内の既存の要件を上書きできます（ファイルのデータが仕様内のデータを置き換えます）。
Parametrize values オプションを有効にすると、提案された要件に定量化可能なパラメータが含まれていないかを確認し、それらを Vali に変換できます。
classic importer を使用する場合は、次のオプションも利用できます。
-
Starting row– インポートしたファイルのどの行からデータの収集を開始し、Requirements Portal に挿入するかを選択できます。
-
Sheet– 複数のシートを含むファイルの場合、どのシートからインポートするかを選択できます。
対応する行の左側にあるチェックボックスを有効にすることで、インポートする要件を選択できます。
データマッピング
アップロードしたファイルのデータを、Requirements Portal 内のどのフィールドに対応させるかを定義できます。ファイルに Requirements Portal のデフォルトフィールドと同じヘッダーが含まれている場合、それらのフィールドは自動的にマッピングされます。ただし、必要に応じてこの自動マッピングを上書きまたは調整できます。列ヘッダーをクリックし、ドロップダウンから必要なフィールドを選択してください。
または、ドロップダウン内の Search/Add custom フィールドに必要な名前を入力し、その後ドロップダウンから <custom_column_name> (Create new) を選択することで、列データを新しいカスタム列にマッピングすることもできます。
ドロップダウンから None を選択して、ファイルのデータをどの列にもマッピングしないようにすることもできます（つまり、このデータはインポートされません）。
少なくとも Identifier 列と Text 列を選択する必要があります。そうでない場合、その条件が満たされるまで警告メッセージが表示されます（
）。
Importer を使用して要件にインポートできるフィールドは次のとおりです。
-
Identifier
-
Text
-
Title
-
Rationale
-
Children
-
Parents
-
Section
-
Path to Section
-
Applicable Block
-
Compliance Comment
-
Type
-
State
-
Compliance
-
V&V Status
-
V&V Methods
-
Applicability
-
Owner
-
Tags
-
カスタム列
実行レポート
インポートするデータの確認と必要なオプションの設定が完了したら、
ボタンをクリックして先へ進みます。インポートが完了すると、確認ウィンドウが表示されます。
Importer がインポートされた要件内の問題を検出した場合、そのことがウィンドウに表示されます（
）。リンクをクリックすると、検出された問題の原因を詳述したレポートをダウンロードできます。想定されるケースは次のとおりです。
-
プロジェクト内にも、インポートファイル内の他の要件内にも存在しない Identifier との関係を持つ要件をインポートしようとした場合。
-
プロジェクト内またはインポートファイル内の他の要件内で、複数の要件に属している要件 Identifier との関係を持つ要件をインポートしようとした場合。
-
現在 Requirements Portal で定義されていない compliance statement を持つ要件をインポートしようとした場合。
-
現在 Requirements Portal で定義されていない type を持つ要件をインポートしようとした場合。
-
現在 Requirements Portal で定義されていない state を持つ要件をインポートしようとした場合。
-
現在 Requirements Portal で定義されていない tag を持つ要件をインポートしようとした場合。
-
現在 Requirements Portal で定義されていない applicability condition を持つ要件をインポートしようとした場合。
-
現在 Requirements Portal で定義されていない method を持つ要件をインポートしようとした場合。
-
現在 Requirements Portal で定義されていない applicable block を持つ要件をインポートしようとした場合。
-
現在 Requirements Portal で定義されていない owner をインポートしようとした場合。
-
現在 Requirements Portal で定義されていない複数の owner、state、または type をインポートしようとした場合。
ボタンをクリックすると Importer のファイルアップロード段階に戻り、
をクリックすると Importer を終了します。
Importer の以前のバージョン
上記で説明した Importer の新しいバージョンにアクセスできない場合は、以前のバージョンが使用されます。詳細は以下の折りたたみセクションを参照してください。
Previous Iteration of the Importer
AI 支援 Requirements Importer（以前のバージョン）
要件エンジニアリングは、多くの場合、PDF や Excel スプレッドシートのような、データ構造が十分に整っていない文書でステークホルダー要件を作成することから始まります。こうした非構造化文書から要件データを手作業で抽出するのは、手間がかかり、ミスも起こりやすくなります。Requirements Portal での要件取り込みプロセスを迅速化するために、AI 機能を活用して、非構造化の PDF、Excel、Word、CSV ファイルから要件をインポートできます。
Importer へのアクセス（以前のバージョン）
AI Assisted Importer はデフォルトで有効になっています。必要に応じて、Workspace 管理者が External Provider ページの Settings – ValiAssistant オプションを使用して無効にできます（右上の アイコンをクリックし、表示されるメニューから Settings を選択し、続いて左側ペインの一覧から ValiAssistant を選択してアクセス）– 
。
External Provider オプションが無効な場合は、legacy importer のみが利用可能となります。legacy importer の詳細については、以下の Legacy 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 のファイルアップロード段階に戻り、 をクリックすると importer を終了します。
Legacy Importer（以前のバージョン）
Importer にアクセスする際（learn more）、構造化された要件データをアップロードするために legacy import tool を使用して続行することもできます。また、legacy importer は、管理者によって Requirements Portal 設定で External Provider オプションが無効になっている場合にのみ利用できます。
このプロセスでは、Specification、Upload、Review の 3 つの主要な段階を案内します。仕様のインポートが完了すると、概要が表示され、Valifying や他のファイルのインポートなど、追加のアクションを実行することもできます。これらの段階とアクションについては、以下のセクションで説明します。
Specification（以前のバージョン）
Import Wizard のこの段階では、インポート先の仕様を定義できます。
-
Import Requirements ウィンドウの左側にある Select a specification 領域を使用して、既存の仕様と、必要に応じてそのセクションを選択します。
-
Import Requirements ウィンドウの右側にある Create a specification 領域を使用して、import wizard を終了せずに新しい仕様を作成し（さらに略称と割り当て先ブロックも定義し）ます。
希望する方法を使用するには、該当する領域をクリックします。
Upload（以前のバージョン）
Import Wizard のこの段階では、サポートされている形式のファイルをアップロードできます。アップロードするには、Import Requirements ウィンドウの右側にファイルをドラッグ＆ドロップするか、Drop file コントロールをクリックしてハードドライブからファイルを参照して選択します。ファイルのアップロードに成功すると、ウィンドウに通知が表示されます。
Review（以前のバージョン）
Import Wizard のこの段階では、アップロードしたファイルからインポートされたデータの結果を確認し、ファイルオプションを設定し、ファイルのデータを要件フィールドにマッピングできます。
Import Requirements ウィンドウの Destination 領域には、データがどこにインポートされるか（仕様またはセクション単位）が視覚的に示されます。
File options 領域では、次のオプションを利用できます。
-
Update requirements– 有効にすると、宛先仕様内の既存の要件がデータの置き換えによって上書きされます（ファイルのデータが仕様内のデータを置き換えます）。
-
Use header row– アップロードしたファイルのヘッダー行を使用するか、Requirements Portal が提供する一般的な参照ヘッダー行（つまり、列ヘッダーが A、B、C など）を使用するかを選択できます。
Sheet – 複数のシートを含むファイルの場合、どのシートからインポートするかを選択できます。
Starting row – インポートしたファイルの何行目から Requirements Portal に取り込むデータの収集を開始するかを選択できます。
Import Requirements ウィンドウ下部の表では、アップロードしたファイルのプレビューを表示し、その列を Requirements Portal の各フィールドにマッピングできます。これにより、各列に対して Map To ドロップダウンで適切なフィールドを選択することで、ファイル内のデータを Requirements Portal 内の特定のフィールドにどのように対応付けるかを定義できます。ファイルに Requirements Portal のデフォルトフィールドと同一のヘッダーが含まれている場合、それらのフィールドは自動的にマッピングされます。ただし、必要に応じてこの自動マッピングを上書きまたは調整できます。
-
少なくとも Identifier 列を選択する必要があります。そうでない場合、この条件が満たされるまで警告メッセージが表示されます（
）。
-
次のフィールドでは大文字と小文字が区別されます。
-
Type
-
State
-
Compliance
-
Tags
たとえば、Requirements Portal にすでにタグ
TBDが存在し、タグtbdをインポートすると、新しいタグtbdが作成され、その要件とともにインポートされます。 -
実行レポート（前回のイテレーション）
インポート処理が完了し、正常に終了した場合は、成功メッセージと実施された変更内容が表示されます。インポートに失敗した場合は、失敗メッセージが表示されます。成功したインポートの例を以下に示します。
ソフトエラーがある場合は、それらも表示されます（
）。発生し得るソフトエラーは次のとおりです。
-
関連付けを確立できません → Parent または Children の Identifier がプロジェクト内に存在しません
-
関連付けを確立できません → Parent または Children の Identifier がプロジェクト内で重複しています
-
Requirement Compliance Statement がプロジェクト内に存在しません
-
Requirement Type がプロジェクト内に存在しません
-
Requirement State がプロジェクト内に存在しません
-
Tag がプロジェクト内に存在しません
-
Applicability Condition が存在しません
インポーターの成功・失敗にかかわらず、Import new file（成功時）または Try again（失敗時）をクリックすると、再インポートまたは新しいインポートを実行でき、ステージ1（Specification）に戻ります。
AI で翻訳